Running the IIS Integration Utility

If Microsoft Internet Information Services (IIS) is installed on your computer, the automated installer detects IIS and asks if you want to integrate your installation with IIS. You will see this question even if you are upgrading from a previous version that was already integrated with IIS.

  • You can also run the IIS Integration Utility independently if you do not choose to integrate while installing the product.

  • Running a configuration utility (initial configuration or configuration upgrade) after you install and configure the product may affect the integration with IIS that was performed previously. If you see this condition, you must reintegrate with IIS.

    Use the IIS Integration Utility to remove the existing integration and perform IIS integration again. Follow the steps below to Integrate with IIS.

Reasons to Integrate Management and Security Server with IIS

By default, the Apache Tomcat web server is installed, so you do not need to integrate the product with IIS. However, you may choose to integrate Management and Security Server with IIS to be able to

  • take advantage of the IIS Single Sign-on (SSO) functionality.

  • use your existing web server certificates on IIS.

    NOTE:When integrated with the IIS web server, Management and Security Server uses IIS and the IIS-configured server certificate for HTTPS communication. The Apache Tomcat certificate is ignored. Although the Tomcat certificate is not used after IIS integration, it is recommended that you do not delete this certificate. Once integrated with IIS, the expiration status of the Tomcat certificate does not affect the Management and Security Server installation.

To integrate with IIS:

  1. Run the IIS Integration Utility (IISIntegrationUtility.exe) located in the [MssServerInstall]\utilities\bin folder.

  2. To integrate IIS with Management and Security Server, select a site and click Integrate.

  3. If you are prompted, confirm the installation directory (for example, C:\Program Files\Micro Focus\MSS) and click Yes.

  4. If you are prompted to install required IIS role services, click Yes. Installation of role services can take a few minutes.

  5. If you are prompted to restart the Administrative Server service, click Yes.

  6. On the Integration Completed message box, click Yes to exit.

  7. Restart the Administrative Server. This step is necessary only if you did not select the option to restart the MSS service.

    • If you installed the product as a Windows service, go to Control Panel > Administrative Tools > Services > Micro Focus MSS Server. Stop and restart the service.

    • You can also use the -stop and -start commands with MssServer.exe.

  8. Confirm that integration was successful by browsing to http://<serverName>[:port]/mss/AdminStart.html where <serverName> is the IP address or alias of your Microsoft Windows machine running the Administrative Server, for example: http://myserver.mycompany.com/mss/AdminStart.html

To change your settings or remove the integration, run the IIS integration utility again.