'''How to get going with Samba Server for OS/2:'''

1.) Uninstall TCPBEUI (NETBIOS over TCPI/IP) using MPTS.

2.) {{{SET UNIXROOT=x:}}} where x: is the drive that has a /etc/ path. 

Steps 1 and 2 are also the prerequisites for using the WarpIN installation package.
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.

3.) Unzip ftp://ftp.netlabs.org/pub/gcc/alpha/baselayout.zip to the %UNIXROOT% drive. Among other directories this creates the required /etc directory.

4.) Edit {{{%UNIXROOT%\etc\master.passwd}}} and add the users that you need. You might want to add user pcguest (See step 6 why).

Note the syntax of master.passwd - first field before the colon is username, second is password (leave this blank), third is usernumber which must be unique - others aren't important right now.

5.) Remove the old {{{%UNIXROOT%\etc\pwd.db}}} and {{{%UNIXROOT%\etc\spwd.db}}} files.

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

7.) Edit smb.conf which should be put into %ETC%\samba\* 

Note %ETC% path is not necessarily the same as %UNIXROOT%\etc!

Note that 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

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

9.) Start nmbd.exe and start smbd.exe.