ACC SHELL

Binary packages and bug reporting
---------------------------------
Please check http://en.openSUSE.org/Samba for general information on Samba as
part of SUSE Linux Enterprise or openSUSE products, links to binary packages
of the most current Samba version, and a bug reporting how to.

Documented example configuration
--------------------------------
The installed sample configuration at /etc/samba/smb.conf is a stripped down
version of the full commented and with deactivates examples enriched file as
from /usr/share/doc/packages/samba/examples/smb.conf.SUSE  While building
the package all comments are removed like running testparm on this file.

Samba packaging organisation
----------------------------
The packaging split Samba in several components.  This allows you to install
only the components you need.  The most common package is samba-client which
also includes the main configuration file /etc/samba/smb.conf.

As a result you can't install samba-winbind or the main Samba package, samba
without also installing samba-client.

Package name        Content
samba               smb and nmb daemon and utilities, SWAT
samba-client        smb.conf, client utilities
samba-doc           Documentation (noarch)
samba-pdb           Password Database plugins
samba-python        Python bindings
samba-vscan         On-access virus scanning VFS modules
samba-winbind       Name Service Switch resolving names from NT servers
ldapsmb             Tool to simplify Samba LDAP administration
libmsrpc            Msrpc library
libmsrpc-devel      Development files of the msrpc library
libsmbclient        Smb client library
libsmbclient-devel  Development files of the smb client library

Printing
--------
To access printers, these samba packages use CUPS by default. If you want
to use a different printing subsystem, like LPRNG, set
"printing = LPRNG" and
"print name = /etc/printcap" in /etc/smb.conf.

smbfs and nmb service
---------------------
If your Linux system should mount a remote SMB/ CIFS share and the remote
system is not in the broadcast domain of the Linux system, it might be useful
to also activate, configure and start the nmb service. Especially if you use
NetBIOS names and not IP addresses of the target.

For activation of the nmb service use insserv or the YaST runlevel editor. By
this the nmb service is started automatically while the system startup.

To configure edit /etc/samba/smb.conf.

To start the nmb service by hand call rcnmb start.

Setup a particular environment for a Samba daemon
-------------------------------------------------
It's possible to pass extra environment settings to nmbd, smbd, and winbindd.
Therefore set SAMBA_NMBD_ENV, SAMBA_SMBD_ENV, or SAMBA_WINBINDD_ENV in
/etc/sysconfig/samba

For example SAMBA_WINBINDD_ENV="/usr/local/ldap:LDAPCONF=/usr/local/ldap/etc"
will only export LDAPCONF with the mentioned path if /usr/local/ldap exists.
It's possible to set a variable without a check by omitting the first path and
the colon.

umount.cifs permissions
-----------------------
By default umount.cifs isn't installed setuid root.  If you would like to
allow users a umount of CIFS filesystems please adjust the permissions via one
of the /etc/permissions* files.

usershares
----------
The usershare default directory /var/lib/samba/usershares is not packaged with
any Samba RPM.  The main reason is not to bother the users with changed
permissions after any package update.

To activate usershares you have to set 'usershare max shares' to something not
equal zero in smb.conf, create the directory, and set appropriate permissions.

In the following example any member of the group named 'users' will be able to
create usershares:

mkdir /var/lib/samba/usershares
chown root:users /var/lib/samba/usershares
chmod 1770 /var/lib/samba/usershares

/var/spool/samba no longer part of any Samba RPM package
--------------------------------------------------------
/var/spool/samba is no longer part of any Samba RPM package.  As the directory
never was shipped with the permissions required for a spool dir we had
recurrent complains about changed permissions after any update.  As the dir is
no longer in any package file list RPM will remove it while an update if it is
empty.  Therefore you have to recreate the dir by hand, set the appropriate
permissions one time and we'll never bother you with any changes.

You might even consider to use /var/tmp as the spool dir for Samba instead.

How to view the Samba package detailed changelog?
-------------------------------------------------
If the package is installed type: rpm -q --changelog samba | less
If not type: rpm -qp --changelog /path/to/the/samba*.rpm | less