Configuring the WebSite Server

The O'Reilly WebSite server comes in two flavors: the souped-up WebSite Professional Web server, and the (free!) basic nuts-and-bolts WebSite 1.1 server.

To use Caucus with either web server, you must make a few changes to the WebSite configuration.  This should not affect any other use of your web server.

(As usual, anywhere you see c:\caucus, replace it with the actual path of the Caucus home directory.)

  1. As Administrator, bring up the WebSite Server Properties dialog box.  (Click Start, Programs, WebSite, Server Properties.)  Click on the "Mapping" tab.

  2. In the "List Selector" section, make sure the "Documents" radio button is checked.  (If that area is greyed-out, press the "Apply" button near the bottom of the dialog box.)  In the "Document URL Path" field, type "/~caucus/".  In the "Directory" field, type "c:\caucus\public_html\".  Click on "Add", and then "Apply".

  3. In the "List Selector" section, click on the "Standard CGI" radio button.  In the "Standard CGI URL Path" field, type "/sweb/".  In the "Directory" field, type "c:\caucus\sweb\".  Click on "Add", and then "Apply".

  4. Repeat the previous step, this time with URL Path "/caucus" and Directory "c:\caucus\sweb\start.exe".

The rest of this page describes how to set up the userid and password access to Caucus for your Web users.

  1. Click on the "Groups" tab, and in the "Authentication Realm" section, click "New".  Add a new authentication realm called "caucus".  In the "Group" section, click "New", and add a new group called "caucus_users".

  2. Click on the "Access Control" tab, and then the "New" button.  In the "URL Path" field, enter "/sweb/", and select "caucus" from the "Realm:" pull-down list. 

    In the "Authorized Users & Groups" section, click on "Add", select the group "caucus_users", and click OK.

    This step forces the WebSite server to only allow those users in the "caucus_users" group to access the "caucus" realm (and thus any URL containing "/sweb"), and furthermore, insists that each user have a unique userid and password.

  3. Finally, create those users.  Click on the "Users" tab again, select the "caucus" realm, and click "New" to add a new "web" userid and password for Caucus.  (This is the userid and password that each individual user will supply when they begin using Caucus.  It is not the same as adding a new user account to your NT machine.)

    In the "Group Membership" section, select "caucus_users", and click on "Add". 

    Repeat this process for each Caucus user that you wish to add.  You may come back to this step at any time to add more users; all of the previous steps 1 through 6 are only performed when you first install Caucus.