877-277-2477
info@capstonecourseware.com

Tool Setup Instructions

Metro, Version 1.5

If the course you are setting up requires Metro 1.5, follow these instructions to set it up on the student and instructor machines. If you have questions, please contact your courseware vendor.

Note that Metro is intended to be plugged in to a Java EE server. Our courses use it with GlassFish, so be sure you've already set up the Java EE 5 SDK, Update 7.

Metro is a free download from the GlassFish project. Download from the following location:

http://capcourse.com/Tools/metro-1_5.zip

Open the downloaded ZIP file, and unpack the embedded metro-1_5.jar. Put this file anywhere; for simple cleanup after class we suggest creating a directory c:\Capstone\Tools and placing the file there. (This directory would be created by the lab installer later anyway, and so this puts Metro alongside other tools.)

Open a command console in the working directory c:\Capstone\Tools. Unpack the JAR with the following command:

java -jar metro-1_5.jar

You'll see a license agreement in a dialog box:

License top

Read the license agreement, and when you've reached the bottom, the Accept button will be enabled; click it:

License bottom

Then you'll see a rolling list of files being unpacked:

metro
metro\bin
metro\docs
metro\docs\style
...
metro\samples\xmlbind_datasource\src\xmlbind_datasource\client\DispatchImage.java
metro\samples\xmlbind_datasource\src\xmlbind_datasource\server\ImageImpl.java
installation complete

To install Metro on GlassFish, be sure that the server is not running, and then run the following commands:

cd metro
c:\Sun\SDK\bin\asant -Das.home=c:\Sun\SDK -f metro-on-glassfish.xml install
Buildfile: metro-on-glassfish.xml

gfv3-checkpoint:

init:
    [mkdir] Created dir: C:\Sun\SDK\.wsit-1.5
     [copy] Copying 3 files to C:\Sun\SDK\.wsit-1.5

install:
     [echo] Installing Metro 1.5 FCS on c:\Sun\SDK ...
     [copy] Copying 2 files to C:\Sun\SDK\lib
     [copy] Copying 1 file to C:\Sun\SDK\lib\endorsed

gfv3-checkpoint:

install-api:
    [mkdir] Created dir: C:\Sun\SDK\jdk\jre\lib\endorsed
     [copy] Copying 1 file to C:\Sun\SDK\jdk\jre\lib\endorsed
     [echo] ... installation complete.

BUILD SUCCESSFUL