Amiga Installation notes ======================== This is just a quick list of notes that will be useful for someone trying to install Samba on an Amiga. However, this is not all there is to be said about installing Samba, and the person performing the installation *will* be required to use his/her brain to at several points during installation. If someone wants to write an installer script or better installation notes, feel free to do so. I'll happily include it the next port (if any). There are lots of valuable pieces of information in the "docs" directory. If you need help, you can subscribe to the Samba mailing list (see "docs/announce"). I am on the Samba mailing list, and so are other Samba users. If you have had Samba installed previously, you should still go through all of these points, checking that things are set up correctly. Things have changed since my last port (see "Amiga Changes"). 1. The file "docs/INSTALL.txt" mention running the deamons (nmbd and smbd) in stand-alone mode. This is not currently support for smbd on the Amiga, it needs to be run from inetd. This should't give any problems, though. 2. The default path names in the Makefile were chosen with users of AmiTCP and the other Samba port in mind. If you create a directory named "samba", put all of the files in that directory and have "AmiTCP:" assigned to the parent of that directory, installation will be much easier. AmiTCP users will probably want to put all the Samba files in "AmiTCP:samba" for this reason. However, the default location of the Samba files can be overridden using either command line arguments or settings in the configuration file. 3. An example configuration file is provided in "lib/smb.conf". It sets up a few services, just to serve as an example. You will most likely have to modify it to be usable on your system. See the file "docs/smb.conf.0" for the configuration file documentation. There are more examples in the "examples" drawer. 4. Append the file "inetd.conf.addon" to your "AmiTCP:db/inetd.conf" or "INET:db/inetd.conf" file and edit it to suit your system. 5. Append the file "services.addon" to your "AmiTCP:db/services" or "INET:db/services" but DON'T edit it. 6. Create a user account to use as a guest user. You can do this by appending "passwd.addon" to your "AmiTCP:db/passwd" or "INET:db/passwd" and appending "group.addon" to your "AmiTCP:db/group" or "INET:db/group". This will create a user named "pcguest" who will be a member of the gruop "guest". You will probably have to adjust the user ID and group ID to suit your existing setup. If you have any experience in doing this, don't use the "passwd.addon" and "group.addon" files, but create the "pcguest" account from scratch or modify lib/smb.conf to use an existing guest user ("guest account = myguest"). Don't use user/group IDs of 65535 or -1! 7. Insert the file "starnet.addon" into your "AmiTCP:bin/startnet" or "INET:bin/startnet" file just above the place you start "inetd" and edit as appropiate for your system. If you don't set TMPDIR, TMP: will be used instead. Make sure that the directory pointed to by TMDIR (or TMP:) exists and is writable. Otherwise, smbd will silently fail. 7. Assign "ETC:" to "AmiTCP:db" or "INET:db". I suggest adding this "Assign" command to either "S:User-Startup" or your "AmiTCP:bin/startnet" script. 9. Install ixemul.library 45.0 (or later) in LIBS: together with ixnet.library 45.0 (or later) (currently comes in the ixemul archive). You may also want to run "IXPrefs" to set up ixemul.library prefs. Note: As soon as 45.1 (or later) is released, upgrade to it! 45.0 and earlier versions don't handle multiuser stuff very well. If you get messages like "smbstatus should not be run setuid", it is because of this problem. 10. If "inetd" isn't running, start it now. Otherwise, tell it to reread it's configuration file if it doesn't do so automatically when it is configuration file changes. If that is not possible, stop it and restart it. See the documentation for "inetd" for details on how to do this. If none of this works, reboot. 11. "nmbd" will cause frequent access to the file "AmiTCP:samba/var/locks/browse.dat" (assuming you haven't specified another location for this file). This is normal and is a good sign. 12. Samba seems to hate Amiga file/drawer names. Instead of specifying "device:drawer/file", you should specify "/device/drawer/file", otherwise Samba fails or does other strange (although not dangerous) things. This probably applies to the TMPDIR environment variable too! 13. For external commands to work (printing, Winpop reception, etc.) you'll need to install a shell as "BIN:sh". This shell will be used to execute the external commands. I'm using pdksh 4.9 for this. I don't know if other shells will work or not since I haven't tried any. 14. Although the file "docs/SPEED.txt" suggests adding "TCP_NODELAY" to "socket options" in "lib/smb.conf", this seems to slow down tranfers *a lot*. I would like people to experiment with the various options, and tell me which settings give the best performance. 15. The manual pages are in "docs". Files ending in ".0" are formatted manual pages that can be read with More, Less or MultiView (with appropriate datatype installed). Files ending in ".[1-9]" are unformatted manual pages. To format them, use groff or an equivalent tool. 16. Subscribe to the Samba mailing list. See the file "docs/announce".