ego

ego execpasswd -u user_name -x password [-noverify]

Registers and verifies the password for a Windows execution user account.

Registering the password allows EGO to use the account to run work on Windows hosts.

This is an administrative command. You must be cluster administrator to issue this command. In addition, to verify the password, you must be logged on to Windows as the OS account administrator, egoadmin.

-u user_name

Specifies the fully-qualified Windows user name of the execution account to register the password for.

-x password

Specifies the password to register for the Windows execution user account.

-noverify

Registers the password without verification. This option is required if you run this command from a Linux® host. Only a Windows host can verify this password.

ego elimrestart env_suffix env_value [-p exempt_process_name;…] [-c close_process_name;…] [-f] [host_name … | all]

Restarts and reconfigures external load information managers with an environment variable (elim.sa). Generally used for host harvesting feature. During restart, the LIM service passes along configuration information to the harvesting agent such as thresholds of resources that are used to evaluate trigger conditions, whether the host is currently enabled for harvesting, and whether the grace period is disabled.

You must be logged on to Windows as the local systems OS account administrator, or logged on to Linux as the root OS account.

env_suffix

Always specify SA (harvesting agent) to indicate the host harvesting feature.

env_value

Specifies whether to enable host harvesting with grace period (on), enable host harvesting without grace period (fastrelease), or disable (off) host harvesting on this host.

Specifies the thresholds of load indices used to evaluate host workload and to trigger host harvesting.

Enter the environment value in this format, delimited by commas without any spaces: <harvesting_flag>,<user_idle_time_threshold_in_minutes>,<Adjusted_CPU_utilization_threshold_in_percentage>,<CPU_idle_time_threshold_in_minutes>.

For example:

egosh ego elimrestart SA fastrelease,2,0.3,1.67 all

This example enables host harvesting on all hosts, disables the grace period, sets the user idle time threshold (uit_t) to 2 minutes, Adjusted CPU utilization threshold (cu_t) to 30%, and CPU idle time threshold (cit_t) to 1.67 minutes (or 100 seconds).

Note: Threshold values are specified by numbers greater than zero. They do not need to be whole numbers.

-c close_process_name

Specifies processes that will cause the host to be closed if the processes are running. A process name can be specified either with or without a path; if specified without a path, it must be unique; if specified with a path, the path cannot include spaces. The list of process names is limited to 256 characters.

-p exempt_process_name

Specifies the processes to be excluded from the calculation of Adjusted CPU utilization for one or more hosts. A process name can be specified either with or without a path; if specified without a path, it must be unique; if specified with a path, the path cannot include spaces. The list of process names is limited to 256 characters.

-f

Executes command immediately without asking for confirmation. Use this option when you are issuing egosh ego elimrestart from within a script and do not want the script to stop running to respond to prompts.

host_name …

Specifies the name of the host or hosts on which to restart and reconfigure the external load information manager(s).

To specify multiple hosts, separate the host names with a space.

If no host name is given, then control is assumed to be local.

all

Restarts/reconfigures the external load information manager (ELIM) on all hosts in the cluster.

ego info

Displays information about the cluster, including the cluster name, the name of the primary, and the version of EGO.

ego restart [-f] [-n commands] [host_name … | all]

Restarts EGO on the local host, or, if issued from the primary host, restarts EGO on all the hosts in the cluster. Does not affect running work or services.

This is an administrative subcommand. On Linux, you must be logged on with root permissions to issue this command. On Windows, you must be logged on as cluster administrator to issue this command.

-f

Forces the action on the host without validating the configuration file. Use this option when you are issuing the command from within a script and do not want the script to stop running to respond to prompts.

This option is automatically applied if the value for the -n commands option is greater than one.

-n commands

Specifies the number of commands to run in parallel. Executing commands in parallel allows the cluster to restart faster. On Linux, use forked processes to implement parallel execution. On Windows, use threads.

There is no hard limit to the number of commands; however, on Linux, the maximum number of commands is limited by the operating system user limits, and can cause the forking to fail.

If the value for the -n commands option is greater than one, the command automatically applies the -f option.

host_name …

Specifies the name of the host or hosts on which to restart EGO.

To specify multiple hosts, separate the host names with a space.

You cannot use this option from a compute host unless the primary host is up and running.

all

Restarts EGO on all hosts in the cluster.

You cannot use this option from a compute host unless the primary host is up and running.

ego shutdown [-f] [-n commands] [host_name … | all]

Stops EGO on the local host, or, if issued from the primary host, stops EGO on all the hosts in the cluster.

This is an administrative subcommand. On Linux , you must be logged on with root permissions to issue this command. On Windows, you must be logged on as cluster administrator to issue this command.

-f

Forces the action on the host without validating the configuration file. Use this option when you are issuing the command from within a script and do not want the script to stop running to respond to prompts.

This option is automatically applied if the value for the -n commands option is greater than one.

-n commands

Specifies the number of commands to run in parallel. Executing commands in parallel allows the cluster to shut down faster. On Linux, use forked processes to implement parallel execution. On Windows, use threads.

There is no hard limit to the number of commands; however, on Linux, the maximum number of commands is limited by the operating system user limits, and can cause the forking to fail.

If the value for the -n commands option is greater than one, the command automatically applies the -f option.

host_name …

Specifies the name of the host or hosts on which to stop EGO.

To specify multiple hosts, separate the host names with a space.

You cannot use this option from a compute host unless the primary host is up and running.

all

Stops EGO on all hosts in the cluster.

CAUTION:

Never use this option to shut down the cluster. To shut down the entire cluster, run the egoshutdown command.

You cannot use this option from a compute host unless the primary host is up and running.

ego start [-f] [-n commands] [host_name … | all]

Starts EGO on the local host or, if issued from the primary host, starts EGO on all the hosts in the cluster.

This is an administrative subcommand. On Linux, you must be logged on with root permissions to issue this command. On Windows, you must be logged on as cluster administrator to issue this command.

-f

Forces the action on the host without validating the configuration file. Use this option when you are issuing the command from within a script and do not want the script to stop running to respond to prompts.

This option is automatically applied if the value for the -n commands option is greater than one.

-n commands

Specifies the number of commands to run in parallel. Executing commands in parallel allows the cluster to start faster. On Linux , use forked processes to implement parallel execution. On Windows, use threads.

There is no hard limit to the number of commands; however, on Linux, the maximum number of commands is limited by the operating system user limits, and can cause the forking to fail.

If the value for the -n commands option is greater than one, the command automatically applies the -f option.

host_name …

Specifies the name of the host or hosts on which to start EGO.

To specify multiple hosts, separate the host names with a space.

You cannot use this option from a compute host unless the primary host is up and running.

To use this option on Linux, you must have root permission on each host and have RSH or SSH configured for your account for each host. You may need to add an entry for the local host in the .rhosts or .sshosts file for root. Note if you are using Red Hat Enterprise Linux (RHEL), starting with RHEL 8, use SSH; RHEL versions 8 or later no longer supports RSH.

Note: You cannot start EGO on a Linux host from a Windows host; you cannot start EGO Windows host from a Linux host.

all

Starts EGO on all hosts in the cluster. Use this option when you want to start the entire cluster.

You cannot use this option from a compute host unless the primary host is up and running.

To use this option on Linux, you must have root permission on each host and have RSH or SSH configured for your account for each host. You may need to add an entry for the local host in the .rhosts or .sshosts file for root. Note if you are using Red Hat Enterprise Linux (RHEL), starting with RHEL 8, use SSH; RHEL versions 8 or later no longer supports RSH.

Note: You cannot start EGO on a Linux host from a Windows host; you cannot start EGO Windows host from a Linux host.