Instalation guide for LinWare 0.95 beta
****************************************

0. untar archive under /usr/src
-------------------------------
# cd /usr/src
# tar -xzf /some_where/lwared-0.95.tar 

1. install modified IPX kernel support
--------------------------------------
IPX support is correct for kernel 1.2.0, so next step depend on your kernel
version:

1.2a (you have kernel 1.3.17 or newer (tested with 1.3.23 & 1.3.36))
patch your kernel source:
# make patch
/* you can unpatch the sources by 'make unpatch'*/

1.2b (older than 1.3.17)
you must install patches by hand
(you can try to simply do 1.2a, but it may not work)
you need to move files to diferent location or to remove calls to nonex. 
functions like proc_net_register, place source to another directory etc. 
The older kernel you have the more trouble you can expect.

1.3 switch to your kernel source dir
# cd /usr/src/linux

1.4 enable IPX support in kernel
# make config ......

1.5 recompile and install new kernel
# make
# lilo
# reboot

2. compile and install IPX router daemons, utilities and LinWare server

2.1 switch to LinWare source directory
# cd /usr/src/lwared-0.95

2.2 reconfigure server (optional)
edit server/config.h

2.3 update dependecies
# make depend

2.4 compile all binaries
# make

2.5 install the binaries and man pages
# make install

3. setup IPX subsystem

3.1 bind IPX network numbers to the interfaces 
(consult your network admin to obtain correct IPX network numbers or try
autobinding (read util/README for details))

sample commands for host with two ethernet cards:

#ipx_internal_net add A2E4D67A 1 (internal network - not necessary,
                                  but recommended for multihomed hosts)
#ipx_interface add eth1 etherii B
#ipx_interface add eth0 802.3 8B7F0
#ipx_interface add eth0 etherii 8B7F1

3.2 start router daemons
# ipxripd /var/adm/ipxrip
# ipxsapd /var/adm/ipxsap

4. setup LinWare server

4.1 add users to /etc/lwpasswd and set password for some user (to be able to
test the server)
# vi /etc/lwpasswd
# chmod 600 /etc/lwpasswd
# lwpasswd testuser

4.2 add directories you want to access as LinWare volumes to /etc/lwvtab
(at least volume SYS)
# vi /etc/lwvtab

4.3 create standard file and directory structure on volume SYS (optional)
(consult your Novell NetWare documentation or local Novell guru)
The required software is not a part of LinWare, because is copyrighted by 
Novell, Inc. I recommend to use Novell NetWare v3.11.

4.4 start the server
# lwared

5. test LinWare

5.1 attach to server from DOS (this expects you are logged to true NetWare)
# slist (server should appear in the list)
# attach linux/ales
# whoami

5.2 test messages
# send "TEST" to linux/ales

5.3 test file/dir operations
# map x:=linux/sys:
# x:
# any file/dir operation

6. enjoy :-) and/or report a bug :-(
