The Real Time Monitor

Supported Operating Systems

It has been run and tested on the following architectures:

  • Windows XP
  • Mac OSX 10.5+
  • Windows Vista
  • Ubuntu and Fedora
It has not been tested on:
  • Windows 7
It will not run on:
  • Mac OSX 10.4.11 and earlier
  • Windows Me and earlier

Requirements

The client uses OpenGL and Java 1.6 your architecture will need to have these installed to work. It is quite likely that if you have a modern and up to date operating system it will.

Controls

H - brings up the 'Help' screen
A - brings up the 'About' screen
V - Virtual Organisation selection screen
M - Menubar on/off (default on)
N - Number of jobs on/off (default on)

The arrow keys or a dragged clicked mouse button will move the Earth around
+ (plus key) Zooms in
- (minus key) Zooms out
C - Removes all open tabs
The table of jobs that is accesible through the site's windows is sortable - click on the column headers to sort.
Closing the main window will exit the program

You can add the following to the Command line in the .BAT or .SH files for extra customisation:
-Drtm.noStats This will give you no job statistics at startup
-Drtm.noAbout This removes the About greeting window at startup
-Drtm.minLon -Drtm.maxLon -Drtm.minLat -Drtm.maxLat Specifies what area to appear on startup. They are in the form -Drtm.minLat=xx.x -Drtm.maxLat=XX.X -Drtm.maxLon=yy.y -Drtm.minLon=YY.Y with the values being in degrees.

An example of a command line with these flags would look like this:
java -Xmx512m -Dsun.java2d.noddraw=true -Drtm.minLat=34.3 -Drtm.maxLat=48.5 -Drtm.maxLon=18.85 -Drtm.minLon=6.22 -Drtm.noAbout -Djava.library.path="lib" -jar "dist/rtm_3D_2009.jar"

Installation Instructions

Windows (Basic)

  1. Unzip the folder and transfer the folders and file to a suitable location e.g. "C:\Program Files\RTM" keeping the folder hierarchy.
  2. To run the client just double click the .BAT file found at "C:\Program Files\RTM".

Windows (Advanced)

These instructions will make it easier to run the RTM from your machine.
  1. Follow the above instructions until step #2.
  2. Open the "C:\Program Files\RTM" folder.
  3. Right click the .BAT file.
  4. Select "Create Shortcut" from the menu. This will put a shortcut file to the .BAT file in that folder.
  5. Drag and drop this shortcut to your desktop.
  6. Right click the shortcut.
  7. Select "Properties" from the menu.
  8. On the Shortcut tab click the "Change Icon" near the bottom of the dialog box"
  9. Select a suitable icon and hit "OK"
  10. You may also want to rename the shortcut to "Real Time Monitor" or something similar.
  11. Now to run the client just click on the shortcut on your desktop.

Mac OSX (Basic)

  1. Unzip the folder and transfer the folders and file to a suitable location e.g. "/Applications/RTM" keeping the folder hierarchy.
  2. To run the client you will need to open a terminal window.
  3. Now navigate to the "/Applications/RTM" folder with the terminal window
  4. Run the .sh file with the sh command e.g. "sh rtm.sh".

If at this point you see the yellow box and a terminal window, then the yellow box disappears but the terminal says it is showing events but there are no graphics, then you don't have Java 1.6 installed. On some installs of Mac OSX 10.5 Java 1.6 isn't installed and doesn't come as standard. To get it download and install this.
Then go to Applications > Utilities > Java > Java Preferences.
Drag Java SE 6 64 Bit to the top of both of the lists (applications and applets).
Now the new RTM should run.

Mac OSX (Advanced)

These instructions will make it easier to run the RTM from your machine.
  1. Follow the above instructions until step #2.
  2. Open a new file in TextEdit
  3. Assuming that your install of the RTM is at "/Applications/RTM/" and the .sh file is called rtm.sh type the following into your file:

    cd /
    cd /Applications
    cd RTM
    sh rtm.sh

  4. Save this file as RTM.command in the "/Applications/RTM" folder.
  5. You now need to make this executable so it can run the RTM.
  6. Open a terminal window.
  7. Navigate to the "/Applications/RTM" folder with Terminal.
  8. Type "chmod 755 RTM.command" this will make the file executable.
  9. Drag the RTM.command file to your dock.
  10. Now to run the RTM just click on the icon in your dock to run the RTm when needed.

Mac OSX (Even More Advanced)

If you want the shortcut in the dock to look nicer follow these instructions:
  1. Remove the icon from your dock.
  2. Open this png file in a browser window.
  3. "cmd + click" on the image and "Copy Image"
  4. Navigate to the rtm.command file with Finder, select it, press "cmd + i" to get info.
  5. At the top left hand side of the dialogue box for the .command file is the file's icon (a terminal window).
  6. Click this image and you will see a very vague highlighting appear around the icon.
  7. Now press "cmd + v" this should replace the terminal image with that of a globe.
  8. As before drag the .command file to your dock and you will have the RTM globe sitting in your dock ready for launching.

Linux(Basic)

  1. Unzip the folder and transfer the folders and file to a suitable location e.g. "home/user/RTM" where user is your username and keeping the folder hierarchy.
  2. Create a file called rtm.sh which contains the following:

    cd /
    cd /home/user/RTM
    java -Xmx512m -Dsun.java2d.noddraw=true -Djava.library.path="lib" -jar dist/rtm_3D_2009.jar

  3. To run the client you will need to open a terminal window.
  4. In the terminal window type "sh home/user/RTM/rtm.sh"
  5. The RTM should now run
  6. You can create a simple application launcher with your flavour of linux by using the command "sh home/user/RTM/rtm.sh"