egoconfig

Configures hosts.

Synopsis

egoconfig subcommand [options]
egoconfig -h
egoconfig -V

Description

Use the egoconfig command to join a host to the cluster, set the list of master candidates and the failover priority, and add hosts to or remove hosts from the ManagementHosts resource groups, or set other configuration options.

This is an administrative command. You must be logged on as cluster administrator to issue this command.

-h

Outputs command usage and exits.

-V

Prints product version to stderr and exits.

Subcommand synopsis

addresourceattr "[resource resource_name] [resourcemap value*resource_name] …"
join master_name [-f]
masterlist host_name[,host_name, …]
mghost shared_top [-f]
mghost shared_top user_account password [-f]
mghost lsf [-f]
mghost lsf user_account password [-f]
mghost soam [-f]
mghost soam [user_account] [password] [-f]
setbaseport base_port_no
setlicense license_file
unsetmghost [-f]

addresourceattr "[resource resource_name] [resourcemap value*resource_name] …"

Adds a resource attribute tag to the parameter EGO_LOCAL_RESOURCES in ego.conf on the local host. The attribute tag is later referenced when you create a resource group and want to add hosts to it that share the same resource attribute.

resource

Keyword required by EGO_LOCAL_RESOURCES to signify that the name of the resource attribute tag is boolean.

resourcemap

Keyword required by EGO_LOCAL_RESOURCES to signify that the name of the resource attribute tag is numeric. The name is preceded by a numeric value to form a name-value pair.

resource_name

Specifies the name of the resource attribute tag that identifies this type of host. For example, the resource attribute tag scvg could be later used to create a resource group for scavenging-capable hosts.

join master_name [-f]

For use on UNIX only. Adds the local UNIX host to the cluster that has the specified master host.

master_name

Specifies the host name of the master host.

-f

Suppresses confirmation of the command.

Use this option when running this command from a script.

masterlist host_name[,host_name, …]

Specifies the list of master candidates, starting with the master host, and including all of the candidates, in the order of failover priority.

host_name
Specifies the name of the master host and each of the master candidates. Ensure that you do not specify compute hosts in this list.
CAUTION:

Be sure to include all master candidates in the list when you issue this command, as issuing this command overwrites the existing list.

mghost shared_top [-f]

For use on UNIX. Specifies to ignore the local configuration directory and look in the shared location for the configuration information and common files so the management hosts use a common set of files. Issuing this command adds this host to the management hosts resource group.

After issuing this command, you need to source your environment. Running this command creates an entry for the local host in ego.cluster.cluster_name.

shared_top

Specifies the path to the shared file location where configuration information is accessed by the management hosts in the cluster.

-f

Suppresses confirmation of the command.

Use this option when running this command from a script.

mghost shared_top user_account password [-f]

For use on Windows. Specifies to ignore the local configuration directory and look in the shared location for the configuration information and common files so the management hosts use a common set of files. Issuing this command adds this host to the management hosts resource group.

Issuing this command changes the behavior of Windows services on this host to run under the cluster administrator account rather than the local service account. Running this command creates an entry for the local host in ego.cluster.cluster_name.

shared_top

Specifies the path to the shared file location where configuration information is accessed by the management hosts in the cluster.

user_account

Specifies the user account under which to run. Must be a valid user account that has been assigned the role of CLUSTERADMIN. The format is DOMAIN\user_name.

password

Specifies the password to use to authenticate the user account.

-f

Suppresses confirmation of the command.

Use this option when running this command from a script.

mghost lsf [-f]

For use on UNIX. Use this command when adding Platform LSF to an existing cluster. Specifies to ignore the local LSF configuration directory and use the EGO shared directory instead. Issue this command on all management hosts so LSF can use shared location configurations.

After issuing this command, you need to source your environment.

-f

Suppresses confirmation of the command.

Use this option when running this command from a script.

mghost lsf user_account password [-f]

For use on Windows. Use this command when adding Platform LSF to an existing cluster. Specifies to ignore the local LSF configuration directory and use the EGO shared directory instead. Issue this command on all management hosts so LSF can use shared location configurations.

After issuing this command, you need to relaunch another DOS command prompt.

user_account

Specifies the user account under which to run. Must be a valid user account that has been assigned the role of CLUSTERADMIN. The format is DOMAIN\user_name.

password

Specifies the password to use to authenticate the user account.

-f

Suppresses confirmation of the command.

Use this option when running this command from a script.

setbaseport base_port_no

Changes the port number for the EGO_LIM service or daemon to the specified port number.

CAUTION:

Shut down the cluster before issuing this command.

The remaining system port numbers are also changed as a result of issuing this command.

base_port_no

Specifies an unused port number. The default base connection port is 7869. EGO always uses five consecutive ports starting from the base port. By default, EGO uses ports 7869-7873.

Valid base port numbers are between 1025 and 65531, inclusive.

setlicense license_file

For use on UNIX only. Copies the specified license file into the EGO configuration directory and updates the configuration file ego.conf with the name and location of the license file.

license_file

Specifies the full path to the license file including the file name.

unsetmghost [-f]

Demotes the local management host to a compute host.

Specifies to look in the local configuration directory for configuration information and common files. This command cannot be run on the master host.

Before running this command, ensure the host’s lim is not running (you may need to shut down the host first). Be sure to restart the master host after running this command for the change to take effect. Running this command removes the host entry from ego.cluster.cluster_name.

-f

Suppresses confirmation of the command.

Use this option when running this command from a script.