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 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 23 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 13 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," pg. 24, 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 13 in the System Administrator Manual).
3. Run the start-up command.

   legion_startup -local

4. Your local host or vault object now be running.

3.4 Using two hosts to start up a system

Generally, you can use a single host to start a new Legion system, but if your machines are strapped for memory you may need to split the process between two hosts. Technically, you can use two hosts used for the whole procedure, the start-up host and the bootstrap host (Figure 1): start Legion from one host and use a different host as the bootstrap.

Figure 1: Start-up and Bootstrap hosts.

The start-up host must always be used to run legion_startup. The host that you select during legion_setup_state and that contains the basic Legion classes is the start-up host. The bootstrap host is used to boot the system and is the first host object added to the system. It will contain the first pieces of the new system (the first contexts and instances of the classes). In either case, Legion binary executable files must be installed on any hosts used for Legion procedures. That is, you don't have to run legion_startup in order to use the host in a Legion net: you just have to have the binary files. You do not have to run legion_initialize on the same host on which you run legion_setup_state and legion_startup.

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

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