add readme
This commit is contained in:
Mario Fetka
parent
849dbf3ead
commit
080bfb34b8
137
README.md
Normal file
137
README.md
Normal file
@ -0,0 +1,137 @@
|
|||||||
|
# MARS_NWE
|
||||||
|
|
||||||
|
This is Mars_nwe, a free NetWare emulator for Linux originally written by
|
||||||
|
Martin Stover of Marburg, Germany.
|
||||||
|
|
||||||
|
## Current Development Status
|
||||||
|
The last release by the original author was on 1 September 2000.
|
||||||
|
Marco Cavallini of Koan Software produced version 0.99.pl21 on or around 14 June 2003.
|
||||||
|
Mario Fetka (@geos_one) released version 0.99.pl22 on 21 May 2012 and 0.99.pl23 on 5
|
||||||
|
November 2013.
|
||||||
|
|
||||||
|
No further work has been done on this in public since 2013. While it all builds and runs on
|
||||||
|
modern linux systems (surprisingly) there are a lot of build warnings and many missing
|
||||||
|
features to be dealt with as well as bugs to be found and squashed.
|
||||||
|
|
||||||
|
## About This Repository
|
||||||
|
This repository was initially produced to see what the differences were between the few
|
||||||
|
most recent versions of mars_nwe, in particular the versions not produced by the
|
||||||
|
original author. Most other versions going back to 0.96 have also been imported to see
|
||||||
|
how it changed over time. The source archives used to build this repo can be found
|
||||||
|
[here](https://ftp.zx.net.nz/pub/archive/novell/mars_nwe_dist/).
|
||||||
|
|
||||||
|
## What can Mars_nwe do?
|
||||||
|
From the old [README file](README):
|
||||||
|
|
||||||
|
- mars_nwe is a very functional clone of a NetWare server that runs
|
||||||
|
under Linux. It works fine with the usual DOS client software that
|
||||||
|
normally comes with your NetWare server.
|
||||||
|
|
||||||
|
- mars_nwe offers file, bindery and print services for NetWare client
|
||||||
|
software.
|
||||||
|
|
||||||
|
- mars_nwe does not include any user license restrictions. You can
|
||||||
|
increase mars_nwe's licenses by simply recompiling it, and you can
|
||||||
|
start any number of mars_nwe's on your network!
|
||||||
|
|
||||||
|
- mars_nwe includes a RIP/SAP daemon that turns your Linux box into a
|
||||||
|
fine IPX router.
|
||||||
|
|
||||||
|
|
||||||
|
Related packages include:
|
||||||
|
|
||||||
|
- mars_dosutils: Some utilities that should free you from having to
|
||||||
|
use proprietary utilities when you want to use mars_nwe with DOS
|
||||||
|
clients. These are now in the dosutils directory of this repository
|
||||||
|
|
||||||
|
- [ncpfs](https://github.com/EnzephaloN/ncpfs-module): a linux-only
|
||||||
|
filesystem allowing you to mount volumes exported by NetWare servers
|
||||||
|
on your linux box.
|
||||||
|
|
||||||
|
- [ipx kernel module for Linux](https://github.com/pasis/ipx): this is
|
||||||
|
required to run mars_nwe on versions of Linux newer than 4.17.
|
||||||
|
|
||||||
|
## WARNING Security
|
||||||
|
This code has not been actively maintained in over two decades. The network protocol it
|
||||||
|
implements is even older than that. **THERE WILL BE SECURITY VULNERABILITIES.** If you
|
||||||
|
decide to run this please do so on a private network only.
|
||||||
|
|
||||||
|
In particular, since version 0.99.pl9 mars_nwe has made filesystem calls as the root
|
||||||
|
user in order to handle trustees so this may be a source of security issues.
|
||||||
|
|
||||||
|
## Installing
|
||||||
|
|
||||||
|
With [the IPX Kernel Module](https://github.com/pasis/ipx) installed you should be able to
|
||||||
|
just go:
|
||||||
|
```shell
|
||||||
|
cmake .
|
||||||
|
make
|
||||||
|
sudo make install
|
||||||
|
```
|
||||||
|
|
||||||
|
Once thats done you'll need to edit `/usr/local/etc/mars_nwe/nwserv.conf` to:
|
||||||
|
- Give your server a name (section 2)
|
||||||
|
- Set ethernet frame types and IPX network numbers (section 4, you may be able to skip
|
||||||
|
this if you have no other NetWare servers on your LAN)
|
||||||
|
- Give the supervisor user a password (section 12)
|
||||||
|
|
||||||
|
You should probably read all the comments in the server configuration file in case there
|
||||||
|
are any other settings you wish to customise.
|
||||||
|
|
||||||
|
You'll also want to edit `/var/mars_nwe/SYS/public/net$log.dat` and replace the
|
||||||
|
default login script with something sensible like:
|
||||||
|
```
|
||||||
|
MAP INS S1:=SYS:PUBLIC
|
||||||
|
MAP *1:=SYS:
|
||||||
|
```
|
||||||
|
|
||||||
|
Once all that's done you should be able to start mars_nwe by running the following as root:
|
||||||
|
```shell
|
||||||
|
mkdir -p /var/log/mars_nwe
|
||||||
|
mkdir -p /var/run/mars_nwe
|
||||||
|
nwserv
|
||||||
|
```
|
||||||
|
To make it start automatically you can put the above in `/etc/rc.local` or, even better,
|
||||||
|
write a systemd unit file.
|
||||||
|
|
||||||
|
Lastly you'll need a client. The best one for DOS and Windows 3.11 is probably
|
||||||
|
[Client32 v2.71](https://ftp.zx.net.nz/pub/archive/novell/clients/client32_2.71_dos_win3x/dw271e.exe)
|
||||||
|
from February 1999 which uses at most 4K of conventional memory (386SX or better CPU
|
||||||
|
and a few MB of extended memory required). For other operating systems (or older DOS
|
||||||
|
machines) you can grab another client from [here](https://www.zx.net.nz/netware/client/). Note
|
||||||
|
that Mars_NWE won't work with the Mac client as that needs NDS (NetWare 4.0+) which Mars_NWE
|
||||||
|
does not implement.
|
||||||
|
|
||||||
|
## NetWare DOS & OS/2 Utilities
|
||||||
|
mars_nwe only comes with the bare minimum required to login and map drives on DOS. You can get
|
||||||
|
some other utilities (such as flag and ncopy) from the NetWare DOS Client Kit v3.01
|
||||||
|
(released in 1990) which was made freely available by Novell. You can get it from
|
||||||
|
[this page](http://www.zx.net.nz/netware/client/dos-netx.shtml) (DSWIN3.ZIP and
|
||||||
|
DSWIN4.ZIP). These utilities would normally live in `/var/mars_nwe/SYS/public/`
|
||||||
|
|
||||||
|
For OS/2, some of the client kits for OS/2 include updated 16bit OS/2 utilities
|
||||||
|
(usually the OS2UTIL disks) which may fill some gaps. Four EXEs (attach, login, map, slist)
|
||||||
|
should go in `/var/mars_nwe/SYS/login/OS2/` while the rest go in `/var/mars_nwe/SYS/public/OS2/`.
|
||||||
|
|
||||||
|
For other utilities such as SysCon you may need to obtain a proper copy of
|
||||||
|
NetWare 3.11 or 3.12.
|
||||||
|
|
||||||
|
## Managing Users and Login Scripts
|
||||||
|
For NetWare 3.x servers this is normally done with the SYSCON utility for DOS. Mars_NWE doesn't
|
||||||
|
include any replacement for this utility and the original Novell one is probably out of bounds
|
||||||
|
unless you've got a NetWare 3 license.
|
||||||
|
|
||||||
|
One alternative is [WnSyscon](https://web.archive.org/web/20050828165409/http://www.amcsoft.demon.co.uk/wnsyscon.htm),
|
||||||
|
a 16bit windows SYSCON replacement. Novell actually bundled the registered version of
|
||||||
|
this with NetWare 3.2 as their [Graphical SYSCON Utility](https://support.novell.com/techcenter/articles/ana19980403.html).
|
||||||
|
You can grab the ShareWare version from [here](https://ftp.zx.net.nz/pub/archive/novell/3rdparty/admin/wnsyscon/) - it
|
||||||
|
seems to be fully functional aside from a few nag screens. Unfortunaltely buying a copy of NetWare 3.2 is probably
|
||||||
|
the only way to get a proper registered version of this today unless the original author can be contacted somehow.
|
||||||
|
|
||||||
|
## Where To Get Help
|
||||||
|
|
||||||
|
There is some very old documentation available [here](doc) which may be of interest.
|
||||||
|
The old [linware mailing list archives](https://marc.info/?l=linware&r=1&w=2) may still
|
||||||
|
contain useful information as well. There is also a few additional notes [here](http://www.zx.net.nz/netware/server/mars.shtml).
|
||||||
|
If you can't find a solution to a problem in any of those places the only remaining
|
||||||
|
option is probably reading the code.
|
||||||
Loading…
Reference in New Issue
Block a user