IBM Support

Password limitations exist for IBM Business Process Manager (BPM) when running specific batch commands during installation of process applications to an offline Process Server

Troubleshooting


Problem

In a Microsoft Windows environment, characters with special meaning to the Windows shell cannot be used in the password that is passed as parameter for offline application installation commands.

Symptom

When you run one of the following commands to install a process application to an offline server, you might receive a message in the command line that the "Installation state is missing":

  • executeProcessAppInstallationService.bat
  • importProcessAppPackage.bat
  • installProcessAppPackage.bat
  • migrateProcessAppGlobalData.bat
  • migrateProcessAppInstances.bat

As a result, the command fails. However, the command-line parameters have been used correctly and the log files do not show an error.

Cause

The percent sign (%) and the caret (^) have a special meaning in the Microsoft Windows shell and you cannot use escape characters to suppress it. When you use the previously listed batch commands, another batch script is called internally. Because of the special characters, one of the passed parameters is truncated and the "Installation state is missing" message occurs.

Environment

This issue has been observed in Microsoft Windows environments only.

Resolving The Problem

This issue is a limitation in the product batch scripts.

For other operating systems and other scripts, a similar behavior has not been observed.

In general, avoid using characters that have a special meaning to the operating system. However, in some cases you can escape the characters by using other characters when using the command line. For more information, see Entering passwords on the command line.



In a Microsoft Windows environment, you can use one of the following work arounds to successfully run the commands:
  • Do not use the percent sign (%) or the caret (^) in the password for running the offline installation utility.
  • Use the equivalent wsadmin commands to install the process application on the offline server

Note: For IBM Business Process Manager V8.0 and later releases, the commands that can cause the described problem are deprecated. Instead, use the BPMCreateOfflinePackage, BPMExtractOfflinePackage, and BPMInstallOfflinePackage commands. You can find more details in the product documentation.

[{"Product":{"code":"SSFTN5","label":"IBM Business Process Manager Advanced"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Application Deployment","Platform":[{"code":"PF033","label":"Windows"}],"Version":"7.5.1;7.5","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSFTDH","label":"IBM Business Process Manager Standard"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Application Deployment","Platform":[{"code":"PF033","label":"Windows"}],"Version":"7.5.1;7.5","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSFTBX","label":"IBM Business Process Manager Express"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Application Deployment","Platform":[{"code":"PF033","label":"Windows"}],"Version":"7.5.1;7.5","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Product Synonym

BPM

Document Information

Modified date:
15 June 2018

UID

swg21592494