Troubleshooting installation

Use this information to troubleshoot issues with your installation and updates.

Procedure

  • Problem: When you run the installation command from a remote computer, such as \\mymachine\downloads\, the following message displays: CMD.EXE was started with the above path as the current directory. UNC paths are not supported. Defaulting to Windows directory. As a result, the installation does not complete correctly.

    Solution: Map the remote computer to a network drive. For example, in Windows, you can right-click My computer and choose Map Network Drive and include the uniform naming conventions (UNC) path to the remote computer. You can then run the installation script from the network drive successfully, for example: y:\mymachine\downloads\WXS\install.bat.

  • Problem: The installation completes unsuccessfully.

    Solution: Check the log files to see where the installation failed. When the installation completes unsuccessfully, the logs are in the wxs_install_root/logs/wxs directory.

  • Problem: A catastrophic failure occurs during the installation.

    Solution: Check the log files to see where the installation failed. When the installation fails when it is partially completed, the logs can generally be found in the user_root/wxs_install_logs/ directory.

  • [Windows] Problem: If you are installing the WebSphere® eXtreme Scale Client on Windows, you might see the following text in the results of the installation:
    Success: The installation of the following product was successful: 
    WebSphere eXtreme Scale Client.  Some configuration steps have errors. 
    For more information, refer to the following log file:  
    <WebSphere Application Server install root>\logs\wxs_client\install\log.txt"  
    Review the installation log (log.txt) and review the deployment manager 
    augmentation log. 
    Solution: If you see a failure with the iscdeploy.sh file, you can ignore the error. This error does not cause any problems.
  • Problem:

    If you have a full installation and try to apply WebSphere eXtreme Scale Client only maintenance with the update installer, you see the following message:

    Prerequisite checking has failed. Click Back to select a different package, 
    or click Cancel to exit.
    
    Failure messages are:
    
    Required feature wxs.client.primary is not found.
    If you have WebSphere eXtreme Scale Client installed and try to apply a full maintenance package with the update installer, you see the following message:
    Prerequisite checking has failed. Click Back to select a different package, 
    or click Cancel to exit.
    
    Failure messages are:
    
    Required feature wxs.primary is not found.
    Solution: The maintenance package that you install must match the type of installation. Download and apply the maintenance package that applies to your installation type.
Parent topic: Troubleshooting
Related tasks:
Installing WebSphere eXtreme Scale Client
Using the Update Installer to install maintenance packages
Related reference:
Network ports
Related information:
Client properties file