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. SET UNIXROOT=x: where x: is the drive that has a /etc/ path.

4. 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.

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

These prerequisites are also valid, when using the WarpIN installation package.

Note: The WarpIN installer checks whether the above package is installed (not the presence of the DLLs).

Whereas the installer completes all further steps for you, you have to continue at step 3 in case you want to procede manually. In addition the WarpIN package comes with scripts and external commands preconfigured.

Note:The 3.0.2x builds do not currently rely on Security/2, instead they use libc's user/group functions to determine if a user is valid or not. The older 3.0.9 builds relied on Security/2.

Setup:

1. 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.

2. 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)!

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

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

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

6. 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.

7. 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 cannot be renamed.

Note: The UserAddPM.EXE and UserDelPM.EXE utilities perform both steps''

8. 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.