SAMBA SMB Server for UNIX Systems FREEWARE PRODUCT Version 1.9.17 README September 1997 Welcome to the SAMBA Server. This file describes how to install and configure the SAMBA Server. Further configuration documentation can be found in the SAMBA directory after installation. SAMBA as a FREEWARE application is not subject to the JSB License Agreement. The following sections are included in this README -------------------------------------------------- SECTION 1 - INTRODUCTION SECTION 2 - LISTS THE OPERATING SYSTEMS THAT ARE SUPPORTED SECTION 3 - DESCRIBES THE VARIOUS METHODS YOU CAN USE TO TRANSFER THE SOFTWARE FROM THE CD TO YOUR REMOTE SYSTEM SECTION 4 - DESCRIBES THE INSTALLATION PROCEDURE SECTION 5 - HOW TO RUN THE SERVER SECTION 6 - HOW TO TEST THAT THE SERVER IS WORKING SECTION 7 - TECHNICAL TIPS SECTION 8 - TECHNICAL SUPPORT SECTION 1 - INTRODUCTION SAMBA is FREEWARE. SAMBA is issued under a GNU public license, please see the file COPYING in the /usr/local/samba directory on your system for more information on SAMBA licensing. As a FREEWARE product, JSB do not warranty, or support, any of the functionality of this FREEWARE product. Please see the documentation in the SAMBA directory for more information on getting technical support and access to later releases of the SAMBA product. As per the distribution agreement, a copy of SAMBA in source form is available on the distribution media in the SAMBA directory. SECTION 2 - OPERATING SYSTEM PLATFORMS SUPPORTED The SMB Server is currently available on the following platforms, HP HP-UX for version 9.0x, 10.x IBM AIX for version 3.2.x and 4.x SCO UNIX for OS/3 ,OS/5 and UNIXWARE 2.1 (INTEL) SUN Solaris (SPARC) for version 2.5 SECTION 3 - TRANSFERRING THE SAMBA SERVER This section is only relevant if you are installing the SAMBA Server from CD. The information contained within this section explains the different ways how to transfer the SAMBA Server from the CD to your remote system. The SAMBA Server is stored on the CD in a compressed tar file as detailed below. HP HP-UX v9.0 and 10.x transfer, "smb_hp.Z" IBM AIX v3.2.x and AIX v4.x transfer, "smb_aix.Z" SCO UNIX OS/3 transfer, "smb_sco3.Z" SCO UNIX OS/5 transfer, "smb_sco5.Z" SCO UNIXWARE 2.1 (INTEL) transfer, "smb_uwar.Z" SUN Solaris (SPARC) v2.5 transfer, "smb_sol2.Z" Method 1 - With CD player connected to the remote host Insert the CD, change to the SAMBA Server directory and copy the file that corresponds to your operating system into a temporary directory, (e.g. "/tmp"). Method 2 - PC with a file transfer program available Using a file transfer client, for example MultiView 2000 or MultiView DeskTop file transfer, connect to your remote system. Change to the SAMBA Server directory on the CD, and transfer the file that corresponds to your operating system on your remote system into a temporary directory, (e.g. "/tmp"). Method 3 - Other physical media Should any of the above methods not be available, you can obtain the SAMBA Server from the following sources, WWW - www.jsb.com FTP - ftp.jsb.com BBS - +44 (0) 1260 296 267 For any other media requirement, please contact JSB directly. SECTION 4 - INSTALLING THE SAMBA SERVER To successfully install the SAMBA Server follow the steps detailed below for the appropriate operating system. Example SCO UNIX OS/3 Login to the remote system as root and move to the temporary directory as specified in SECTION 3, e.g. "/tmp". Type: uncompress smb_sco3.Z to uncompress the file containing the SAMBA Server. Type: tar xf smb_sco3 to extract the SAMBA Server. Type: ./install to install the SAMBA Server and follow the instructions. SECTION 5 - RUNNING THE SAMBA Server 1. Running the SAMBA server Type: startsmb on your remote server. This will invoke the SAMBA server as a background process. SECTION 6 - TESTING THE SAMBA SERVER STEP 1. Try listing the shares available on your server smbclient -L yourhostname Your should get back a list of shares available on your server. If you don't then something is incorrectly setup. Note that this method can also be used to see what shares are available on other LanManager clients (such as Windows for Workgroups). If you choose user level security then you may find that Samba requests a password before it will list the shares. See the smbclient docs for details. (you can force it to list the shares without a password by adding the option -U% to the command line. This will not work with non-Samba servers) STEP 2. try connecting with the unix client. eg: smbclient '\\yourhostname\aservice' Typically the "yourhostname" would be the name of the host where you installed smbd. The "aservice" is any service you have defined in the smb.conf file. Try your user name if you just have a [homes] section in smb.conf. For example if your unix host is bambi and your login name is fred you would type: smbclient '\\bambi\fred' NOTE: The number of slashes to use depends on the type of shell you use. You may need '\\\\bambi\\fred' with some shells. STEP 3. Try connecting from a dos/Windows for Workgroups/Win95/NT/os-2 client. Try mounting disks. eg: net use d: \\servername\service If problems are being expeirenced then check the log files generated in /usr/local/samba/var. log.smb - is generated by the smb server log.nmb - is generated by the nmb server (netbios name server) SECTION 7 - TECHNICAL TIPS 1) How to make a standalone SAMBA server restart automatically with the host machine A standalone server is started from the bootstrap command file (for example /etc/rc.local) so that it runs continuously. This method has the advantage over using the inetd that the response time is reduced. Add a line starting starsmb to your system startup file (usually /etc/rc.local or /etc/rc). /usr/bin/startsmb & >/dev/console 2>&1 2) How to make sure that the SAMBA man pages are available on your system The install script will put the manual pages for SAMBA in /usr/local/man. To ensure that these pages are available make sure that the MANPATH environment variable is set to include /usr/local/man. e.g. MANPATH=/usr/share/man:/usr/local/man: export MANPATH SECTION 8 - TECHNICAL SUPPORT As a FREEWARE product, JSB do not warranty, or support, any of the functionality of this FREEWARE product For technical information regarding the Samba Server please refer to the following locations: /usr/local/samba/docs/Support.txt - Contains information of organisations who are prepared to commercialy support Samba. /usr/local/samba/README - Contains important information about the configuration and use of Samba. /usr/local/samba/COPYING - Contains information on SAMBA's licensing. For upto date information please visit the following web address. http://samba.canberra.edu.au/pub/samba/samba.html