Go to the previous, next section.
@everyfooting Author: rootd// Editor: ensley // Texinfo: rootd@| @| 3 December 1994
This chapter shows how to install an archie server. Be advised that this chapter is in very-rough-draft form.
Much of the installation is mechanized with makefiles and shell scripts. You can run these makefiles as the user archie if you wish--there is no need to run them as root.
Some system reconfiguration is necessary to activate the archie system. You need to add lines to your rc, passwd, group, and shells files. We have chosen to have the installer perform these steps manually. This has two advantages:
Free archie requires a dedicated sparcII (or better) sparcstation with the following components:
Archie is only supported on sparcs running SunOS 4.1.3
Since archie is a computationally-intensive and important public service, The sparcstation should be dedicated to archie.
Of course, you will need to have root access to install archie.
Archie is a critical service on the internet. Every day, tens of thousands of people use an archie search to find files and programs available via anonymous ftp. Without this service, finding information available via ftp would be incredibly difficult--and require that administrators of anonymous ftp sites spend much more time keeping their site organized.
Our competitor, Bunyip Inc (who produce a commercial archie server) charge $6,000 for you to use their server. In addition, to get "maintainance", you need to pay $4,500/year. As a result, there are few archie servers on the net, and some of the existing archie servers do not have the latest version of archie.
Archie is too critical an internet service to ration by charging large amounts of money. By providing a free archie server, we help to increase the number of archie servers available for the public's use. In addition, by making source code available for free anyone on the internet can help improve the quality of the archie system.
Remote users can use archie in a number of ways:
It is possible to set up archie so that only a subset of the above methods is activated.
Free Archie source code is available via anonymous ftp from ftp.ee.pdx.edu in the /pub/freearchie directory. The filename is freearchie-x.xx.tar.gz In addition to the gziped tar file, get the freearchie.README file
Make sure you have a disk partition with at least 500 megs of free hard drive space. Create a new user: archie, in the group archie. Have the home directory be in the disk partition, and make its shell the bourne shell. Copy the tar.gz file into the archie-user's home directory. cd to the archie user, and execute the following commands (as root or as the user archie).
> gunzip freearchie-x.xx.tar.gz > tar -xf freearchie-x.xx.tar.gz
This unpacks the gzipped tar file. Note that it unpacks into the current directory, so you don't want to unpack it in a directory that already has files (if you just created the new user archie, this isn't a problem).
The archie-user's home directory is called the INSTALLDIR in the remainder of this document. cd into INSTALLDIR/src, and edit the include.make file. You will need to edit the INSTALLDIR line in the include.make file to be the archie-user's home directory. Then execute the following commands:
> make configure > make
If you need to reinstall the system after editing the install.make file, execute the
> make clean
before rebuilding the archie server. Archie is now built. You need to start the archie server, enable the archie interfaces, download the ftp site list, and manually build the database for the first time. At that point, you can perform archie searches. We show how to download the ftp site list and how to manually build the database in the next chapter (Maintaining the archie server).
To start the archie server, run INSTALLDIR/bin/queuer in the background (so it won't quit when you log out). To make sure it runs each time the system reboots, you can add the following lines to the end of your /etc/rc.local file (make sure to replace INSTALLDIR with the home directory of the archie user)
if [ -f INSTALLDIR/bin/queuer ] ; then
su archie -c "INSTALLDIR/bin/queuer &"
fi
You can choose to activate whatever interfaces you wish. We suggest that you activate them all to allow users to use whatever method they prefer.
Change the archie user's shell (in the /etc/passwd file) to INSTALLDIR/bin/telnet-interface You may need to add "telnet-interface" to your system's /etc/shells file. Now make the password field blank.
Now, whenever someone telnets to your machine, logs in as archie, and doesn't type a password, they will be put in archie's telnet interface as a shell, which will allow them to conduct searches.
When you unpacked the tar file, a file called "dot.forward" was created in the archie user's home directory (the INSTALLDIR). To activate the email interface, type the following command:
> mv dot.forward .forward
The .forward file will forward email that archie receives to the email-interface program, which will parse and execute the search requests.
To be determined.
To be determined.
Go to the previous, next section.