Install the Master Host

Set up a Windows host as the master host.

The following steps summarize installation on the master host

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

    • Obtain an EGO license

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

  3. As egoadmin, configure and test the master host:
    1. Define the host as a master host.

    2. Install the database driver.

    3. Configure the database connection

    4. Start the host.

    5. Test that a management host was added to the cluster.

    6. Test the web server.

    7. Check the reporting services.

Next: Add a compute host to your cluster, as described in Install a Compute Host.

Obtain the MSI package

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

Obtain an EGO license

You need to install an EGO license to use your cluster.

You can get two types of licenses:
Demo license

This is a temporary license to be used for evaluation purposes. Contact Platform Computing to obtain a demo license.

Permanent license

This license is granted after you purchase it 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.

Run the MSI package on the master host

Check the following:
  • You have the EGO MSI package.

  • You have a valid EGO license file.

  • 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.

  • That the installation directory 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 starting from this base port (7869-7873)

    Tip:

    Run netstat -an to see if ports are in use.

  • The required web server ports are not in use.

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

  • That the required web service gateway port is not in use.

    The default web service gateway port is 9090.

  • That the required service director port is not in use.

    The service director port is 53.

  • The cluster administrator account exists.

You can install two ways:

  • Interactive installation.
  • Silent installation.

Interactive installation

If you customize the cluster name, cluster administrator, installation directory, or ports, you must use the same settings when adding more hosts to the cluster.

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

    For example, log on as DOMAIN\egoadmin.

  2. Run the MSI package by double-clicking the MSI file.
  3. At the Master Host dialog, specify the name of your master host (HostM) and click Next.
  4. At the License File dialog, specify the location of your license file and click Next.

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

  5. At the Cluster Name dialog, specify the name of your cluster and click Next.

    The default is cluster1.

  6. 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.

  7. At the Installation Directory dialog, specify the path to the installation directory and click Next.

    For example, C:\EGO.

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

    The default is 7869.

  9. At the Startup dialog, clear the check box and click Next.

    The default is to enable Start system services after installation. In our example, clear the check box.

  10. 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.

Silent installation

If you customize the cluster name, cluster administrator, installation directory, or ports, you must use the same settings when adding more hosts to the cluster.

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 master 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 DBHOST parameter, specify the name of your production database host (HostQ).

    For example, DBHOST=HostQ.

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

    For example, MASTERHOST=HostM.

  4. For the LICENSEFILE parameter, specify the path to your license file.

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

  5. For the CLUSTERNAME parameter, specify the name of your cluster.

    The default is cluster1, which you don’t need to change in our example.

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

    The default is the current account, which you don’t need to change in our example. For example, DOMAIN\egoadmin.

  7. For the ADMINPASSWD parameter, specify the password of your cluster administrator.

    For example, ADMINPASSWD=mypasswd.

    This password must be the actual password of the account. The installer does not verify the password.

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

    The default is C:\EGO, which you don’t need to change in our example.

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

    The default is 7869.

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

    The default is Yes. For our example, use STARTUP=No.

Using our example:

msiexec -i "C:\EGO\ego1.2.3_win32.msi" DBHOST=HostQ MASTERHOST=HostM LICENSEFILE=C:\Temp\license.dat ADMINPASSWD=mypasswd STARTUP=No /qn

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

Configure and test the master host

You have installed EGO on the master host. You are logged on as egoadmin.

Complete the following steps to configure the master host:

  1. Define the host as a master host.
  2. Install the database driver.
  3. Configure the database connection.
  4. Start the host.
  5. Test that a management host was added to the cluster.
  6. Test the web server.
  7. Check the reporting services.

Define the host as a master host

Make the host a master host.

What you need to know

  • Host roles

  • Shared directory

Define a management host

You are logged on as egoadmin.

Take this step on every management host, including all master candidates.

  1. Start the command console.
  2. Run the egoconfig mghost command:

    egoconfig mghost shared_dir user_name password

    where shared_dir is the shared directory that contains important files such as configuration files to support failover, user_name is the egoadmin account, and password is the egoadmin password.

    For example
    egoconfig mghost \\HostF\EGOshare DOMAIN\egoadmin mypasswd

After you run egoconfig mghost, the host:

  • Has access to important system files on the shared directory

  • Belongs to the ManagementHosts resource group.

  • Uses egoadmin to run services instead of the Windows LocalSystem account.

Remember:

The shared directory is the same for all management hosts.

The configuration does not take effect until you close and re-open the command console to reset the environment.

Install the database driver

Install the driver for your commercial database.

The commercial database is properly configured and running.

  1. Download and install the latest JDBC driver for your commercial database.
    • If you are using an Oracle database, the latest driver is ojdbc14.jar or newer and is available from the following URL:

      http://www.oracle.com/technology/software/tech/java/sqlj_jdbc/index.html

    • If you are using a MySQL database, the latest driver is mysql-connector-java-3.1.12-bin.jar or newer and is available from the following URL:

      http://dev.mysql.com/downloads

  2. If you are using the Oracle database, copy the Oracle JDBC driver into the PERF and GUI library directories.
    You need to copy the Oracle JDBC driver to the following directories:
    • EGO_TOP\perf\common\lib

    • EGO_TOP\gui\tomcat\webapps\perfgui\WEB-INF\lib

Configure the database connection

You have a user name, password, and URL to access the database host.

Launch the database configuration tool to configure your database connection.

  1. Launch the database configuration tool.

    Run dbconfig.

  2. In the User ID and Password fields, specify the user account name and password with which to connect to the database and to create your database tablespaces.

    This user account must have been defined in your database application, and must have read and write access to the database tables. In general, this is the name you used to create your tablespaces.

  3. In the JDBC driver field, select the driver for your commercial database.
  4. In the JDBC URL field, enter the URL for your database.

    This should be similar to the format given in Example URL format.

  5. In the Maximum connections field, specify the maximum allowed number of concurrent connections to the database server.

    This is the maximum number of users who can produce reports at the same time.

Start the host

Start EGO on the Windows host.

You are logged on as egoadmin.

To start the local EGO Windows host, perform the following steps:

  1. Start the command console.
  2. Start EGO:

    egosh ego start

You have now started EGO on the host.

Test that a management host was added to the cluster

  1. Start the command console.
  2. Look for the host in the ManagementHosts group in your cluster:
    egosh resource group ManagementHosts
    If you can see the host name in the Resource List, the host is successfully added to the cluster and configured as a management host.
    Note:

    This test only detects hosts that are running.

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 the Platform Management Console page in your master host.

    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.
      Note:

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

Check the reporting services

Check that the reporting services are running.

  1. Run egosh to view the status of your services.
    egosh service list
  2. Check that the status of the plc and purger services are STARTED.