Grid Engine Home > Installing > Installing the Software With the GUI Installer >

Express Installation

The express installation mode is targeted at first-time users and provides a significantly reduced set of parameters to configure. This mode also provides reasonable default values for most of the parameters. You must have a password-less ssh or scp access if you are planning to install Sun Grid Engine on remote hosts. The following steps describe a complete cluster installation and assume that the password-less access is configured. (Click any of the screen captures in the following steps to view more details.)

Using the Express Installation Mode

The express installation steps are as follows.

Steps

1. Start the GUI installer. On the welcome screen, click Next.

   Note Ensure that you start the GUI installer on the qmaster host.

   As root, run the start_gui_installer command in your sge-root directory. For example:

   qmaster:/sge# ./start_gui_installer
   Starting Installer ...
   

   
   
   

2. Agree to the terms of the license. Click Next.
   
   
   
3. Choose components to install. Click Next.
   
   See the following table for a brief explanation of options displayed on this screen.

   Host type	Description
   Qmaster host	Main component in Sun Grid Engine software. You must install exactly one qmaster component per Sun Grid Engine cluster installation.
   Execution host(s)	Hosts that execute the tasks (jobs).
   Shadow host(s)	Hosts that provide a high availability feature to the cluster. In case the qmaster fails (for example, due to a crash or network issue), one of the shadow hosts takes over the qmaster responsibility.
   Berkeley db host	Host that implies a Berkeley db host spooling option. Sun Grid Engine then spools data to a remote server. Not recommended as the default option.

   If you are not sure what you want to install, keep the components selected by default.
   
   

4. Modify the main configuration details. Click Next.
   

   Option	Description
   Admin user	Sun Grid Engine processes will be executed under this user name, and certain directories will be owned by this user.
   Qmaster host	Host that will run qmaster daemon (main component). It can be changed later in the host selection.
   Grid Engine root directory	Directory where you unpacked Sun Grid Engine tar.gz archive or installed a package (for example, rpm, pkg). It must not contain an automounter prefix.
   Cell name	Name of this Sun Grid Engine cell, a value that identifies an instance of Sun Grid Engine when several instances run simultaneously.
   Cluster name	Name of this Sun Grid Engine instance used by SMF on Solaris machines. In express installation mode, this instance is hidden and has a default value of p6444. The following naming restrictions apply to this field: The cluster name must start with a letter ([A-Za-z]), followed by letters, digits ([0-9]), dashes ("-"), or underscores ("_").
   Qmaster port	Port that will be used by the qmaster daemon. Default value is 6444.
   Execd port	Port that will be used by the execution daemon. Default value is 6445.
   Administrator mail	Email address used by Sun Grid Engine to report issues to the grid administrator. Default value is none (no emails will be sent).
   Automatically start service(s) at machine boot	Component (service) will be automatically started at machine boot. By default, this is selected.

   Typically, one would provide a valid administrator email and click next.
   
   

5. Select hosts to be installed and fix reported problems. Click Install to start the installation on the reachable hosts.
   
   This screen allows you to select the hosts and components that you would like to install. Express installation mode has a slightly simplified selection model. Custom installation mode enables you to change the components that will be selected once new hosts are added. The qmaster host is added based on the qmaster host value from the main configuration screen by default. You can select the hosts in one of two different ways:
   1. By a host name, host name pattern, or by an IP address or IP address pattern
   2. From a file that you create using the installer's save action
   The patterns do not support regular expressions. The supported expressions are lists and numeric ranges. For more information, see the following table:

   Description	Input	Resolved Value
   Host name	grid00	grid00
   IP address	192.168.0.1	192.168.0.1
   List of hosts	grid00 grid01 grid03	grid00 grid01 grid03
   List of IP addresses	192.168.0.1 192.168.0.2 192.168.0.5	192.168.0.1 192.168.0.2 192.168.0.5
   Host ranges	grid[00-03]	grid00, grid01, ..., grid03
   Range of IP addresses	192.[168-169].0.[50-60]	192.168.0.50 ... 192.168.0.60, 192.169.0.50 ... 192.169.0.60

   
   In the following screen sequence, hosts grid01 to grid03 are added as execution and hosts grid00 to grid03 submit hosts. However, two hosts grid10 to grid11 have errors. See Understanding Host and Installation States for a complete list of errors and possible solutions. Note that each state has a tooltip that displays a better error message. Once the errors are resolved on the problematic hosts, select hosts that you want to verify and right-click. A pop-up menu enables you to refresh selected hosts. Optionally, invalid hosts can be removed. Once the states have been refreshed, a different error state or reachable state will be displayed.

   
   
   

6. (Optional) Modify the host configuration. Click OK.
   Select a host in the Select hosts screen, right-click on the host and click Configure to modify the host configuration.
   

   Option	Description
   Local execd spool directory	Directory for local execd spooling data.
   JVM library path	Path to the JVM library on the qmaster and/or shadow hosts.
   Additional JVM args	Additional arguments to be used when starting the JVM in qmaster.
   Connect user	The user which will be used to connect to the remote host using ssh or scp.
   Resolve timeout(sec)	Timeout value for any resolving task.
   Install timeout (sec)	Timeout value for any installation task.

   
   
   

7. (Optional) Fix problems reported during pre-install validation, then click Install.
   When you click the Install button as described in Step 5, the installation does not start immediately. First, the installer executes a series of advanced checks for each host to verify that there is no misconfiguration. If the validation fails, host states are updated and you are presented with an option to return to the host selection or to continue with the installation.

   Note Continuing the installation after the installer reports errors will likely result in a failed installation. Before restarting the installation, you should return to the host selection and either resolve the reported problems or remove the hosts that have configuration errors.

   In the following screen sequence, one host has a configuration error. See Understanding Host and Installation States for a complete list of errors and possible solutions. Notice that each state includes a tooltip that displays an error message.
   

   
   
   

8. Monitor the progress of the installation, then click Next.

   
   If there were any failures during the installation, the Failed tab is selected. See Understanding Host and Installation States for a complete list of installation states. Click the Log button for each failed installation for more information.
   
   

   This error is displayed because the cluster name p6222 already exists on this host (installation was not attempted).

   
   
   

9. Review the overview information, then click Done.
   
   Optionally, print or save the information about the Sun Grid Engine configuration for future reference. The page is also automatically saved to the $SGE_ROOT/$SGE_CELL/Readme_TIMESTAMP.html file. If the page could not be saved there, due to root being mapped to nobody on NFS shared file system, it is saved to /tmp/Readme_TIMESTAMP.html.
   To verify the installation, go to Verifying the Installation.