Install a Single-Host Cluster

The following steps summarize the installation of a single-host cluster. This host simultaneously acts as master host, management host, and compute host.

  1. Obtain the necessary files:
    1. Obtain an EGO license
    2. Obtain the MSI package
  2. As egoadmin, deploy the software:
    1. Run the MSI package on a single-host cluster.
  3. Test:
    1. Test the web server.

One host can perform all duties in the cluster. You can use this host to test or demonstrate some of the functions you would perform in a production cluster.

If you wish to convert the host into a functional master host of a production cluster, follow the steps described in Migrate to a Multiple-Host Cluster.

Obtain an EGO license

You need to install an EGO license to use your single-host cluster.

You can get two types of licenses:
  • Demo license: A temporary license to be used for evaluation purposes. Contact Platform Computing to obtain a demo license.

  • Permanent license: A license granted after you purchase the product from Platform Computing.

Tip:

Before installing, you should copy your licence to a location that you can easily access from the master host. You will need to locate this file to configure your license.

Obtain the MSI package

Obtain the EGO has one MSI package for Windows hosts: ego1.2.3_win32.msi

Run the MSI package on a single-host cluster

Check the following:
  • That you have an EGO MSI package.

  • That you have a valid EGO license file.

  • That your Windows operating system is using MSI 2.0 or later.

    The EGO MSI package does not support MSI 1.0.

  • That you have access to a Windows account that is a member of the local Administrators group. This account will be the cluster administrator of your single-host cluster. This account requires the following privileges:

    • Act as part of the operating system

    • Debug programs

    • Increase quotas

    • Log on as a service

    • Replace a process level token

    Tip:

    If you intend to convert your single-host cluster into a production cluster, we recommend that you use a dedicated domain account named egoadmin to be the cluster administrator. In this example, the name of the cluster administrator is egoadmin, and the name of the domain is DOMAIN.

  • That the installation directory does not exist or is empty.

    The default installation directory is C:\EGO.

  • That the required connection ports are not in use.

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

    Tip:

    Use netstat -an to see if these ports are in use. If they are, choose a base port where the next three consecutive ports are also not in use. For example, if you choose 7939 as your base port, check that ports 7939-7943 are not in use.

  • The required web server ports are not in use.

    The default web server ports are 8080, 8005, and 8009.

  • The required web service gateway port is not in use.

    The default web service gateway port is 9090.

  • The required service director port, port 53, is not in use.

  • The required Derby database port, port 1527, is not in use.

If you customize the cluster name, cluster administrator, installation directory, or ports, you should take note of your customized settings. If you later migrate this host for use in a production cluster, you must use the same settings when adding other hosts to this cluster.

  1. Log on to your 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 host and click Next.
  5. At the License File dialog, specify the location of your license file and click Next.

    For example, C:\Temp\license.dat.

  6. At the Cluster Name dialog, specify the name of your single-host cluster and click Next.

    The default is cluster1.

    Tip:

    Your cluster name is case sensitive and can only use up to 39 alphanumeric characters or underscores. Do not use the name of any host or user as the name of your cluster. For example, Sample_cluster1.

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

    The default is the current account. For example, DOMAIN\egoadmin.

  8. At the Derby DB Host dialog, click Next. You must specify the master host to make Reporting work in a single-host cluster.

    The default is the master host.

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

    The default is 7869.

  10. At the Startup dialog, click Next.

    The default is to start system services after installation.

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

After you complete the installation process, you may delete the license file from your temporary directory.

Test the web server

Check that the following is true:

  • You installed and configured the software on the master host.

  • You started the master host.

  1. Launch any web browser and visit this URL.

    http://master_host_name:8080/Platform

    If you see the Platform Management Console web page, your web server is running.

  2. Log on to the Console and check host status (optional):
    1. User Name: Admin
    2. Password: Admin
    3. On the Cluster Health section of the Cluster Health Dashboard, check the host status of the master host is ok.
      Tip:

      This may take several minutes, depending on your cluster and host configuration.