Installing the Legion GUI

Table of Contents
1. Installing and starting
1.1 Windows NT with Legion
1.2. Windows 95 and 98, NT without Legion
1.2.1. File structure
1.2.2. Starting
1.3. Unix
2. Exiting
Other on-line tutorials & documentation
Other GUI pages:
Click on the to move to the selected text.

A note on this page's style conventions: context path names are in a fixed font and the GUI's main menu bar command options are in green. If you need to click a series of options, they will be separated by a "|" pipe. For example, File | Import indicates that you need to go to the menu bar, click "File" and then click "Import".

1. Installing and starting


There are two different types of Windows installation mentioned in this section. One is for a Windows NT machine that contains the Legion NT binary release package. The other is for Windows 95 and 98 machines and NT machines that do not have the Legion NT binaries.

1.1. Windows NT with Legion


This package assumes that you or your system administrator have downloaded and installed the Legion NT binary on your NT machine. You must be connected to a working Legion system by executing the appropriate environment scripts before you can start a GUI. Once you're connected, there are two steps to starting the GUI:

  1. Open a DOS window and type the following:
  2. LegionGui
  3. You will then be asked to enter your user context root path (probably something like /home/<user name>). The default setting is /. Check with your system administrator if you are not sure what your context root path should be.

    If you enter an invalid path, you will get an error message and be asked to enter a correct path. If you are in a secure system and you enter a path that you do not have permission to write to, you will not be able to use that path as your view root (e.g., if you are not logged in as admin, you probably do not have permission to use / as your root context path). You will be able to start the GUI but you will not be able to create memos, create new objects, or remove existing objects from Legion space (although you will be able to remove members from the GUI view window).

    Please note that you cannot change your root path from inside the GUI. You can either start another GUI or close down the current GUI and start again.

The GUI menu bar and a view window will then appear.


1.2. Windows 95 and 98, NT without Legion


You must have the Java Runtime Environment (JRE) or the Java Developer Kit (JDK) 1.1.3 or later in order to run this application. You can download these from <http://java.sun.com/products>.

The installation package is in the LegionGui.zip file. It consists of three parts: binaries, libraries and classes. Move the package to your hard drive, then unzip it.


1.2.1. File structure


The files for running the GUI in Windows95 must be stored in a specific directory configuration. The unzipped package must have the directory structure shown below. If you are using WinZip be sure to check the Use folder names option before extracting the files. All directory names must appear as shown, particularly the GUI classes, since these names reflect the package structure of the program.
c:\LegionGui
	\Bin
	\context_manager
	\dialogs
	\displays
	\attributes
	\instances
	\methods
	\LegionBridge
	\Lib
	\processors
	\multi_run
	\usage
	\views
	\viewTree
The \Bin subdirectory holds the jre.exe, and the *.dll files. The \Lib subdirectory holds the *.jar files and classes.zip. The remaining directories hold the compiled classes of the GUI program.

The GuiStart.bat file is in the \LegionGui directory, but you can move it anywhere in your current machine's directory structure. It assumes that the directory structure above is in c:\, but you can put the unzipped package in any part of your current machine. If the GUI files are not on the c:\ drive you must alter the GuiStart.bat file accordingly.


1.2.2. Starting


You must be connected to a working Legion system before you can start a GUI. Once you're connected, there are three steps to starting the GUI:

  1. Open a window to a host with Legion distribution installed, and execute the following command:
    javaLegionServer

    This will return a port number <PPP>.

  2. Open a DOS window. Move to the directory containing the \LegionGui directory structure (e.g., c:\), and enter the following:
    GuiStart <my_host> <PPP>

    The <my_host> argument is the address of the Legion host computer (e.g., host.cs.virginia.edu). The <PPP> argument is the port number produced by the JavaLegionServer command in step 1. This will load the GUI and display its initial view of your context space.

  3. You will then be asked to enter your user context root path (probably something like /home/<user name>). The default setting is /. Check with your system administrator if you are not sure what your context root path should be.

    If you enter an invalid path, you will get an error message and be asked to enter a correct path. If you are in a secure system and you enter a path that you do not have permission to write to, you will be to use that path as your view root (e.g., if you are not logged in as admin, you probably do not have permission to use / as your root context path). You will be able to start the GUI but you will not be able to create memos, create new objects, or remove existing objects from Legion space (although you will be able to remove members from the GUI view window).

    Please note that you cannot change your root path from inside the GUI. You can either start another GUI or close down the current GUI and start again.

The GUI menu bar and a view window will then appear.


1.3. Unix


The GUI is not currently supported in Unix, but we expect it will be in future releases.

2. Exiting


To close all views and displays and exit the GUI, click the File | Exit command on the main menu bar or click the Windows Close button in the upper right corner of the main menu bar.


Other relevant on-line documents:
Click on the to go to the page.
Logging in to a running Legion system
Introduction to Legion context space
Context-related commands
Legion tty objects
Running a PVM code in Legion
Running a Legion MPI code
Running native MPI code
Quick list of all 1.7 Legion commands
Usage of all 1.7 Legion commands
FAQs for running programs in Legion
Starting a new Legion system
Legion security
Legion host and vault objects
Adding host and vault objects
Brief descriptions of all on-line tutorials

Last modified: Wed Apr 26 14:45:25 2000

 

[Home] [General] [Documentation] [Software]
[Testbeds] [Et Cetera] [Map/Search]

legion@Virginia.edu
http://legion.virginia.edu/