Legion 1.4
Reference Manual


3.0 Starting extra hosts and vaults from the command line

Please note that the procedure described below does not use rsh classes, as does the normal procedure described in "Adding a new host" and "Adding a new vault" in the System Administrator Manual. The rsh procedure1 is preferable, if possible, to the command-line procedure, since it is easier and faster.

The full procedure explained below can be used for adding new host or vault objects with the command-line procedure to a system spanning multiple file systems or to a Legion system with a common file system. For a system spanning multiple file systems, however, skip steps 2 and 3. In either case, the main Legion system must be active. If necessary, start it with the first-time start-up or restart procedure.

  1. Login to the desired machine.
  2. Create the $LEGION and $LEGION_OPR directories on the new machine, if they do not already exist.
  3. Copy the following files from your Legion system's $LEGION_OPR directory to the new machine's $LEGION_OPR directory, if they do not already exist.
  4. legion_context_env.sh
    legion_context_env.csh
    LegionClass.config
    LegionClass.config._LegionStorage_MetaData_

  5. Set the environment on the new machine.
  6. ksh or sh users should enter:

    . $LEGION/bin/legion_env.sh
    . $LEGION_OPR/legion_context_env.sh

    csh users should enter:

    source $LEGION/bin/legion_env.csh
    source $LEGION_OPR/legion_context_env.csh

  7. On the new machine, start up the host:
  8. legion_startup -local

    You will prompted as to whether or not you wish to start a host and vault object. We recommend that you answer "yes" to both.

3.1 Shutting down extra hosts and vaults from the command line

Shut down the main system (see System shutdown in the System Administrator Manual).

Login to the desired machine (i.e., the machine which contains the host and/or vault object that you wish to shut down)

Set the user environment correctly (see Preparing the Legion environment in the System Administrator Manual).

Enter the shutdown command:

legion_shutdown -local

3.2 Extra hosts & vaults restart

Once an extra host or vault has been safely shut down, it can be restarted. If the host or vault was not safely shut down, you cannot restart it, but must delete the OPR directory, restart Legion, and start the host or vault again (see System restart, in the System Administrator Manual).

Login to the machine on which the host or vault object resides.

Set the user environment (please see Preparing the Legion environment in the System Administrator Manual).

Run the start-up command.

legion_startup -local

Your local host or vault object now be running.


1. If preferred, ssh can be used in place of rsh back


Back to Reference Manual Table of Contents