Difference between revisions of "AFP"

From Amahi Wiki
Jump to: navigation, search
(Updating AFP to fedora 12 and adding advertising (avahi) service)
Line 1: Line 1:
The Apple Filing Protocol (AFP) is a network protocol that offers file services for Mac OS X and original Mac OS.
+
The Apple Filing Protocol (AFP) is a network protocol that offers file services for Mac OS X and original Mac OS.  
 +
Avahi is an open source implementation of Bonjour or former Rendezvous wich advertises servers to MacosX
  
 
NOTE: THIS IS NOT MEANT FOR PEOPLE WHO DONT KNOW WHAT THEY ARE DOING
 
NOTE: THIS IS NOT MEANT FOR PEOPLE WHO DONT KNOW WHAT THEY ARE DOING
  
== Installation into Amahi ==
+
== Installation of netatalk into Amahi ==
# Open a terminal either on the desktop or SSH
+
* Open a terminal either on the desktop or SSH
# Become root (sudo -s or su -)
+
* Become root (sudo -s or su -)
# yum -y install netatalk
+
* yum -y install netatalk
# Once the app is installed you can add the folders you wish to share over AFP by editing the /etc/atalkd/netatalk.conf file and adding them at the bottom. Full instructions to edit that file are in the actual file
+
* edit afpd.conf <code>- -noddp -tcp -uamlist uams_dhx.so,uams_dhx2.so -nosavepassword -advertise_ssh</code>
# /etc/init.d/atalkd start. Note that this will take longer then the next time you start AFP.
+
*edit netatalk.conf
# Try to connect from Finder from your Mac! You should see the server in the sidebar
+
<code>
 +
ATALKD_RUN=no
 +
PAPD_RUN=no
 +
CNID_METAD_RUN=yes
 +
AFPD_RUN=yes
 +
TIMELORD_RUN=no
 +
A2BOOT_RUN=no
 +
</code>
 +
* Once the app is installed you can add the folders you wish to share over AFP by editing the Applevolume.default
 +
 
 +
<code>~/ "$u" allow:UserName rwlist:UserName,@users cnidscheme:cdb</code>
 +
 
 +
Change UserName to your username, this will share your homefolder over afp
 +
 
 +
== Installation of avahi into Amahi ==
 +
* Open a terminal either on the desktop or SSH
 +
* Become root (sudo -s or su -)
 +
* yum -y install avahi
 +
*go to /etc/avahi/services/
 +
*add the afpd.service
 +
 
 +
<code><?xml version="1.0" standalone='no'?><!--*-nxml-*-->
 +
<!DOCTYPE service-group SYSTEM "avahi-service.dtd">
 +
<service-group>
 +
<name replace-wildcards="yes">%h Xserve</name>
 +
<service>
 +
<type>_afpovertcp._tcp</type>
 +
<port>548</port>
 +
</service>
 +
<service>
 +
<type>_device-info._tcp</type>
 +
<port>0</port>
 +
<txt-record>model=Xserve</txt-record>
 +
</service>
 +
</service-group></code>
 +
 
 +
%h Xserve can be changed to your server name (not the same as your samba server!)
 +
model=Xserve can be changed to get a different icon for your server to PowerBook, PowerMac, Macmini, iMac, MacBook, MacBookPro, MacBookAir, MacPro, AppleTV1,1, AirPort
 +
 
 +
*Additionally you can make avahi advertise other services on your mac
 +
 
 +
rfb.service for screensharing without chickenvnc
 +
 
 +
<code><?xml version="1.0" standalone='no'?><!--*-nxml-*-->
 +
<!DOCTYPE service-group SYSTEM "avahi-service.dtd">
 +
<service-group>
 +
<name replace-wildcards="yes">%h</name>
 +
<service>
 +
<type>_rfb._tcp</type>
 +
<port>5900</port>
 +
</service>
 +
</service-group>
 +
</code>
 +
 
 +
samba.service so the bsod icon is replaced with a nice screen icon and is on the same server as vnc/screensharing
 +
 
 +
<code><?xml version="1.0" standalone='no'?><!--*-nxml-*-->
 +
<!DOCTYPE service-group SYSTEM "avahi-service.dtd">
 +
<service-group>
 +
<name replace-wildcards="yes">%h</name>
 +
<service>
 +
<type>_smb._tcp</type>
 +
<port>139</port>
 +
</service>
 +
</service-group>
 +
</code>
 +
 
 +
there is also a nfs.service but havent been able to get this to work on snow leopard
 +
 
 +
<code><?xml version="1.0" standalone='no'?>
 +
<!DOCTYPE service-group SYSTEM "avahi-service.dtd">
 +
<service-group>
 +
<name replace-wildcards="yes">NFS Shares on %h</name> ## Display Name
 +
