Tutorial:
The Legion Browser

Table of Contents
What is the browser?
How do I start it up?
What am I looking at?
What can I do with it?
Other on-line tutorials & documentation

Click on the to move to the selected text.


Depending on how your system is set up, you may need to set up your access to your system before you can run Legion commands. This will probably involve running a command such as this:
$ . ~legion/setup.sh
     or
$ source ~legion/setup.csh
The exact syntax will depend on what kind of shell you are using and where your Legion files are installed (i.e., the value of ~legion will depend on your individual Legion net). Consult your system administrator for more information.

The following style conventions are used in these tutorials:


What is the browser?
The Legion browser is an on-line graphic interface to vanet context space. If you are a vanet user, you can see and work with your objects from the web. If you've never worked in context space before, this is a helpful tool for seeing how it works.

At this point, it only displays vanet's context space and is not available for download to other Legion systems. At some point soon we hope to have a web-based graphical user interface available for downloading.


How do I start it up?
The browser is available at http://sirius.cs.virginia.edu/browser. To start it, you can log in as a guest or, if you have a vanet account, with your vanet account name and id. You may have to accept site certificates from the sirius.cs.virginia.edu host (which runs the browser) before or after you login.


What am I looking at?
The first page that you will see is the login page.

You can fine tune your session on this page, by choosing among the various options:

  • The Legion Net field is already filled in for you (vanet is currently the only Legion net available on the browser). You need to enter a vanet user name and password in the User Name and Password fields in order to start a browser session. If you don't have a vanet account, just enter "guest" in the User Name field and leave the Password field empty.
  • The command box currently has two options. You can browse context space (the default setting) or run Amber (Assisted Model Building with Energy Refinement), a biomolecular simulation program.
  • The "Browse Contexts" option will take you to vanet context space. If you enter you vanet user id & password, you will be taken to your home context. Otherwise, you will start off in the the / root context.
  • You can also choose to start up to three additional windows. These windows display the session's status (please click here for more information), standard input, and standard error. Please note that you can only start these windows from the login window.

Once you're ready, click the "Login" box to start.

Once you've successfully logged in, you'll see your home context (or the root context, if you have logged in as a guest). The example below shows the home context space for vanet user spw4s:


What am I looking at?

The browser displays several pieces of useful information. The top of the screen shows the name of the Legion net, a list of options, and your current context. In this screen shot, you are in vanet and in /home/spw4s.

The left side of the screen shows your location in vanet context space. You can click on any name to see other sections of vanet. If you do not have permission to see a particular part of context space, you will not be able to view the objects or see their contents.

The right side of the screen shows the contents of your current context. The browser display each name contained in the current context in the Name column and its object's type in the Type column. More information about the object can be found in three categories: Basics, Permissions, and Details.

Basics -- attrs, class, and names -- tells you about the object's attributes, its class, and if it has any other context names. Permissions -- acls, change -- lets you see and edit the object's access control list. Details -- info, whereis, ping -- lets you see all the petty details (host, vault, owner, LOID, etc.). Please note that you may not have permission to use all of these options on some objects.


Options bar
The Options bar is at the top of the browser page. It contains a set of actions that you can do in your current session.

These options help you navigate through context space and work with your objects. Let's look at them one at a time.

Home

The Home option takes you back to your starting point in vanet context space. If you are logged in as a vanet user, this will be /home/<user name>. Otherwise, you will go back to the root / context.

Create/Copy

You can create a new Legion context, copy a Legion file object, copy a local file into context space, or copy a file object into a local file. In each of these processes, Legion will copy the contents of one file into a new file. When you click this option, you'll see a new window:

To create a new Legion context, you'll use the section marked A in the screen shot. Enter the new path in first field and click the "Create Legion Context" button.

If you are copying a local file object into Legion context space, you'll use the section marked B in the screen shot. Enter the local file's path in the first field or use the "Browse..." button to find the file. Enter the new file object's name in the second field, then hit the

Delete

Register

Run

Whoami

Clear Cache

Man Pages

Instance Information

Status

Logout


The Status window
You can open a Status window when you first login to the browser (but not after you've started your session). Click the box labeled "Status" on the "Show" options on the login page. When you start your session, a Status window will pop up. It looks like this:

The Status window is a separate window that displays what the browser is currently doing. The Status window displays the time the action started, the user id that the action is running under, and the action itself. The current action is listed on the bottom of the window.

An action can be running a Legion command-line tool, waiting for output, generating data, or running a program. If the browser is running a command-line tool, the status window will show what parameters the tool is using. For example, the screen shot above shows that user spw4s is currently running the legion_ls command-line tool for the context /home. On the command line, the current action would look like this:

$ legion_ls /home

This windows shows actions only for your session.


What can I do with it?


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: Fri Sep 15 17:08:53 2000

 

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

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