Installing on a compute host

You must install and configure IBM® Spectrum Conductor on at least one management host (and use it as the primary host). You can additionally install IBM Spectrum Conductor on a compute host. Compute hosts provide computing resources.

Before you begin

Review the requirements for installing IBM Spectrum Conductor in Installing on a compute host and download the applicable installation package according to Installation packages.
When installing IBM Spectrum Conductor to a local environment, use the same installation settings (installation directory, ports (including BASEPORT), and installation environment variable options) for all compute hosts, as you specified for the initial primary host.

About this task

Follow these steps to install IBM Spectrum Conductor on a compute host. Compute hosts provide computing resources.

For production clusters, log in with root or sudo to root permission. For evaluation clusters you can install as any user, who becomes the cluster administrator. If you install as non root, every execution user that is specified must be the Cluster Administrator.

Procedure

Define the cluster properties by setting the following environment variables. If you do not set the optional environment variables, the default values will be used.

Option	Description
BASEPORT	Optional. Set for the cluster. The cluster uses seven consecutive ports from the base port. The default port number is `7869`. For example: `export BASEPORT=14899` Note: Before installation, make sure that the seven consecutive ports are not in use.
CLUSTERADMIN	Mandatory if you are installing as root. Set to any valid operating user account, which then owns all installation files. For example: `export CLUSTERADMIN=egoadmin` Note: You must create the `egoadmin` user if it does not already exist. When you set up users on all your hosts (both management and compute hosts), the execution user must use the same user ID (UID) and GID on all the hosts.
CLUSTERNAME	Optional. Set to the name of the cluster. The default is `cluster1`. For example: `export CLUSTERNAME=cluster123` Important: You cannot change the cluster name after installation.
EGOCOMPUTEHOST	Specify `Y` to indicate installation on a compute host. This setting installs the necessary packages for IBM Spectrum Conductor to run on the compute host. For example: `export EGOCOMPUTEHOST=Y` The default is `N`.
IBM_SPECTRUM_CONDUCTOR_LICENSE_ACCEPT	Mandatory if using quiet installation mode to accept the license agreement. For example: `export IBM_SPECTRUM_CONDUCTOR_LICENSE_ACCEPT=Y`

Optional: If you want to modify the Elastic Stack configuration, set the following environment variables and ensure that they are the same on all hosts. If you do not set these environment variables, the default values are used. You cannot change these values after installation.

Option	Description
ELASTIC_HARVEST_LOCATION	Specifies the directory under which the new logging structure logs' symbolic links that point to the real Spark log directory ($SPARK_HOME/logs) are stored that Filebeat uses to harvest information and support queries. All instance group logs are organized under one directory with human readable names and structure. The value of ELASTIC_HARVEST_LOCATION must be different from ELK_HARVEST_LOCATION. The default directory is ${EGO_TOP}/elastic_logs.
ELK_LOGSHIPPER_PORT	Specifies the port that is used by the indexer service. The default port number is 5043.
ELK_HARVEST_LOCATION	Specifies the directory under which the old logging structure logs are stored that Filebeat uses to harvest information and support queries. The default directory is /var/tmp/elk_logs/.

For Ubuntu installation, run the apt-get install rpm in Ubuntu to install the RPM utility.
Run the IBM Spectrum Conductor installer package.
- If you want to install with default settings, enter one of the following commands:
  Entitled version:
```
export IBM_SPECTRUM_CONDUCTOR_LICENSE_ACCEPT="Y"
conductor2.5.0.0_ppc64le.bin --quiet
```
  Evaluation version:
```
export IBM_SPECTRUM_CONDUCTOR_LICENSE_ACCEPT="Y"
conductoreval2.5.0.0_ppc64le.bin --quiet
```
  - For Linux® 64-bit:
```
conductor2.5.0.0_x86_64.bin
```
    If you are using the evaluation version, run:
```
conductoreval2.5.0.0_x86_64.bin
```
  - For Linux for POWER® LE:
```
conductor2.5.0.0_ppc64le.bin
```
    If you are using the evaluation version, run:
```
conductoreval2.5.0.0_ppc64le.bin
```
  Note: Alternative method: If you must use .rpm files instead of .bin, extract the .rpm files, install the ego*.rpm files, then install the ascd*.rpm and conductorspark*.rpm files.
  For example, first extract the .rpm files from the conductor2.5.0.0_x86_64.bin or conductor2.5.0.0_ppc64le.bin package by running:
