August 26, 1999
This package contains Samba 2.0.5a, a SMB/CIFS file and print server pre-compiled for PowerPC processors running MacOS X Server 1.0-2. 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.
nt pipe support = no
nt smb support = no
Samba can serve up files on either HFS+ or UFS filesystems. However, file locking will not work properly for serving up NFS mounted file systems. If you do so, be sure to test extensively; you might only have success with read only file systems over NFS. Also, on HFS+, there may be strange problems with file name case sensitivity since Samba might make assumptions that it is serving a case sensitive file system. I have not had a chance to test this.
Samba runs pretty slowly on MacOS X Server 1.0. Definitely try all the speed tuning suggestions given in the Samba documentation.
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. For full benchmarking, you need the client.txt file from the dbench distribution. 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.5a, please refer to the document, samba-2.0.5a/WHATSNEW.txt
Double click on the Samba.pkg file and Installer.app will automatically launch and open this installer package. Then press the Install button. Alternatively, you can use the installer.sh shell script or manually install the components yourself. The Samba.post_install script inside the Samba.pkg might be of interest. If you are upgrading from a previous Samba.pkg installation, open the Samba.pkg in /Local/Library/Receipts and press the delete button first. This will not erase your configuration files. Then install the new Samba.pkg.
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.5a/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.
The binaries, like smbstatus are located in /usr/local/samba/bin. You must specify the full path or add that directory to your path in order to execute those commands.
You can get additional help on the macosx-admin@omnigroup.com mailing list, the Apple MacOS X Server support forum, or the various Samba mailing lists. Definitely go through the samba-2.0.5a/docs/textdocs/DIAGNOSIS.txt file before asking for help. That will give you a better grasp as to where you are having a problem. I read the macosx-admin@omnigroup mailing list often.
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.
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:
Note that the smbtorture binary that is included has modifications from the original 2.0.5a 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