Install a Management Host

Set up a Windows host as a management host.

The following steps summarize installation on a management host

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

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

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

    2. Start the host.

    3. Restart the Windows cluster.

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

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 a management 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 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 from this base port (7869-7873).

  • 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 cluster administrator account exists.

  • You have turned off real-time anti-virus checking.

    Doing this prevents performance degradation and other problems (in some cases, anti-virus software will lock files while scanning them, creating the potential for problems to arise). If periodic scans are required, a best practise is to schedule these during periods of cluster downtime.

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 a host to the cluster. Do not take the default settings when adding a host if you customized the installation on the master host.

  1. Log on to the management 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 Master Host dialog, specify the name of your master host and click Next.

    For example, HostM.

  4. At the Install Type dialog, click Next.

    The default is Full installation.

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

    The default is cluster1.

    Important:

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

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

    The default is the current account. 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 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.

    Important:

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

  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.

Silent installation

If you customize the cluster name, cluster administrator, installation directory, or ports, you must use the same settings when adding a host to the cluster. Do not take the default settings when adding a 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 management 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 MASTERHOST parameter, specify the name of your master host.

    For example, MASTERHOST=HostM.

  3. For the HOSTTYPE parameter, specify Management for the full installation.

    The default is Management.

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

    The default is cluster1.

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

    The default is the current account. 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 INSTALLDIR parameter, specify the path to the installation directory.

    The default is C:\EGO.

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

    The default is 7869.

  8. 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 "ego1.2.3_win32.msi" MASTERHOST=HostM STARTUP=No /qn

After the silent installation, even if you have logged on as egoadmin, close and re-open the command console before you define the host as a management host.

Configure and test a management host

You have installed EGO on the host using the full installation option. You are logged on as egoadmin.

Complete the following steps to configure the management host:

  1. Define a management host.
  2. Start the host.
  3. Restart the Windows cluster.
  4. Test that a management host was added to the cluster.

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.

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.

Restart the Windows cluster

Log on as egoadmin. If the master is up, log on to any host in the cluster; if the master is down, log on to a management host.

Restart all hosts in the cluster:

egosh ego restart all

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.