How To
Summary
Tomcat 10.0.x has a significant improvement over its previous version, Tomcat 9.0.x. The Java package used by the specification APIs changed from javax to Jakarta. Tomcat recommends that uses their migration tool to make it compatible with Apache Tomcat 10.0.x.
Objective
Apache Tomcat can convert an existing web application from Java EE 8 to Jakarta EE 9 during deployment that uses the Apache Tomcat migration tool for Jakarta EE. To make use of the feature, move the web application to the Host legacyAppBase folder(by default named, "webapps-javaee"). This process covert the application to an equivalent Jakarta EE web application in the Host appBase folder (by default named, "webapps").
For more information about the migration process, refer to https://tomcat.apache.org/migration-10.html.
Environment
Windows, Linux, and AIX
Steps
The steps to follow for migration:
METHOD 1
1. Download Jakarta migration tool "jakartaee-migration-1.0.0-bin.zip" file from https://archive.apache.org/dist/tomcat/jakartaee-migration/v1.0.0/binaries/.
2. Copy Daeja ViewONE server jars (jiserver.jar, jiserver-external.jar, jiserver-resources-*.jar) into C:/Daeja_source.
3. Migrate jars with the following command:
java -jar C:\Migration_tool\jakartaee-migration-1.0.0.jar C:\Daeja_source C:\Daeja_destination
java -jar C:\Migration_tool\jakartaee-migration-1.0.0.jar C:\Daeja_source C:\Daeja_destination
In case if there is any exception or blank page after migrating the jars to viewer application, ensure guava.jar file (https://github.com/google/guava) is available in "<Tomcat 10 path>\webapps\viewone\WEB-INF\lib".
Note: Copying the jar in <Tomcat 10 path>\lib directory may affect all the deployed applications.
4. Migration process can take some time to finish. Look for entry, "Migration completed successfully in <time taken> milliseconds".
5. Ensure all jars are migrated to C:\Daeja_destination.
6. Deploy migrated jars available in C:\Daeja_destination to your Apache Tomcat 10 Viewer application.
METHOD 2
1. Ensure Apache tomcat 10.0.x server is stopped.
2. Deploy Viewer web application to <Tomcat 10 path>\webapps-javaee\ (Create "webapps-javaee" if not available)
3. Start Apache Tomcat 10 application server and wait for Application to migrate to <Tomcat 10 path>\webapps.
4. Launch migrated viewer application in Tomcat 10.0.x.
Document Location
Worldwide
[{"Type":"MASTER","Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSTTN8","label":"IBM Daeja ViewONE Virtual"},"ARM Category":[{"code":"a8m50000000L2oyAAC","label":"Technote"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions"}]
Was this topic helpful?
Document Information
Modified date:
31 October 2022
UID
ibm16517724