cfgsvc command
Purpose
Configures an agent or service specified by the given name.
Description
The cfgsvc command configures the agent or service specified, by the given name. Use the lssvc command to obtain a list of agents or services. After configuring the agent or service, you can start and stop the agent or service by using the startsvc and stopsvc commands. Each time you run the command, it overwrites previous configurations.
To find the values for required attributes for an agent or service, use the -ls flag. If you do not specify a required attribute when you specify this command, a message is displayed that indicates the missing required attribute.
Agents might create ssh keys as part of their configuration. You can display the ssh public key that is generated during configuration by using the -key flag.
Parameters
Flag name | Description |
---|---|
-attr Attribute=Value | Identifies an attribute and value that are associated with the configuration of an agent or service. |
-ls | Lists all the attributes that can be changed for a particular agent or service configuration. |
-key | Displays the ssh public key that is generated
for a particular agent or service configuration. Note: The -key flag
is not valid for the Tivoli® Storage Productivity Center.
|
Agent or service names
Agent or service name | Description |
---|---|
ITM_premium ITM_cec |
Attribute names for the IBM® Tivoli Monitoring (ITM) agents The ITM_premium and ITM_cec agents provide system information including I/O virtualization mappings and system utilization. These agents require that you specify the HOSTNAME attribute for configuration. Also, an ssh public key is generated if one does not exist.
|
TPC | Attribute names for the TotalStorage Productivity Center agents The TPC agent is a TotalStorage Productivity Center agent. This agent requires that you specify the S, A, devAuth, and caPass attributes for configuration. By default, specifying this agent configures both the TPC_data and TPC_fabric agents.
|
|
|
perfmgr | Attribute names for the performance management data collector agent: see the postprocesssvc command. |
ipsec_tunnel | ipsec_tunnel works as a service on the Virtual I/O Server. Configurable parameters are as follows:
|
ILMT | The IBM License Metric Tool (ILMT) agent helps the License Metric Tool to identify the system on the network to determine which IBM software is installed. It requires the server attribute to be configured with the host name or IP of the ILMT server.
|
Examples
- To list all the attributes that are associated with an agent configuration,
type the command as follows:
cfgsvc -ls ITM_premium
- To configure the ITM_premium agent with several attributes, type
the command as follows:
cfgsvc ITM_premium -attr Restart_On_Reboot=TRUE hostname=tems_server managing_system=hmc_console
Note: When the RESTART_ON_REBOOT attribute is set to TRUE, the ITM agent is restarted when the Virtual I/O Server is being rebooted. The hostname attribute specifies the Tivoli Enterprise Monitoring Server (TEMS) IP address, or hostname is set to tems_server. The managing_system attribute specifies the HMC IP address, or hostname is set to hmc_console. - To display the ITM_premium agent ssh public key, type the command
as follows:
cfgsvc -key ITM_premium
- To list all TotalStorage Productivity Center configurable attributes, type the command as follows:
cfgsvc TPC -ls
- To configure TotalStorage Productivity Center with mandatory attributes, type the command as follows:
cfgsvc TPC -attr S=tpc_server_hostname A=agent_manager_hostname devAuth=password caPass=password
- To list all the attributes associated with the service configuration,
type the command as follows:
cfgsvc -ls ipsec_tunnel
- To configure ipsec_tunnel, type the command as follows:
cfgsvc ipsec_tunnel -attr local_ip=1.2.3.4 remote_ip=2.1.4.3 key=abcd1234
- To list all IBM License Metric Tool (ILMT) attributes,
type the command as follows:
cfgsvc ILMT -ls
- To configure ILMT, type the command as
follows:
cfgsvc ILMT -attr server=1.2.3.4