Previous      Contents      Index      Next
Sun Java System Directory Proxy Server 5 2004Q2 Administration Guide

Appendix D
Command Reference

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

The appendix has the following section:

dpsconfig2ldif
dpsldif2config

---

dpsconfig2ldif

The dpsconfig2ldif utility downloads Directory Proxy Server configuration and saves it in an LDIF file. The dpsconfig2ldif utility is found at the following location:

<serverroot>/bin/dps_utilities/dpsconfig2ldif

The dpsconfig2ldif 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

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

<serverroot>/bin/dps_utilities/dpsldif2config

The dpsconfig2ldif 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 Console; System Properties are assigned via the systems node in the Directory Proxy Server Console ("settings saved as..."); and Log Properties are assigned via the Logs node in the Directory Proxy Server Console ("settings saved as...").

Pre-conditions

You are running Directory Proxy Server 5 2004Q2.

Post-conditions

The belongs-to attribute is ignored in the imported LDIF file.

Previous      Contents      Index      Next

---

Copyright 2004 Sun Microsystems, Inc. All rights reserved.