Migrating Apache Tomcat server configuration

Begin your configuration migration process by migrating the Apache Tomcat server configuration. Before you run the configuration migration tool, the Liberty server must already exist in Eclipse. To create a Liberty server in Eclipse, you must use the WebSphere Application Server Liberty Developer Tools. For more information, see Installing IBM WebSphere Application Server Developer Tools for Eclipse.

To migrate the server configuration, complete the following steps:

Start the migration tool.
You can start the migration tool from the following locations within Eclipse:
- In the Eclipse menu bar, go to Run > Tomcat Configuration Migration. Browse to the location of the Tomcat server installation, and click OK.
- In the Explorer view, right-click your Tomcat server and select Migrate Tomcat Configuration.
- In the Servers view, right-click your Tomcat server and select Migrate Tomcat Configuration.
Select the Liberty server that you want to migrate to. Click OK to begin migrating the configuration.
After the configuration is migrated, you are notified that the migration completed successfully and whether further action is required. Select whether you want to open the updated Liberty server configuration and the server migration log file, and click OK. The Liberty server workspace refreshes.

The selected Liberty server now contains the updated configuration. The server.xml file contains an include of the migratedConfig/server-updates-for-config.xml file.

The updated configuration includes the following files:

File name	Description
server.xml	Liberty server configuration file that was updated to include the generated configuration file, migratedConfig/server-updates-for-config.xml
migratedConfig/configMigration.log	Information on the migration
migratedConfig/context.xml	Configuration from the Tomcat context.xml file
migratedConfig/server.xml	Configuration from the Tomcat server.xml file
migratedConfig/server.xml.original.txt	Copy of the original Liberty server.xml file before the migration
migratedConfig/server-updates-for-config.xml	High-level include file
migratedConfig/shared-libraries.xml	Shared library configuration for reference by Liberty `datasource` elements and the `classloader` element on the `application` element
migratedConfig/shared-libraries.xml.original.txt	Copy of the original shared-libraries.xml file before the migration. This copy is made only if the file existed and was modified during the migration.
migratedConfig/variables.xml	Configuration from the Tomcat catalina.properties file
migratedConfig/variables.xml.original.txt	Copy of the original variables.xml file before the migration. This copy is made only if the file existed and was modified during the migration.
migratedConfig/`[tomcat-users-file]`_users-and-roles.xml	Configuration from the Tomcat tomcat-users.xml file or a user-defined file with `tomcat-users` elements. The Liberty file name is created based on the Tomcat file name.