dsccagent

manages a DSCC agent instance.

Synopsis

dsccagent  subcommand [global_options] [subcommand_options] [subcommand_operands]

Description

The dsccagent command is used to create, delete, start, and stop DSCC agent instances on the local system. You can also use the dsccagent command to display status and DSCC agent information, and to enable and disable SNMP monitoring. Use the dsccagent command with the subcommands described in this man page:

Subcommands

The following subcommands are supported:

dsccagent create [-i] [-p PORT] [-w FILE] [AGENT_PATH]: Creates a DSCC agent instance.
dsccagent delete [AGENT_PATH]: Deletes a DSCC agent instance.
dsccagent disable-service [AGENT_PATH]: Unregisters the DSCC agent instance as a service. Available on Solaris and Windows.
dsccagent disable-snmp [AGENT_PATH]: Unconfigures the SNMP agent of a DSCC agent instance.
dsccagent enable-service [AGENT_PATH]: Registers the DSCC agent instance as a service. Available on Solaris and Windows.
dsccagent enable-snmp [--v3] [--snmp-port SNMP_PORT] [--ds-port DS_PORT] [AGENT_PATH]: Configures a DSCC agent instance as SNMP agent.
dsccagent info [AGENT_PATH]: Displays the DSCC agent instance status and some configuration information.
dsccagent start [AGENT_PATH]: Start a DSCC agent instance. The DSCC agent will be able to start if it was registered in the DSCC registry, or if the SNMP agent is enabled.
dsccagent stop [AGENT_PATH]: Stops a DSCC agent instance.

Global Options

The following options apply to all commands and subcommands:

-?
--help: Display usage for the command or for the specified subcommand.
-V
--version: Displays the current version of dsccagent. The version is provided in the format year.monthday.time. So version number 2009.0601.0035 was built on June 1st, 2009 at 00h35. If the components used by dsccagent are not aligned, the version of each individual component is displayed.
-v
--verbose: Display extra information for debugging purposes.

Subcommand Options

The following options apply to the subcommands where they are specified:

--ds-port DS_PORT: Use DS_PORT for traffic from Directory Servers to agent. (Default is 3995 or random.)
-i, --no-inter: Does not prompt for password.
-p PORT, --port PORT: Specifies DSCC agent port. (Default: 3997)
--snmp-port SNMP_PORT: Use SNMP_PORT for SNMP traffic. (Default is 3996 or random.)
--v3: Use SNMP version 3.
-w FILE, --pwd-file FILE: Reads the DSCC agent password from PWD_FILE. (Default: prompt for pwd)

Operand

AGENT_PATH: Path of the DSCC agent instance. (Default: INSTALL_DIR/var/dcc/agent).

Exit Status

The following exit status values are returned:

0: Successful completion
non-zero: An error occurred.

Attributes

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	11g R1 (11.1.1.7.0)
Stability Level	Evolving