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.
Related Information
Product Synonym
BPM
Was this topic helpful?
Document Information
Modified date:
15 June 2018
UID
swg21592494