Name | Synopsis | Description | SUBCOMMANDS | GLOBAL OPTIONS | SUBCOMMAND OPTIONS | Operands | Exit Status | Attributes | See Also
install-path/bin/dsccsetup [subcommand] [options]
The dsccsetup command is used to deploy Directory Service Control Center (DSCC) in an application server, and to register local agents of the administration framework. Use the dsccsetup command with the subcommands described in this man page.
The following subcommands are supported:
Initialize the DSCC registry, a local Directory Server instance for private use by DSCC to store configuration information. DSCC requires that this instance reside locally on the host where you run DSCC. Therefore, if you replicate the data in the instance for high availability, set up one DSCC per replica host.
If you do not provide the Directory Manager password for the DSCC registry in the file passed to the -w option, the command prompts for the password.
The default port numbers used by the instance are 3998 for LDAP, and 3999 for LDAPS. If those ports are already used, then dsccsetup randomly chooses some ports. If you want to use specific ports, then use the -p and -P options.
The default instance path of DSCC registry is /var/opt/SUNWdsee7/dcc/ads on Solaris systems in native mode and install-path/var/dcc/ads on other platforms.
The base DN for the suffix containing configuration information is cn=dscc.
Use the dsccsetup status subcommand to read actual values for the DSCC registry instance.
Delete the Directory Server instance used by DSCC to store configuration information.
This subcommand undo the work performed by the dsccsetup ads-create command. If you delete the DSCC registry, all the server registrations are deleted but the Server instances remain unaffected.
Use the -i when not using the command interactively.
Register the local DSCC agent with the Common Agent Container, cacao.
Use the -t option if you want to start the Common Agent Container manually at a later time.
Remove the local DSCC agent registration information from cacao.
Undo DSCC initialization by performing cacao-unreg, ads-delete, and war-file-delete.
Use the -i when not using the command interactively.
Use the -t option if you want to start the Common Agent Container manually at a later time.
Initialize DSCC by performing cacao-reg, ads-create, and war-file-create.
Use the -i when not using the command interactively.
Use the -t option if you want to start the Common Agent Container manually at a later time.
If you do not provide the Directory Manager password for the DSCC registry in the file passed to the -w option, the command prompts for the password.
Register the local Directory Server monitoring agent for Java Enterprise System Monitoring Framework with the Common Agent Container, cacao.
Use the -t option if you want to start the Common Agent Container manually at a later time.
Remove the local Directory Server monitoring agent registration information from cacao.
Perform actions that are required before applying a patch.
This subcommand stops the server instances and the Common Agent Container. Once prepare-patch is completed, none of the executables from the current installation is running. Thus the installation can be safely patched.
Display whether DSCC has been registered with Common Agent Container. Also, display whether the DSCC registry has been initialized.
Generate the WAR file for deploying DSCC in an application server.
Delete the WAR file.
The following options apply to all commands and subcommands:
Display usage for the command or for the specified subcommand.
Do not prompt for confirmation before performing the operation.
Displays the current version of dsccsetup. 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 dsccsetup are not aligned, the version of each individual component is displayed.
Display extra information for debugging purposes.
The following options apply to the subcommands where they are specified:
Overwrites the existing WAR file.
Uses PORT for the LDAP port (Default: 3998 or random)
Uses PORT for the LDAPS port (Default: 3999 or random).
Do not start the Common Agent Container after performing the operation.
You can restart the Common Agent Container using the cacaoadm command.
Use the Directory Service Manager password specified in file.
By default, dsccsetup prompts for a password.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE |
ATTRIBUTE VALUE |
---|---|
Availability |
SUNWdsee7 |
Stability Level |
Unstable |
cacaoadm(1M), smcwebserver(1M)
Name | Synopsis | Description | SUBCOMMANDS | GLOBAL OPTIONS | SUBCOMMAND OPTIONS | Operands | Exit Status | Attributes | See Also