chconfig command

This command configures the BladeCenter unit Service Advisor feature.

Table 1. chconfig command
Function What it does Command Valid targets
Display Service Advisor configuration Displays the contact information for the Service Advisor feature. Service Advisor resides on your advanced management module and monitors your BladeCenter unit 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 IBM support. To send call home event to IBM support, you must enable and configure Service Advisor. For each call home event IBM receives, a service ticket will opened, and a follow-up call will be made. This feature will generate a message to IBM when events occur in the BladeCenter unit 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 
                           -T system:mm[x]

where x is the primary management-module 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.
 
                           -T system:mm[x]

where x is the primary management-module bay number.
Enable / disable Service Advisor terms and conditions Enables or disables the call-home terms and conditions.
Notes:
  • 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 advanced management module.
  • 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 2–character ISO 3166 country code of the IBM support center location. For example, the country code for the United States is US.
Notes:
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.
 
                           -T system:mm[x]

where x is the primary management-module bay number.
Set contact information for Service Advisor Sets contact information for the Service Advisor. chconfig -co "company" -cn "name" -cph "phone" -ce email -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.
  • 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.
  • "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.

(continued on next page) 

                           -T system:mm[x]

where x is the primary management-module bay number.
Set contact information for Service Advisor

(continued)

 
  • 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.
 
                           -T system:mm[x]

where x is the primary management-module bay number.

Example:

To accept the Service Advisor terms and conditions, while management module 1 is set as the persistent command environment, at the system:mm[1]> prompt, type 
                  chconfig -li accept
To display the current configuration of the Service Advisor, while management module 1 is set as the persistent command environment, at the system:mm[1]> prompt, type 
                  chconfig

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

               system:mm[1]> chconfig -li accept
OK
system:mm[1]> chconfig
-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
-loc  google.cn
-po  8080
-ps disabled
-u  User-001
system:mm[1]>
Parent topic: Command syntax