= Samba for eComStation (OS/2) =
[[PageOutline]]

[http://www.samba.org/ Samba] is a free implementation of the CIFS/SMB protocol for Unix, which allows LAN-Server style file and printer sharing among machines running Windows, Mac OS, Unix or [http://www.ecomstation.com/ eComStation] (OS/2). The goal of this project is to port the Samba server and create Samba clients for eCS (OS/2) in order to replace the functionality of the outdated IBM-LAN-!Requester/Peer/Server components.[[BR]]

Please, consider the pages of this wiki to be your online documentation for Samba for eCS (OS/2)!
[[br]][[br]]

== Official Releases ==
''In the tables below the latest GA (General Availability, stable) release is always marked as '''Bold'''''
[[br]]
=== Additional software prerequisites ===
It is strongly recommended to install from the WPI packages.
||'''kLibc 0.6.3 Library'''||[ftp://ftp.netlabs.org/pub/gcc/libc-0_6_3-csd3.wpi WPI]||kLibc Runtime libraries required by all Samba related installations.||
||'''kLibc 0.6.4x Library'''||[ftp://ftp.netlabs.org/pub/samba/server/libc-0_6_4x.wpi WPI]||Extended kLibc Runtime library required by Samba Server installations.||
||'''GCC 4 Core Libraries'''||[ftp://ftp.netlabs.org/pub/gcc/gcc4core.wpi WPI]||GCC 4 runtime libraries required by all Samba related installations.||
||'''REXX libraries 1.1.1'''||[ftp://ftp.netlabs.org/pub/samba/server/rxlib4smb.wpi WPI]||Several REXX libraries required for running the Samba GUI Tools, '''please, uninstall any older revision of this package!''' || 

[[br]]

=== Server ===
[[Image(wiki:WikiStart:smbfldr.jpg, 300px, right)]]
The eComStation (OS/2) server port is very fast and stable, and although still incomplete, very usable for daily work. It can be used to perform the following tasks:[[BR]]

 * share files among eCS (OS/2), Windows, Mac OS and Unix machines, including extended attribute support.
 * share printers among eCS (OS/2), Windows, Mac OS and Unix machines.

[ftp://ftp.netlabs.org/pub/samba/server Quick access to all server files][[br]][[br]][[br]]
==== Samba 3.0.x based releases ====
||'''Release date'''||'''State'''||'''Component'''||'''Version'''||'''Based upon'''||'''Package'''||'''Description'''||
||21th. Feb. 2011||'''GA'''||Server core files||1.0.6||[http://www.samba.org/samba/history/samba-3.0.37.html Samba 3.0.37]||[ftp://ftp.netlabs.org/pub/samba/server/samba-1-0-6.zip ZIP]||Required to share files and printers, stable, deprecated||
||21th. Feb. 2011||'''GA'''||Installation package||1.0.6||[http://www.samba.org/samba/history/samba-3.0.37.html Samba 3.0.37]||[ftp://ftp.netlabs.org/pub/samba/server/samba-1-0-6.wpi WPI]||Required to share files and printers, stable, deprecated||[[br]]
''NOTE: The Samba 3.0.xx code is neither supported, nor maintained anymore!''

==== Samba 3.3.x based releases ====
||'''Release date'''||'''State'''||'''Component'''||'''Version'''||'''Based upon'''||'''Package'''||'''Description'''||
||'''26th. June 2011'''||'''GA'''||Server core files||1.1.0||[http://www.samba.org/samba/history/samba-3.3.15.html Samba 3.3.15]||[ftp://ftp.netlabs.org/pub/samba/server/samba-1.1.0-3.3.15.565-eCS-20110623.zip ZIP]||Required to share files and printers||
||'''26th. June 2011'''||'''GA'''||Installation package||1.1.0||[http://www.samba.org/samba/history/samba-3.3.15.html Samba 3.3.15]||[ftp://ftp.netlabs.org/pub/samba/server/test/samba-1-1-0-580.wpi WPI]||Required to share files and printers, stable, easy installation||
||'''06th. July 2011'''||'''GA (Refresh)'''||RxLib4Smb||1.1.1||-||[ftp://ftp.netlabs.org/pub/samba/server/rxlib4smb.wpi WPI]||'''REXX libraries required to install the Server WPI package!!! '''|| 

==== Samba 3.5.x based releases ====
||'''Release date'''||'''Type'''||'''Component'''||'''Version'''||'''Based upon'''||'''Package'''||'''Description'''||
||03rd Aug. 2010||beta||Server core files||1.2.beta2||[http://www.samba.org/samba/history/samba-3.5.4.html Samba 3.5.4]||[ftp://ftp.netlabs.org/pub/samba/server/samba-12beta2-354-20100803.zip ZIP]||Really experimental, migration from 3.0.x releases not possible! ||
||28th. June 2011||beta||Server core files||1.2.beta3||[http://www.samba.org/samba/history/samba-3.5.5.html Samba 3.5.5]||[ftp://ftp.netlabs.org/pub/samba/server/samba-12beta3-355-20110628.zip ZIP]||Still experimental, migration from 3.3.x releases works! ||
||30th. June 2011||beta||Server core files||1.2.beta4||[http://www.samba.org/samba/history/samba-3.5.6.html Samba 3.5.6]||[ftp://ftp.netlabs.org/pub/samba/server/samba-12beta4-356-20110630.zip ZIP]||Still experimental, migration from 3.3.x releases works! ||
||01th. July 2011||beta||Server core files||1.2.beta5||[http://www.samba.org/samba/history/samba-3.5.7.html Samba 3.5.7]||[ftp://ftp.netlabs.org/pub/samba/server/samba-12beta5-357-20110701.zip ZIP]||Still experimental, migration from 3.3.x releases works! ||
||02th. July 2011||beta||Server core files||1.2.beta6||[http://www.samba.org/samba/history/samba-3.5.8.html Samba 3.5.8]||[ftp://ftp.netlabs.org/pub/samba/server/samba-12beta6-358-20110701.zip ZIP]||Still experimental, migration from 3.3.x releases works! ||
||07th. July 2011||beta||Server core files||1.2.beta7||[http://www.samba.org/samba/history/samba-3.5.9.html Samba 3.5.9]||[ftp://ftp.netlabs.org/pub/samba/server/samba-12beta7-359-20110706.zip ZIP]||Appears to be stable in basic tests, migration from 3.3.x releases works! ||
||07th. July 2011||beta||Installation package||1.2.beta7||[http://www.samba.org/samba/history/samba-3.5.9.html Samba 3.5.9]||[ftp://ftp.netlabs.org/pub/samba/server/samba-1-2-beta7.wpi WPI]||Preliminary installation package, browsing from smbmon does not work. ||

==== Server Tools ====
The Server GUI Tools are also installed by default when you install a samba server with a !WarpIN package. They are not included in the Samba server zip files.

||'''Release date'''||'''State'''||'''Component'''||'''Version'''||'''Based upon'''||'''Package'''||'''Description'''||
||'''23th. June 2011'''||'''GA'''||RxLib4Smb||1.1.0||-||[ftp://ftp.netlabs.org/pub/samba/server/rxlib4smb.wpi WPI]||Rexx libraries required for the GUI Tools|| 
||'''26th. June 2011'''||'''GA'''||SSCC||1.0.2||-||[ftp://ftp.netlabs.org/pub/samba/server/guitools/sscc-102-20110627.zip ZIP]||GUI Tool for server configuration and installation||
||'''26th. June 2011'''||'''GA'''||SMBUsers||1.0.0||-||[ftp://ftp.netlabs.org/pub/samba/server/guitools/smbusers-100-20110627.zip ZIP]||GUI Tool for user and group administration||
||'''15th. Aug. 2010'''||'''GA'''||SMBMon||1.9.0||-||[ftp://ftp.netlabs.org/pub/samba/server/guitools/smbmon-190-20100815.zip ZIP]||GUI Tool for Samba status monitoring||
[[br]]
''NOTE: Do not use Expert mode if you are using Samba 3.3.x and SSCC Version 1.0.1 or earlier, it will trash your smb.conf!

=== Clients ===
The eComStation (OS/2) clients can be used to perform the following tasks:

    * access shared files on servers running Samba (eCS (OS/2), Unix) or Windows (Server or Workstation; NT 4 or better), including extended attribute support.
    * print on printer servers that provide SMB/CIFS services. 
[ftp://ftp.netlabs.org/pub/samba/client Quick access to all client files]
[[br]]
==== Netdrive based ====
[http://www.blueprintsoftwareworks.com/netdrive/download.html NetDrive for eComStation (OS/2)] is required to be installed. !NetDrive is a virtual filesystem driver, which is extensible with plugins for various filesystems. We provide a !NetDrive plugin for Samba access.

||'''Release date'''||'''State'''||'''Component'''||'''Version'''||'''Based upon'''||'''Package'''||'''Description'''||
||11th. May 2009||GA||Plugin||1.0||[http://www.samba.org/samba/history/samba-3.0.34.html Samba 3.0.34]||[ftp://ftp.netlabs.org/pub/samba/client/ndpsmb-1.0-3.0.34-20090511.zip ZIP]||Required to access shared files, deprecated||
||03rd. Nov 2010||'''GA'''||Plugin||1.5.3||[http://www.samba.org/samba/history/samba-3.0.37.html Samba 3.0.37]||[ftp://ftp.netlabs.org/pub/samba/client/ndpsmb-1.5.3-GA-3.0.37-20101103.zip ZIP]||Required to access shared files, deprecated||
||06th. March 2011||'''GA (Refresh2)'''||Plugin||2.0.1||[http://www.samba.org/samba/history/samba-3.0.37.html Samba 3.0.37]||[ftp://ftp.netlabs.org/pub/samba/client/ndpsmb-2_0_1-GA-20110306.zip ZIP]||Required to access shared files, dir caching, deprecated||
||06th. March 2011||'''GA (Refresh2)'''||Plugin||2.0.1||[http://www.samba.org/samba/history/samba-3.0.37.html Samba 3.0.37]||[ftp://ftp.netlabs.org/pub/samba/client/ndpsmb-2_0_1-GA-20110306.wpi WPI]||Required to access shared files, dir caching, deprecated||
||'''28th. June 2011'''||'''GA'''||Plugin||2.1.0||[http://www.samba.org/samba/history/samba-3.3.15.html Samba 3.3.15]||[ftp://ftp.netlabs.org/pub/samba/client/ndpsmb-2_1_0-GA-20110628.zip ZIP]||Required to access shared files, dir caching, 3.3.x based||
||'''28th. June 2011'''||'''GA'''||Plugin||2.1.0||[http://www.samba.org/samba/history/samba-3.3.15.html Samba 3.3.15]||[ftp://ftp.netlabs.org/pub/samba/client/ndpsmb-2_1_0-GA-20110628.wpi WPI]||Required to access shared files, dir caching, 3.3.x based||[[br]]
''NOTE: The Samba 3.0.xx code is neither supported, nor maintained anymore!''


==== EVFS based ====
EVFS (eComStation Virtual Filesystem for SMB) is installed by default on eComstation version 2.0 GA or better (It was included in some eCS 2.0 RC as well). EVFS also makes use of the !NetDrive plugin for Samba access.

||'''Release date'''||'''State'''||'''Component'''||'''Version'''||'''Based upon'''||'''Package'''||'''Description'''||
||11th. May 2009||GA||Plugin||1.0||[http://www.samba.org/samba/history/samba-3.0.34.html Samba 3.0.34]||[ftp://ftp.netlabs.org/pub/samba/client/ndpsmb-1.0-3.0.34-20090511.zip ZIP]||Required to access shared files, deprecated||
||03rd. Nov 2010||GA||Plugin||1.5.3||[http://www.samba.org/samba/history/samba-3.0.37.html Samba 3.0.37]||[ftp://ftp.netlabs.org/pub/samba/client/ndpsmb-1.5.3-GA-3.0.37-20101103.zip ZIP]||Required to access shared files, stable, deprecated||
||06th. March 2011||GA (Refresh2)||Plugin||2.0.1||[http://www.samba.org/samba/history/samba-3.0.37.html Samba 3.0.37]||[ftp://ftp.netlabs.org/pub/samba/client/ndpsmb-2_0_1-GA-20110306.zip ZIP]||Required to access shared files, deprecated||
||06th. March 2011||GA (Refresh2)||Plugin||2.0.1||[http://www.samba.org/samba/history/samba-3.0.37.html Samba 3.0.37]||[ftp://ftp.netlabs.org/pub/samba/client/ndpsmb-2_0_1-GA-20110306.wpi WPI]||Required to access shared files, deprecated||
||'''28th. June 2011'''||'''GA'''||Plugin||2.1.0||[http://www.samba.org/samba/history/samba-3.3.15.html Samba 3.3.15]||[ftp://ftp.netlabs.org/pub/samba/client/ndpsmb-2_1_0-GA-20110628.zip ZIP]||Required to access shared files, dir caching, 3.3.x based||
||'''28th. June 2011'''||'''GA'''||Plugin||2.1.0||[http://www.samba.org/samba/history/samba-3.3.15.html Samba 3.3.15]||[ftp://ftp.netlabs.org/pub/samba/client/ndpsmb-2_1_0-GA-20110628.wpi WPI]||Required to access shared files, dir caching, 3.3.x based||[[br]]
''NOTE: The Samba 3.0.xx code is neither supported, nor maintained anymore!''


==== Client Tools and GUI ====

||'''Release date'''||'''State'''||'''Component'''||'''Version'''||'''Based upon'''||'''Package'''||'''Description'''||
||01th. Sept. 2009||GA||EVFSGUI||1.3.7||-||[http://www.ecomstation.com/ Link]||Setup and manage connections, deprecated.||
||'''13th. June 2011'''||'''GA'''||EVFSGUI||2.1.2||Plugin 1.5.x or 2.x.x||[ftp://ftp.netlabs.org/pub/samba/client/evfsgui/evfsgui-212-GA-20110613.wpi WPI]||Setup and manage connections|| 
||08th. March 2011||'''GA'''||Commandline utilities||1.0.6||[http://www.samba.org/samba/history/samba-3.0.37.html Samba 3.0.37]||[ftp://ftp.netlabs.org/pub/samba/client/smbclut/smbclut-1.0.6-os2-3.0.37-20110308.zip ZIP]||Required by EVFSGUI Ver. 2.x||
||07th. July 2010||'''GA'''||Commandline utilities||1.1.0||[http://www.samba.org/samba/history/samba-3.3.13.html Samba 3.3.13]||[ftp://ftp.netlabs.org/pub/samba/client/smbclut/smbclut-1.1.0-os2-3.3.13-20100707.zip ZIP]||Required by EVFSGUI Ver. 2.x||
||30th. Mar. 2010||'''GA'''||Port driver ||1.0.1||[http://www.samba.org/samba/history/samba-3.3.12.html Samba 3.3.12]||[ftp://ftp.netlabs.org/pub/samba/pdr/smb_pdr-1.0.1-20100330.zip ZIP]||Required to print to shared printers or CIFS/SMB based printer servers||

''Note: EVFSGUI also can be used together with !NetDrive in order to manage SMB/CIFS connections. This makes sense, as EVFSGUI provides functionality for SMB/CIFS connections not found in the !NetDrive GUI. For other connection types you will however still need the !NetDrive GUI.''

==== Updating eComstation with EVFS ====
In order to update eComStation with an installed EVFS, you will need the following packages:
 * from the section "EVFS based" client a '''plugin''' package plus
 * from the section "Client Tools and GUI" an '''EVFSGUI''' package plus 
 * from the section "Client Tools and GUI" a '''Commandline utilities''' package
In case you prefer WPI:
 * take this [ftp://ftp.netlabs.org/pub/samba/client/ndpsmb-2_0_1-GA-20110306.wpi 2.0.1 level Plugin WPI package] AND
 * take this [ftp://ftp.netlabs.org/pub/samba/client/evfsgui-212-GA-20110613.wpi 2.1.2 level EVFSGUI WPI package]

''Note: The Samba Client WPI that comes with eComStation 2.0 GA is on 2.0.4 level.''
''Note: The Samba Client WPI that comes with eComStation 2.1 GA is on 2.1.0 level.''
[[br]][[br]]

== Interim Releases ==

Herwig Bauernfeind sometimes provides interim releases and test builds of Samba server, clients, GUI tools and scripts on his [http://members.aon.at/herwig.bauernfeind/samba/index.html Samba for eCS (OS/2)] page.
[[BR]][[br]]

== [wiki:"FAQ" FAQ] Frequently Asked Questions and Answers ==

Here is our ever growing collection of useful Samba for eCS (OS/2) [wiki:"FAQ" Frequently Asked Questions] and Answers. 
[[br]][[br]]

== More Information ==

 * How to setup [wiki:"Cookbook" Samba]
 * Useful Samba [wiki:"Scripts and utilities" scripts and utilities]
 * Samba was tested with [wiki:"Currently tested clients:" these clients]
 * Currently known Samba [http://svn.netlabs.org/samba/report/1 issues (open Tickets)]
 * Samba Development [http://svn.netlabs.org/samba/roadmap Progress]
 * Samba [wiki:"links" links collection]
 * Samba 3.x/4.x [wiki:"ScratchPad" scratchpad]
 * Samba for eCS (OS/2) [wiki:"CodeMaintenance" code maintenance]
[[br]]

== Reporting Bugs ==

Reporting bugs and requesting new features is done through the ticket system. You can view existing tickets, add comments to them and create new tickets using the corresponding buttons at the top of every page. If you want to submit a new bug or request a feature, please use the Search function first to make sure there is no ticket for this task already created.[[BR]]
We review the tickets regulary and leave comments if we need more info. So please revisit the [http://svn.netlabs.org/samba/report/14 Feedback analysis] as often as possible. If we leave comment and don't get feedback from the ticket creator, we will close the ticket after some weeks.[[BR]][[BR]]
Anonymous access to the ticket system has been restricted due to multiple attacks of stupid spammers we've been suffering from during the last month. In order to create a new ticket or comment the existing one, you need to login with your Netlabs login id. If you do not have a login id, you can request one at  http://www.netlabs.org/en/site/member/member.xml. We are sorry for inconvenience, but at the present time this is the only way to avoid extremely annoying spam.[[BR]]
[[br]]
== Mailinglist ==

 * [http://news.gmane.org/gmane.org.netlabs.samba.user]

== Credits ==

 * Silvan Scherrer (aka diver), current core code maintenance, recent core fixes and additions
 * Herwig Bauernfeind (aka HerwigB), testing, maintenance of Samba Server and Client GUI (EVFSGUI 2.x) tools, scripts and WPI installation packages
 * Vitali Pelenyov (aka sunlover), provides Samba Client caching
 * Paul Smedley (aka Smedles), provided historic Samba 3.0.24 port, groundwork for current port
 * Yuri Dario (aka Paperino), provided workable locking code and other important fixes
 * Alex Taylor (aka AlexT), provided historic EVFSGUI 1.x, fixes for 2.x
 * Nikolay Kolosov (aka nickk), provided historic Samba 3.0.9 port
 * and all we missed

Thanks for testing!

== Screenshots ==
 * coming soon