Install a Compute Host

Set up a Windows host as a compute host.

  1. Obtain the necessary files:
    1. Obtain the MSI package.

  2. As egoadmin, deploy the software:
    1. Run the MSI package on the compute host.

  3. As egoadmin, test the host in the cluster:
    1. Test that the host was added to the cluster.

Your cluster is ready to run work.

Tip:

Repeat these steps to add more compute hosts to your cluster. You can also add a management host, as described in Install a Management Host.

Obtain the MSI package

EGO has one MSI package for Windows hosts. This package is named ego1.2.3_win32.msi

Run the MSI package on the compute host

Check the following:
  • You have the EGO MSI package

  • Your Windows operating system is using MSI 2.0 or later.

    The EGO MSI package does not support MSI 1.0.

    Tip:

    Run msiexec to determine your version of MSI.

  • You have access to an account that is a member of the Local Administrators group, for example, egoadmin.

  • The installation does not exist or is empty.

    The default installation directory is C:\EGO.

  • The required connection ports are not in use.

    The default base connection port is 7869. EGO uses five consecutive ports from this base port (7869-7873).

    Tip:

    Run netstat -a | find <port_number> and if nothing returns, <port_number> is free.

  • The cluster administrator account exists.

You can install two ways:

Interactive installation

If you customized the cluster name, cluster administrator, installation directory, or ports, you must use the same settings when adding additional hosts to the cluster. Do not take the default settings when adding another host if you customized the installation on the master host.

  1. Log on to the compute host as a Local Administrator account.

    For example, log on as DOMAIN\egoadmin.

  2. Run the installation package by double-clicking the MSI file.
  3. At the Installation Directory dialog, specify the path to the installation directory and click Next.

    For example, C:\EGO.

  4. At the Master Host dialog, specify the name of your master host and click Next.

    For example, HostM.

  5. At the Install Type dialog, choose the type of installation.

    Choose Compute host only.

  6. At the Cluster Administrator dialog, specify the name of your cluster administrator and click Next.

    The default is the current account from which you logged in to your host. For example, DOMAIN\egoadmin.

    Important:

    This cluster administrator name must be the same as the cluster administrator name you specified when you installed on the master host.

  7. At the Connection Base Port dialog, specify the connection base port and click Next.

    The default is 7869.

    Important:

    This base port must be the same as the base port you specified when you installed on the master host.

  8. At the Startup dialog, click Next.

    The default is to enable Start system services after installation.

  9. At the Summary dialog, review your settings and click Install.

Silent installation

If you customized the cluster name, cluster administrator, installation directory, or ports, you must use the same settings when adding another host to the cluster. Do not take the default settings when adding another host if you customized the installation on the master host.

Ensure the information you specify is free from typographical errors: the installation will not continue if there are errors within parameter entries.

  1. Log on to the compute host as a Local Administrator account and install the MSI package. Use parameters to customize the installation as desired.

    For example, log on as DOMAIN\egoadmin.

  2. For the INSTALLDIR parameter, specify the path to the installation directory.

    The default is C:\EGO.

  3. For the MASTERHOST parameter, specify the name of your master host.

    For example, MASTERHOST=HostM.

  4. For the HOSTTYPE parameter, specify the type of installation, Management for the full installation or Compute to install a compute host only.

    For example, HOSTTYPE=Compute.

  5. For the CLUSTERADMIN parameter, specify the name of your cluster administrator.

    The default is the current account from which you logged in to your host. For example, DOMAIN\egoadmin.

    Important:

    This cluster administrator name must be the same as the cluster administrator name you specified when you installed on the master host.

  6. For the BASEPORT parameter, specify the connection base port.

    The default is 7869.

    Important:

    This base port must be the same as the base port you specified when you installed on the master host.

  7. For the STARTUP parameter, specify Yes to start services automatically or No to disable this feature.

    The default is Yes.

Using our example:

msiexec -i "ego1.2.3_win32.msi" MASTERHOST=HostM HOSTTYPE=Compute /qn

Using all possible variables:

msiexec -i "ego1.2.3_win32.msi" MASTERHOST=HostM HOSTTYPE=Compute CLUSTERADMIN=egoadmin INSTALLDIR=C:\EGO BASEPORT=7869 STARTUP=Yes /qn

After the silent installation, even if you have logged on as egoadmin, close and re-open the command console to reset the environment.

Test that the host was added to the cluster

You installed EGO on the host. You are logged in as egoadmin.

Run egosh resource list to see the resources in your cluster.

Look for the host you added in the list of the resources.

If you can see the host name in the list of resources, that host was successfully added to the cluster.

This test detects hosts even if the host is not currently available. Some hosts make take a while to become available after they are added to the cluster.