dsccsetup(1M)

NAME | Synopsis | Description | SUBCOMMANDS | GLOBAL OPTIONS | SUBCOMMAND OPTIONS | Exit Status | Attributes | See Also

NAME

dsccsetup – Set up Directory Service Control Center

Synopsis

install-path/dscc6/bin/dsccsetup 
 [subcommand] [options]

Description

The dsccsetup command is used to register Directory Service Control Center with Sun Java Web Console (DSCC), and to register local agents of the administration framework. Use the dsccsetup command with the subcommands described in this man page.

SUBCOMMANDS

The following subcommands are supported:

dsccsetup ads-create [-w file]

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 availablity, 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.

The default instance path is /var/opt/SUNWdsee/dscc6/dcc/ads on Solaris systems, /var/opt/sun/dscc6/dcc/ads on HP-UX and Red Hat systems, and C:\Program Files\Sun\DSEE\var\dscc6\dcc\ads on Windows systems.

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.

dsccsetup ads-delete

Delete the Directory Server instance used by DSCC to store configuration information.

Use the -i when not using the command interactively.

dsccsetup cacao-reg [-t]

Register the local DSCC agent with the Common Agent Container, cacao.

Use the -t option if you want to restart the Common Agent Container manually at a later time.

dsccsetup cacao-unreg

Remove the local DSCC agent registration information from cacao.

dsccsetup console-reg [-t]

Register DSCC with the web application container, Sun Java Web Console.

Use the -i when not using the command interactively.

Use the -t option if you want to restart Sun Java Web Console manually at a later time.

dsccsetup console-unreg [-t]

Remove DSCC from Sun Java Web Console.

Use the -i when not using the command interactively.

Use the -t option if you want to restart Sun Java Web Console manually at a later time.

dsccsetup dismantle [-t]

Dismantle the DSCC administration framework, running the cacao-unreg, console-unreg, and ads-delete subcommands.

Use the -i when not using the command interactively.

Use the -t option if you want to restart Sun Java Web Console, and the Common Agent Container manually at a later time.

dsccsetup initialize [-t] [-w file]

Initialize the DSCC administration framework, running the ads-create, console-reg, and cacao-reg subcommands.

Use the -i when not using the command interactively.

Use the -t option if you want to restart Sun Java Web Console, or 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.

dsccsetup status

Display whether DSCC has been registered with Sun Java Web Console, and with the Common Agent Container. Also, display whether the DSCC registry has been initialized.

dsccsetup mfwk-reg [-t]

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 restart the Common Agent Container manually at a later time.

dsccsetup mfwk-unreg

Remove the local Directory Server monitoring agent registration information from cacao.

GLOBAL OPTIONS

The following options apply to all commands and subcommands:

-?
--help

Display usage for the command or for the specified subcommand.

-i
--no-inter

Do not prompt for confirmation before performing the operation.

-V
--version

Displays the current version of dsccsetup. The version is provided in the format year.day.time. So version number 2006.178.0035 was built on the 178th day of 2006 at 00h35. If the components used by dsccsetup 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:

-t
--norestart

Do not restart the Common Agent Container or Sun Java Web Console after performing the operation.

You can restart the Common Agent Container using the cacaoadm command. You can restart the Sun Java Web Console using the smcwebserver command.

-w file
--pwd-file file

Use the Directory Service Manager password specified in file.

By default, dsccsetup prompts for a password.

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	SUNWldap-console-agent
Stability Level	Unstable

See Also

cacaoadm(1M), smcwebserver(1M)

NAME | Synopsis | Description | SUBCOMMANDS | GLOBAL OPTIONS | SUBCOMMAND OPTIONS | Exit Status | Attributes | See Also