Connected: An Internet Encyclopedia

Up: Connected: An Internet Encyclopedia
Up: Project Documentation
Prev: Downloading Connected
Next: Instructions for Mirror Sites


Installation Almost all of the Encyclopedia consists of HTML documents, so installation on most systems should be trivial - just use your favorite browser to open index.htm in the top directory. However, several parts of the Encyclopedia require special attention.

CGI scripts

The interactive parts of the Encyclopedia use CGI scripts; you'll need to browse the Encyclopedia via a web server (I recommend Apache) to take advantage of them. All of the Encyclopedia's CGI scripts are written using Perl, so you need a working copy of Perl (version 5) from The standard location for Perl is /usr/bin/perl. The web server must be configured to execute the CGI script when it's URL is requested. Newer versions of Apache should be configured by uncommenting the line in httpd.conf that reads:

         AddHandler cgi-script .cgi

If you have an older version of Apache that lacks this command, make sure a line such as the following appears in srm.conf:

         AddType application/x-httpd-cgi .cgi

You may also need to enable CGI execution on a per-directory basis in access.conf or httpd.conf, by setting the ExecCGI option. This can be done system-wide by adding the option to root Directory section, or by adding the option on a per-directory basis, like this (note that you must use the full UNIX path, not just the URL path):

         <Directory /home/httpd/html/CIE>
         Options Indexes ExecCGI

I strongly suggest you run the webserver using an untrusted account, and regard the scripts with some suspicion. Although I try not to distribute anything that would create a security hole, I also can't take responsibility for security on other sites. If you're concerned about CGI security, or have difficulty understanding these directions, consult with a web server expert.

Search Engine

The search engine deserves special attention, since in addition to the CGI script, the Isearch program must be installed for it to work. In addition, the index files, which can be quite large, must be maintained and updated. Therefore, I have provided the option to allow other sites to relay their searches to; all other web pages, including the search results, are served from your site. I suggest you consider this option, since it is much simpler than maintaining your own search engine. Of course, you must have a network connection to for your searches to work.

On the other hand, you may decide not to depend on to run your searches, because of speed, intermittent network connectivity or other reasons. In this case, you'll have to setup your own search engine. Currently, this can only be done on a UNIX workstation with a web server.

You chose one configuration or the other by picking which version of search.htm you'll use.

Option A: Use

Option B: Setup your own search engine.

You're ready to try the the search page.

Next: Instructions for Mirror Sites

Connected: An Internet Encyclopedia