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 wsadmin.sh script. The MachinePlan_localhost.log will show failure as below immediately after running this script.
[echo] /e00/app/tws/zcon/eWAS/bin/wsadmin.sh -lang jython -profileName TIPProfile -username xxxx -password xxxx -f /e00/app/tws/zcon/eWAS/profiles/TIPProfile/bin/propagateTIPRoles.py
com.ibm.ac.coi.api.exception.WrappedException: An exception was received during the processing of MachinePlan: localhost. See the Exception Stack Trace for more information.
Caused by: com.ibm.ac.coi.api.exception.WrappedException: 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.
wsadmin.sh -lang jython -profileName TIPProfile -username xxxx -password xxxx -f TIPHOME/profiles/TIPProfile/bin/propagateTIPRoles.py
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.