How do I install OGC CGI Servers?

First create an instance for the required OGC service(s). Related Topics

TIP: Cadcorp recommend you create all four OGC instances even if they won’t be used immediately. This will save you uninstalling and re-installing the CGI web service at a later date.

Click View on your instance and select Maps > Properties to add SWDs or datasets.

In the SWD File Path, type in the path of the dataset or SWD to be served.

Check the tickbox for the OGC server type(s) through which the data is to be served, e.g. OGC Web Map Service. The selected dataset will be added to the instance.

Depending upon the presence of prerequisite software, which may or may not be already installed on your computer, you may be prompted to install required software.

IIS setting

If IIS is not enabled you may see a warning message. In this case refer to Microsoft documentation to enable IIS.

IIS 6 Compatibility

If IIS 7.0 or 7.5 is being used then IIS 6 Compatibility must be enabled.

1. In Windows click Start (bottom left of the screen) and select Control Panel.
2. Click Programs.
3. Under Programs and Features select Turn Windows features on or off.
   
4. The Windows Features dialog will be displayed:
5. Expand Internet Information Services > Web Management Tools and check the IIS 6 Management Compatibility tickbox.
   

Before installation ensure the CGI Role service has been enabled. To do this, follow the steps below:

1. In Windows, click Start (bottom left of the screen) and select Control Panel. (or start typing it in the Search bar)
2. Click Programs.
3. Under Programs and Features select Turn Windows features on or off.
4. The Windows Features dialog will be displayed:
   
   
5. Expand Internet Information Services > World Wide Web Services > Application Development Features and check the tickbox for CGI.
   
   
6. Click OK.

Note: This menu can look different on different versions of Windows or even Windows 2012 server. The example shown is Windows 10 Pro. If you need help with earlier versions, please contact your IT department.

The CGI installation files are located online on the Cadcorp website in Downloads.

Click Download and open the .EXE to launch the installer.

Providing the prerequisite software has already been installed and the CGI role service has been enabled you will see the installer’s welcome screen. Click Next.

The OGC Service Type dialog will be displayed. Check the tickbox for each of the four OGC Service Types (recommended) and click Next.

The WMS Server Settings dialog will be displayed:

• Default Web Site will be shown in the Site entry.
• Select Anonymous Authentication in IIS Security.
• Enter the GeognoSIS address and port number.

Click Next.to see WMS server optional configurations.

• GeognoSIS User - The GeognoSIS user account to use.
• GeognoSIS Password - The password for the GeognoSIS user account.
• Lookup Server Address - The name of an environment variable which contains the GeognoSIS service address.
• Lookup User - The name of an environment variable which contains the user name.
• Lookup Password - The name of an environment variable which contains the password.

Enter any of the above and click Next.

Note: If you have opted for the other services (WFS or WMTS) you can configure them in the next few screens. They are identical to the configurations shown above.

Once all services have been configured click Install to begin installation.

On completion the InstallShield Wizard Completed screen will be displayed with a list of the OGC services URLs. Ensure you have noted these URLs

Click Finish to exit the InstallShield Wizard.

Note: The following changes are made automatically by the installer and require no action from the user.

In the IIS console the execute permissions and access rights for the web service application / website will be set and a handler for the OGC CGI module added. These actions depend on the version of IIS (dependent on the web server operating system).

IIS 6.0, Windows Server 2003 and Windows XP Professional x64 Edition

IIS 7.0, Windows Server 2008 and Windows Vista (Home Premium, Business, Enterprise, Ultimate Editions)

IIS 7.5, Windows Server 2008 R2 and Windows 7

In IIS 6.0:

• In the Permissions dialog of the website the user account which will access the web service (e.g. Internet Guest User) is given the necessary access rights.
  
  
• On the properties dialogue for the web server application the execute permissions is set to scripts and executable.
  
  
• At least Read permissions given for the local path.
  
  
• On the Configuration settings for the Application Settings the OGC CGI .exe is added as a script engine.
  
  
• The access permissions in the Directory Security of the application are edited to allow anonymous access.

In IIS 7.0 & 7.5:

• The permissions of the OGC service application are edited. At least the user account which will access web service (e.g. IUSRS) has read & execute permissions allowed.
  
  
• The application pool is set to the Classic .NET AppPool in the advanced settings of the application management.
  
  
• In the application pools management the Classic .Net AppPool is started and runs the v2.0 .NET framework version. The identity which runs the application pool (e.g. Network Services) is also given read & execute permission on the web service application, wwwroot and sub-directories.
  
  
• Anonymous Authentication is enabled in the Authentication settings for the web service application. The anonymous user identity is set to the specific user: IUSR.
  
  
• Module Mapping for the CGI.exe is added to the Handler Mappings of the application. The WMS.exe, WFS.exe or WMTS.exe are enabled as CgiModule handler. The request restrictions for this module are set to Execute on the Access tab. The CGI-exe CgiModule is enabled in the Handler Mappings. 
  
  

The IUSR account is given access rights to the wwwroot and sub-directories.