# List of discovered WebSphere application servers and how to migrate their# hosted applications to containers.webSphereApplicationServers:# The application server installation path.-home:/opt/ibm/wlpapplicationServerInfo:name:WebSphereApplicationServerprofile:Libertyversion:23.0.0.4edition:Base# List of Java installations available to the application server.javaDevelopmentKits:-home:/opt/ibm/javavendor:IBMCorporationversion:jdk:javaversion1.8.0_361jre:Java(TM)SERuntimeEnvironmentjvm:IBMJ9VM# List of hosted applications and how to migrate them to containers.applications:-path:/opt/ibm/wlp/usr/servers/defaultServer/apps/app.war# Application archives to be migrated into the target container.archives:-/opt/ibm/wlp/usr/servers/defaultServer/apps/app.war# Application configuration files to be migrated into the target container.configurations:serverXML:/opt/ibm/wlp/usr/servers/defaultServer/server.xmlserverEnv:-/opt/ibm/wlp/usr/servers/defaultServer/server.envbootstrapProperties:-/opt/ibm/wlp/usr/servers/defaultServer/bootstrap.propertiesvariableProperties:-/opt/ibm/wlp/usr/servers/defaultServer/variables/variable.propertiesjvmOptions:-/opt/ibm/wlp/usr/servers/defaultServer/jvm.options# Application resource files to be migrated into the target container.resources:locations:-/opt/ibm/wlp/usr/servers/defaultServer/resources/ports.xmllibraries:-/opt/ibm/wlp/usr/servers/defaultServer/resources/postgresql.jarkeystores:-/opt/ibm/wlp/output/defaultServer/resources/security/key.p12sharedResources:-/opt/ibm/wlp/usr/shared/resources/jdbc.jaradditionalResources:-/opt/ibm/wlp/output/defaultServer/resources/mongodb.jarjavaRuntime:se:SE8ee:EE7vendor:IBMCorporationtargetJavaRuntime:se:SE8ee:EE7vendor:IBMCorporationtargetApplicationServer:profile:Libertyversion:23.0.0.4edition:BasetargetContainer:# The target container base image name.baseImage:ibmcom/websphere-liberty:full-java8-ibmjava-ubi# The application server installation path within the target container# base image.home:/opt/ibm/wlp# The application server default server name.server:defaultServer# The UID or name of the user configured within the target container# base image. Defaults to 1001 for Liberty profile.user:"1001"# The GID or name of the group configured within the target container# base image. Defaults to 0 for Liberty profile.group:"0"# Application ports to be exposed in Kubernetes artifacts.ports:-name:http-tcp-9080port:9080protocol:TCP-name:https-tcp-9443port:9443protocol:TCP# Specify whether discovered keystores are automatically converted to# Kubernetes secrets. Defaults to true.enableSecrets:true
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["很难理解","hardToUnderstand","thumb-down"],["信息或示例代码不正确","incorrectInformationOrSampleCode","thumb-down"],["没有我需要的信息/示例","missingTheInformationSamplesINeed","thumb-down"],["翻译问题","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2025-09-04。"],[],[],null,["# Customize migration plan for WebSphere workloads\n================================================\n\nBefore you begin\n----------------\n\nThis document 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 details and guiding comments to add information as\nneeded.\n\nSpecifically, consider edits around the following sections.\n\nMigration plan structure\n------------------------\n\nThe migration plan for WebSphere workloads has the following structure,\nwhich you can customize as described in the following sections. \n\n # List of discovered WebSphere application servers and how to migrate their\n # hosted applications to containers.\n webSphereApplicationServers:\n # The application server installation path.\n - home: /opt/ibm/wlp\n applicationServerInfo:\n name: WebSphere Application Server\n profile: Liberty\n version: 23.0.0.4\n edition: Base\n # List of Java installations available to the application server.\n javaDevelopmentKits:\n - home: /opt/ibm/java\n vendor: IBM Corporation\n version:\n jdk: java version 1.8.0_361\n jre: Java(TM) SE Runtime Environment\n jvm: IBM J9 VM\n # List of hosted applications and how to migrate them to containers.\n applications:\n - path: /opt/ibm/wlp/usr/servers/defaultServer/apps/app.war\n # Application archives to be migrated into the target container.\n archives:\n - /opt/ibm/wlp/usr/servers/defaultServer/apps/app.war\n # Application configuration files to be migrated into the target container.\n configurations:\n serverXML: /opt/ibm/wlp/usr/servers/defaultServer/server.xml\n serverEnv:\n - /opt/ibm/wlp/usr/servers/defaultServer/server.env\n bootstrapProperties:\n - /opt/ibm/wlp/usr/servers/defaultServer/bootstrap.properties\n variableProperties:\n - /opt/ibm/wlp/usr/servers/defaultServer/variables/variable.properties\n jvmOptions:\n - /opt/ibm/wlp/usr/servers/defaultServer/jvm.options\n # Application resource files to be migrated into the target container.\n resources:\n locations:\n - /opt/ibm/wlp/usr/servers/defaultServer/resources/ports.xml\n libraries:\n - /opt/ibm/wlp/usr/servers/defaultServer/resources/postgresql.jar\n keystores:\n - /opt/ibm/wlp/output/defaultServer/resources/security/key.p12\n sharedResources:\n - /opt/ibm/wlp/usr/shared/resources/jdbc.jar\n additionalResources:\n - /opt/ibm/wlp/output/defaultServer/resources/mongodb.jar\n javaRuntime:\n se: SE8\n ee: EE7\n vendor: IBM Corporation\n targetJavaRuntime:\n se: SE8\n ee: EE7\n vendor: IBM Corporation\n targetApplicationServer:\n profile: Liberty\n version: 23.0.0.4\n edition: Base\n targetContainer:\n # The target container base image name.\n baseImage: ibmcom/websphere-liberty:full-java8-ibmjava-ubi\n # The application server installation path within the target container\n # base image.\n home: /opt/ibm/wlp\n # The application server default server name.\n server: defaultServer\n # The UID or name of the user configured within the target container\n # base image. Defaults to 1001 for Liberty profile.\n user: \"1001\"\n # The GID or name of the group configured within the target container\n # base image. Defaults to 0 for Liberty profile.\n group: \"0\"\n # Application ports to be exposed in Kubernetes artifacts.\n ports:\n - name: http-tcp-9080\n port: 9080\n protocol: TCP\n - name: https-tcp-9443\n port: 9443\n protocol: TCP\n # Specify whether discovered keystores are automatically converted to\n # Kubernetes secrets. Defaults to true.\n enableSecrets: true\n\n### Exclude applications\n\nTo exclude applications from the migration, remove them from the `applications` list. \n\n applications:\n # Exclude app1.war:\n # - path: app1.war\n # ...\n - path: app2.war\n\n### Control application files\n\nTo control which application files are included or excluded from the migration,\nupdate the `configurations` and `resources` fields. \n\n applications:\n - path: app.war\n resources:\n keystores:\n # Exclude key1.p12:\n # - key1.p12\n # Include key2.p12:\n - key2.p12\n additionalResources:\n # Exclude resource1.xml:\n # - resource1.xml\n # Include resource2.xml:\n - resource2.xml\n\n### Customize the target Java runtime\n\nTo customize the target Java runtime for the application, update the `targetJavaRuntime` field. \n\n applications:\n - path: app.war\n targetJavaRuntime:\n se: \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-n\"\u003eSE\u003c/span\u003e\u003c/var\u003e\n ee: \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-n\"\u003eEE\u003c/span\u003e\u003c/var\u003e\n vendor: \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-n\"\u003eVENDOR\u003c/span\u003e\u003c/var\u003e\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eSE\u003c/var\u003e: the Java SE version. Format: \\[SE8\\|SE11\\|SE17\\].\n- \u003cvar translate=\"no\"\u003eEE\u003c/var\u003e: the Java EE or Jakarta EE version. Format: \\[EE7\\|EE8\\|EE9\\|EE10\\].\n- \u003cvar translate=\"no\"\u003eVENDOR\u003c/var\u003e: the Java vendor. Format: \\[IBM Corporation\\|Oracle Corporation\\].\n\n### Customize the target application server\n\nTo customize the target application server for the application, update the `targetApplicationServer` field. \n\n applications:\n - path: app.war\n targetApplicationServer:\n profile: \u003cvar translate=\"no\"\u003ePROFILE\u003c/var\u003e\n version: \u003cvar translate=\"no\"\u003eVERSION\u003c/var\u003e\n edition: \u003cvar translate=\"no\"\u003eEDITION\u003c/var\u003e\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003ePROFILE\u003c/var\u003e: the WebSphere profile. Format: \\[Liberty\\|Traditional\\].\n- \u003cvar translate=\"no\"\u003eTARGET_VERSION\u003c/var\u003e: the WebSphere version.\n- \u003cvar translate=\"no\"\u003eTARGET_EDITION\u003c/var\u003e: the WebSphere edition. Format: \\[Base\\|Core\\|Open\\|ND\\].\n\n### Customize the target container\n\nTo customize the target container to be used for the application, update the `targetContainer` field. \n\n applications:\n - path: app.war\n targetContainer:\n baseImage: \u003cvar translate=\"no\"\u003eBASE_IMAGE\u003c/var\u003e\n home: \u003cvar translate=\"no\"\u003eHOME\u003c/var\u003e\n server: \u003cvar translate=\"no\"\u003eSERVER\u003c/var\u003e\n user: \u003cvar translate=\"no\"\u003eUSER\u003c/var\u003e\n group: \u003cvar translate=\"no\"\u003eGROUP\u003c/var\u003e\n\n### Customize Kubernetes secrets\n\nBy default, files listed under the `keystores` field are migrated to Kubernetes\nsecrets. To migrate these files as is, you can disable this feature. \n\n applications:\n - path: app.war\n resources:\n keystores:\n - key.p12\n targetContainer:\n # Do not migrate keystores to Kubernetes secrets:\n enableSecrets: false\n\n### Customize Kubernetes ports\n\nTo control which ports are exposed by Kubernetes Pods and Services, update the `ports` field. \n\n applications:\n - path: app.war\n targetContainer:\n ports:\n # Exclude http-tcp-9080:\n # - name: http-tcp-9080\n # port: 9080\n # protocol: TCP\n # Include https-tcp-9443:\n - name: https-tcp-9443\n port: 9443\n protocol: TCP\n\nWhat's next\n-----------\n\n- Learn how to [execute the migration](../execute-the-migration-plan)."]]