2.7 General functions about the state of the system

legion_check_system 
     [-v] [-q] [-fix CommandLine | -fix Contexts] [-debug] [-help]

Checks the status of the key elements of your Legion system: LegionClass, host objects, root context object, etc. The output will include a summary of any warnings and errors in your system.

The following options are supported:

-v

Run the command in a verbose mode.

-q

Run the command in a quiet mode, i.e., print only the summary of warnings and errors.

-fix CommandLine

Report any errors in a command-line object then delete the object.

-fix Contexts

Report any errors in a context object then delete the object.

-debug

Catch and print Legion exceptions.

-help

Print command syntax and exit.

You can use a -fix flag to specify that offending command-line and/or context objects be reported and destroyed (you may use both -fix flags to specify that both types of offending objects be removed). The example here uses both flags and shows the discovery and removal of a bad context object:

$ legion_check_system -v -fix CommandLine -fix Contexts
Checking UnixHostClass status
Checking UnixVaultClass status
Checking UnixImplementationCacheClass status
Checking ContextClass status
Checking CommandLineClass status
Determining root context
Checking root context status
Checking current context status
Validating the integrity of the class hierarchy
legion_check_system: error, object in "error" state:
1.3746b561.06.b6f4d579.000001fc0b3af9621e5b883eee4cd21b415bd
3828bc4dcd9ec09b4667dbf989a1b6f7d4c44d77f650dd125b581028fc58
05e0176d69bd60beed84e55555fef2cf6031fa7.
fix specified, destroying object - say good-bye
[etc.]
$
legion_classof 
     {[-c] <object context name> | -l <object LOID>} [-debug] [-help]

Displays the LOID of the class of the object named in <context path> or <object LOID>. The example below displays instance Foo's class LOID.

$ legion_classof Foo
The class of 1.01.66000000.01000000.000001fc0...
     is 1.01.66000000..000001fc0d085b2c33...
$

The following options are supported:

-debug

Catch and print Legion exceptions.

-help

Print command syntax and exit.

legion_create_stat_tree 
     <base context path> [-debug] [-help]

Creates a database of current loads on all host objects in a system.

The following options are supported:

-debug

Catch and print Legion exceptions.

-help

Print command syntax and exit.

legion_host_stats 
     {[-c] <host context path> | -l <host LOID>} [-debug] [-help]

Prints the number of objects and current load for the given host object. The following options are supported:

-debug

Catch and print Legion exceptions.

-help

Print command syntax and exit.

legion_list_objects 
     {[-c] <host context path> | -l <host LOID>} [-debug] [-help]

Lists the Legion objects currently managed by (i.e., running on) the host object named in <host context path> or <host LOID>. This may include each object's LOID, status, and its owner's LOID and OA.

The following options are supported:

-debug

Catch and print Legion exceptions.

-help

Print command syntax and exit.

legion_version [-debug] [-help]

Prints your Legion version number. For example, the output below indicates that the current system is University of Virginia Legion version 1.5.9.

$ legion_version
VaL Legion version 1.5.9
$

The following options are supported:

-debug

Catch and print Legion exceptions.

-help

Print command syntax and exit.

legion_wellknown_class 
     <wellknown class name> [-debug] [-help]

Gets the class LOID of a Legion "well-known" class. Possible values for <wellknown class> are:

  • LegionClass
  • BootstrapMetaClass
  • UnixHostClass
  • UnixVaultClass
  • CommandLineClass
  • ContextClass
  • ImplementationClass
  • UnixImplementationCacheClass
  • BindingAgentClass

The following options are supported:

-debug

Catch and print Legion exceptions.

-help

Print command syntax and exit.

legion_whereis 
     {[-c] <object context name> | -l <object LOID>} [-debug] [-help]

This command returns a specified object's host and vault object. That is, the output gives the context path of the host and vault objects where the object and the object's persistent state are located. If the host or vault objects have been assigned aliases Legion will randomly return one of the context paths. Your output will look something like this:

$ legion_whereis Foo
Host : /hosts/BootstrapHost
Vault: /vaults/BootstrapVault
$

This example looks up the location of object Foo. The output shows that the object is located on BootstrapHost and its persistent state is on BootstrapVault. The following options are supported:

-debug

Catch and print Legion exceptions.

-help

Print command syntax and exit.

legion_whoami 
     [-debug] [-help]

You can use this command to find out which user id you are currently logged in with. If you are logged in as user nemo, your output will be:

$ legion_whoami
/users/nemo
$

The following options are supported:

-debug

Catch and print Legion exceptions.

-help

Print command syntax and exit.

Directory of Legion 1.6.4 Manuals
[Home] [General] [Documentation] [Software]
[Testbeds] [Et Cetera] [Map/Search]

Free JavaScripts provided by The JavaScript Source

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