Configuring the web server
Your web server needs to be configured to use OECGI4. The types of settings required differ from web server to web server. Below are the settings for three of the more common web servers, IIS v7.x, IIS v8.x and Apache.
Configuring IIS on Windows 7, Windows 8 & Windows 10
By default, IIS does not install support for CGI gateways. You need to specifically add this feature using the “Turn Windows Features on and off” option in the Windows Control Panel.
Step 1 – Turn on World Wide Web Services CGI Feature
Figure 2 - Enabling CGI extensions on IIS
Navigate to the Internet Information Services Options, click on it to expand the options, then click on World Wide Web Services, Application Development Features, and put a tick next to CGI, ISAPI Extensions and ISAPI Filters. To save the changes click the OK button.
Once you have installed support for CGI, you can then open the Internet Information Services (IIS) Manager console. Right Click on My Computer and select Manage. You will find the Internet Information Services (IIS) Manager under the Services and Applications section.
Figure 3 - Accessing the Internet Information Services (IIS) Manager console on Windows Windows 7, Windows 8 & Windows 10
Check that the CGI module has been successfully added to IIS. There should be a CGI option in the list of configuration items for the IIS server.
Figure 4 - Confirming CGI support is installed in IIS
If the CGI option is not displayed, then please go back and install CGI support using the “Turn Windows Features on and off” option as detailed above.
Step 2 – Register OECGI4 with IIS as a valid extension
Next you need to register OECGI4 as a valid CGI extension. To do this click on the ISAPI and CGI Restrictions option in the web server Home window.
Figure 5 - ISAPI and CGI restrictions settings
To add the settings for OECGI4 click on the Add link on the right side of the window.
Figure 6 - Adding OECGI4 settings to IIS
This will display the following window. Complete the values as set out below and click OK. Please ensure that you check the “Allow extension path to execute” check box.
Figure 7 - Adding OECG4 settings to IIS
You should now see OECGI4 in the list of known CGI extensions.
Figure 8 - OECGI4 is now added as a valid CGI extension.
Step 3 – Add a Virtual Directory to OECGI4.EXE
A virtual directory is a friendly name, or alias, for a physical directory on your server hard drive. You need to create a virtual directory to the c:\Revsoft\OInsight\o4w directory where OECGI4.EXE is located.
Figure 9 - Adding a Virtual Directory to IIS
Add the following settings to the Add Virtual Directory Window.
Figure 10 - Virtual Directory Window
Step 4 - Updating the Security access rights for OECGI4
Go to the newly added virtual directory home page by clicking on the name of the virtual directory in the connections list on the left of the console. Then select the Handler Mappings option from the list.
Figure 11 - Adjusting Security settings for OECGI4 on IIS
This will open the Handler Mappings options. To add the required values for OECGI4 click on the Add Script Map link under Actions on the right side of the window.
Figure 12 - Adding security settings for OECGI4
This will open the Add Script map window. Complete the values as below.
Figure 13 - Adding the Security settings for OECGI4
You need to click on the Request Restrictions push button to add in some extra values. This will display the Request Restrictions window. Go to the Access tab and select the Execute option. Then click Ok to close this window.
Figure 14 - Adding the Execute Option for OECIG4
Then click OK to save and close the Add Script map Window. A message may appear like the one below. Click the Yes button
Figure 15 - Confirming the OECGI4 security settings.
OECGI4 should now appear in the list of enabled handler Mappings
If, for some reason OECGI4 appears in the disabled list rather than the enabled list, simply right click on OECGI4 and select Edit Feature Permissions.
Figure 16 - Enabling OECGI4 if it's in the disabled list
Figure 17 - Selecting the Edit Feature Permissions option
Make sure that you tick the Execute option then click OK.
Figure 18 - enabling the Execute option
OECGI4 should now appear in the Enabled list.
This completes the setup steps for IIS. To create additional virtual directories, simply repeat steps 3 and 4, above.
Configuring IIS on Windows Server 2008 & Server 2012
By default, IIS does not install support for CGI gateways. You need to specifically add this feature using the Server Manager. Open the Server Manager, click on “Roles” and then click on “Add Roles”
Step 1 – Turn on World Wide Web Services CGI Feature
Figure 19 - Enabling CGI extensions on IIS
Navigate to the Web Server (IIS), click on it to expand the options, then click on Web Server, Application Development, and put a tick next to CGI, ISAPI Extensions and ISAPI Filters. To save the changes click the Install button.
Once you have installed support for CGI, you can then open the Internet Information Services (IIS) Manager console. Right Click on This PC and select Manage. You will find the Internet Information Services (IIS) Manager under the Tools section of Server Manager.
Figure 20 – Starting Internet Information Services (IIS) Manager
Figure 21 - Accessing the Internet Information Services (IIS) Manager console on Windows Server 2008 & Windows Server 2012
Check that the CGI module has been successfully added to IIS. There should be a CGI option in the list of configuration items for the IIS server.
Figure 22 - Confirming CGI support is installed in IIS
If the CGI option is not displayed, then please go back and install CGI support using the “Turn Windows Features on and off” option as detailed above.
Step 2 – Register OECGI4 with IIS as a valid extension
Next you need to register OECGI4 as a valid CGI extension. To do this click on the ISAPI and CGI Restrictions option in the web server Home window.
Figure 23 - ISAPI and CGI restrictions settings
To add the settings for OECGI4 click on the Add link on the right side of the window.
Figure 24 - Adding OECGI4 settings to IIS
This will display the following window. Complete the values as set out below and click OK. Please ensure that you check the “Allow extension path to execute” check box.
Figure 25 - Adding OECG4 settings to IIS
You should now see OECGI4 in the list of known CGI extensions.
Figure 26 - OECGI4 is now added as a valid CGI extension.
Step 3 – Add a Virtual Directory to OECGI4.EXE
A virtual directory is a friendly name, or alias, for a physical directory on your server hard drive. You need to create a virtual directory to the c:\Revsoft\OInsight\o4w directory where OECGI4.EXE is located.
Figure 27 - Adding a Virtual Directory to IIS
Add the following settings to the Add Virtual Directory Window.
Figure 28 - Virtual Directory Window
Step 4 - Updating the Security access rights for OECGI4
Go to the newly added virtual directory home page by clicking on the name of the virtual directory in the connections list on the left of the console. Then select the Handler Mappings option from the list.
Figure 29 - Adjusting Security settings for OECGI4 on IIS
This will open the Handler Mappings options. To add the required values for OECGI4 click on the Add Script Map link under Actions on the right side of the window.
Figure 30 - Adding security settings for OECGI4
This will open the Add Script map window. Complete the values as below.
Figure 31 - Adding the Security settings for OECGI4
You need to click on the Request Restrictions push button to add in some extra values. This will display the Request Restrictions window. Go to the Access tab and select the Execute option. Then click Ok to close this window.
Figure 32 - Adding the Execute Option for OECIG4
Then click OK to save and close the Add Script map Window. A message may appear like the one below. Click the Yes button
Figure 33 - Confirming the OECGI4 security settings.
OECGI4 should now appear in the list of enabled handler Mappings
If, for some reason OECGI4 appears in the disabled list rather than the enabled list, simply right click on OECGI4 and select Edit Feature Permissions.
Figure 34 - Enabling OECGI4 if it's in the disabled list
Figure 35 - Selecting the Edit Feature Permissions option
Make sure that you tick the Execute option then click OK.
Figure 36 - enabling the Execute option
OECGI4 should now appear in the Enabled list.
This completes the setup steps for IIS. To create additional virtual directories, simply repeat steps 3 and 4, above.