FAQ

From Netatalk Wiki
Jump to: navigation, search
(How does Netatalk integrate with Samba?)
(How does Netatalk integrate with Samba?)
 
Line 21: Line 21:
 
== I think, I found a bug in netatalk. Where should I report it? ==
 
== I think, I found a bug in netatalk. Where should I report it? ==
 
First of all, try to isolate the problem and see whether it's not a feature instead (some of the underlying mac-related basics like file/folder IDs and the like, look irritating for people newly entering the world of cross-platform networking)
 
First of all, try to isolate the problem and see whether it's not a feature instead (some of the underlying mac-related basics like file/folder IDs and the like, look irritating for people newly entering the world of cross-platform networking)
 +
 
Then have a look in the archives of both netatalk-admins and netatalk-devel list whether it's a known bug, already being worked on, or something special.
 
Then have a look in the archives of both netatalk-admins and netatalk-devel list whether it's a known bug, already being worked on, or something special.
# http://marc.theaimsgroup.com/?l=netatalk
+
# [http://marc.theaimsgroup.com/?l=netatalk Netatalk-Admins-Mailinglist-Archive]
# http://marc.theaimsgroup.com/?l=netatalk-devel
+
# [http://marc.theaimsgroup.com/?l=netatalk-devel Netatalk-Devel-Mailinglist-Archive]
If that doesn't help, consider asking the lists whether some others might have an idea what's going on (try to avoid using the  SourceForge discussion forums since most experienced users and developers only monitor the mailing lists)
+
If that doesn't help, consider asking the lists whether some others might have an idea what's going on (try to avoid using the  SourceForge discussion forums since most experienced users and developers only monitor the mailing lists).
Before asking the list, try to understand and accept the  basic principles for reporting bugs and asking for help
+
 
If you're finally sure you found a bug, then please report it at the SF Bugs section and post it to the netatalk-devel list as well (no list subscription required).
+
Before asking the list, try to understand and accept the  basic principles for reporting bugs and asking for help If you're finally sure you found a bug, then please report it at the SF Bugs section and post it to the netatalk-devel list as well.
 +
 
 
In case, the developers want you to provide more details about crashing processes, have a look at [[How to use gdb]].
 
In case, the developers want you to provide more details about crashing processes, have a look at [[How to use gdb]].
  
Line 49: Line 51:
 
* Filename/foldername encoding: By default both Netatalk 2.0 and Samba 3.0 use UTF-8 precomposed on the server side. So at a first look, this problem is solved.
 
* Filename/foldername encoding: By default both Netatalk 2.0 and Samba 3.0 use UTF-8 precomposed on the server side. So at a first look, this problem is solved.
 
* "Illegal" names, that make Windows choke, are still a problem. There exists an [http://netatalk.sourceforge.net/2.0/htmldocs/AppleVolumes.default.5.html AppleVolumes] option called "mswindows", which will prevent Mac clients from saving such names. But this leads to Netatalk's afpd breaking the AFP specifications and is no real solution (like a working Samba VFS module, that mangles such names on demand in a sane way, would be). Additionally, this option breaks saving to Netatalk volumes for several applications, i.e. OfficeX.
 
* "Illegal" names, that make Windows choke, are still a problem. There exists an [http://netatalk.sourceforge.net/2.0/htmldocs/AppleVolumes.default.5.html AppleVolumes] option called "mswindows", which will prevent Mac clients from saving such names. But this leads to Netatalk's afpd breaking the AFP specifications and is no real solution (like a working Samba VFS module, that mangles such names on demand in a sane way, would be). Additionally, this option breaks saving to Netatalk volumes for several applications, i.e. OfficeX.
* Hiding the metadata stuff from the other platform: You might want to hide all the directories and files described in the SpecialFilesFolders FAQ entry by using Samba's veto option. You can do the same for Mac clients too using  Netatalk's veto option. For samba:
+
* Hiding the metadata stuff from the other platform: You might want to hide all the directories and files described in the [[Special Files and Folders]] entry by using Samba's veto option. You can do the same for Mac clients too using  Netatalk's veto option. For samba:
  veto files = /:2eFBCLockFolder/.FBCLockFolder/:2eFBCIndex/.FBCIndex/:2eDS_Store/.DS_Store/TheVolumeSettingsFolder/TheFindByContentFolder/Temporary Items/\
+
  veto files = /:2eFBCLockFolder/.FBCLockFolder/:2eFBCIndex/.FBCIndex/TheVolumeSettingsFolder/TheFindByContentFolder/Temporary Items/\
 
               Network Trash Folder/.AppleDB/:2eVolumeIcon.icns/.VolumeIcon.icns/Icon/.AppleDouble/.AppleDesktop/desktop.ini/RECYCLER/
 
               Network Trash Folder/.AppleDB/:2eVolumeIcon.icns/.VolumeIcon.icns/Icon/.AppleDouble/.AppleDesktop/desktop.ini/RECYCLER/
 
  delete veto files = Yes
 
  delete veto files = Yes
* File locking: partially working as Netatalk is using POSIX locks and SAMBA uses them too. But SAMBA usually also uses oplocks which should be disabled for interoperating with Netatalk.
+
* File locking: partially working as Netatalk is using POSIX locks and SAMBA uses them too. But SAMBA usually also uses oplocks which should be disabled for interoperating with Netatalk. More importantly, open modes are not synchronized. Thus Samba will now nothing of a deny read/write open [http://developer.apple.com/library/mac/#documentation/Networking/Conceptual/AFP/FileSharingModes/FileSharingModes.html%23//apple_ref/doc/uid/TP40000854-CH233-CHBDEIJE AFP mode] from an AFP client and vice versa.
  
 
== What are the .AppleDouble and .AppleDB? directories and .Parent files which are created in the Netatalk Shares? ==
 
== What are the .AppleDouble and .AppleDB? directories and .Parent files which are created in the Netatalk Shares? ==
 +
These are described at the [[Special Files and Folders]] page.
 +
 
== Why can't I mount more than one server? ==
 
== Why can't I mount more than one server? ==
 +
When trying to mount multiple independent servers running Netatalk, you might run into a problem where the workstation thinks that the second server is the same as the first one that was mounted. This problem is often due to what the /etc/hosts file looks like.
 +
 +
"Out of the box", /etc/hosts often looks like:
 +
 +
127.0.0.1 localhost.localdomain localhost
 +
<some ip addr> hostname.domainname hostname
 +
 +
Netatalk will look at the first line to find out what server it's running on. If both servers you're trying to mount have identical first lines in /etc/hosts, Netatalk will think it's trying to access the first server you mounted.
 +
 +
The solution, in my hands and as suggested by several members of the Netatalk mailing list, is to change the order of entries in /etc/hosts. In the example given above, this could be done simply by changing it to:
 +
 +
<some ip addr> hostname.domainname hostname
 +
127.0.0.1 localhost.localdomain localhost
 +
 +
That is, reversing the order.
 +
 
== How can I check the consistency of the CNID databases? ==
 
== How can I check the consistency of the CNID databases? ==
== How do you use netatalk over ssh? ==
+
Starting with Netatalk 2.1 there's a dedicated and versatile utility exactly for this purpose: [http://netatalk.sourceforge.net/2.1/htmldocs/dbd.1.html dbd].

Latest revision as of 12:12, 7 October 2010

Personal tools
Namespaces
Variants
Actions
Navigation
Toolbox