Samba on NonStop User Manual

3 Configuration
Configuration Overview
NS-Samba must be configured appropriately to provide services mentioned in “Features Available
in NS-Samba” (page 9). NS-Samba processes can be flexibly configured by a set of configuration
parameters which can be specified in the smb.conf file. See the smb.conf(5) manpage to
understand the options. This chapter describes various methods that can be used to configure
NS-Samba. For a quick overview, see “Quick Start” (page 25), which provides an example,
complete with instructions/commands to be used.
The smb.conf file is a configuration file for the NS-Samba suite. smb.conf contains runtime
configuration information for the NS-Samba programs. Configuration parameters are specified in
this file using one of the following methods:
• Editing smb.conf manually
A sample configuration file, /etc/samba/smb.conf.sample, is provided with the
NS-Samba suite. You can copy this file as /etc/samba/smb.conf and customize as per
your requirements.
• Using SWAT
SWAT is the Samba Web Administration Tool. It allows a NS-Samba administrator to configure
the complex smb.conf file using a web browser. For more information on SWAT, see the
swat manpage. For instructions on setting up and launching SWAT on a NonStop system,
see “Enabling SWAT” (page 16).
NOTE: Rewriting the configuration file using SWAT removes all comments.
After specifying the required parameters in the smb.conf configuration file, run it through the
testparm tool to check its internal correctness. For the command syntax, see the testparm(1)
manpage.
The smb.conf file specifies what portions of the NonStop file-system could be shared with which
users and how, imposing various security checks. Therefore, it is important to understand the
parameters, because, incorrect settings might lead to undesirable effects.
Enabling SWAT
SWAT provides a web browser based Graphical User Interface for configuring Samba. SWAT is
run under the control of the inetd super-server. To enable SWAT to launch through inetd, create
an entry for the SWAT service in the /etc/inetd.conf and /etc/services files:
• In /etc/services, add the following line:
swat 901/tcp
• Edit /etc/inetd.conf to include:
swat stream tcp nowait super.super /usr/sbin/swat swat
And then start the inetd super-server. See the inetd(8) manpage for details.
Launching SWAT
Before you launch SWAT, ensure that the prerequisite steps mentioned in “Enabling SWAT”
(page 16) are successfully completed. To launch SWAT, point your web browser to the following
address: http://[NonStop system name or IP address]:901.
16 Configuration