Samba 2.0.4b for MacOS X Server Package Notes

May 24, 1999

This package contains Samba 2.0.4b, a SMB/CIFS file and print server pre-compiled for PowerPC processors running MacOS X Server 1.1. The Samba Web Administration Tool (SWAT) is included and is installed with the package. After installation, SWAT can be accessed at http://localhost:901/ or replace "localhost" with the host name of the server. Samba must be configured before it can run properly. This distribution includes the documentation and examples from the original source distribution, but not the source code. To obtain the full source distribution or for more information about Samba, refer to the Samba web pages at http://www.samba.org/. The documentation for each configuration directive is also directly linked from within SWAT.

This package is produced for your convenience and no warranty is expressed or implied. You need to know that the installation might cause problems on your machine and you assume all the risks by installing this package.

Release Notes

Samba 2.0.4b fixes the problems that Samba 2.0.3 had with Windows NT clients. Therefore, this workaround should not be required anymore:

nt pipe support = no
nt smb support  = no

Also, this package includes the Samba test program, smbtorture. This program is not part of the standard Samba compile and binary supplied includes several fixes to enable it to work under Mac OS X Server. I will be submitting the patches I have made for smbtorture as well as other changes for Mac OS X Server to the Samba team.

For a full list of the changes made to make 2.0.4b, please refer to the document, WHATSNEW.txt

Installation Notes

This package does not configure Samba for you. Rather, it includes the precompiled binaries and sets up Samba enough to run the SWAT. You will still have to go through the various configuration directives and plug in the proper information for Samba to work for you. Samba comes with extensive documentation as well as example configuration files which are included in this package. Look in samba-2.0.4b/docs/textdocs/DIAGNOSIS.txt as well as the Samba FAQ if you have problems getting Samba to run properly.

The files that are specific to this package are installed in /usr/local/samba/MacOSXServer_package_material.

The man pages included will not be visible to the man command unless you modify your MANPATH environment variable to include /usr/local/samba/man.

Here are the details of what this package installer does. After the files have been installed, a script runs to do some basic setup. The script creates the services entry and the inetd.conf entry to run SWAT. It also sends a HUP signal to inetd to have it re-read its configuration file. Finally, the script makes to modifications to start Samba as a daemon during the bootstrap sequence. It copies a startup script, 5100_Samba into /etc/startup and modifies the /etc/hostconfig file with the addition of a line, "SAMBASERVER=-YES-". Note that there is no GUI to change that entry. You will have to manually modify the /etc/hostconfig file to stop the Samba server from starting at boot time. Finally, if no smb.conf file exists, it copies one from the default example. It also creates an empty smbpasswd file if none exists.

A script also runs after the package is deleted to remove the modifications made during the installation of the package. Note that the delete script leaves samba/private/smbpasswd and samba/lib/smb.conf. You can manually delete these files if you do not want to save them.

The original hostconfig and inetd.conf files are saved during installation and deletion. The original smb.conf and smbpasswd files are also not modified if they already exist. However, I would strongly recommend that you save a back up of these files.

Building Samba from Source on MacOS X Server

This package contains the default build of Samba. If you need additional features, you will have to build Samba yourself. Samba builds cleanly from the original source with one exception, the config.guess script do not recognize MacOS X Server. Here are the directions:
  1. Get the Samba source distribution. This package does not include the source to 2.0.4b. Look on http://www.samba.org/ for a nearby download site.
  2. Unpack the distribution.
  3. If this change was not done already, copy /usr/libexec/config.guess to the samba-2.0.4b/source directory.
  4. Open a terminal window and cd to the source directory
  5. Read the documentation in samba-2.0.4b/docs and decide which configuration flags you want to use for the build. Append those flags to the end of the next command.
  6. Type "./configure --prefix=/usr/local"
  7. Type "make"
  8. Assuming there were no problems, type "make install"
  9. Follow the directions for installing SWAT and starting Samba during boot if they have not been installed already. Alternatively, you can run the Samba.post_install script included in this package.

    Note that the smbtorture binary that is included has modifications from the original 2.0.4b source. I will be releasing a patch to the Samba team and therefore the changes will be in later Samba source releases.

This package was created by Bill Chin, wchin@acm.org