Troubleshooting the installation

Known installation errors

• Validation error post upgrade from V2.5.0.5 HTTP to V2.5.0.6 HTTPS keystone topology

  When you perform any action on the region or clone a virtual machine for the first time after you upgrade from V2.5.0.5 HTTP to V2.5.0.6 HTTPS keystone topology, the following error might get displayed:

  Region validation failed, hostname or credentials might be wrong. If you do not want this region, please delete it using delete region action.

  Ignore this error message and click OK to save the region.
• The SIMPLE_TOKEN_SECRET and OPENSTACK_SERVICES prerequisites might fail whenever the operating system is below RHEL 7.3.
  Do the following steps to resolve the error:

  1. Verify whether all values are correct in the ico_install.rsp.
  2. Update python package version to 2.7.5-48.el7 if the python package is at a lower version.

• During installation, ignore the following error message that might get triggered because of Chef:

  Error : . warning: already initialized constant Chef::Recipe::Delete_Cert
  warning: previous definition of Delete_Cert was here

• Upgrade fails because of signer certificate issue

  The IBM® Cloud Orchestrator upgrade or installation command might fail because the CLI installation client is not able to connect to server process due to the signer certificate issue.

  As a workaround, manually run the command that fails and restart the upgrade without reverting the snapshots. Repeat this workaround for all failing commands.

• Cannot find 32-bit library files libstdc++.so.6 and /lib/libpam.so*
  If the 32-bit library files cannot be found on the 64-bit operating system platform, the db2prereqcheck.log file might contain errors similar to the following errors:

  Validating "32 bit version of "libstdc++.so.6" " ...
  
  Found the 64 bit "/usr/lib64/libstdc++.so.6" in the following directory "/usr/lib64".
  
  DBT3514W  The db2prereqcheck utility failed to find the following 32-bit library file: 
            "libstdc++.so.6".
  
  Validating "/lib/libpam.so*" ...
  
  DBT3514W  The db2prereqcheck utility failed to find the following 32-bit library file: 
            "/lib/libpam.so*".
  
  Validating "32 bit version of "libstdc++.so.6" " ...
  
  DBT3514W  The db2prereqcheck utility failed to find the following 32-bit library file: 
            "/lib/libpam.so*".
  
  WARNING : Requirement not matched.
  Requirement not matched for DB2 database "Server" . Version: "10.5.0.2".
  Summary of prerequisites that are not met on the current system:
  
  DBT3514W  The db2prereqcheck utility failed to find the following 32-bit library file: 
            "/lib/libpam.so*".

  The errors are not critical and can be ignored.
• The domain name that is specified in the IBM Cloud Orchestrator deployment parameter must match the domain name format that is used in cookies .

  Cookies that are used to implement user interface security features can be set only for domain names that are not top-level domain names and that adhere to the public suffix list.

  To resolve this problem, provide a domain name that matches the cookie requirements.