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. For most subcommands, 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 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-ready 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]

Log on using the installation OS account, or with the same permissions as the account you used to install on the host. For example, if you installed without Windows system administrator permissions, log on as cluster administrator. If you installed with Windows system administrator permissions on the local host, log on using any account that has Windows system administrator permissions on the local host.

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 cluster administrator OS user account. The format is DOMAIN\user_name.

password

Specifies the password to use to authenticate the user account (input the actual password of the cluster administrator OS account).

-f

Suppresses confirmation of the command.

Use this option when running this command from a script.

mghost soam [-f]

For use on UNIX. Use this command when adding Platform Symphony to an existing cluster. Specifies to ignore the local Symphony configuration directory and use the EGO shared directory instead. Issue this command only on the master host so that Symphony 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 soam [user_account] [password] [-f]

Log on using the installation OS account, or with the same permissions as the account you used to install on the host. For example, if you installed without Windows system administrator permissions, log on as cluster administrator. If you installed with Windows system administrator permissions on the local host, log on using any account that has Windows system administrator permissions on the local host.

For use on Windows. Use this command when adding Platform Symphony to an existing cluster. Specifies to ignore the local Symphony configuration directory and use the EGO shared directory instead. Issue this command only on the master host so that Symphony can use shared location configurations.

user_account

Specifies the cluster administrator OS user account. The format is DOMAIN\user_name.

password

Specifies the password to use to authenticate the user account (input the actual password of the cluster administrator OS 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.

The following port numbers are also changed as a result of issuing this command:

  • EGO_LIM_PORT

  • EGO_KD_PORT

  • EGO_PEM_PORT

  • ESC_PORT

  • REPOSITORY_SERVICE_PORT

  • SD_ADMIN_PORT

  • SD_SDK_PORT

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.

Symphony always uses seven consecutive ports starting from the base port. By default, Symphony uses ports 7869-7875.

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]

Log on using the installation OS account, or with the same permissions as the account you used to install on the host. For example, if you installed without Windows system administrator permissions, log on as cluster administrator. If you installed with Windows system administrator permissions on the local host, log on using any account that has Windows system administrator permissions on the local host.

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.