Ga naar hoofdinhoud

Technical Resources

Running on IIS​

Running Pimplus on IIS​

This article explains how to run Pim+ on IIS. It provides pictorial examples with each step to help you navigate the software's interface. By default, the user interface is accessed through a web server that is integrated right in PimPlus. The integrated web server makes for quick and easy deployment without the need to install and configure IIS.

However, there are certain times when you may prefer to access the PimPlus user interface through IIS and this is fully supported. Reasons to switch to IIS may include corporate policy or the need to use HTTPS/SSL to protect access to the console.

Step 1: Disable the Integrated Web Server​

  1. Go to the e.g. C:\Program Files\pimplus folder.
  2. Edit the file called config.ini using Notepad.
  3. Look for the section called [WebServer] followed by an entry called Enabled=1 and change it to Enabled=0.

Alt Text

If the Enabled line is not present in your config.ini file add it manually under the [WebServer] section.

  1. Restart the PimPlus service.

Step 2: Install IIS​

  1. Open Server Manager on your Windows server.
  2. Click on Add roles and features.
  3. In the wizard, select Role-based or feature-based installation and click Next.
  4. Select your server from the server pool and click Next.
  5. Under Server Roles, check the box for Web Server (IIS).
  6. Expand the Web Server (IIS) section, then expand Web Server > Application Development.
  7. Enable the option for ISAPI Extensions.
  8. Click Next and proceed through the wizard to install IIS and the selected features.
  9. When the installation is complete, close the wizard.

Step 3: Install a Self-Signed Certificate​

  1. Open the IIS Manager in the Administrative Tools section of the Control Panel.
  2. Select the top level item which has the same name as the local system.
  3. On the right-hand side double-click on the item called "Server Certificates".

Alt Text

  1. In the Actions menu on the very right-hand side select "Create Self-Signed Certificate".

Alt Text

  1. Enter a name for the certificate and press OK.
  2. Navigate to the "Default Web Site" item in the IIS Manager.
  3. Right-click on "Default Web Site" and select "Edit Bindings".
  4. Use the Add button to add an HTTPS binding on port 443 with your newly created certificate.
  5. When adding the HTTPS binding, turn on the option labeled "Disable HTTP/2"
  6. Use the Remove button to remove the HTTP binding on port 80 so that HTTPS/SSL is required to access the site.

Step 4 (Optional): Add the Application​

This step is only necessary if multiple sites are running in IIS or if the PIM+ API is being used.

  1. In the IIS Manager navigate to the "Default Web Site" site under the "Sites" folder.
  2. Right-click on "Default Web Site" and select "Add Application".

Alt Text

  1. For the alias specify "PimPlus".
  2. For the physical path enter e.g. C:\Program Files\pimplus\Html.
    • If you have installed PimPlus in a non-default location use that location instead.

Step 5: Configure Application Pool​

  1. Right-click on "DefaultAppPool" and choose "Advanced Settings".
  2. Verify "Enable 32-bit Applications" is set to "False" and press OK.

Alt Text

Step 6: Configure ISAPI​

  1. Open the IIS Manager.
  2. Select the server root node.
  3. On the right side, double-click "ISAPI and CGI Restrictions".
  4. If "FrameFlow Extension" is not listed, click Add... on the right-hand side.
    • For "ISAPI or CGI path" select: C:\Program Files\PIM\FrameFlowTokenExpander.dll
    • For the description enter: PIM+ Extension
    • Check the option Allow extension path to execute.
    • Press OK.
  5. If "FrameFlow Extension" is already listed, you can skip this step.

Alt Text

Step 7: Unlock Handlers​

  1. Open a command line window with Administrator access.
  2. Run the following command:
%windir%\system32\inetsrv\appcmd unlock config -section:system.webServer/handlers

Step 8: Verify HTTPS/SSL Access​

  1. Verify that you can access the user interface through HTTPS/SSL by visiting https://servername/pim.plus.
  2. Your web browser may warn about the self-signed certificate before allowing you to proceed.

Step 8: Update Remote Node Configurations​

  1. On each remote node, edit the file config.ini in the C:\Program Files\PimPlus folder.
  2. Edit the MasterNode value to start with https://.