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". The rsh procedure* 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.
  4. legion_context_env
    legion_context_env.csh
    LegionClass.config
    LegionClass.config._LegionStorage_MetaData_
  5. Set the environment on the new machine.
  6. ksh or sh users:

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

    csh users:

    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
  9. 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 System shutdown 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 Preparing the Legion environment in the System Administrator Manual).
  4. Enter the shutdown command:
  5. 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 Preparing the Legion environment in the System Administrator Manual).
  3. Run the start-up command.
  4. legion_startup -local
  5. Your local host or vault object now be running.

* If preferred, ssh can be used in place of rsh


Back to Reference Manual Table of Contents

Directory of Legion 1.5 Manuals