Generic device agent: acsgen

Edit online

The generic device agent, acsgen, is the component that uses adapters to start snapshot commands on snapshot-compatible devices.

The generic device agent, acsgen, is started as a background daemon so you are not required to manually start it.

If you must deviate from the standard installation, the generic device agent, acsgen, offers the following command options for customization:

Figure 1. acsgen generic device agent

Syntax for obtaining version or help information:

Figure 2. acsgen generic device agent help

Table 1. Options for starting the generic device agent, acsgenDescription of acsgen options with default values if applicable.
Option	Description	Default
-p profile	Full profile name.	`<instance_directory>`/profile
-c acsd-hostname	Name of the server where the management agent, acsd, is running.	`localhost`
acsd-port	TCP/IP port number or service name on which the management agent, acsd, is listening.	`57328`
-s device-class	Section in the profile that pertains to the device class. Specify multiple device classes by separating each device class by a space.	`STANDARD`
-l acs-directory	Directory where the logs and shared directories can be found.	`<ACS_DIR>`
-D	Start as daemon. The -a option defines the usability states that the device agent responds to. Valid only when started from the following path: /etc/inittab	Run and end.
-H hostname	The host name where the process is running. The primary use is by the launchpad component to check its partitions in a DB2® multi-partition environment.	The system host name that is displayed by the hostname command.
-M	Start the device agent as a mount agent. This agent is called for mounting or unmounting the target volumes on the backup system when any of the following situations exist: An offloaded backup to IBM® Storage Protect is requested Database files on JFS file systems Database files on AIX® LVM mirrored volumes The database is not suspended Cloning databases A mount verifies the consistency of the associated file systems.	Start as the monitoring agent.
-v	Display version and help information.	None
-h	Display help information only.	None
Note: The device agent profile parameters can also reside in the management agent, acsd, profile so that only one profile is needed. This change requires that the management agent, acsd, profile be shared across all DB2 partitions on all participating hosts. However, it is also possible to have a different profile for each of the device agents. All profiles need at least the following sections: `GLOBAL` `CLIENT` at least one section for the device agent (`STANDARD` or any other section name that is specified with the vendor option `DEVICE_CLASS`) The `OFFLOAD` section is optional. If an `OFFLOAD` section is not included, the default values for the parameters are used.

Table 2. Options for starting the generic device agent, acsgenDescription of acsgen options with default values if applicable.
Option	Description	Default
-p profile	Full profile name.	`<instance_directory>`/profile
-c acsd-hostname	Name of the server where the management agent, acsd, is running.	`localhost`
acsd-port	TCP/IP port number or service name on which the management agent, acsd, is listening.	`57328`
-s device-class	Section in the profile that pertains to the device class. Specify multiple device classes by separating each device class by a space.	`STANDARD`
-l acs-directory	Directory where the logs and shared directories can be found.	`<ACS_DIR>`
-D	Start as daemon. The -a option defines the usability states that the device agent responds to. Valid only when started from the following path: /etc/inittab	Run and end.
-H hostname	The host name where the process is running. The primary use is by the launchpad component to check its partitions in a DB2 multi-partition environment.	The system host name that is displayed by the hostname command.
-M	Start the device agent as a mount agent. This agent is called for mounting or unmounting the target volumes on the backup system when any of the following situations exist: An offloaded backup to IBM Storage Protect is requested Database files on JFS file systems Database files on AIX LVM mirrored volumes The database is not suspended A mount verifies the consistency of the associated file systems.	Start as the monitoring agent.
-v	Display version and help information.	None
-h	Display help information only.	None
Note: The device agent profile parameters can also reside in the management agent, acsd, profile so that only one profile is needed. However, it is also possible to have a different profile for each of the device agents. All profiles need at least the following sections: `GLOBAL` `CLIENT` at least one section for the device agent (`STANDARD` or any other section name that is specified with the vendor option `DEVICE_CLASS`) The `OFFLOAD` section is optional. If an `OFFLOAD` section is not included, the default values for the parameters are used.

Table 3. Options for starting the generic device agent, acsgenDescription of acsgen options with default values if applicable.
Option	Description	Default
-p profile	Full profile name.	`<instance_directory>`/profile
-U	Additional client or cloning sections must be named.	`<use_client_section_name>`, `<use_cloning_section_name>`
-c acsd-hostname	Name of the server where the management agent, acsd, is running.	`localhost`
acsd-port	TCP/IP port number or service name on which the management agent, acsd, is listening.	`57328`
-s device-class	Section in the profile that pertains to the device class. Specify multiple device classes by separating each device class by a space.	`STANDARD`
-l acs-directory	Directory where the logs and shared directories can be found.	`<ACS_DIR>`
-D	Start as daemon. The -a option defines the usability states that the device agent responds to. Valid only when started from the following path: /etc/inittab	Run and end.
-H hostname	The host name where the process is running. The primary use is by the launchpad component to check its partitions in a DB2 multi-partition environment.	The system host name that is displayed by the hostname command.
-M	Start the device agent as a mount agent. This agent is called for mounting or unmounting the target volumes on the backup system when any of the following situations exist: An offloaded backup to IBM Storage Protect is requested Database files on JFS file systems Database files on AIX LVM mirrored volumes The database is not suspended A mount verifies the consistency of the associated file systems.	Start as the monitoring agent.
-v	Display version and help information.	None
-h	Display help information only.	None
Note: The device agent profile parameters can also reside in the management agent, acsd, profile so that only one profile is needed. However, it is also possible to have a different profile for each of the device agents. All profiles need at least the following sections: `GLOBAL` `CLIENT` at least one section for the device agent (`STANDARD` or any other section name that is specified with the vendor option `DEVICE_CLASS`) `ORACLE` The `OFFLOAD` section is optional. If an `OFFLOAD` section is not included, the default values for the parameters are used.