Stay organized with collections
Save and categorize content based on your preferences.
Customize migration plan for WebSphere traditional workloads
Before you begin
This topic assumes that you've already
created a migration
and have the migration plan file.
Edit the migration plan
After you have copied the file system and analyzed it, you can find the
migration plan in the new directory that is created in the specified output
path: ANALYSIS_OUTPUT_PATH/config.yaml.
Edit the migration plan as necessary and save the changes.
Review your migration plan's details and guiding comments to add information as
needed.
Specifically, consider edits around the following sections.
Select applications
On the migration plan, the application field represents the applications to migrate.
If you do not want to migrate all applications, you can remove them.
scannerOptions:# Setting 'includeSensitiveData: true' will upload sensitive data, if exists, such as private keys, to the artifacts repositoryincludeSensitiveData:falsesourceAppServer:was90
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[],[],null,["# Customize migration plan for WebSphere traditional workloads\n============================================================\n\n| **Important:** The `websphere-traditional` plugin is now deprecated. For existing customers, this plugin is still supported till December 2023, after which it will no longer be available. If you're new to WebSphere workload modernization, then use the `websphere-container` plugin with the Migrate to Containers CLI instead.\n\nBefore you begin\n----------------\n\nThis topic assumes that you've already\n[created a migration](/migrate/containers/docs/m2c-cli/create-a-migration-plan)\nand have the migration plan file.\n\nEdit the migration plan\n-----------------------\n\nAfter you have copied the file system and analyzed it, you can find the\nmigration plan in the new directory that is created in the specified output\npath: \u003cvar translate=\"no\"\u003eANALYSIS_OUTPUT_PATH\u003c/var\u003e/`config.yaml`.\n\nEdit the migration plan as necessary and save the changes.\n\nReview your migration plan's details and guiding comments to add information as\nneeded.\n\nSpecifically, consider edits around the following sections.\n\nSelect applications\n-------------------\n\nOn the migration plan, the application field represents the applications to migrate.\nIf you do not want to migrate all applications, you can remove them. \n\n applications:\n - appName: hello-world-servlet-ear\n httpEndpoints:\n - httpPort: 9080\n httpsPort: 9443\n id: defaulthttpendpoint\n image:\n name: hello-world-servlet-ear\n path: /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/config/cells/m4a-twas-ndNode01Cell/applications/Hello-World-Servlet.ear\n ...\n - appName: commons-ejb-ear-provided-ear\n httpEndpoints:\n - httpPort: 9080\n httpsPort: 9443\n id: defaulthttpendpoint\n image:\n name: commons-ejb-ear-provided-ear\n path: /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/config/cells/m4a-twas-ndNode01Cell/applications/commons-ejb-ear-provided.ear\n sharedLibraries:\n - /opt/IBM/WebSphere/AppServer/sharedJars/commons-io-2.8.0.jar\n\nSet the scanner options\n-----------------------\n\nIn the migration plan, the `scannerOptions` field represents the argument to pass\nto the [IBM WebSphere Application Server Migration Toolkit for Application Binaries](https://www.ibm.com/support/pages/migration-toolkit-application-binaries).\nYou can edit the arguments. \n\n scannerOptions:\n # Setting 'includeSensitiveData: true' will upload sensitive data, if exists, such as private keys, to the artifacts repository\n includeSensitiveData: false\n sourceAppServer: was90\n\n| **Note:** In order to collect sensitive data, in the migration plan, under `scannerOptions`, modify the value of `includeSensitiveData:` to be `true`. Notice that `set includeSensitiveData: true` will cause uploading sensitive artifacts into the user repository. On `liberty` and `openliberty`, the sensitive data will be stored in a secret file artifact that is used when building app container.\n\nWhat's next\n-----------\n\n- Learn how to [execute the migration](../execute-the-migration-plan)."]]