14.1.4 IIS Integration Utility (on Windows)

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

Reasons to Integrate Management and Security Server with IIS

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

  • take advantage of the IIS Single Sign-on (SSO) functionality, such as authentication to the Administrative Console and to the HTML Assigned Sessions list.

  • 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 servlet runner certificate is ignored. Although the servlet runner certificate is not used after IIS integration, it is recommended that you do not delete that certificate. Once integrated with IIS, the expiration status of the servlet runner certificate does not affect the Management and Security Server installation.

When to integrate:

  • You can run the IIS Integration Utility even if you did not integrate IIS when you installed Management and Security Server.

  • If a previous IIS integration existed when you ran the Initial or Upgrade configuration utility, the integration may be affected. Use the IIS Integration Utility to remove the existing integration and perform IIS integration again.

Running the IIS Integration Utility:

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

  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.