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

 4. Get the current [ftp://ftp.netlabs.org/pub/gcc/libc-0_6_3-csd3.wpi kLibc runtime]. It is recommended that you install the libc*.dll files using this package, even if they are already present on your system.

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 [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 is best to take SWAT. SWAT is a web Admin interface. [wiki:"SWAT" Here is a cookbook how to use SWAT as an Apache CGI].