Getting Started

These setup instructions are for users of NSP routers and/or the newer NPR routers. The only difference is the RLI jar file that you will need (RLI.jar for NPSs and RLInpr.jar for NPRs). If you are using ONL in a course, check with your instructor for the appropriate platform. Otherwise, you are probably interested in the newer NPRs. But feel free to try both platforms.

Follow these steps:

• Get the RLI.jar file (NSP version)

You can get the RLI.jar file by following this Get RLI.jar Web link. You can also get it by logging into onl.arl.wustl.edu and copying the file RLI.jar from ~onl/export/RLI.jar to your remote host. You can also get the jar file from the Get RLI link in the side bar of the ONL web page under the NSP section.

• Get the RLInpr.jar file (NPR version) (Not available until mid-August 2008)

You can get the RLInpr.jar file by following this Get RLInpr.jar Web link. You can also get the jar file from the Get RLI link in the side bar of the ONL web page under the NPR section.


• Install JRE (Java Run-time Environment) 1.5.0 or higher (May not be necessary)
• First determine if you can avoid this step by seeing if you are already running JRE 1.5.0 or higher. Enter: java -version . If the response says that you are already running some version that is atleast 1.5.0, you can skip this step. JRE 1.4.2 or higher might also work for you, but we have noticed that Winows XP monitoring panels will lock up in some cases.
• If you need to install the JRE, go to the Java download page http://java.sun.com/j2se/ and download the latest JRE for your platform by following the instructions posted at the Sun site. Note: You only need to download the JRE (less than 100 MB), not the entire JDK (Java Development Kit) which is around 450 MB. The download you want is labeled something like Download JRE 5.0 (note the JRE label).
• Verify that you can run an ssh client on your host
• If you know you have an ssh client, you can go on to the next step. Otherwise, continue ....
• Open up a command-line window and enter: ssh -V
  This should display the version number of your ssh. Furthermore, it should indicate that you are running version 2 and not the older version 1. If this fails, you see your system administrator or get an ssh client from the Web. Try PuTTY or Open SSH.
• Verify that you can SSH from your client host to our user host
• You can only SSH into onl.arl.wustl.edu from outside of the ONL testbed.
• Use your SSH client tool or a command line window to SSH to onl.arl.wustl.edu. If the connection succeeds, you should see a command line prompt that indicates that you are logged into the host onlusr. If you reach this point, you have successfully gotten through the firewall and a Linux bash shell is waiting for commands.
• Verify that you can run the RLI on your remote host
• Follow the instructions for setting up an ssh tunnel to the ONL Central Resource Daemon. See RLI SSH Tunneling. If successful, the SSH connection will be from your client to onlusr and there will be a tunnel to the ONL Central Resource Daemon (wherever it is running).
• Open up another command-line window.
• Start the RLI by enterring: java -jar RLI.jar
• At this point, we just want to see if the RLI will talk to the Central Resource Daemon. So, this step will result in an error message but hopefully the one we expect.
  Add one host by selecting in the RLI: Topology => Add host.
• Request ONL to commit resources by selecting: File => Commit
  One of three things will happen:
  
  • You will get a prompt for you password. Enter your password and select Enter. You should get a Commit Error message saying Reservation Not Found. This is OK at this point since it indicates that you were able to communicate with the Central Resource Daemon. Select OK. A Make Reservation dialogue box will appear. Select Cancel, and exit the RLI by selecting File => Exit.
  • You get a dialogue box that contains the error message Unable to connect: couldn't get I/O for 127.0.0.1. This indicates that your ssh tunnel to the Central Resource Daemon is not working. If you can not fix the problem, send email to testbed-ops@onl.arl.wustl.edu for assistance. Include your phone number (just in case we have to contact you by phone).
• If you encounter problems that you can not resolve, send email to testbed-ops@onl.arl.wustl.edu.

Congratulations!

Please note the following:

• If you want to change your password, you should do so through the web interface and not on the ONL hosts. Although there is nothing to stop you from changing your password by entering the passwd command while logged into one of the ONL hosts, your password on the hosts and your password in the database will be different.