Notification

Urchin WebAnalytics Software is discontinued and is no longer supported. All Urchin documentation applies only to the Urchin product as it was at the time of discontinuation, and does not apply to any Google Analytics products or services.

Using an Existing IIS Webserver (Windows Platforms)

Using an Existing IIS Webserver (Windows Platforms)

By default, Urchin administration and reporting are done using a standalone Apache server that is bundled with the Urchin product. In the vast majority of Urchin installations, this is the preferred method for delivering Urchin admin and reporting interfaces. However, in rare instances it may be necessary to utilize an existing IIS webserver. This may be due to site requirements that disallow the use of a third party webserver product on the server, or the need to set up Urchin reporting as a virtual host on an existing IIS server.

DISCLAIMER: These modifications to the Urchin installation are unsupported.

Procedure

Note: this procedure assumes that Urchin has been installed in the default location of C:\Program Files\Urchin. If you have installed Urchin elsewhere, please be sure to substitute the proper location in the example below.

Step 1: Create a new user for the Urchin web interface

  • Go to "Administrative Tools" -> "Computer Management"

  • On the left hand side of the Computer Management screen, click "Local Users and Groups"
  • Right-click on the Users folder and select "New User..."
  • Enter "IUSR_URCHIN" in the "User name:" field
  • Uncheck the "User must change password at next logon" box
  • Check the "User cannot change password" box
  • Click "Create" and then "Close"
  • Double click on the"Users" folder on the left
  • Right-click on the IUSR_URCHIN on the right and select "Properties..."
  • Under the "Member of" tab, remove all existing entries, and then click the "Add.." button and choose "Guests" in the popup window, and click "Add" again, then click "OK"
  • Click "Apply" and "Close" to save your changes

Step 2: Install Urchin (if not already done)

Step 3: Disable the Urchin Apache web server

  1. Go to "Administrative Tools" -> "Services"

  2. Under "Services" find the "Urchin Webserver" record
  3. Right click on "Urchin Webserver" and select "Stop"
  4. Right click on "Urchin Webserver" and select "Properties", then change the Startup type" to "Disabled"
  5. Click "OK"

Step 4: Add a new web site to IIS. Go to "Administrative Tools" -> "Internet Information Services (IIS) Manager"

  1. Right-click on "Web Sites"
  2. In the "Description:" field type "Urchin" and click Next
  3. Select the IP address and port number (typically 9999) and click Next
  4. In the "Path:" field browse to the location where Urchin is installed (typically C:\Program Files\Urchin\htdocs) and click Next
  5. Add a check mark in "Execute:" and click Next and then Finish
  6. Right-click on the new Urchin web site and go to "Properties"
    1. Under the "Web Site" tab, un-check "Enable Logging"
    2. Click on the "Home Directory" tab and check "Script source access"
    3. Click on the "Documents" tab and Remove both Default entries, then click Add and enter "session.cgi" in the popup window, then click OK.
    4. Click on the "Directory Security" tab, and then click Edit in the "Authentication and Access control" area. Ensure that the "Anonymous access" box is checked, then click Edit... to change the "Account used for anonymous access". In the pop-up window, select "IUSR_URCHIN" for the Username. Click OK and then OK again to get back to the Properties window.
    5. Click OK to save your changes and exit the Properties window

Step 5: Set up directory permissions 1. Right click on "Start" and select "Explore"

  1. Navigate to the location where Urchin is installed (typically C:\Program Files\Urchin)
  2. Right click on the "Urchin" folder and select "Properties"
  3. Click on the "Security" tab
  4. Click "Advanced" button. Un-check "Allow inheritable permissions from parent to propagate to this object" and then click "Remove" in the pop-up window.
  5. Click "Add" and select the Administrator user and then click "Add"
  6. Click "Add" and select IUSR_URCHIN and then click "Add"
  7. In the "Name:" field ensure that only the Administrator and IUSR_URCHIN entries are there

  8. Grant write permissions to the <urchin_home>\var folder

  9. Return to Preferences=>Security and ensure that the following permissions are allowed for IUSR_URCHIN user:

    • Read & Execute

    • List Folder Contents
    • Read
    • Note: Leave the default full permissions for SYSTEM
  10. Click OK to save the permissions.
  11. Click into the "Urchin" folder in the Windows Explorer window.
  12. Right click on the "data" folder and select "Properties"
  13. Click on the "Security" tab.
  14. Click Advanced. Un-check "Allow inheritable permissions from parent to propagate to this object" and then click "Remove" in the pop-up window.
  15. Click "Add" and select the Administrator user and then click "Add"
  16. Click "Add" and select IUSR_URCHIN and then click "Add"
  17. In the "Name:" field ensure that only the Administrator and IUSR_URCHIN entries are there

  18. Return to Preferences=>Security and ensure that the following permissions are allowed for both the Administrator and IUSR_URCHIN users:

    • Full Control
    • Modify

    • Read & Execute

    • List Folder Contents
    • Read
    • Write
  19. Click "OK"

Step 6: IIS 6 only. Go to the "Web Service Extentions Manager"

  1. Click on 'Add new web service extention..'
  2. Enter "Urchin CGI" in the "Extention Name:"
  3. Click 'Add'
  4. Browse to and highlight report.cgi and session.cgi (By default, only *.dll files are shown so you will need to change the filter to display "All files")
    • Default location: C:\Program Files\Urchin\htdocs
  5. Check "Set Extention Status to Allow"
  6. Click "OK"
  7. Go to the main IIS entry for your server: "Hostname"
  8. Right click and select "Properties"
  9. Click on "Mime Types"
  10. Click "New"
  11. Enter ".cgi" in the "Extention:" field.
  12. Enter "application/octet-stream" in the "Mime Type" field.
  13. Click "OK"
  14. Click "OK"

Your IIS webserver should now be set up to call the Urchin web interface if you connect to it using the URL ofhttp://my.server.com:port, whereportis what you set Urchin to use when you installed it (default is 9999).

Using an Existing IIS Webserver for Urchin Data API web services (Urchin 6.6+)

The Urchin Data API web services (Urchin 6.6+) are bundled with an IIS module that can be deployed and configured to handle requests to the Urchin Data API. To configure the Data API under IIS Webserver, please refer to Can I integrate the Urchin Data API with IIS?.

 
true
Search
Clear search
Close search
Main menu
11737720388595643188
true
Search Help Center
true
true
true
false
false