Transforming and Migrating LDAP Configuration Data

If you are upgrading to CentraSite 9.7 from an earlier version of CentraSite, you must transform and migrate the LDAP configuration from the old Registry Repository to the new CentraSite JAAS configuration.

To resolve this problem, a mechanism is available to migrate the LDAP data in CentraSite.

You can transform and migrate the LDAP configuration to the new JAAS configuration by executing the following command in the command line interface CentraSiteCommand.cmd (Windows) or CentraSiteCommand.sh (UNIX) of Command Central. The tool is located in <SuiteInstallDir>/CentraSite/utilities.

If you start this command line tool with no parameters, you receive a help text summarizing the required input parameters.

The parameters of the command are case-sensitive, so for example the parameter -url must be specified as shown and not as -URL.

If you omit the passwords from the command, you will be prompted to provide them.

The syntax of the command is as follows:

CentraSiteCommand generate JaasConfiguration [-url <CENTRASITE-URL>]
-user <USER-ID> -password <PASSWORD>

The following table describes the complete set of input parameters that you can use with the generate JaasConfiguration utility:

Parameter	Description
-url	The fully qualified URL (http://localhost:53307/CentraSite/CentraSite) for the CentraSite registry/repository.
-user	The user name of a user in the user repository who has the required rights to create a new user in the user repository.
-password	The password of the user identified by the parameter -user.

CentraSiteCommand add Admin -url http://localhost:53307/CentraSite/CentraSite
-user Administrator -password manage

The script generates JAAS LoginModule entries that correspond to the old LDAP configuration and saves the entries in the jaas.config file in the <CentraSiteInstallDir>/profiles/CTP/configuration directory. For each LDAP domain, the script creates user and group files that map internal (CentraSite) properties to external (LDAP) properties and saves the files in the <CentraSiteInstallDir>/profiles/CTP/configuration/com.softwareag.platform.config.propsloader directory.

Note:

The generate JaasConfiguration utility transforms only domains of type LDAP. If you have advanced JAAS configurations such as single-sign-on configurations, you must migrate them manually.