= 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. [wiki:"UninstallTCPBEUI" 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. 

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 [wiki:"Scripts and utilities" 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 [wiki:MasterPasswdSyntax 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 [http://us1.samba.org/samba/docs/man/manpages-3/smb.conf.5.html 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 [wiki:"Scripts and utilities" utilities] perform both steps!''

 8. Start nmbd.exe and start smbd.exe.

== SWAT: ==

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