IBM Support

A version-to-version migrated environment does not work if the target WebSphere Process Server (WPS) is installed under a subdirectory of the source WebSphere Process Server installed directory

Troubleshooting


Problem

Version-to-version migration fails with an InvalidExecutableException and PROC0004E error if you try to migrate WebSphere Process Server when it is installed under a previous version of WebSphere Process Server.

Symptom

After you migrate, the Deployment manager fails to start with the following exception:

Program exiting with error:
com.ibm.ws.process.exception.InvalidExecutableException: PROC0004E:
Executable: [/usr/IBM/WebSphere/ProcServer/ProcServer/java/bin/java]
does not appear to be a valid executable.  Process could not be  created.com.ibm.ws.process.UnixProcessImpl.create(UnixProcessImpl.java:159)
com.ibm.ws.process.ProcessFactory.create(ProcessFactory.java:69)
com.ibm.ws.management.launcher.ProcessLauncher.launch(ProcessLauncher.java: com.ibm.ws.management.launcher.LaunchCommand.launchProcess(LaunchCommand.java:248)
com.ibm.ws.management.tools.WsServerLauncher.runTool(WsServerLauncher.java:309)
com.ibm.ws.management.tools.AdminTool.executeUtility(AdminTool.java:264) com.ibm.ws.management.tools.WsServerLauncher.main(WsServerLauncher.java:120)              at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:79
sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
java.lang.reflect.Method.invoke(Method.java:618)
at com.ibm.ws.bootstrap.WSLauncher.main(WSLauncher.java:263)


Note:
You will also see additional file structures created during the migration under the following directory structure:

/usr/IBM/WebSphere/ProcServer/ProcServer/   where "/usr/IBM/WebSphere/ProcServer/" is the "WAS_INSTALL_ROOT" for the migrating profile.

Cause

Migrating WebSphere Process Server when the target WebSphere Process server is installed under a subdirectory of the source WebSphere Process Server does not work. Example of unsupported directory structure:

WebSphere Process Server V6.1 is installed under the  /usr/IBM/WebSphere/ directory

WebSphere Process Server V7.0 is installed under the /usr/IBM/WebSphere/ProcServer7/ directory.

Attempting version-to-version profile migration from WebSphere Process Server when the V-Next directory structure string has the same sub-String as the "WAS_INSTALL_ROOT" variable of the V-Previous WebSphere Process Server installation.

Resolving The Problem

Installing a new WebSphere Process Server product under an existing WebSphere Process Server is not supported. Instead, install the new version of the WebSphere Process Server in a new directory and complete the migration process. For example:

WebSphere Process Server V6.1 installed under the "WAS_INSTALL_ROOT"=/usr/IBM/WebSphere/ directory uses a new directory structure that does not contain "/usr/IBM/WebSphere/". You can use /usr/IBM/WebSphere70/ProcServer for the new installation.

The following sample directory structure is not a supported combination:

V-previous version is installed under the /usr/IBM/WebSphere/ directory.

V-Next version is installed under the /usr/IBM/WebSphere/ProcServer7 directory.

The following sample directory structure is supported:

Combination 1:

V-previous version is installed under the /usr/IBM/WebSphere/ProcServer directory.

V-Nest version is installed under the /usr/IBM/WebSphere/ProcServer7 directory.

Combination 2:

V-previous version is installed under the /usr/IBM/WebSphere/ directory.

V-Next version is installed under the /usr/IBM/WebSphere7 directory.

[{"Product":{"code":"SSQH9M","label":"WebSphere Process Server"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Migration","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF012","label":"IBM i"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"},{"code":"PF035","label":"z\/OS"}],"Version":"7.0;6.1.2;6.1","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Product Synonym

WPS

Document Information

Modified date:
15 June 2018

UID

swg21429402