Install/configure IIS 8.5, CGI and Metabase Components for Windows Server 2012-2019 for use with CA Service Desk Manager
Article ID: 31703
Updated On:
Products
Issue/Introduction
When installing or configuring CA Service Desk Manager (CA SDM) in a Windows 2012 - 2019 environment, one may encounter a problem in trying to select any of the webengine options that include IIS.
For example, in the following graphic, one can access the Config Type in pdm_configure, but only choose "Tomcat Server only" and none of the IIS options:
By default, Windows 2012 - 2019 does not include IIS 8.5 and it needs to be installed and configured to include the CGI and Metabase components. This document discusses how to setup IIS 8.5 so that one can have CA SDM work with IIS as an available webengine.
Environment
Service Desk Manager 14.1 and 17.x
All Supported Windows Operating Systems
Resolution
Note: These instructions require you to login as a local system administrator to the Windows 2012 - 2019 server and assume that IIS is not installed at all.
The following instructions may also require the following:
- Assistance from a Network or Systems Administrator
- Windows 2012 Server Install Media
- A full recycle of the Windows Server
1. On the Windows 2012 Server, go into the Administrative Tools (Control Panel -> System and Security) and access "Server Manager"
2. Once in Server Manager, choose "Add roles and features".
3. In the "Add Roles and Features Wizard", click "Next" and answer any questions regarding your environment with the defaults. Make sure you are configuring for updates on your local system. Continue until you reach "Server Roles".
4. Once you reach "Server Roles", click on "Web Server (IIS)" and check it ON, then click Next.
5. You will receive a message advising to "Add features that are required for Web Server (IIS)". Make sure "Include management tools (if applicable)" is checked ON, then click "Add Features".
6. Continue through the wizard and answer any questions regarding your environment with the defaults. Continue until you reach "Web Server Role (IIS) -> Role Services."
7. Check on the following: "Management Tools", "IIS Management Console", "IIS 6 Management Compatibility", "IIS 6 Metabase Compatibility".
8. Just above, select "Application Development"
9. Scroll down and select/open "Web Server (IIS)" and install "Application Development" and "CGI"
10. Continue through the wizard, until you reach the "Confirmation" page. Make sure you have chosen the checkbox "Restart the destination server automatically if required". Also, make sure you are able to perform a recycle at this time. Click "Install"
12. Once the IIS 8.5 component is installed, and the CGI and Metabase components are included, go into the Internet Information Services (IIS) Manager (under Administrative Tools).
13. Drill down on the left-hand side of the window to access "Default Web Site", then choose "Header Mappings" on the right-hand side of the window.
14. CGI-exe is disabled by default. Right click on CGI-exe and select "Edit Feature Permissions"
15. For the "Execute" checkbox, check it as ON, then hit "OK" to enable CGI-exe.
16. Recycle IIS.
17. You should now be able to access pdm_configure and select IIS as a choice for the web interface.
Additional Information
If after the above changes are made, IIS based configurations remain inaccessible, run "pdm_configure -z" and review the configure.log in SDM Server's log directory.
The pdm_configure command tests for the presence of IIS by running a powershell script:
12/03 21:23:47.316 DEBUG IISHelper.java 566 Executing PowerShell Command "'powershell.exe (Get-WindowsFeature Web-Server).InstallState'"
12/03 21:23:50.875 DEBUG IISHelper.java 598 Installed
12/03 21:23:50.875 DEBUG IISHelper.java 566 Executing PowerShell Command "'powershell.exe Get-Module -ListAvailable -Name WebAdministration | select Name | ft -HideTableHeaders'"
12/03 21:23:52.032 DEBUG IISHelper.java 598 WebAdministration
12/03 21:23:52.032 DEBUG IISHelper.java 566 Executing PowerShell Command "'powershell.exe Get-WebSite | select name | ft -HideTableHeaders'"
12/03 21:23:55.189 DEBUG IISHelper.java 598 Default Web Site
If Powershell is blocked in some way due to local permissions and cannot run the above commands, this will also prevent pdm_configure from selecting an IIS based web site config. There may be an error reported as a result in configure.log pointing out the fault with powershell.exe.
It is recommended to run the SDM installer or pdm_configure as an admin user with permission to access Powershell. Any controls over the local Windows server's group policy are the purview of the local server admin teams and outside the scope of Broadcom Support.
Feedback
