"Fossies" - the Fresh Open Source Software Archive

Member "whois-5.5.2/INSTALL" (8 Aug 2012, 3494 Bytes) of package /linux/privat/old/whois-5.5.2.tgz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 
    2 These installation instructions are for UNIX-based systems. I know that 
    3 this program will run on NT using the ActiveState Windows port of Perl 
    4 (www.activestate.com), altough I have little experience with that platform 
    5 so I cannot write installation instructions for it. 
    6 
    7 NOTE: In the following instructions directory paths are enclosed in 
    8 square bracktes [thusly]. Don't type the brackets. 
    9 
   10   1.  Copy the file "whois" to a directory in your path, preferably 
   11       [/usr/local/bin] (if you have root access). (You may need to 
   12       remove [/usr/bin/whois] if you have an older whois client.)
   13 
   14   2.  Copy the man page (whois.1) to a directory in your man-path. 
   15       this file usually goes in [/usr/local/man/man1]. (You may need 
   16       to remove the file from [/usr/man/man1/whois.1] if there is 
   17       already a man page there for an older whois client.)
   18 
   19   3.  If you look up a lot of domains outside of .COM .NET and .ORG, 
   20       you will need the tld.conf file. This file is entirely optional. 
   21       The default location of this file is [/etc/whois/tld.conf]. You 
   22       can put it in a different location by setting an option in the 
   23       whois.conf configuration file. See the man page for instructions. 
   24 
   25   4.  If you want to customize the operation of the program, or plan 
   26       to use advanced features, you will need to install the whois.conf
   27       file. The default location for this is [/etc/whois/whois.conf].
   28 
   29   5.  If you want to use the "stripdisclaimer" feature, you will need 
   30       to install the sd.conf configuration file. The default location 
   31       for this is [/etc/whois/sd.conf].
   32 
   33   6.  If you will be using the whois program in a CGI environment (as 
   34       a web application) and you want Apache-style SSI support, then 
   35       you will want to install bwInclude.pm in your perl lib path. 
   36 
   37 I have included a script that will do the above steps on a UNIX system. 
   38 It's probably better to do the steps yourself, as I believe that you are 
   39 never in control of your system if you do not know it's underpinnings 
   40 well. The script is called [install.sh] and while it probably does no 
   41 harm, you must run it as root so you must assume responsibility for 
   42 running it. 
   43 
   44 OPTIONAL DATABASE FEATURES
   45 
   46   If you will be using the database features of this program and you have
   47   SQLite 3, PostgreSQL, or MySQL and DBI installed, then you will need to
   48   create the apporpriate database and tables in your SQL system.
   49 
   50   If you are using SQLite 3 (recommended for most installations) I have 
   51   included an initialized database file in the distribution. 
   52 
   53   My script does not create databases and tables in PostgreSQL or MySQL for
   54   you because I consider it a security risk to give create permissions in the
   55   database system to "root", and the script needs to run as "root" in order to
   56   install the whois script for command-line use. Perhaps I will think of a
   57   solution to this at a later time.
   58 
   59   You will need to create a database; then edit the create_whois_*.sql
   60   file (according to the database engine you are using) and use it to
   61   create the tables. Be sure to edit your whois.conf file with the
   62   appropriate connect string for your setup.
   63 
   64   Because SQLite3 uses a simple and portable database format, and
   65   because it's databases are atomic files (not shared by a database
   66   "server"), I have included an initialized database file (whois.db) for
   67   use with SQLite 3 in the distribution.
   68 
   69 Enjoy.
   70 
   71 --Bill Weinman, 27 July 2002
   72   revised 17 September 2010
   73