Grid Engine Home > Service Domain Manager > SDM Installation Overview >

How to Install the SDM Module on the Master Host

When you install SDM on the master host, the sdmadm install_master_host command does the following:

Before You Begin

• Verify the SDM Hardware and Software Requirements.
• Gather information as explained in Planning the SDM Installation.
• Confirm Java configurations as explained in Step 2 of Installing SDM.
• Download and unpack the SDM binaries as explained in Step 3 of Installing SDM.
• Verify configuration settings as explained in Steps 4 and 5 of Installing SDM

Steps

1. Log in as the root user on the master host.
2. Install the SDM primary components on the master host.
   Use the following command with the information that you wrote down on your planning sheet:

   # sdmadm -s <system-name> -p system install_master_host -ca_admin_mail <mail-address> \
   -ca_state <state> -ca_country <country> -ca_location <location> -ca_org_unit <unit> \
   -ca_org <org> -au <admin-user-name> -cs_port <port-number> -l <path-to-spool-dir> \
   -sge_root <path-to-$SGE_ROOT>
   

   Note The sdmadm command resides in the sdm-install-dir/bin directory on the host. For information about sdmadm install_master_host command options, see Install Master Host Command Options.

3. Start all processes on the master host.
   Use the following command with the same system-name as in the previous step:

   # sdmadm -system <system-name> startup_jvm 
   

4. When all processes are successfully started on the master host, install SDM components on all managed hosts.
   See How to Install SDM Components on a Managed Host.

Example – Installing SDM Master Host and Starting All Processes

The first command in the following example:

• Installs the SDM master host on the local host foo.
• Uses the specified -ca options to create the security (CA) certificate.
• Specifies a free port on the master server to use for the configuration service in the cs_port value. All components will contact this service to get their configuration.

foo# sdmadm -s hedeby1 -p system              \
          install_master_host                 \
          -ca_admin_mail "userFoo@foo.com"    \
          -ca_state "fooLand"                 \
          -ca_country "FO"                    \
          -ca_location "fooLocation"          \
          -ca_org_unit "fooUnit"              \
          -ca_org "fooOrg"                    \ 
          -au sdm_admin                       \
          -cs_port 31118                      \
          -l /var/spool/sdm/hedeby1           \
          -sge_root /opt/sge62

foo# sdmadm -s hedeby1 -p system              \
          install_master_host                 \
          -ca_admin_mail "userFoo@foo.com"    \
          -ca_state "fooLand"                 \
          -ca_country "FO"                    \
          -ca_location "fooLocation"          \
          -ca_org_unit "fooUnit"              \
          -ca_org "fooOrg"                    \ 
          -au sdm_admin                       \
          -cs_port 31118                      \
          -l /var/spool/sdm/hedeby1           \
          -sge_root /opt/sge62                \
          -simple_install

After the first command completes successfully, the bootstrap information for the SDM system hedeby1 is stored in the system preferences.

To verify that installation was complete, the next command shows the bootstrap configuration.

foo# sdmadm sbc
system   type   host     port  properties version 
--------------------------------------------------
hedeby1  SYSTEM foo      31118            1.0u3

The last command starts the configuration service, executor, and resource provider processes on the system hedeby1.

foo# sdmadm -s hedeby1 startup_jvm
jvm         host  result  message
---------------------------------
cs_vm       foo   STARTED 
executor_vm foo   STARTED  
rp_vm       foo   STARTED 

foo# sdmadm -s hedeby1 startup_jvm
jvm         host  result  message
---------------------------------
cs_vm       foo   STARTED 

Install Master Host Command Options

Use the sdmadm install_master_host command to install the SDM functionality onto the master host.

Synopsis

sdmadm  install_master_host|imsth [-autostart] [-nossl] -au <admin-user> -ca_admin_mail <mail-address> 
-ca_country <country> -ca_location <location> -ca_org <organization> -ca_org_unit <unit> 
-ca_state <state> -cs_port <port-number> [-l <path-to-local-spool-dir>] 
-sge_root <path-to-sge-root-dir> [-d <dist-dir>] [-al] [-simple_install]

Security

• Required Privileges
  WRITE_BOOTSTRAP_CONFIG, WRITE_LOCAL_SPOOL_DIR

• Optional Privileges
  • SUPER_USER
    If the -p parameter is set to SYSTEM the executing user must have the SUPER_USER privilege. In this case the bootstrap configuration is stored in /etc/sdm/bootstrap. The owner of the jvm keystore will be the user running the jvm (according to the global config) and the owner of admin keystore will be the admin user.
    If the -p parameter is set to USER the SUPER_USER privilege is not necessary.The bootstrap configuration is stored in $HOME/.sdm/bootstrap and the owner of all keystores is the executing user.
    The SUPER_USER privilege includes the WRITE_KEYSTORE WRITE_KEYSTORE privilege, hence the WRITE_KEYSTORE privilege is not necessary for this command.

Also see Global Options for the sdmadm Command.