chconfig command

This command configures the Flex System Enterprise Chassis Service Advisor feature.

If command syntax is not correctly entered, or if a command fails to run, an error message is returned. See Common errors for a list of error messages that apply to all commands or chconfig command errors for a list of error messages that are specific to the chconfig command.

Table 1. chconfig command.

The command table is a multi-row, four-column table where each row describes a CMM CLI command option: column one lists command function, column two provides a detailed command description, column three shows command-option syntax, and column four lists valid command targets.

Function What it does Command Target (see paths in Command targets)
Display Service Advisor configuration Displays the contact information for the Service Advisor feature. Service Advisor resides on your CMM and monitors your Flex System Enterprise Chassis for hardware events. Upon detecting a hardware event, Service Advisor captures the event, error logs, and service data, and can automatically report the event to Lenovo support. To send call home event to Lenovo support, you must enable and configure Service Advisor. For each call home event Lenovo receives, a service ticket will opened, and a follow-up call will be made. This feature will generate a message to Lenovo when events occur in the Flex System Enterprise Chassis or one of its components that usually can be resolved without additional problem determination.
Note: The system will wait five days before sending duplicate events if they are left unacknowledged in the activity log.
chconfig
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Display / accept Service Advisor terms and conditions Displays or accepts the terms of the Service Advisor terms and conditions. chconfig -li license
where license is
  • view to view the Service Advisor terms and conditions.
  • accept to accept the Service Advisor terms and conditions.
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Enable / disable Service Advisor terms and conditions Enables or disables the call-home terms and conditions.
Note:
  • All contact information fields are required before the Service Advisor can be enabled.
  • Call Home will connect to IBM through HTTPS and HTTP. HTTP Proxy fields must be set to permit for outbound traffic.
  • Service Advisor also needs to set up DNS server address on the CMM.
  • Changing the Service Advisor setting from disabled to enabled will automatically trigger a test call home and the Service Advisor Activity Log will record this test call home.
chconfig -sa setting-sc support_center
where
  • setting is
    • enable to activate the Service Advisor terms and conditions.
    • disable to suspend the Service Advisor terms and conditions.
  • support_center is the 2character ISO 3166 country code of the Lenovo support center location. For example, the country code for the United States is US.
Note:
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set contact information for Service Advisor Sets contact information for the Service Advisor.
Note: Each Service Advisor field can be set or updated independently, as well as specifying all fields at the same time, as shown here.
chconfig -co "company" -cn "name"-cph "phone" -cphe "extension"-ce email -mlph "m_phone"-ca "address"-cci "city"-cs state-sc support_center-cz "postalcode"

where:

  • "company" is the quote-delimited contact company name, of up to 30 characters in length.
  • "name" is the quote-delimited contact name, of 1 to 30 characters in length.
  • "phone" is the quote-delimited contact phone number, of 5 to 30 characters in length.
  • "extension" is the quote-delimited contact phone extension, of 1 to 30 characters in length.
  • email is email address of the contact person in the form userid@hostname (30 characters maximum). The userid can be alphanumeric characters, ".", "-", or "_" but must begin and end with alphanumeric characters. The hostname can be alphanumeric characters, ".", "-", or "_". It must contain at least two domain items. Every domain item should begin and end with an alphanumeric character and the last domain item should be from 2 to 20 alphabetic characters.
  • "m_phone" is the quote-delimited machine location phone number, of 5 to 30 characters in length.

(continued on next page)

Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set contact information for Service Advisor

(continued)

 
  • "address" is the quote-delimited street address of the machine location, of 1 to 30 characters in length.
  • "city" is the quote-delimited city of the machine location, of 1 to 30 characters in length.
  • state is the state of the machine location, of 2 to 3 characters in length.
  • "postalcode" is the quote-delimited postal code of the machine location, of 1 to 9 alphanumeric characters in length.
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
Set contact information for alternate Service Advisor Sets contact information for an alternate Service Advisor.
Note: Each alternate Service Advisor field can be set or updated independently, as well as specifying all fields at the same time, as shown here.
chconfig -acn "name" -acph "phone" -acphe "extension"-ace email -mlph "m_phone" -ca "address" -cci "city"-cs state-sc support_center-cz "postalcode"

where:

  • "name" is the quote-delimited contact name, of 1 to 30 characters in length.
  • "phone" is the quote-delimited contact phone number, of 5 to 30 characters in length.
  • "extension" is the quote-delimited contact phone extension, of 1 to 30 characters in length.
  • email is email address of the contact person in the form userid@hostname (30 characters maximum). The userid can be alphanumeric characters, ".", "-", or "_" but must begin and end with alphanumeric characters. The hostname can be alphanumeric characters, ".", "-", or "_". It must contain at least two domain items. Every domain item should begin and end with an alphanumeric character and the last domain item should be from 2 to 20 alphabetic characters.
  • "m_phone" is the quote-delimited machine location phone number, of 5 to 30 characters in length.
  • "address" is the quote-delimited street address of the machine location, of 1 to 30 characters in length.

(continued on next page)

Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set contact information for alternate Service Advisor

(continued)

 
  • "city" is the quote-delimited city of the machine location, of 1 to 30 characters in length.
  • state is the state of the machine location, of 2 to 3 characters in length.
  • "postalcode" is the quote-delimited postal code of the machine location, of 1 to 9 alphanumeric characters in length.
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
Set up HTTP proxy for Service Advisor Sets up HTTP proxy for Service Advisor. chconfig -ps setting-loc hostname-po port-u "username"-pw "password"
where:
  • setting is enabled or disabled
  • hostname is the fully qualified host name or IP address of the HTTP proxy, of 1 to 63 characters in length.
  • port is the port of the HTTP proxy, a number from 1 to 65535, inclusive.
  • "username" is the quote-delimited user name, of 1 to 30 characters in length.
  • "password" is the quote-delimited password of the HTTP proxy, of up to 15 characters in length
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.

Example:

To accept the Service Advisor terms and conditions, while the Flex System Enterprise Chassis is set as the persistent command environment, at the system> prompt, type
chconfig -li accept -T mm[p]
To display the current configuration of the Service Advisor, while the Flex System Enterprise Chassis is set as the persistent command environment, at the system> prompt, type
chconfig -T mm[p]

The following example shows the information that is returned from these two commands:

system> chconfig -li accept -T mm[p]
OK
system> chconfig -T mm[p]
-sa enabled
-sc  US
-ca  No 399, Keyuan Rd,
-cci  Dallas
-ce  bob@cn.ibm.com
-cn  bob
-co  IBM
-cph  800-555-1111
-cs  TX
-cz  75210
-cphe  5678
-acn  mary
-acph  800-555-1113
-acphe  1234
-ace  mary@cn.ibm.com
-mlph  800-555-1112
-loc  google.cn
-po  8080
-ps disabled
-u  User-001
system>