Instalation guide for LinuxWare 0.92 beta
****************************************

0. untar archive under /usr/src
-------------------------------
# cd /usr/src
# tar -xzf /some_where/lwared-0.92.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.1a (you have kernel 1.2.0)
untar patches in the kernel source directory:
# cd /usr/src/linux
# tar -xf /usr/src/lwared-0.92/kernel/ipxkern.tar

1.1b (other than 1.2.0)
it is better to install patches by hand
(you can try to simply replace the files (see 1.1a), but it may not work)

There are 3 files to replace:
include/linux/ipx.h - replace the file from ipxkern.tar
net/inet/ipx.h - replace the file from ipxkern.tar
net/inet/ipx.c - replace the file from ipxkern.tar

There are 3 files to modify (see the modified files in ipxkern.tar - changes
to original 1.2.0 source are marked by comments like '/* AD patch */'):
fs/proc/net.c - remove calls to functions unimplemented in ipx.c 
                (no modification may be required for older kernels)
net/inet/sock.h - replace/add struct sock IPX member(s) 
                  (no modification may be required for some kernels)
drivers/net/loopback.c - set HW address of loopback to 00:00:00:00:00:01

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

1.3 recompile and install new kernel
# make
# lilo

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

2.1 switch to LinuxWare source directory
# cd /usr/src/lwared-0.92

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 (see man ipxbind))

sample commands for host with two ethernet cards:

# ipxbind A2E4D67A lo dix (internal network - not necessary,
                           but recommended for multihomed hosts)
# ipxbind 3ABCD eth0 802.3
# ipxbind 3ABD3 eth0 dix
# ipxbind 1ABD1 eth1 802.3
# ipxbind 1ABD2 eth1 dix

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

4. setup LinuxWare 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 LinuxWare 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 LinuxWare, because is copyrighted by 
Novell. I recommend to use Novell NetWare v3.11.

4.4 start the server
# lwared

5. test LinuxWare

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 :-(
