From 05ecbfdc34d29831f96b664a5d00fe02fdfee1c1 Mon Sep 17 00:00:00 2001 From: Parvathi Nair Date: Thu, 28 May 2026 14:53:46 +0100 Subject: [PATCH 1/2] update readme Signed-off-by: Parvathi Nair --- README.md | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index 36f0340..4883d39 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@ # ModResorts Demo Application ## Overview -ModResorts (as per the `main` branch) is a IBM WebSphere Application Server web application. It is a simple application that can be used to demonstrate modernization of a IBM WebSphere Application Server to Liberty, as well as Java version upgrade scenarios. +ModResorts (as per the `main` branch) is a IBM WebSphere Application Server web application. It is a simple application that can be used to demonstrate application modernization from IBM WebSphere Application Server traditional to Liberty, which is a modern cloud-ready enterprise Java runtime, as well as Java SE version upgrade scenarios. The Java source code is dependent on APIs that only exist on the IBM WebSphere Application Server and as such, this version of the application will only function correctly when deployed to IBM WebSphere Application Server. In order to successfully deploy to Liberty, code changes need to be made to the application. See [Liberty Versions of ModResorts](#liberty-versions-of-modresorts) below. @@ -38,9 +38,9 @@ Two Liberty versions of the application are maintained on the following branches - `liberty-java8` This branch shows what the application looks like after it has been modernized to Liberty. Comparing this branch to main, you will notice the following changes: - Code changes in some source files (to remove use of WAS APIs) - - Addition of the Liberty config file: `src/main/liberty/config/server.xml`. This file is produced by IBM Transformation Advisor and is available in the [migration bundle](#migration-bundle) + - Addition of the Liberty config file: `src/main/liberty/config/server.xml`. This file is produced by IBM Application Modernization Accelerator and is available in the [migration plan](#migration-plan) - A `Containerfile` has also been added to the project root to allow you to build an image and run the application in a container. - - The Liberty tools [plugin](https://github.com/OpenLiberty/ci.maven) has been added to the `pom.xml` for convenience of running the application in Liberty. + - [Liberty Maven Plugin](https://github.com/OpenLiberty/ci.maven) has been configured in the `pom.xml` for convenience of developing the application with Liberty. - `liberty-java21` This branch shows what the application looks like after it has been modernized to Liberty **AND** upgraded to Java 21. Comparing this branch to main, you will notice all the changes described for the `liberty-java8` branch in addition to: @@ -51,27 +51,27 @@ Two Liberty versions of the application are maintained on the following branches There are no special instructions for deploying the application to IBM WebSphere Application Server. There is no configuration required on the application server in order for the application to deploy and function. It can be deployed using the UI console or using `wsadmin`. -Please refer to the [documentation](https://www.ibm.com/docs/en/was-nd/9.0.5?topic=applications-how-do-i-deploy) for more details on deploying the application to WebSphere Application Server. +See the [documentation](https://www.ibm.com/docs/en/was-nd/9.0.5?topic=applications-how-do-i-deploy) for more details on deploying the application to WebSphere Application Server. ## Deploying the Application to Liberty To deploy the application on Liberty you can do one of the following: -- Install the Liberty tools IDE plugin (VSCode and Eclipse available) -- Add the Liberty tools plugin to the build configuration. Note, for convenience, the Liberty tools plugin is already added to the `pom.xml` in the `liberty-` branches. Liberty can be launched in dev mode with the following command: +- Install the Liberty Tools IDE plugin (available for VS Code, Eclipse IDE and IntelliJ IDEA) +- Add Liberty Maven or Gradle Plugin configuration to your build file. Note, for convenience, configuration for Liberty Maven Plugin is already added to the `pom.xml` in the `liberty-` branches. Liberty can be launched in dev mode with the following command: ``` mvn liberty:dev ``` -- Run the Liberty tools directly from the command line: +- Start Liberty in dev mode directly from command line: ``` mvn io.openliberty.tools:liberty-maven-plugin:3.10.2:dev ``` - Build and drop the WAR file into Liberty installation. -For more on Liberty Dev Tools please refer to [Develop with Liberty Tools](https://openliberty.io/docs/latest/develop-liberty-tools.html) +For more on Liberty Tools, see [Develop with Liberty Tools](https://openliberty.io/docs/latest/develop-liberty-tools.html) ## Building and Running the Application a Liberty Container -A Containerfile exists in the `liberty-` branches. The Containerfile is produced by IBM Transformation Advisor and is available in the [migration bundle](#migration-bundle). It can be used to build an image and run the application in a container. You can build the image as follows: +A Containerfile exists in the `liberty-` branches. The Containerfile is produced by IBM Application Modernization Accelerator and is available in the [migration plan](#migration-plan). It can be used to build an image and run the application in a container. You can build the image as follows: ``` docker build -t modresorts:latest -f Containerfile . @@ -83,5 +83,5 @@ You can run the container as follows: docker run --rm -d -p 9080:9080 modresorts:latest ``` -## Migration Bundle -The `migration_bundle` directory contains a migration bundle for ModResorts created by [IBM Transformation Advisor](https://www.ibm.com/products/cloud-pak-for-applications/transformation-advisor). It contains an analysis of the application and artifacts that accelerate modernization to Liberty and cloud migration. +## Migration Plan +The `migration_plan` directory contains a migration plan for ModResorts created by [IBM Application Modernization Accelerator](https://www.ibm.com/products/jsphere/tools) (AMA). It is used by IBM AMA Dev Tools (available for VS Code, Eclipse IDE, and IntelliJ IDEA) or IBM Bob to accelerate modernization of legacy enterprise Java applications to run on Liberty. [Try](https://www.ibm.com/account/reg/us-en/signup?formid=urx-53705) AMA. From 2e5a32c3e15f22b2fc63ffdc22ecd14322fc53da Mon Sep 17 00:00:00 2001 From: Parvathi Nair Date: Thu, 28 May 2026 14:54:02 +0100 Subject: [PATCH 2/2] rename Signed-off-by: Parvathi Nair --- migration-bundle/About.md | 1 - migration-plan/About.md | 1 + .../modresorts.ear_migrationPlan.zip | Bin 3 files changed, 1 insertion(+), 1 deletion(-) delete mode 100644 migration-bundle/About.md create mode 100644 migration-plan/About.md rename migration-bundle/modresorts.ear_migrationBundle.zip => migration-plan/modresorts.ear_migrationPlan.zip (100%) diff --git a/migration-bundle/About.md b/migration-bundle/About.md deleted file mode 100644 index 12f5bcf..0000000 --- a/migration-bundle/About.md +++ /dev/null @@ -1 +0,0 @@ -This directory contains a migration bundle created by [IBM Transformation Advisor](https://www.ibm.com/products/cloud-pak-for-applications/transformation-advisor). It contains an analysis of the application and artifacts that accellerate modernization to Liberty and cloud migration. \ No newline at end of file diff --git a/migration-plan/About.md b/migration-plan/About.md new file mode 100644 index 0000000..44fcb29 --- /dev/null +++ b/migration-plan/About.md @@ -0,0 +1 @@ +This directory contains a migration plan created by [IBM Transformation Advisor](https://www.ibm.com/products/cloud-pak-for-applications/transformation-advisor). It contains an analysis of the application and artifacts that accellerate modernization to Liberty and cloud migration. \ No newline at end of file diff --git a/migration-bundle/modresorts.ear_migrationBundle.zip b/migration-plan/modresorts.ear_migrationPlan.zip similarity index 100% rename from migration-bundle/modresorts.ear_migrationBundle.zip rename to migration-plan/modresorts.ear_migrationPlan.zip