last update: Sat Feb 19 2000

Installation

How to proceed

PhoneBook is distributed as a zip- or gzip-ed tar-archive. Both (g)tar and (un)zip should be installed on any UNIX-based operating system. If you do not have either of them on your system, do a search for them on the web, there are several pages, depending on the operating system you use, which have them, or ask your system administrator or the distributer of your system software.
Create the directory in which you want PhoneBook to reside, copy the archive into that directory and change into it. Then unpack the archive by typing:
tar xzvf PhoneBook-10.tgz "Enter"
or
gtar xzvf PhoneBook-10.tgz "Enter"
for a tar-gzip-archive or
unzip PhoneBook-10.zip "Enter"
for a zip-archive. The directory will then contain the following eight files (plus, of course, the archive itself):
Next, you need to tell PhoneBook where the "wshh" file is located. Assuming that you have the Telekom CD mounted under "/cdrom" this would be the location "/cdrom/database/wshh". For PhoneBook you now simply have to create a softlink named "wshh" to that location. You do this by typing
ln -sf /cdrom/database/wshh wshh "Enter"
If you use a different mounting-point for the CD or if you use a copy of "wshh" on your harddisk, you have to specify that location in the above command.

Finally, you have to configure PhoneBook. To do this, simply type "Install". This will, among other things, run CreateIndices, which will create the reverse index file needed to find addresses when given a telephone number. This index file is a little over 10MB in size, and both CreateIndices and PhoneBook require approximately 20 MB of free RAM, so make sure you have enough memory and enough space on your harddisk.

If Install terminates normally, PhoneBook is now ready for use.
Otherwise it will print out an error message. In this case, unless you are able to resolve the problem yourself, email me the output produced by Install and I will try to locate and solve the problem.

Once PhoneBook has been successfully compiled, you can delete all of the above files, which will have been moved into a subdirectory "del".

Download the PhoneBook-archive (ZIP, TGZ) or go back to the Unix section ?



This page hosted by Get your own Free Home Page
1