Legion Host and Vault Objects


More on legion_starthost
Supported <flags> for legion_starthost are:
-L <$LEGION> Specify $LEGION for the new host
(default is "/home/xxxx/Legion")
-O <$LEGION_OPR> Specify $LEGION_OPR for host
(default is current $LEGION_OPR)
-A <$LEGION_ARCH> Specify the architecture type for the host
(default is current $LEGION_ARCH)
-B <path> Specify the basename of the host binary
(default is "UnixHostObject")
-N <context name> Specify the context name for the host object
(default is "/hosts/<new host name>")
-U <user id> Specify a Unix user id for host
(default is current Unix user id)
-C <host class> Specify the context path of the host class
(default is "/class/UnixHostClass")

This command first creates a new host object on the specified <new host name> (the host's DNS name). It selects the following additional default values for the new object:

<$LEGION_OPA>= $LEGION_OPR/Host-$HOST.OPA
<binary path>= $LEGION/bin/$LEGION_ARCH/UnixHostObject

An OPA (Object Persistent representation Address) is used to track a specific OPR. In this case, the OPA will represent the persistent state of the new host object. The binary path is the binary path of the program that will be run on the new host in order to start the new host object. Currently, this path can be altered only by editing the legion_start source file, in the $LEGION/src/CoreObjects/ClassObjects/rshStartClassObject directory.

These flags and defaults need to be carefully considered when adding new hosts and vaults to your system. If the new host has a different architecture or a different directory structure, use the -A, -L, or -O flags to specify these parameters. The -U flag allows you to specify a Unix user id for the new object, so that a system administrator can add host objects to another user on the same Unix system. This can be useful should you wish to create a guest user id that has limited access privileges to the new host. The -C flag allows you to start an instance of a different class, so that users can create new host classes and have more flexibility in managing their resources. (Legion currently comes with only one host class, UnixHostClass, but users can add more host classes as necessary, either by creating instances of the UnixHostClass or by writing new classes.)

If the new host object's architecture is not the same as the current host object's architecture, you should run the legion_init_arch tool in order to create implementation objects to match the new architecture (see section 9.0 of the System Administrator Manual, for information about implementations, and section 9.2 of the System Administrator Manual, for information about running legion_init_arch).


About the legion_startvault flags

Supported <flags> for legion_startvault are:

-L <$LEGION> Specify $LEGION for the vaults host
(default is "/home/Legion")
-O <$LEGION_OPR> Specify $LEGION_OPR for the vault's host
(default is "/home/OPR")
-A <$LEGION_ARCH> Specify the architecture of the vault's host
(default is current $LEGION_ARCH)
-N <context name> Specify the context name for the vault object
(default is "/vaults/vault-<host name>")
-U <user id> Specify a Unix user id
(default is current Unix user id)
-C <vault class> Specify the context path of the vault class
(default is "/class/UnixVaultClass")

This commands creates a new vault object on the storage system of a specified host (named in <host name>). The flags are similar to the legion_starthost flags. The -L, -O, or -A flags can be used to specify a different architecture or a different directory structure. The -N flag allows you to specify a context name. The -U flag allows you to specify a Unix user id for the new object, so that a system administrator (or anyone with root privileges) can add vault objects to another user on the same Unix system. This can be useful should you wish to create a guest user id that has limited access privileges to the new host. The -C flag allows you to start an instance of a different class. That is, if you do not use this flag, the new host object will be an instance of class UnixVaultClass. This flag allows users to create new vault classes, so as to give users more flexibility in managing their resources.