IBM Support

DataStage clients will not install if the machine name contains special characters.

Troubleshooting


Problem

The client installer will not proceed if it finds a problem with the machine name, although the reported error may not make this clear.

Symptom

The installer will throw an error during the Early Requirements Check along the following:

Description
The system must be able to resolve the host name correctly.

Status
FAILED: Ensure hostname is not set to "localhost" and does not contain _ (underscore) see: <link to WebSphere online documentation>

Resolution for failure
Your hostname is set to "localhost". Check the /etc/hosts (Unix) or %SystemRoot%\System32\drivers\etc\hosts file and ensure "loclalhost" is mapped to 127.0.0.1, not the networkIP address.

[{"Product":{"code":"SSVSEF","label":"IBM InfoSphere DataStage"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Component":"--","Platform":[{"code":"PF033","label":"Windows"}],"Version":"9.1;8.9;8.7;8.5;8.1;8.0","Edition":"","Line of Business":{"code":"LOB76","label":"Data Platform"}}]

Log InLog in to view more of this document

This document has the abstract of a technical article that is available to authorized users once you have logged on. Please use Log in button above to access the full document. After log in, if you do not have the right authorization for this document, there will be instructions on what to do next.

Document Information

Modified date:
25 April 2025

UID

swg21625697

Page Feedback