wiki:Cookbook

Version 8 (modified by guest, 16 years ago) (diff)

smal fix

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

These prerequisites are also valid when 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.

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.
  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)!
  1. Remove the old %UNIXROOT%\etc\pwd.db and %UNIXROOT%\etc\spwd.db files.
  1. Run %UNIXROOT%\usr\sbin\pwd_mkdb.exe %UNIXROOT%\etc\master.passwd. This creates new pwd.db and swd.db files.
  1. In %ETC% directory create %ETC%\samba directory, in %ETC%\samba create %ETC%\samba\private, %ETC%\samba\pid and %ETC%\samba\lock directories.
  1. 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.

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

  1. Start nmbd.exe and start smbd.exe.

SWAT:

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