= 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. In addition {{{SET TMPDIR=x:\tmp}}} where {{{x:\tmp}}} is any valid directory to put temporary files on.

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

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

 6. Samba must be installed on a 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.

When you downloaded the .zip file you have to procede with the manual setup. When you downloaded the WarpIn version the installer will completes all further steps for you. In addition the WarpIN package comes with [wiki:"Scripts and utilities" scripts and external commands] preconfigured.

''Note: Only older builds (3.0.9 and older) rely on Security/2. Newer builds (after 3.0.9) use libc's user/group functions to determine if a user is valid or not.''

== Manual setup: ==

 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 [wiki:MasterPasswdSyntax syntax of master.passwd (and group)]! 

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

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

 4. In {{{%ETC%}}} directory create {{{%ETC%\samba}}} directory, in {{{%ETC%\samba}}} create {{{%ETC%\samba\private}}}, {{{%ETC%\samba\pid}}} and {{{%ETC%\samba\lock}}} directories.

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

 6. 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 can only be renamed from a Windows client.''

''Note: The smbusers.exe [wiki:"Scripts and utilities" utility] perform both steps!''

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