Sun Microsystems
Products & Services
 
Support & Training
 
 

Previous Previous     Contents     Index     Next Next

ProcedureHow to Install Execution Hosts

The execution host installation procedure creates the appropriate directory hierarchy required by sge_execd, and starts the sge_execd daemon on the execution host. This section describes how to install execution hosts interactively from the command line. You can automate the installation of execution of multiple hosts by using the procedure described in Chapter 3, Automating the Installation Process.

Before You Begin

Before installing an execution host, you first need to have installed the master server as described in How to Install the Master Host.

You must satisfy several prerequisites before you can install N1GE execution hosts with Windows operating systems. It might be necessary to install additional software on your computer. (See Appendix A)

Steps
  1. Log in to the execution host as root.

  2. As you did for the master installation, either copy the installation files to a local installation directory sge-root or use a network installation directory.

  3. Ensure that you have set the $SGE_ROOT environment variable by typing:

    # echo $SGE_ROOT

    • If the $SGE_ROOT environment variable is not set, set it now, by typing:

      # SGE_ROOT=sge-root; export SGE_ROOT

  4. Change directory (cd) to the installation directory, sge-root.

  5. Verify that the execution host has been declared on the administration host.

    # qconf -sh

    • If you do not see the name of this execution host in the output of the qconf command, you will need to declare it as an administration host.

      1. Start a new terminal session or window.

      2. In that window, log into the master host.

      3. Declare the execution host as an administration host, using the qconf command.

        # qconf -ah quark
        quark added to administrative host list

      4. Log back out of the master host, and continue with the installation of the execution host.

  6. Run the install_execd command.

    If you are installing using the Certificate Security Protocol method described in Chapter 4, Installing the Increased Security Features, add the -csp option to the install_execd command.

    % ./install_execd

    This command starts the execution host installation procedure.

    Welcome to the Grid Engine execution host installation
    ------------------------------------------------------
    
    If you haven't installed the Grid Engine qmaster host yet, you must execute
    this step (with >install_qmaster<) prior the execution host installation.
    
    For a sucessfull installation you need a running Grid Engine qmaster. It is
    also neccesary that this host is an administrative host.
    
    You can verify your current list of administrative hosts with
    the command:
    
       # qconf -sh
    
    You can add an administrative host with the command:
    
       # qconf -ah <hostname>
    
    The execution host installation will take approximately 5 minutes.
    
    Hit <RETURN> to continue >> 

  7. Verify the sge-root directory setting.

    In the following example, the value of sge-root is /opt/n1ge6.

    Checking $SGE_ROOT directory
    ----------------------------
    
    The Grid Engine root directory is:
    
       $SGE_ROOT = /opt/n1ge6
    
    If this directory is not correct (e.g. it may contain an automounter
    prefix) enter the correct path to this directory or hit <RETURN>
    to use default [/opt/n1ge6] >> 
    
    Your $SGE_ROOT directory: /opt/n1ge6
    
    Hit <RETURN> to continue >> 

  8. Enter the name of your cell(s).

    The use of grid engine system cells is described in Cells.

    Grid Engine cells
    -----------------
    
    Grid Engine supports multiple cells.
    
    If you are not planning to run multiple Grid Engine clusters or if you don't
    know yet what is a Grid Engine cell it is safe to keep the default cell name
    
       default
    
    If you want to install multiple cells you can enter a cell name now.
    
    The environment variable
    
       $SGE_CELL=<your_cell_name>
    
    will be set for all further Grid Engine commands.
    
    Enter cell name [default] >> 

    • If you have decided to use cells, then enter the cell names now.

    • If you have decided not to use cells, then press <RETURN> to continue.

      Using cell >default<. 
      Hit <RETURN> to continue >> 

    Press <RETURN> to continue.

  9. Press <RETURN> to continue.

    The script verifies that the execution host has been declared as an administration host.

    Checking hostname resolving
    ---------------------------
    
    This hostname is known at qmaster as an administrative host.
    
    Hit <RETURN> to continue >> 

  10. Specify whether you want to use a local spool directory.

    For information on spooling, see Spool Directories Under the Root Directory.

    Local execd spool directory configuration
    -----------------------------------------
    
    During the qmaster installation you've already entered a global
    execd spool directory. This is used, if no local spool directory is configured.
    
    Now you can enter a local spool directory for this host.
    
    Do you want to configure a local spool directory
    for this host (y/n) [n] >> 

    • If you do not want a local spool directory, answer n.

      Do you want to configure a local spool directory
      for this host (y/n) [n] >> n

      Creating local configuration
      ----------------------------
      sgeadmin@host1 modified "host1" in configuration list
      
      Local configuration for host >host1< created.
      
      Hit <RETURN> to continue >> 

    • If you do want a local spool directory, answer y.

      In the following example, /var/tmp/spool is used as the local spool directory on host1. Choose any directory that meets the disk space requirements described in Disk Space Requirements.

      Do you want to configure a local spool directory
      for this host (y/n) [n] >> y
      
      Please enter the local spool directory now! >> /var/tmp/spool
      Using local execd spool directory [/var/tmp/spool]
      Hit <RETURN> to continue >> 

      Creating local configuration
      ----------------------------
      sgeadmin@host1 modified "host1" in configuration list
      
      Local configuration for host >host1n< created.
      
      Hit <RETURN> to continue >> 

  11. Specify whether you want execd to start automatically at boot time.

    You may not wish to install the startup script if you are installing a test cluster or you decide you'd rather start the daemon manually on reboot.

    execd startup script
    --------------------
    
    We can install the startup script that will
    start execd at machine boot (y/n) [y] >> y
    
    Installing startup script /etc/rc2.d/S95sgeexecd
    
    Hit <RETURN> to continue >> 

    Grid Engine execution daemon startup
    ------------------------------------
    
    Starting execution daemon. Please wait ...
       starting sge_execd
    
    Hit <RETURN> to continue >> 

  12. Specify a queue for this host.

    Adding a queue for this host
    ----------------------------
    
    We can now add a queue instance for this host:
    
       - it is added to the >allhosts< hostgroup
       - the queue provides 1 slot(s) for jobs in all queues
         referencing the >allhosts< hostgroup
    
    You do not need to add this host now, but before running jobs on this host
    it must be added to at least one queue.
    
    Do you want to add a default queue instance for this host (y/n) [y] >> 

    Once you answer this question, the installation process is complete. Several screens of information will be displayed before the script exits. The commands that are noted in those screens are also documented in this chapter.

  13. Create the environment variables for use with the grid engine software.


    Note - If no cell name was specified during installation, the value of cell is default.


    • If you are using a C shell, type the following command:

      % source sge-root/cell/common/settings.csh

    • If you are using a Bourne shell or Korn shell, type the following command:

      $ . sge-root/cell/common/settings.sh

See Also

For details on how you can verify that the execution host has been set up correctly, see How to Verify That the Daemons Are Running on the Execution Hosts.

Previous Previous     Contents     Index     Next Next