Invalid Characters on Windows - ibm-datapower/datapower-configuration-manager GitHub Wiki
The DataPower Configuration Manager (DCM), and therefore the plug-in, are based on an Ant-based command line interface. Ant version 1.9.9 does not correctly parse many characters ($, `, <, >, &, etc) on the Windows operating systems. For this reason, we suggest running commands and configuring IBM UrbanCode Agent's on Linux operating systems. Ant's start script for Linux contains the correct logic to account and escape for terminal specific syntax. The Ant start script for Windows does not contain this necessary escaping.
This issue most commonly presents itself in complex passwords or in Target files property of the Download Files (download-files
target) plug-in step. This issue can present itself in many different forms. For example:
- Password = ad<in: The system cannot find the file specified.
- Password = &admin: Missing value for property pwd 'admin' is not recognized as an internal or external command, operable program or batch file.
- Password = admin$: Unable to reach HOSTNAME or the userid/password doesn't work.
Special characters in files do not experience this issue. This error only pertains to characters on the command line.
DCM and plug-in users who do not expect to use special characters should be able to use a Windows Agent or terminal without problems.
In DataPower plug-in v15, we began adding double quotes to the password field. This will escape all special characters (except double quotes). This should be sufficient for most special character errors. If you find a similar error in another property, whether in the plug-in or DCM tool, try surrounding it in double or single quotes!