Chapter 5: Errors and Notes

Error Message or DescriptionExplanation and Resolution
Link Error: Bad Location

Selecting F1 Help a second time when the initial F1 selection has not yet opened the help will result in multiple help windows. Repeated F1 selections will result in a "Link Error:Bad Location" message each time the help is called.

Error: Sorry...the page you are looking for could not be found.

This error indicates that a link in the documentation points to a file that does not exist. Reinstalling the help may correct this problem, as the missing file will be copied to its proper installation location.

Error Opening Viewer

This error indicates that a problem occurred when attempting to load all data required to open the help. This error is most often caused by a "file not found" exception (i.e., the viewer cannot find the start page).

Check to make sure the required directories exist:

Program Files\ANSYS Inc\V182\commonfiles\help\ (Windows)

/ansys_inc/v182commonfiles/help/ (Linux)

Make sure that the following files are in the \commonfiles\help\ folder:

  • helpmap_config.xml

  • at least one HelpMap*.xml file (HelpMap.xml, HelpMapCFDPost.xml, etc.)

Make sure that the following files and folders are listed in the \en-us folder:

  • 404.html

  • customHelp.html

  • introduction.html

  • helpNotInstalled.html

  • searchHelp.html

  • toc_config.xml

  • synonyms.dat

  • \AutoCompleteIndex

  • \LuceneIndex

  • \SpellCheckIndex

If any of these files are not listed, re-install the client ANSYS, Inc. product. If, after a reinstallation, the files are still not listed, contact ANSYS customer support.

Unable to Find Open Port

This error indicates that all ports within the range specified (50000-50019) are currently being used and are busy.

Close and restart the client program.

If this error persists, contact a system administrator. A system administrator will be able to determine if there are any firewall or gateway blockages preventing ports from being utilized.

Error Communicating with Client

This error is caused when a connection is successfully made with a client program, but communication between the client and the help server is disrupted. A possible cause for this problem could be a loss of network connectivity between the client program and the server machine running the help.

If the help is running on the same physical machine as the client program, a communication error could be caused by faults or illegal operations performed by the client program. To correct this problem, close Help and restart the client program. If restarting the client program does not result in proper communication, try restarting the system running the help server.

If problems persist, check port allowances. Consult a system administrator for more information on making allowances for the port or port range being used by help. By default, the help uses a port range of 50,000 to 50,019.

Misunderstood Command Error

Client programs must adhere to a strict syntax for commands being sent to the help system. If a client program deviates from this specification, the help server is unable to interpret instructions and returns a "Misunderstood Command" Error.

One cause for this error includes faults in the client program (e.g., the program performs an illegal operation and sends invalid signals to the Help server). To correct this problem, restart the client program.

This error could also be caused by extraneous or unintended accessing of the port (e.g., unlawful connections to the help system by third-party or unauthorized client programs).

If this problem is chronic, extraneous connections may be the cause. Extraneous connections can be prevented by closing the help system and all client products connected to it, changing the help port range (see Unable to Find Open Port), and restarting the help system and client program.

If the error continues to occur after changing the port range and restarting, contact a system administrator to report anomalous network behavior. Port connections can be controlled using gateways and/or network firewalls.

File Not Found ErrorThis error results when a help file being referenced does not exist or is not placed in its proper location. To correct this problem, re-install the help system. The help program is installed automatically by the ANSYS, Inc. installation process. Reinstalling one or more ANSYS, Inc. products will reinstall the help.
Error Parsing the HelpMap.xml FileThis error results if HelpMap*.xml files do not exist on the system running help or are not located properly. Please check if the file exists in Program Files\ANSYS Inc\V182\commonfiles\help\ on Windows or /ansys_inc/v182commonfiles/help/ on Linux machines. To fix this problem, re-install the help system by re-installing the applicable client program. The re-installation should restore a valid, uncorrupted copy of the HelpMap*.xml files.
Error Disconnecting from ClientThis error may occur when closing a client program while using the help server. This error is non-catastrophic, as the closing of the help server continues and does not affect the system at large. This error may be indicative, however, of larger network difficulties. Contact a system administrator to report anomalous network behavior.
Connection Errors

Connection errors are most common in systems requiring cross-network communication between a client program (for example, ANSYS Workbench) and the server (in this case, the help). Systems where the help is hosted by a dedicated machine separate from and external to the machine running the client program can often be blocked by gateway or firewall settings.

To prevent connection problems, contact a system administrator to make sure that the necessary ports are unblocked. By default, the help attempts to connect using a port within the range of 50,000 to 50,019.

A system administrator may require the port range to be changed in order to comply with gateway/firewall restrictions.

Printing Directly from the Help ViewerAlthough you can print individual help pages from the viewer, the text may not wrap if an image on the page is wider than the print area your printer allows. For that reason, if you need to print help text, we recommend that you download the corresponding document from the ANSYS Customer Portal.
Missing Help FilesIf this message appears, it is because the help files have not been included in the current install. This could be caused by a bad install. Try reinstalling any ANSYS, Inc. product to reinstall the help files.
No Search IndexThe entire help set is indexed to locate search terms. If the index was not installed, the search is disabled. The only solution is to reinstall any of the products to reinstall the help.
Error Connecting to Client/ Error Creating a Reading Connection with Client

This error indicates that a client program unsuccessfully attempted to make a connection to the help server. This error can result from the client program failing or returning an error code or from the client program attempting to re-connect after it had already established a proper connection.

To fix this error, restart the client program. If after a restart of the client program, a connection cannot be made properly, restart the machine running the help. A restart will reset all socket connections and listening ports.

This error could also be caused by blockages from firewalls or gateways. Contact a system administrator to determine if a firewall port exception is required.


Release 18.2 - © ANSYS, Inc. All rights reserved.