```
conductor2.5.0.0_x86_64.bin --extract extract_directory
```
```
conductor2.5.0.0_ppc64le.bin --extract extract_directory
```
  where extract_directory specifies the directory to extract .rpm files.
  Next, install each .rpm file in order by running:
```
rpm -ivh rpm_file_name
```
  For example:
```
rpm -ivh egocore-version.architecture.rpm
```
```
rpm -ivh egocore-3.9.0.0.rpm
```
  Additional note for Ubuntu: To install the .rpm files on Ubuntu, you must also specify the --ignorearch parameter. For example:
```
rpm -ivh --ignorearch rpm_file_name
```
- If you want to install to a different location other than the default, enter one of the following commands:
  Entitled version:
```
export IBM_SPECTRUM_CONDUCTOR_LICENSE_ACCEPT="Y"
conductor2.5.0.0_ppc64le.bin --quiet
```
  Evaluation version:
```
export IBM_SPECTRUM_CONDUCTOR_LICENSE_ACCEPT="Y"
conductoreval2.5.0.0_ppc64le.bin --quiet
```
  - For Linux 64-bit:
```
conductor2.5.0.0_x86_64.bin --prefix install_location --dbpath dbpath_location
```
    If you are using the evaluation version, run:
```
conductoreval2.5.0.0_x86_64.bin --prefix install_location --dbpath dbpath_location
```
  - For Linux for POWER LE:
```
conductor2.5.0.0_ppc64le.bin --prefix install_location --dbpath dbpath_location
```
    If you are using the evaluation version, run:
```
conductoreval2.5.0.0_ppc64le.bin --prefix install_location --dbpath dbpath_location
```
  where:
  - --prefix install_location specifies the absolute path to the installation directory. The --prefix parameter is optional. If you install without the --prefix option, IBM Spectrum Conductor is installed in its default directory: /opt/ibm/platform. Ensure that the path is set to a clean directory.
  - --dbpath dbpath_location sets the RPM database to a directory different from the default /var/lib/rpm. The --dbpath parameter is optional.
  Note: Alternative method: If you must use .rpm files instead of .bin, extract the .rpm files, install the ego*.rpm files, then install the ascd*.rpm and conductorspark*.rpm files.
  For example, first extract the .rpm files from the conductor2.5.0.0_x86_64.bin or conductor2.5.0.0_ppc64le.bin package by running:
```
conductor2.5.0.0_x86_64.bin --extract extract_directory
```
```
conductor2.5.0.0_ppc64le.bin --extract extract_directory
```
  where extract_directory specifies the directory to extract .rpm files.
  Next, install each .rpm file in order by running:
```
rpm -ivh --prefix install_location --dbpath dbpath_location rpm_file_name
```
  For example:
```
rpm -ivh --prefix /opt/mydir --dbpath /opt/mydir/mydb egocore-3.9.0.0egocore-version.architecture.rpm
```
  Additional note for Ubuntu: To install the .rpm files on Ubuntu, you must also specify the --ignorearch parameter. For example:
```
rpm -ivh --ignorearch --prefix install_location --dbpath dbpath_location rpm_file_name
```
- If you want to perform a silent installation, enter one of the following commands:
  - For Linux 64-bit:
```
conductor2.5.0.0_x86_64.bin --quiet
```
    If you are using the evaluation version, run:
```
conductoreval2.5.0.0_x86_64.bin --quiet
```
  - For Linux for POWER LE:
```
conductor2.5.0.0_ppc64le.bin --quiet
```
    If you are using the evaluation version, run:
```
conductoreval2.5.0.0_ppc64le.bin --quiet
```
  where --quiet suppresses prompts during installation.
After installation is complete, source the environment.
- If you are running using BASH, run:
```
. $EGO_TOP/profile.platform
```
- If you are running using CSH, run:
```
source $EGO_TOP/cshrc.platform
```
  where $EGO_TOP is your installation directory (default is /opt/ibm/spectrumcomputing).

What to do next

After installing IBM Spectrum Conductor, join the host to the cluster. See Adding a host to a cluster.