Using the activator command

You can activate and configure IBM Electronic Service Agent with a non-interactive operation executed as a command in a shell or in a script. This activation script enables you to automate activation and configuration of IBM Electronic Service Agent. For this method of activation and configuration, one command contains all the configuration parameters used to define the contact and location for the machine.

Most of the parameters used to configure IBM Electronic Service Agent from the command line are necessary to supply contact and location information to the IBM Electronic Support website, and are therefore required. Enclose parameter arguments in quotation marks, such as ‘United States’ or “Great Britain”. Options and operands that are enclosed in brackets ([]), such as [-w] or [-Y], are optional. For more information about reading syntax diagrams, see How to read syntax diagrams.

To activate and configure IBM Electronic Service Agent, run the following command:

/opt/ibm/esa/bin/activator -c -m company -n contact name -e contact mail 
-t contact phone -g contact country -s system phone -u system country 
-r system address -y system city -a system state -z system postal code 
-b system building -i IBM ID -p port [-w] [-Y]

-c

Specifies that activation and configuration are performed immediately.

-m {company}

Specifies the name of the company that owns or is responsible for the system.

-n {contact name}

Specifies the name of the person in the organization that is responsible for the system.

-e {contact mail}

Specifies the email address for the contact person.

-t {contact phone}

Specifies the telephone number where the contact person can be reached. A valid telephone number can contain alphanumeric characters and must include at least 5 but not more than 30 characters. Valid United States or Canada telephone numbers must contain at least 10 but not more than 30 characters and must not contain any dashes.

-g {contact country}

Specifies the name of the region or country where the contact person is located. The country must be specified as a valid two-letter code as defined by ISO-3166.

-s {system phone}

Specifies the telephone number where the system is located. A valid phone number must include at least 5 but not more than 30 characters. A valid telephone number can contain alphanumeric characters and must include at least 5 but not more than 30 characters. Valid United States or Canada telephone numbers must contain at least 10 but not more than 30 characters and must not contain any dashes.

-u {system country}

Specifies the name of the region or country where the system is located. The country must be specified as a valid two-letter code as defined by ISO-3166.

-r {system address}

Specifies the address where the system is located.

-y {system city}

Specifies the name of the city where the system is located.

-a {system state}

Specifies the state or province where the system is located. The state or province must be specified as a valid code as defined by ISO-3166.

-z {system postal code}

Specifies the postal code where the system is located.

-b {system building}

Specifies the building, floor, and office where the system is located.

-i {IBM ID}

Specifies the IBM ID to associate with the system.

-f {secondary contact name}

Specifies the secondary person in the organization who is responsible for the system.

-j {secondary contact email}

Specifies the email address for the secondary contact person. (for example, newuserid@mycompany.com)

-k {secondary contact phone}

Specifies the telephone number where the secondary contact person can be reached. A valid telephone number can contain alphanumeric characters and must include at least 5 but not more than 30 characters. Valid United States or Canada telephone numbers must contain at least 10 but not more than 30 characters and must not contain any dashes.

-p {port}

Specifies the port number on which the subsystem listens for incoming client requests.

-w

Specifies to add firewall rules that are required to access IBM Electronic Service Agent from remote systems.

-Y

Specifies acceptance of the license agreement so the license agreement is not displayed.

Note: To view the license agreement at any time, enter the following command:

/opt/ibm/esa/bin/reviewLA