r4 - 2018-02-12 - 16:28:09 - RosaNaranjoYou are here: TWiki >  Deployment Web > DeploymentMigratingAndEvolving > MigrateTomcatToLiberty

Migrate from Apache Tomcat to WebSphere Liberty new.png

Authors: RosaNaranjo
Build basis: All CLM web Applications, 6.0.1 and later

In the 6.0.1 release of Collaborative Lifecycle Management, we switched out the application server we bundle with the product. If you install the default application server, it is now WebSphere Liberty instead of Apache Tomcat. Apache Tomcat is still supported but you must download and configure it yourself. This change was made in part to simplify the installation experience. We had recommended traditional WebSphere for enterprise deployments and at times, this could mean migrating from Tomcat to traditional WebSphere. With the bundling of WebSphere Liberty, that is not necessary.

Migration steps

Our interactive upgrade guide covers this scenario. Application data and Tomcat configurations are migrated to the Liberty Profile during the upgrade process.


Files updated on the Liberty profile are as follows:

  • Location: [JAZZ_Install_Dir]\server\liberty\servers\clm
  • server.xml - Includes Basic or LDAP User Registry based on Tomcat config
  • application.xml and web.xml Security Role mappings
  • basicUserRegistry.xml or ldapUserRegistry.xml User Registry Detail

If you installed CA Certificates on Tomcat, migrate them to Liberty profile.

  • Copy the keystore file you were using with Tomcat to \server\liberty\servers\clm\resources\security
  • Edit server.xml file and update the element keystore_element.png

User registry migration

LDAP Registry

  • LDAP Registry details are updated in ldapUserRegistry.xml
  • LDAP user and group filter details are not updated
  • Follow the info center page for the user and group filter configuration for different LDAPs

Tomcat registry

  • Tomcat Users are migrated to the liberty basicUserRegistry.xml file
  • A file named passwords.txt is created in the /server directory of 6.0.x
    • The file contains temporary passwords for all users from the tomcat-users.xml file
  • After the server is started, users can change their temporary passwords

Related topics: Migrate from traditional WAS to Liberty,Liberty profiles as a Service


Migrating from Apache Tomcat to the WebSphere Application Server Liberty Profile

Additional contributors: PaulEllis, ShubjitNaik

Edit | Attach | Printable | Raw View | Backlinks: Web, All Webs | History: r4 < r3 < r2 < r1 | More topic actions
This site is powered by the TWiki collaboration platformCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Contributions are governed by our Terms of Use. Please read the following disclaimer.