INSTALL for lincks-2.2.1-bin.tar.gz				1JUL94

This is the installation instructions for the LINCKS OODBMS, version 2.2
patchlevel 1, Linux binary distribution. You find the full source at

  ftp.ida.liu.se:pub/lincks/lincks-2.2.1.tar.gz
  ftp.sunet.se:pub/unix/databases/object-oriented/lincks/lincks-2.2.1.tar.gz
  sunsite.unc.edu:pub/packages/database/lincks/lincks-2.2.1.tar.gz
  ftp.uu.net:pub/database/lincks/lincks-2.2.1.tar.gz
  gatekeeper.dec.com:/pub/net/infosys/lincks/lincks-2.2.1.tar.gz
 
You need:

- Ca 8MB of memory to run everything (clients and database server)
  on one host, it might run with less.
- X Window System: You need X11 Release 5.  
- TCP/IP - since the clients communicate with the server using TCP
- A running portmapper (rpc) (see step 4 below and/or Questions # 26
  in LINCKS.FAQ).

This file briefly explains how to install the LINCKS system.
Note that we assume that you install lincks-2.2.1-bin.tar.gz as

-  /usr/local/{bin,man} for executables and manual pages, 
-  /usr/local/lincks/DB for the LINCKS database, and
-  /usr/local/lincks/ for the postscript documentation and information files

To install lincks-2.2.1-bin.tar.gz proceed as follows:

0.  Optional - create a user `lincks' which will own the database,
    executables, and documentation. It might be convient out of
    security to have a special user owning the database files and
    having the database server process' running under his uid. See
    the comment concerning `dbpasswd' under step 3 below.

1.  Change th directory to / by

          cd /

2.  Unpack the gzipped tar file by 

          tar xzvf lincks-2.2.1-bin.tar.gz

3.  Edit /usr/local/lincks/DB/.lincksrc to correct and verify that

          DBDIR    database directory (/usr/local/lincks/DB/)
          LOGDIR   directory for log files (/usr/local/lincks/DB/log)
          BINARIES directory with executables (/usr/local/bin)
          HOST     where you're running it.
          OWNER    of the database (should be same user as in step 0)
          TCPIPNO  the port number used for connecting to the server
	          
    and modify accordingly. Notice that you can have several databases
    by changing DBDIR and TCPIPNO in each database' `.lincksrc' (found
    in the DBDIR). Notice that TCPIPNO  _has_ to be different for each
    database running on the same host, but they can share BINARIES, 
    LOGDIR, OWNER, HOST etc

    The `dbpasswd' executable is installed setuid (under the OWNER of
    the database files). Since the passwords in the DBDIR/passwd file
    is enscrypted and `dbpasswd' makes it possible for users to change
    their own passwords.

    The default accounts have the same password as the their LINCKS user-
    name.  See the file DB/PASSWDS for clear text passwords.

4.  You _must_ have the rpc portmapper running. In most cases the 
    portmapper is started from any of etc/rc.d/rc.inet, rc.inet1 or
    rc.inet2.  It can be namned portmap, portmapper, or rpc.portmap 
    dependent on your Linux distribution. This time, you can start 
    the portmapper as root from the command line if it not running.  
    Then  update the corresponding rc.inet file to have the portmapper 
    running automaticly after the next reboot.

5.  Start the database by

          /usr/local/bin/lincks -s /usr/local/lincks/DB

6.  Check if the database is running by

          /usr/local/bin/dbstat /usr/local/lincks/DB

    which should result in output similar to

           Internet port number: 6073
           Host for servers: iislab
           Database owner: lincks
           Server program directory: 
                   /usr/local/bin
           Logging directory: 
                   /usr/local/lincks/DB/log
           The monitor is running.
           netserv responds.
           @(#)netserv.c   1.12 5/3/94, using encrypted passwd, 32 bit label.
    The database is available for workspace connection.

    You can also check by doing a `ps -x' and you should have a `netserv' 
    and a `monitor' process running.

7.  Start the user interface, `xlincks' under X11, by

          /usr/local/bin/xlincks -u demo -p demo /usr/local/lincks/DB

    which logs you in to the database under the demo account (userid demo 
    with password demo).

8.  You can stop the database server by 

          /usr/local/bin/lincks -k /usr/local/lincks/DB

    Add the LINCKS start command (5) to your rc.local if you would 
    like to have the database server running from boot. If you have
    installed the database under user `lincks', you will have to addd
 
          su lincks -c '/usr/local/bin/lincks -s /usr/local/lincks/DB'

    to your rc.local.
   
9.  Update whatis in /usr/local/man/ by 

          /usr/sbin/makewhatis or /usr/lib/makewhatis or ...

10. Read the postscript documentation in /usr/local/lincks/

11. You find a FAQ (Frequently Asked Questions) as

          /usr/local/lincks/LINCKS.FAQ
	
12. Notice that any message of type `Warning - TCP_NODELAY not supported ..'
    is quite normal under certain kernel versions, since they do not 
    support TCP_NODELAY. For more information see the LINCKS.FAQ.

13. Finally, please send us mail to let us know that you've picked up the
    distribution and are using it so that you can receive any patches.
    You can send mail to lincks@ida.liu.se.  
   
    If you wish to join the LINCKS mailing list (lincks-users@ida.liu.se), 
    please send mail to lincks-users-request@ida.liu.se and ask to be
    added. This is _no_ listserv, but is handled by human persons.

    If you have bug reports or experienced problems in the
    installation that you think we can help with, send mail to
    lincks-bugs@ida.liu.se.  If you send a bug report, it would be
    very helpful if it contained:

   - how to reproduce the bug, if you can.
   - kernel version, library version (X11 and C), any patches etc
   - the output of `gdb xlincks core' or `dbx xlincks core' or some  
     other debugger.

   This will greatly help us in finding the bug.

--
Martin Sj\"olin | http://www.ida.liu.se/labs/iislab/people/marsj
Department of Computer Science, LiTH, S-581 83 Link\"oping, SWEDEN 
phone : +46 13 28 24 10 | fax : +46 13 28 26 66 | e-mail: marsj@ida.liu.se 


