IBM Support

Tivoli Integrated Portal special characters in password for tipadmin user

Technote (troubleshooting)


If password for tipadmin user contains special characters (such as ~, @, #, $, %, ^, &, *, ( , ), \ etc.)Tivoli Integrated Portal install/upgrade will fail.


The IA log may show that installation fails right after executing script. The MachinePlan_localhost.log will show failure as below immediately after running this script.

 [echo] /e00/app/tws/zcon/eWAS/bin/ -lang jython -profileName TIPProfile -username xxxx -password xxxx -f /e00/app/tws/zcon/eWAS/profiles/TIPProfile/bin/ An exception was received during the processing of MachinePlan: localhost. See the Exception Stack Trace for more information.
Caused by: The ANT ant task failed. BaseDir = /e00/app/tws/zcon/eWAS/_uninst/TIPInstall22/plan/install/MachinePlan_localhost AntFile = MachinePlan_localhost.xml


An APAR PM68935 has been opened to document this limitation.

Diagnosing the problem

You can try to run below script on the command line and see if you get any errors. Replace user name, password and TIP home with actual values. -lang jython -profileName TIPProfile -username xxxx -password xxxx -f TIPHOME/profiles/TIPProfile/bin/

Resolving the problem

To resolve this issue please change the password for tipadmin user so that it only contains alphabet and numbers. You can reset the password to have special characters after the upgrade is completed.

The special characters can not be escaped using back slash (\) or any other characters as work around (For example; you can write \$ to represent $ in the password). The only work around for this issue is to remove special characters from the password before performing installation.

Document information

More support for: Tivoli Components

Software version: 1.1.1, 2.1, 2.2

Operating system(s): AIX, Linux, Solaris, Windows, z/OS

Reference #: 1605483

Modified date: 27 July 2016

Translate this page: