Detailed
Web Server Instructions
for administrators installing the Pedigree Website
Package
(reflects version 4.5 and earlier)
Installing on Windows NT with
Internet Information Server (IIS)
Steps for Configuring IIS
- Ensure that you have IIS version 3.0 or later. If you have an earlier version, upgrade
to version 3.0 or later.
- The document root for IIS is C:\InetPub\wwwroot. Use Windows Explorer to create a
directory in the document root called cgi-bin (i.e., full path name of C:\InetPub\wwwroot\cgi-bin).
- Run the Internet Service Manager by selecting Start
> Programs > Microsoft Internet Server
> Internet
Service Manager or by right-clicking on My Computer > Manage >
Services and Applications > Internet Information Service.
- Select Properties for the WWW Service.
- Click the Directories tab and then the Add button.
- Add Directory \InetPub\wwwroot\cgi-bin as Virtual Directory /cgi-bin and
turn on Execute permission.
Steps for Installing the Perl Scripting language
- Download the latest release of Perl from the website http://www.activestate.com. At the time these
instructions were last updated, the file to be downloaded is called APi520e.exe and
is at http://www.activestate.com/ActivePerl/download.htm.
- Install Perl by double-clicking on the file you downloaded.
- You should reboot your Windows NT server after the Perl installation is complete.
Steps for loading the Pedigree Website Package files
- The following files should be placed in the document root (i.e., C:\InetPub\wwwroot):
- search.html
-- The pedigree search page.
- background.jpg
-- The image background for the search page.
- dogprofile.gif
-- A representative image of your dog breed displayed on the search
page.
- step1.gif
-- An image showing Step 1 of the search process.
- step2.gif
-- An image showing Step 2 of the search process.
- step3.gif
-- An image showing Step 3 of the search process.
- step4.gif
-- An image showing Step 4 of the search process.
- step5.gif
-- An image showing Step 5 of the search process.
- search.gif
-- An image button allowing a new search to be started.
- The following files should be placed in the cgi-bin directory (i.e., C:\InetPub\wwwroot\cgi-bin):
- geneal.pl
-- The CGI script that searches your database and prints pedigrees.
- your-database
.dbw -- Your breeding records database after conversion to the
necessary format.
- your-database
.ixw -- The index file for your database generated by running the
mk_ixw program.
Testing
- Run a browser (Internet Explorer, Netscape Navigator, etc.).
- In the location box, enter: http://your-server-name-here/search.html.
- When the page displays properly, click on the Search Now button near the bottom
of the page.
Installing on variants of Unix
with Apache
The "variants of Unix" for which these instructions should work are Linux,
Sun Solaris, BSDI, FreeBSD, and perhaps many others.
Steps for configuring Apache
- No special Apache configuration steps are necessary.
- If your variant of Unix does not have Apache installed, you can download it from http://www.apache.org and install it.
Steps for enabling Domain Name Server (DNS)
DNS might not be enabled by the default installation, and you will want it.
- In file /etc/nsswitch.conf, find the line that says "hosts: files"
and add "dns" to it so that it reads "hosts: files dns".
- Create the file /etc/resolv.conf (using a text editor like vi) with lines
in it of the form:
- domain your-internet-domain-here
- nameserver your-nameserver's-IP-address-here
for example:
- domain alfirin.net
- nameserver 199.182.120.1
Steps for installing the Perl scripting language
- If your variant of Unix does not have Perl installed, you can download it from http://www.perl.com and install it.
- Perl frequently is installed into /usr/bin/perl, however the scripts expect the
path to be /usr/local/bin/perl. You can fix this one of two ways:
- (recommended)
symbolic link /usr/bin/perl to /usr/local/bin/perl with
the command:
- ln -s /usr/bin/perl /usr/local/bin/perl
- edit the first line of the geneal.pl file to read #!/usr/bin/perl instead
of #!/usr/local/bin/perl.
Steps for loading the Pedigree Website Package files
- The document root for Apache is (typically) /home/httpd/html. The cgi scripts are
placed in a sibling directory called /home/httpd/cgi-bin which is symbolic linked
to /home/httpd/html/cgi-bin.
- The following files should be placed in the document root (i.e., /home/httpd/html):
- search.html
-- The pedigree search page.
- background.jpg
-- The image background for the search page.
- dogprofile.gif
-- A representative image of your dog breed displayed on the search
page.
- step1.gif
-- An image showing Step 1 of the search process.
- step2.gif
-- An image showing Step 2 of the search process.
- step3.gif
-- An image showing Step 3 of the search process.
- step4.gif
-- An image showing Step 4 of the search process.
- step5.gif
-- An image showing Step 5 of the search process.
- search.gif
-- An image button allowing a new search to be started.
- The following files should be placed in the cgi-bin directory (i.e., /home/httpd/html/cgi-bin):
- geneal.pl
-- The CGI script that searches your database and prints pedigrees.
- your-database
.dbw -- Your breeding records database after conversion to the
necessary format.
- your-database
.ixw -- The index file for your database generated by running the
mk_ixw program.
- Ensure that three of the files have proper permission settings, by entering these
commands:
- chmod 755 /home/httpd/html/cgi-bin/geneal.pl
- chmod 644 /home/httpd/html/cgi-bin/your-database.dbw
- chmod 644 /home/httpd/html/cgi-bin/your-database.ixw
Testing
- Run a browser (Internet Explorer, Netscape Navigator, etc.).
- In the location box, enter: http://your-server-name-here/search.html.
- When the page displays properly, click on the Search Now button near the bottom
of the page.
Installing on Solaris with Sun
WebServer (SWS)
Steps for installing SWS (if not already installed on Solaris)
- Login to the server as user root.
- Insert the Solaris for ISPs CD-ROM in the server's CD-ROM drive.
- Open the CD-ROM (e.g., use the CDE Panel menu FoldersÝOpen
CD-ROM selection).
- Open an xterm Terminal Window (e.g., use the CDE Panel menu Personal
ApplicationsÝTerminal selection).
- In the terminal window, execute these commands:
- cd /cdrom/sisp_i386_domestic_beta
- ./hcstartup
- I recommend (to reduce grief) that you select installation components as follows:
| Solaris for ISPs Platform |
Install |
| JDK |
Install |
| HotJava |
Install |
| SUNWlicsw |
No Action |
| Sun Directory Services |
No Action |
| SunScreen SKIP |
No Action |
| Sun FTP |
Install |
| Sun News |
No Action |
| Sun WebServer (SWS) |
Install |
| Sun Internet Administrator |
No Action |
| Sun Internet Services Monitor |
No Action |
- The default configuration of each of these components is sufficient. Reboot after
installation.
Steps for enabling Domain Name Server (DNS)
DNS might not be enabled by the default installation, and you will want it.
- In file /etc/nsswitch.conf, find the line that says "hosts: files"
and add "dns" to it so that it reads "hosts: files dns".
- Create the file /etc/resolv.conf (using a text editor like vi) with lines
in it of the form:
- domain your-internet-domain-here
- nameserver your-nameserver's-IP-address-here
for example:
- domain alfirin.net
- nameserver 199.182.120.1
Steps for configuring SWS
SWS is not enabled by the default installation (Sun expects you to use the Admin
webserver at port 50080 first, but we didn't install it).
Steps for installing the Perl scripting language
- If Solaris does not have Perl already installed, you can download it from http://www.sunfreeware.com and install it.
- Perl frequently is installed into /usr/bin/perl, however the scripts expect the
path to be /usr/local/bin/perl. You must fix it this way:
- edit the first line of the geneal.pl file to read #!/usr/bin/perl instead
of #!/usr/local/bin/perl.
Steps for loading the Pedigree Website Package files
- The document root for SWS is /var/http/sws_server/websites/default_site/public.
The cgi scripts are placed in a sibling directory called /var/http/sws_server/websites/default_site/cgi-bin.
- The following files should be placed in the document root (i.e., /var/http/sws_server/websites/default_site/public):
- search.html
-- The pedigree search page.
- background.jpg
-- The image background for the search page.
- dogprofile.gif
-- A representative image of your dog breed displayed on the search
page.
- step1.gif
-- An image showing Step 1 of the search process.
- step2.gif
-- An image showing Step 2 of the search process.
- step3.gif
-- An image showing Step 3 of the search process.
- step4.gif
-- An image showing Step 4 of the search process.
- step5.gif
-- An image showing Step 5 of the search process.
- search.gif
-- An image button allowing a new search to be started.
- The following files should be placed in the cgi-bin directory (i.e., /var/http/sws_server/websites/default_site/cgi-bin):
- geneal.pl
-- The CGI script that searches your database and prints pedigrees.
- your-database
.dbw -- Your breeding records database after conversion to the
necessary format.
- your-database
.ixw -- The index file for your database generated by running the
mk_ixw program.
- Ensure that three of the files have proper permission settings, by entering these
commands:
- chmod 755 /var/http/sws_server/websites/default_site/cgi-bin/geneal.pl
- chmod 644 /var/http/sws_server/websites/default_site/cgi-bin/your-database.dbw
- chmod 644 /var/http/sws_server/websites/default_site/cgi-bin/your-database.ixw
Testing
- Run a browser (Internet Explorer, Netscape Navigator, etc.).
- In the location box, enter: http://your-server-name-here/search.html.
- When the page displays properly, click on the Search Now button near the bottom
of the page.
Installing on variants of Unix
with NCSA Web Server
The "variants of Unix" for which these instructions should work are Linux,
Sun Solaris, BSDI, FreeBSD, and perhaps many others.
Steps for configuring NCSA Web Server
Steps for enabling Domain Name Server (DNS)
DNS might not be enabled by the default installation, and you will want it.
- In file /etc/nsswitch.conf, find the line that says "hosts: files"
and add "dns" to it so that it reads "hosts: files dns".
- Create the file /etc/resolv.conf (using a text editor like vi) with lines
in it of the form:
- domain your-internet-domain-here
- nameserver your-nameserver's-IP-address-here
for example:
- domain alfirin.net
- nameserver 199.182.120.1
Steps for installing the Perl scripting language
- If your variant of Unix does not have Perl installed, you can download it from http://www.perl.com and install it.
- Perl frequently is installed into /usr/bin/perl, however the scripts expect the
path to be /usr/local/bin/perl. You can fix this one of two ways:
- (recommended)
symbolic link /usr/bin/perl to /usr/local/bin/perl with
the command:
- ln -s /usr/bin/perl /usr/local/bin/perl
- edit the first line of the geneal.pl file to read #!/usr/bin/perl instead
of #!/usr/local/bin/perl.
Steps for loading the Pedigree Website Package files
- The document root for NCSA Web Server is (typically) /usr/local/etc/httpd/htdocs.
The cgi scripts are placed in a sibling directory called /usr/local/etc/httpd/cgi-bin.
- The following files should be placed in the document root (i.e., /usr/local/etc/httpd/htdocs):
- search.html
-- The pedigree search page.
- background.jpg
-- The image background for the search page.
- dogprofile.gif
-- A representative image of your dog breed displayed on the search
page.
- step1.gif
-- An image showing Step 1 of the search process.
- step2.gif
-- An image showing Step 2 of the search process.
- step3.gif
-- An image showing Step 3 of the search process.
- step4.gif
-- An image showing Step 4 of the search process.
- step5.gif
-- An image showing Step 5 of the search process.
- search.gif
-- An image button allowing a new search to be started.
- The following files should be placed in the cgi-bin directory (i.e., /usr/local/etc/httpd/cgi-bin):
- geneal.pl
-- The CGI script that searches your database and prints pedigrees.
- your-database
.dbw -- Your breeding records database after conversion to the
necessary format.
- your-database
.ixw -- The index file for your database generated by running the
mk_ixw program.
- Ensure that three of the files have proper permission settings, by entering these
commands:
- chmod 755 /usr/local/etc/httpd/cgi-bin/geneal.pl
- chmod 644 /usr/local/etc/httpd/cgi-bin/your-database.dbw
- chmod 644 /usr/local/etc/httpd/cgi-bin/your-database.ixw
Testing
- Run a browser (Internet Explorer, Netscape Navigator, etc.).
- In the location box, enter: http://your-server-name-here/search.html.
- When the page displays properly, click on the Search Now button near the bottom
of the page.
This page accessed 
times.
Page created by: flamer@alfirin.net.
Changes last made on: Sat Dec 2 8:27:56 2000 PST.