Skip to main content

Troubleshooting Web Server Setup

If you have installed a web server prior to installing InterSystems IRIS, then the InterSystems IRIS installation process will configure the web server automatically. This section provides some troubleshooting steps for addressing web server setup.

Documentation Links Not Working

If links to documentation within the Management Portal (or the Windows Launcher) are not working, you may need to redirect the documentation links. There are different steps for Apache and Microsoft IIS web servers.

Windows and IIS

VS Code Troubleshooting

Additional steps may be required to allow VS Code to connect with your InterSystems IRIS instance. See Configure IIS to Enable VS Code for details.

If VS Code works, but debugging does not, you may need to enable the WebSockets feature.

Restarting IIS

You must restart the IIS web server for some changes to take effect.. It is recommended that you restart your web server after making any changes to the web server or Web Gateway configurations, including after the installation process is completed. To restart the IIS web server:

  1. Using a Windows command line interface, run the following command to stop the web server:

    sc stop W3SVC
  2. After the web server stops, run the following command to start the web server again:

    sc start W3SVC

Repairing or Modifying Your Instance

You can initiate auto-configuration of the IIS web server after installation in the event it was skipped during the installation process. To do so, run an installation using the same executable file you originally used to install the instance. Choose to Repair or Modify depending on whether the CSP for IIS component was included in your initial installation:

If the CSP for IIS component was originally installed, but IIS was either not configured or the configuration was manually deleted, you can run a Repair to initiate auto-configuration of the IIS web server.


The only way to include the CSP for IIS component without auto-configuring your instance is to specify CSPSKIPIISCONFIG=1. This flag can only be specified for an unattended installation, or when executing the installation file from the command line. If you did not include this flag during your installation, you should not run a Repair. You can instead Modify the instance to initiate auto-configuration.

If CSP for IIS was not included in your original installation, you can Modify your installation and select the CSP for IIS component. This will cause the installer to initiate auto-configuration of the IIS web server.

In either case, after the installation finishes you should verify additional configuration steps in order for all features to work properly:

  1. To enable Management Portal access, set the CSPSystem account credentials for your instance within its server access profile. For details, see Step 6 of Automatic Configuration Behavior.

  2. To enable the Launcher links, you need to configure the following InterSystems IRIS Server Manager parameters:

    • Set Web Server Port to the port number your web server is using (80 by default).

    • Set CSP Server Instance to the lowercase version of your instance name (for example, iris).

FeedbackOpens in a new tab