Troubleshooting product installation

If the installation of Product Master fails, you can try performing the following debug steps.

Error messages in the IBM Installation Manager or installation logs

Symptoms
After the installation is complete, you can see error messages in IBM® Installation Manager on the Installation Complete window. You might also see errors in the installation logs.
Resolving the problem
  1. Review the messages in the installation log files to diagnose and correct individual error conditions.
  2. For DB2® or application server problems, use their tools to diagnose and correct individual error conditions.
  3. Rerun IBM Installation Manager to reinstall Product Master.

Issue: Configuring the default_locale parameter to ensure that users can log in successfully

When installing Product Master, version 6.0.0 or later, you might have login problems and receive an error after importing a database memory dump into a different environment.

The following errors might occur after importing the database memory dump:
In the user interface
WPC - Error
AUS-20-014 Invalid username/password/company code.
In the $TOP/logs/<Appserver_hostname>/exception.log file
2009-05-19 07:35:14,651 [jsp_2: enterLogin.jsp] ERROR
com.ibm.ccd.common.error.AustinException - Could not find
lookup table
with name: Propriétés LDAP, Exception:Could not find
lookup table
with name: Propriétés LDAP

One possible reason that users cannot log in to Product Master is that the value of the default_locale parameter is configured incorrectly. For example, if the default_locale parameter is set to a certain value, and then a database memory dump export was taken, the default_locale value in the environment where the memory dump is going to be imported should be set to the same value as the parameter value in the exported environment. That is, if the default_locale parameter was set to fr_FR in the exported environment, it should be set to fr_FR in the imported environment. If the values are not the same, users will not be able to log in to the system.

Issue: Product Master AppServer might not start, or install_war.sh can fail with "arg list too long" error

When installing Product Master, Version 6.0.0 or later, the following error might occur:


/bin/go/init_svc_vars.sh: line 21: /usr/bin/mkdir:
The parameter or environment lists are too long.

/bin/read_config_file.sh: line 34: /usr/bin/awk:
The parameter or environment lists are too long.

If the ncargs parameter on AIX® is not set to a high enough value, the install_war.sh installation script might fail with the error message "arg list too long". This problem might also cause the application server to fail.

The AIX default for the ncargs parameter is set to 6 * 4k.

Since the product needs a long list of arguments to install and run correctly, this parameter might not specify enough memory to run the install_war.sh script or to start the product.

To resolve the problem, the AIX administrator must increase the size of the ncargs parameter, by issuing the following command:

chdev -l sys0 -a ncargs=NewValue
where NewValue is the number of 4k blocks to be allocated for the argument list. You can specify a number between 6 (which is the default value) and 128. You can review the current setting by issuing the following command:
lsattr -E -l sys0 -a ncargs
You can also change the value of the ncargs parameter (and view additional information) by using the smit or smitty AIX configuration commands. For more information, see the AIX older versions.