Appendix D   Command Reference

This appendix describes helpful command line programs associated with Sun ONE Directory Proxy Server.

The appendix has the following section:

· "dpsconfig2ldif"

· "dpsldif2config"

dpsconfig2ldif

---

The utility dpsconfig2ldif is used to download Directory Proxy Server configuration and save it in an LDIF file. The utility is found at the following location:

<Install Root>/bin/dps_utilities/dpsconfig2ldif

The utility requires two arguments:

Argument	Description
-t filename	Filename is the path to the startup configuration file. This will usually be the tailor.txt file in the etc directory.
-o filename	The name of the file in which to output the configuration.

dpsldif2config

---

ImportConfigLdif imports an LDIF file generated by dpsConfig2Ldif.The utility is found at the following location:

<Install Root>/bin/dps_utilities/dpsldif2config

The utility requires the following arguments:

Argument	Description
ldif	name of ldif file containing Directory Proxy Server objects options:
-C	name of configuration to create ('imported-configuration' if unspecified)
-h	directory host name (localhost if unspecified)
-p	directory port number (389 if unspecified)
-D	directory user dn (anonymous bind if unspecified)
-w	directory user password (anonymous bind if unspecified)
-v	verbose

ImportConfigLdif imports three kinds of objects:

· Shared Configurations (i.e. those located in the Main Console Topology Tree under the "Directory Proxy Server Configuration" node)

· Shared System Properties

· Shared Log Properties.

The parameter "Configuration Name" applies only to Shared Configuration objects just described. System and Log properties are added "as is" from the ldif file. If a shared configuration object does not exist with the given parameter name, this script will create a new configuration using the given parameter name. If there ALREADY exists a configuration with the given name, no import will take place. System and Log properties will not be added either if they already exist in the directory.

Once a configuration has been imported, the Main Console must be restarted in order to view the configuration in the Topology Tree. In order to begin using a configuration, a Directory Proxy Server instance server will have to assign itself to each configuration: shared Configurations are assigned via the Network Groups Node in the Directory Proxy Server Server Console; System Properties are assigned via the systems node in the Directory Proxy Server Server Console ("settings saved as..."); and Log Properties are assigned via the Logs node in the Directory Proxy Server Server Console ("settings saved as...").

Pre-conditions:

· Migration from 5.0(sp 1) has already taken place.

Post-Conditions:

· belongs-to attribute is ignored in the imported ldif file.