3.0 Alternative ways to start and shut down

3.1 Starting extra hosts and vaults, 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" (starting on page 39 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. Start it with the first-time start-up or restart procedure, if necessary.

  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. 
    legion_context_env.sh
legion_context_env.csh
LegionClass.config
LegionClass.config._LegionStorage_MetaData_
  4. Set the environment on the new machine.

    ksh or sh users:

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

    csh users:

    source $LEGION/bin/legion_env.csh
source $LEGION_OPR/legion_context_env.csh
  5. On the new machine, start up the host: 
    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.2 Shutting down extra hosts and vaults, command line

  1. Shut down the main system (see page 16 in the System Administrator Manual).
  2. Login to the desired machine (i.e., the machine which contains the host and/or vault object that you wish to shut down)
  3. Set the user environment correctly (see page 19 in the System Administrator Manual).
  4. Enter the shutdown command: 
    legion_shutdown -local

3.3 Restarting extra hosts and vaults

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).

  1. Login to the machine on which the host or vault object resides.
  2. Set the user environment (please see page 19 in the System Administrator Manual).
  3. Run the start-up command. 
    legion_startup -local
  4. 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

Directory of Legion 1.6 Manuals