<service>
 +
      <type>_nfs._tcp</type>
 +
      <port>2049</port>
 +
      <txt-record>path=/var/hda/files/music</txt-record> ## path to NFS mountpoint
 +
</service>
 +
<service>
 +
        <type>_nfs._tcp</type>
 +
        <port>2049</port>
 +
        <txt-record>path=/var/hda/files/movies</txt-record> ## path to NFS mountpoint
 +
</service>
 +
</service-group>
 +
</code>
 +
 
 +
Thanks to this great [http://www.kremalicious.com/2008/06/ubuntu-as-mac-file-server-and-time-machine-volume/#netatalk2 tutorial] for ubuntu !!  
 +
 
 +
 
 +
*Starting and stopping AFP and Avahi :
 +
service atalk (start stop restart)
 +
service avahi-daemon (start stop restart)
 +
 
  
 
== TODO ==
 
== TODO ==
  
Integrate AFP with the Shares tab of the WebUI just as tightly as Samba is
+
Integrate AFP and avahi with the Shares tab of the WebUI just as tightly as Samba is

Revision as of 16:53, 19 December 2009

The Apple Filing Protocol (AFP) is a network protocol that offers file services for Mac OS X and original Mac OS. Avahi is an open source implementation of Bonjour or former Rendezvous wich advertises servers to MacosX

NOTE: THIS IS NOT MEANT FOR PEOPLE WHO DONT KNOW WHAT THEY ARE DOING

Installation of netatalk into Amahi

  • Open a terminal either on the desktop or SSH
  • Become root (sudo -s or su -)
  • yum -y install netatalk
  • edit afpd.conf - -noddp -tcp -uamlist uams_dhx.so,uams_dhx2.so -nosavepassword -advertise_ssh
  • edit netatalk.conf

ATALKD_RUN=no PAPD_RUN=no CNID_METAD_RUN=yes AFPD_RUN=yes TIMELORD_RUN=no A2BOOT_RUN=no

  • Once the app is installed you can add the folders you wish to share over AFP by editing the Applevolume.default

~/ "$u" allow:UserName rwlist:UserName,@users cnidscheme:cdb

Change UserName to your username, this will share your homefolder over afp

Installation of avahi into Amahi

  • Open a terminal either on the desktop or SSH
  • Become root (sudo -s or su -)
  • yum -y install avahi
  • go to /etc/avahi/services/
  • add the afpd.service

<?xml version="1.0" standalone='no'?> <!DOCTYPE service-group SYSTEM "avahi-service.dtd"> <service-group> <name replace-wildcards="yes">%h Xserve</name> <service> <type>_afpovertcp._tcp</type> <port>548</port> </service> <service> <type>_device-info._tcp</type> <port>0</port> <txt-record>model=Xserve</txt-record> </service> </service-group>

%h Xserve can be changed to your server name (not the same as your samba server!) model=Xserve can be changed to get a different icon for your server to PowerBook, PowerMac, Macmini, iMac, MacBook, MacBookPro, MacBookAir, MacPro, AppleTV1,1, AirPort

  • Additionally you can make avahi advertise other services on your mac

rfb.service for screensharing without chickenvnc

<?xml version="1.0" standalone='no'?> <!DOCTYPE service-group SYSTEM "avahi-service.dtd"> <service-group> <name replace-wildcards="yes">%h</name> <service> <type>_rfb._tcp</type> <port>5900</port> </service> </service-group>

samba.service so the bsod icon is replaced with a nice screen icon and is on the same server as vnc/screensharing

<?xml version="1.0" standalone='no'?> <!DOCTYPE service-group SYSTEM "avahi-service.dtd"> <service-group> <name replace-wildcards="yes">%h</name> <service> <type>_smb._tcp</type> <port>139</port> </service> </service-group>

there is also a nfs.service but havent been able to get this to work on snow leopard

<?xml version="1.0" standalone='no'?> <!DOCTYPE service-group SYSTEM "avahi-service.dtd"> <service-group> <name replace-wildcards="yes">NFS Shares on %h</name> ## Display Name <service>

      <type>_nfs._tcp</type>
      <port>2049</port>
      <txt-record>path=/var/hda/files/music</txt-record> ## path to NFS mountpoint

</service> <service>

       <type>_nfs._tcp</type>
       <port>2049</port>
       <txt-record>path=/var/hda/files/movies</txt-record> ## path to NFS mountpoint

</service> </service-group>

Thanks to this great tutorial for ubuntu !!


  • Starting and stopping AFP and Avahi :

service atalk (start stop restart) service avahi-daemon (start stop restart)


TODO

Integrate AFP and avahi with the Shares tab of the WebUI just as tightly as Samba is