cfgsvc command

Purpose

Configures an agent or service specified by the given name.

Syntax

cfgsvc AgentName [-attr Attribute=Value... | -ls | -key]

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

-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 IBM® TotalStorage® Productivity Center.

Agent or service names

The following agents or services can be managed by the Virtual I/O Server.

DIRECTOR_agent	Attribute names for the IBM Systems Director agent View and track hardware configuration details of the system, and monitor performance and use of critical components, such as processors, disks, and memory. RESTART_ON_REBOOT This is an optional configuration attribute for the IBM Systems Director agent. It designates whether the IBM Systems Director agent will be restarted if the Virtual I/O Server is rebooted. Valid values are: True False
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. HOSTNAME Provides the monitoring agent with a Tivoli Enterprise Management System (TEMS) host name. This is a required attribute. Valid values are: Host name IP address RESTART_ON_REBOOT Designates whether the monitoring agent will be restarted if the Virtual I/O Server is rebooted. Because you can only run one monitoring agent on the Virtual I/O Server at any given time, configuring more than one monitoring agent to restart is only valid for the last agent that is configured to restart. Run the lssvc command using the ITM agent name to verify which agent restarts. Valid values are: True False managing_system Provides the monitoring agent with a Hardware Management Console (HMC) host name. This attribute is not valid for the Integrated Virtualization Manager. Valid values are: [user_name@]Host name IP address CEC Provides the ITM_cec agent with a CEC host name. DIRECTOR_HOST_ADDRESS Provides the ITM_cec agent with a Director host name or IP address. The default value is blank. This is an optional attribute. DIRECTOR_AUTHENTICATION Provides the ITM_cec agent with a Director authentication value. The default value is Yes. This is an optional attribute. DIRECTOR_PORT_NUMBER Provides the ITM_cec agent with a Director port number. The default value is 8422. This is an optional attribute.
TSM_base	Attribute names for the Tivoli Storage Manager agent SERVERNAME The host name of the Tivoli Storage Manager server to which the Tivoli Storage Manager client is associated. SERVERIP The IP address or domain name of the Tivoli Storage Manager server to which the Tivoli Storage Manager client is associated. NODENAME The name of the machine on which the Tivoli Storage Manager client is installed.
ITUAM_base	Attribute names for the Tivoli Usage and Accounting Manager agent ACCT_DATA0 The size, in megabytes, of the first data file that holds daily accounting information. ACCT_DATA1 The size, in megabytes, of the second data file that holds daily accounting information. ISYSTEM The time, in minutes, when the agent generates system interval records. IPROCESS The time, in minutes, when the system generates aggregate process records.
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. S Provides the TotalStorage Productivity Center agent with a TotalStorage Productivity Center server host name. This a required configuration attribute. Tha valid values are: Host name IP address A Provides the TotalStorage Productivity Center agent with an agent manager host name. This is a required attribute. The valid values are: Host name IP address devAuth Sets the TotalStorage Productivity Center device server authentication password. This is a required attribute. The valid value is: Password caPass Sets the CA authentication password. This is a required attribute. The valid value is: Password caPort Sets the CA port. This is an optional attribute. The default value is 9510. The valid value is: Number amRegPort Specifies the agent manager registration port. This is an optional attribute. The default value is 9511. The valid value is: Number amPubPort Specifies the agent manager public port. This is an optional attribute. The default value is 9513. The valid value is: Number dataPort Specifies the TotalStorage Productivity Center data server port. This is an optional attribute. The default value is 9549. The valid value is: Number
	devPort Specifies the TotalStorage Productivity Center device server port. This is an optional attribute. The default value is 9550. The valid value is: Number newCA This is an optional attribute. The default value is true. The valid values are: True False oldCA This is an optional attribute. The default value is true. The valid values are: True False daScan This is an optional attribute. The default value is true. The valid values are: True False daScript This is an optional attribute. The default value is true. The valid values are: True False daInstall This is an optional attribute. The default value is true. The valid values are: True False faInstall This is an optional attribute. The default value is true. The valid values are: True False U Specifies to uninstall the agent. This is an optional attribute. The valid values are: All \| data \| fabric
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: local_ip The IP address of the source Virtual I/O Server. remote_ip The IP address of the destination Virtual I/O Server. key The key value consists of alphanumeric characters only.

Examples

IBM Tivoli Monitoring

To list all the attributes that are associated with an agent configuration, type the following command:
```
cfgsvc -ls ITM_premium
```
To configure the ITM_premium agent with several attributes, type the following command:
```
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 following command:
```
cfgsvc -key ITM_premium
```

IBM Tivoli Storage Manager

To list all the attributes associated with an agent configuration, type the following command:
```
cfgsvc -ls TSM_base
```
To configure the TSM_base agent with several attributes, type the following command:
```
cfgsvc TSM_base -attr SERVERNAME=tsm_server SERVERIP=1.127.0.1
NODENAME=VIOS  
```

IBM Tivoli Usage and Accounting Manager

To list all the attributes associated with an agent configuration, type the following command:
```
cfgsvc -ls ITUAM_base
```
To configure the ITUAM_base agent with several attributes, type the following command:
```
cfgsvc ITUAM_base -attr ACCT_DATA0=15 ACCT_DATA1=15
ISYSTEM=60 IPROCESS=60  
```

IBM TotalStorage Productivity Center

To list all TotalStorage Productivity Center configurable attributes, type the following command:
```
cfgsvc TPC -ls
```
To configure TotalStorage Productivity Center with mandatory attributes, type the following command:
```
cfgsvc TPC -attr S=tpc_server_hostname
A=agent_manager_hostname devAuth=password caPass=password
```

IBM Systems Director Agent

To list all the attributes associated with an agent configuration, type the following command:
```
cfgsvc -ls DIRECTOR_agent
```
To configure the DIRECTOR_agent with several attributes, type the following command:
```
cfgsvc DIRECTOR_agent -attr RESTART_ON_REBOOT=TRUE
```

ipsec tunnels

To list all the attributes associated with the service configuration, type the following command:
```
cfgsvc -ls ipsec_tunnel
```

To configure ipsec_tunnel, type the following command:

cfgsvc ipsec_tunnel -attr local_ip=1.2.3.4 remote_ip=2.1.4.3 key=abcd1234

Related Information

The lssvc command, the startsvc command, the stopsvc command, and the postprocesssvc command.

For more information about the various agents, see the following information: