How to get going with the Samba Server for eComStation & OS/2

This page provides a quick cookbook to setup a simple Samba Server on eComstation & OS/2.

Prerequsites:

1. Make sure you have a 32bit TCP/IP stack (this is TCP/IP Version 4.1, 4.2x and 4.3x, not Version 4.0x or earlier).

2. Uninstall TCPBEUI (NETBIOS over TCPI/IP) using MPTS. Samba works directly with TCP/IP and occupies the same port number as TCPBEUI, therefore you cannot use TCPBEUI and Samba together. Here is a cookbook how to uninstall NetBIOS over TCP/IP manually.

3. Samba must be installed on a partition that supports long filenames, such as HPFS(386), JFS or FAT32. Samba cannot be installed on FAT16.

4. SET UNIXROOT=x: where x: is the drive that has a /etc/ path. In addition SET TMPDIR=x:\tmp where x:\tmp is any valid directory to put temporary files on.

The next 2 steps are not required, in case you install a recent WPI package:

5. Unzip ​ftp://ftp.netlabs.org/pub/gcc/alpha/baselayout.zip to the %UNIXROOT% drive or directory. Among other directories, this creates the required /etc directory as mentioned in prerequisites step 3.

6. Get the current ​kLibc runtime. It is recommended that you install the libc*.dll files using this package, even if they are already present on your system.

When you downloaded the .zip file you have to procede with the manual setup. When you downloaded the WarpIn version the installer will completes all further steps for you. In addition the WarpIN package comes with scripts and external commands preconfigured.

Note: Only older builds (3.0.9 and older) rely on Security/2. Newer builds (after 3.0.9) use libc's user/group functions to determine if a user is valid or not.

Manual setup:

1. Edit %UNIXROOT%\etc\master.passwd and add the users that you need. You might want to add user pcguest (See step 4 why). Look here for syntax of master.passwd (and group)!

2. Remove the old %UNIXROOT%\etc\pwd.db and %UNIXROOT%\etc\spwd.db files.

3. Run %UNIXROOT%\usr\sbin\pwd_mkdb.exe %UNIXROOT%\etc\master.passwd. This creates new pwd.db and swd.db files.

4. In %ETC% directory create %ETC%\samba directory, in %ETC%\samba create %ETC%\samba\private, %ETC%\samba\pid and %ETC%\samba\lock directories.

5. Edit smb.conf which should be put into %ETC%\samba\. A sample smb.conf comes with the .zip package of Samba. A complete reference for the smb.conf file can be found ​here

Note: The %ETC% path is not necessarily the same as %UNIXROOT%\etc.

Note: The default config file smb.conf has provision for a guest account pcguest this user must be either added to master.passwd, the guest access commented out of smb.conf; or the user changed to a user that does exist in master.passwd.

6. Now Samba requires the users to be added using smbpasswd.exe, too. You have to add all users twice: First to etc\master.passwd (see step 3), then using smbpasswd.exe.

To add a user called 'psmedley' run:

smbpasswd -a psmedley (enter password).

Note: Currently users can only be renamed from a Windows client.

Note: The smbusers.exe utility perform both steps''

7. Start nmbd.exe and start smbd.exe.

SWAT:

To configue Samba server it is best to take SWAT. SWAT is a web Admin interface. Here is a cookbook how to use SWAT as an Apache CGI.