11.1. Installation Troubleshooting

This section lists problems and error messages that you may encounter while installing and/or running ANSYS, Inc. products. After each situation description or error message is the user action required to correct the problem.

You can also find answers to commonly-asked questions on our customer portal. After you log in to the customer portal, select Knowledge Resources> Solutions.

For information on licensing-related errors, see the Troubleshooting section of the ANSYS Licensing Guide.

11.1.1. Using ANSLIC_ADMIN to Gather Diagnostic Information

There are situations which require licensing-related information to be gathered for diagnostic and troubleshooting purposes. At times it may be necessary to provide this information to technical support.

The client-related diagnostic information can be gathered by using the Client ANSLIC_ADMIN utility. For more information, see, Gather Client Diagnostic Information in the License Administration Using ANSLIC_ADMIN section of the ANSYS Licensing Guide.

The server-related diagnostic information can be gathered by using ANSYS License Management Center or by using the standalone gatherdiagnostics script. For more information, see, Gathering Diagnostic Information in the License Server Administration Using ANSYS License Management Center section of the ANSYS Licensing Guide.

You can also use the AnsysInstallationDiagnostics.exe, in the \v182\instutil directory, for additional installation diagnostics. This tool is helpful to diagnose installation and runtime issues. One or more log files will be generated either at the same location as the tool or in your temporary directory, depending on directory permissions. The log files are intended to help ANSYS, Inc. technical support personnel expedite any technical issues. It would be useful to have the files ready to provide before contacting Technical Support.

11.1.2. Uninstall Gives Access Denied Error Message

If you run the uninstall utility as a non-administrative user, you may get access denied error messages when removing product components. Run the uninstall as an administrative user, and close all applications before running the uninstall.

11.1.3. Uninstall on a Windows 7, Windows 8.1 or Windows 10 System Gives Compatibility Error Message

If you uninstall an ANSYS, Inc. product on a Windows 7, Windows 8.1 or Windows 10 system using the ANSYS, Inc. Uninstall utility, you may see the following error message:

This program might not have installed correctly.

If this program didn't install correctly, try reinstalling using settings that are compatible with this version of Windows.

This message is caused by the Windows Program Compatibility Assistant and can safely be ignored. Click Cancel and continue with the uninstall.

11.1.4. A .chm File Does Not Display Properly Across a Network

Help system .chm files may not display topics correctly when you try to use a Universal Naming Convention (UNC) path to open the file on a network shared folder, typical with a Network Configuration install. This is a known issue with security update 896358, security update 840315, or Microsoft Windows Server 2003 Service Pack 1 (SP1). Go to http://support.microsoft.com/kb/896358 and http://support.microsoft.com/kb/896054 for more information on this problem and Microsoft's recommended fix.

If you are running ICEM CFD over the network and you have applied this security update, you may not be able to access ICEM CFD Help using the Help menu. To access ICEM CFD Help, navigate to commonfiles\help\en-us in the installation directory on the server machine and copy the file icemcfd_help.chm to your local machine. Double-click the local copy to view the help.

11.1.5. Products Crash with an Application Error

On Windows Server 2008 systems, ANSYS applications may crash with an application error if the DEP (Data Execution Prevention) flag is set. To check your DEP setting, right mouse click My Computer, and select Properties. Select the Advanced tab, and under Performance, click Settings. Then select the Data Execution Prevention tab.

If DEP is set, you will need to add ANSYS to the list of exceptions. For more information on DEP and how to change the settings, see http://support.microsoft.com/kb/875351.

11.1.6. Product Installation Does Not Create Start Menu Item for ANSYS and CAD Plugins Do Not Work

On a Windows 7, Windows 8.1 or Windows 10 system, if you install ANSYS, Inc. products but do not see a Start Menu/Apps item and your CAD plugins do not work, the TEMP environment variable may be pointing to an inaccessible location. For example, it may point to a location such as %USERPROFILE%\Local Settings\Temp. As a result, the product installation could end without configuring the product correctly. You should ensure that the TEMP variable points to a valid location, such as %USERPROFILE%\AppData\Local\Temp.

11.1.7. Product Installation Displays Security Warning Dialogs or Silent Product Installation Hangs on a Network Install

If you see a security warning dialog box during a GUI installation/product configuration, or if your installation hangs during a silent installation, you may need to modify your security settings. Set the machine you are installing from as a trusted site and allow launching of unsafe applications so that the prerequisite installation can complete. Then re-run the installation. Contact your system administrator or refer to your operating system documentation for details on modifying security settings.

Alternatively, you can run the prerequisite check to verify that you have all the necessary prerequisites. If necessary, install any prerequisites and rerun the installation:

  1. Run PreReqCheck.exe from the top level directory.

  2. Install any missing prerequisites by running InstallPreReqs.exe from the top level directory as an administrator.

  3. When the prerequisites have finished installing, run the installation as you normally would (GUI or silently).

11.1.8. System-related Error Messages

***Error, ANSYS182_DIR environment variable is not set. This is a fatal error – exiting.

This message indicates that the ANSYS182_DIR environment variable was not set where necessary for licensing. This environment variable should be set to the installation directory.

Unexpected error: Request for the permission of type ... failed.

If you encounter this type of message on a server configuration, you may need to set the machine as a trusted site. On a Windows 7, Windows 8.1 or Windows 10 machine, in the Control Panel, select Network and Internet, select Internet Options, and select Security. Click Trusted Sites and click Sites. Add the machine as file://servername.

11.1.9. CasPol Error Messages

ERROR: Not enough arguments, no permission set specified

If you are configuring to a server with spaces in the path and get this error, then you must put quotes around your server specification as shown in the following example:

C:\Users\>C:\Windows\Microsoft.NET\Framework\v2.0.50727\CasPol.exe -m -a
g 1.2 -url file://"\\machineabc\ANSYS Inc\*" FullTrust

11.1.10. Installing Prerequisites May Require a System Restart

The installation program checks your system to determine if you have the necessary prerequisites. If the prerequisites are not already on your system, the prerequisites will be installed automatically. In some cases, a system restart may be required after exiting the installation and before using any ANSYS Products.

If a system restart is required, a restart error message will be written to the install.err error file. The install.err error file is located in the installation directory.


Note:  Microsoft .NET Framework 4.6.2 is now required for running ANSYS products. If your installation computer does not have .NET 4.6.2 installed, the ANSYS installation program will install .NET 4.6.2 as a prerequisite and may require a system restart after exiting the installation and before running any ANSYS products.


11.1.11. Confirmation Messages Open Behind the Installer Display in Windows

Because of a known issue in Windows, confirmation messages displayed by the ANSYS Installer occasionally open behind the installer display. In such a case, a pulsing task bar icon is the only visible notification that a confirmation message is open. Manually bring the confirmation message to the foreground. Accept the message and continue the installation process.


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