Complete the CentraSite Upgrade
1. Start the new CentraSite.
2. If you use single sign-on with CentraSite, do the following:
a. Open the jaas.config file in the old and new Software AG_directory/profiles/CTP/configuration directories. Copy the following from the old file to the new file:
![*](chapterTOC_bullet.png)
ServletHeaderLoginModule for extracting the user ID from the incoming HTTP header.
![*](chapterTOC_bullet.png)
SimpleNameMappingLoginModule, if you are using it.
![*](chapterTOC_bullet.png)
Any other entries you are using to process the extracted user ID.
The new jaas.config file should look like this:
CentraSite {
com.softwareag.centrasite.security.cache.ShortTermTokenLoginModule sufficient;
com.softwareag.security.jaas.login.internal.InternalLoginModule sufficient
...
com.softwareag.security.sin.is.ldap.lm.LDAPLoginModule sufficient
...
com.softwareag.security.jaas.login.modules.ServletHeaderLoginModule
required
... com.softwareag.security.jaas.login.modules.SimpleNameMappingLoginModule
required
...
com.softwareag.security.sin.is.ldap.lm.LDAPLoginModule required
...
};
The ShortTermTokenLoginModule establishes delegated authentication in CentraSite to perform secured internal communication. The initial InternalLoginModule is normally only for users in the INTERNAL domain, and the initial LDAPLoginModule is for LDAP users that are logging in directly and not via single sign-on. If you need only single-sign on logins, you can remove the initial InternalLoginModule and LDAPLoginModule.
b. Set up your LDAP configuration to resolve the extracted user ID via LDAP. Modify the generated LDAP login module to enable single sign-on-related options, such as technical user. Apply LDAP single sign-on technical user credentials if necessary.
3. Change any settings in CentraSite Control that you noted earlier.
4. If you installed plug-ins that are GUI extensions for CentraSite Control in the old CentraSite installation, install them in the new CentraSite installation.
5. If you are using API Portal with CentraSite or API Gateway, republish all API Portal instances you created in the old release to the new API Portal. For instructions, see the CentraSite or API Gateway documentation.