Netatalk

Netatalk is an open source implementation of the Apple File sharing Protocol (AFP). It supports Time machine and advertising of services with multicast dns (Bonjour in Apple's jargon).

See the netatalk site for more details: http://netatalk.sourceforge.net/

Installation from SFE Repository

There is now a netatalk 2.2.0 package available from the SFE repository.

If you don't have the SFE publisher configured, see this page for how to do it: http://wiki.openindiana.org/oi/Spec+Files+Extra+Repository

Then, netatalk can be installed with the following command:

(It appears that the 'libgcrpyt' and 'avahi' dependencies are missing from the SFE package at present, and these need to be installed before netatalk will run.)

Netatalk 3.0.1 is now in "experemental/SFEnetatalk3" This is still a work in progress, but should work.

Installation from source

Prerequisites

The following packages are required to run netatalk:

A build environment is required. You will need these packages installed if you don't already have them:

Or for building with gcc-3:

Berkeley DB

Netatalk requires Berkeley DB to be installed. (I have read a few issues with later versions of Berkeley DB, I use 4.7.25 and it works fine.)

Download Berkeley DB from Oracle (there doesn't seem : http://www.oracle.com/technetwork/database/berkeleydb/downloads/index-082944.html

(Note, I chose to install bdb into /usr/local. it's default is "/usr/local/BerkeleyDB.4.7". If you use the default or another location, you will need to pass that to netatalk's configure below.)

Building netatalk

Download netatalk from: http://netatalk.sourceforge.net/

The current stable version is 3.0. For older versions of netatalk, you will need to use the "uams_dhx2.so" authentication module to support Mac OS X 10.7 and later clients. Please check the Netatalk website and mailing lists for more details.

You may need to add '--with-bdb=/path/to/berkeleydb' if configure can't find it.

Version 3.0 also includes an SMF service for managing netatalk. To activate this, include "--with-init-style=solaris" on the configure line, and then make install will install the service manifest for you.

Running Netatalk

For netatalk to publish it's services using Multicast DNS (Bonjour / ZeroConf / Avahi) you will need to enable these services:

And start netatalk with this command (for version 3.0 with init-style=solaris):

And start netatalk with this command for 2.x versions:

PAM for version 3.0

Netatalk will complain that, while it supports PAM authentication, it can't automatically set up PAM for you on Solaris systems. You'll need to do this manually.

Howto needed: (LDAP/ Actve Directory support for netatalk3 - Interoperability with CIFS AD support?)

Bonjour Avahi/ Zeroconfig for version V.3

Howto needed

Netatalk 3 should configure Avahi/Zeroconfig automatically (assuming the services are running).

"model mimic"ing is not presently working, this is a netatalk bug, which should be fixed in the next update.

Configuration

Configurations for version 2.x and version >= 3.0 are quite different. Please refer to the netatalk website for more information: http://netatalk.sourceforge.net/

Example Configuration for version 3.0:

All configuration now happens in this one file: /usr/local/etc/afp.conf:
This file must end with a newline or netatalk service would not start (maintenance mode)

Example Configuration for version 2.2:

/usr/local/etc/netatalk/afpd.conf:

/usr/local/etc/netatalk/AppleVolumes.default:

Troubleshooting

There has been some mention on the netatalk mailing list of the "nbmand" zfs property causing problems where users can create but not delete files over afp. If you are experiencing this problem, try `zfs set nbmand=off zpool/path/to/file/system`.

Stale PID file: Netatalk 3.x has a default pidfile location of `/var/spool/locks/netatalk`. If the service won't start because of a stale lock file, delete this.

For more information check out the Netatalk web site and mailing lists.