Netatalk 4.3.2
以前の Netatalk バージョンからのアップグレード
Netatalk 3 からのアップグレード
Netatalk 3 から Netatalk 4 へのアップグレードは簡単。古いバージョンの上に新しいバージョンをインストールするだけ。Netatalk 4 での主要な変更点は、Netatalk 2 と Netatalk 3 の間で削除された AppleTalk サービス、構成ファイル、およびツールを一部復活させたことである。
主に、atalkd デーモンと atalkd.conf 設定ファイル、また papd デーモンと papd.conf 設定ファイルが追加された。
Netatalk 2 からのアップグレード
Netatalk 4 の主要な変更は以下の3点：
-
これまでの AFP 設定ファイルすべてが廃止され、AFP に関してのほぼ全オプション名を変更し、新しい設定ファイルを追加した： afp.conf と extmap.conf
-
ファイルメタデータをファイルシステムの拡張属性に保存する新しいバックエンド。
-
AppleTalk トランスポート層はデフォルトで無効になっている。非常に古い Mac で Netatalk を使用する場合は、afp.conf にて appletalk = yes オプションで有効にしてください。 それから、netatalk を起動する前に atalkd デーモンを立ち上げてください。
設定まわりの変更点
afp.conf
-
（Samba の smb.conf のような） “ini” スタイルの構文
-
一つで設定すべてを指示するという点： AFP 及びボリュームの構成を共に一つのファイルで設定することになるという点
-
afpd.conf、 netatalk.conf、 AppleVolumes.default 及び、 afp_ldap.conf の廃止
【警告】 ほとんどのオプション名は変更されたので、詳細については afp.conf の manpage 全体を読むこと
extmap.conf
-
Classic Mac OS type/creator と拡張子の関連付け
-
2.x とは異なり、マッピングはデフォルトで無効になっている。有効にするには、ファイル内の行のコメントを解除する
-
AppleVolumes.system の廃止
新たなメタデータバックエンド
macOS拡張属性およびClassic Mac OS リソースフォークをファイルシステムの拡張属性に保存する ea = sys という新しいバックエンド。
-
デフォルトのバックエンドである（！）
-
拡張属性のあるファイルシステムが必須。 さもなくば ea = ad オプションの使用が代替となる
-
ファイルシステムを AppleDouble v2 から拡張属性への変換はアクセス時、その都度行われる（convert appledouble オプションを無効にすることも可能）
-
一括で変換する場合 dbd を用いることができる
実装の詳細：
-
Mac のメタデータ（すなわち FinderInfo、AFP フラグ、コメント、CNID）は org.netatalk.Metadataという名前の拡張属性に保存される。
-
さらに、Netatalk 4.1.0以降を実行しているmacOSホストでは、FinderInfo はファイルシステムにネイティブに保存され、com.apple.FinderInfoという名前の拡張属性として表示される。
-
マックのリソースフォークは：
-
ZFSを用いたSolarisではorg.netatalk.ResourceForkという拡張属性に保存される。
-
ないしは、ファイル名がfileであるものに対して各々、._fileという名の別のAppleDoubleファイルに保存される。
-
Netatalk 4.1.0 以降、macOS ホスト上のリソースフォークにネイティブに保存されている。
-
”._” ファイルのフォーマットは、たとえそのファイルシステムにCIFSサーバー（Samba）経由でアクセスした場合でも、マックのCIFSクライアントが想定しているフォーマットと全く同じである。なので、データを失う危険性（リソースもメタデータも）なく、マックから同じデータセットにAFP経由とCIFS経由と並行してアクセスすることができる。一方、Windowsクライアントから当該データセットにCIFS経由でアクセスした場合は、非ZFSファイルシステムでは未だにfileと._fileの紐付けを失うこととなるであろう（上記参照。）今のところその点で拡張Samba VFSモジュールが必要である。
そのほかの主要な変更点
-
AFP 及び CNID デーモンの起動・再起動を担う新しいサービスコントローラデーモン netatalk の導入。バンドルされているスタートスクリプトが すべて更新されているため、自分の環境でもアップデートされているか確認する必要あり！
-
CNID データベースはデフォルトではシステムの状態ディレクトリパス（例：/var/lib）の下にある netatalk/CNID サブディレクトリに保存されるようになった。以前は各共有ボリュームにて保存されていた。
-
Netatalk 2.xのボリュームオプションusedots及びuprivはデフォルトとなった。
-
SLP 及び AFP プロキシのサポート機能は削除。
アップグレード手段
-
Netatalk 2.x を停止する
-
Netatalk 4 をインストールする
-
設定 afp.conf 及び extmap.conf を自力で書き換える
-
afpd と cnid_metad の代わりに netatalk 起動にのみ関連している、 Netatalk 起動スクリプトを更新するか、標準の起動スクリプトに置き換える。
-
afp_voluuid.conf 及び afp_signature.conf を localstate ディレクトリ （デフォルトでは $prefix/var/netatalk/）、に移動。 正しいパスを見つけるために afpd -v コマンドが有用
-
Netatalk 4 を起動する
新旧設定ファイル名
| 旧ファイル名 | 新ファイル名 | 注記 |
|---|---|---|
| - | afp.conf | 新しい “ini” 様式のフォーマット |
| afp_signature.conf | afp_signature.conf | 厳密には $localstatedir に移動 |
| afp_voluuid.conf | afp_voluuid.conf | 厳密には $localstatedir に移動 |
| netatalk.conf | - | 廃止 |
| afpd.conf | - | afp.conf に統合された |
| afp_ldap.conf | - | afp.conf に統合された |
| AppleVolumes.default | - | afp.conf に統合された |
| AppleVolumes.system | extmap.conf | netatalk 3.0.2 から採用 |
| ~/.AppleVolumes | - | 廃止 |
新旧オプション対応表
netatalk.conf (Debianの場合は/etc/default/netatalk) から afp.conf への対応表、および起動手段の対応表
| 旧 netatalk.conf | 新 afp.conf | 旧デフォルト値 | 新デフォルト値 | セクション | 詳細 |
|---|---|---|---|---|---|
| ATALK_NAME | hostname | - | - | (G) | デフォルトでは gethostname() を使用 |
| ATALK_UNIX_CHARSET | unix charset | LOCALE | UTF8 | (G) | - |
| ATALK_MAC_CHARSET | mac charset | MAC_ROMAN | MAC_ROMAN | (G)/(V) | - |
| CNID_METAD_RUN | - | yes | - | - | netatalk(8) で制御 |
| AFPD_RUN | - | yes | - | - | netatalk(8) で制御 |
| AFPD_MAX_CLIENTS | max connections | 20 | 200 | (G) | - |
| AFPD_UAMLIST | uam list | uams_dhx.so,uams_dhx2.so | uams_dhx.so uams_dhx2.so | (G) | - |
| AFPD_GUEST | guest account | nobody | nobody | (G) | - |
| CNID_CONFIG | log level | log_note | cnid:note | (G) | - |
| CNID_CONFIG | log file | - | - | (G) | - |
| ATALKD_RUN | - | no | - | - | 独自起動スクリプトで制御 |
| PAPD_RUN | - | no | - | - | 独自起動スクリプトで制御 |
| TIMELORD_RUN | - | no | - | - | 独自起動スクリプトで制御 |
| A2BOOT_RUN | - | no | - | - | 独自起動スクリプトで制御 |
| ATALK_BGROUND | - | no | - | - | 廃止 |
| ATALK_ZONE | ddp zone | - | - | (G) | 4.0.0で復活 |
afpd.conf から afp.conf への対応表
| 旧 afpd.conf | 新 afp.conf | 旧デフォルト値 | 新デフォルト値 | セクション | 詳細 |
|---|---|---|---|---|---|
| - あるいは“サーバー名”) | hostname | - | - | (G) | 4.2.0で新規追加、デフォルトではhostnameを使用 |
| -uamlist | uam list | uams_dhx.so,uams_dhx2.so | uams_dhx.so uams_dhx2.so | (G) | - |
| -nozeroconf | zeroconf | - | （サポートされていれば） yes | (G) | - |
| -advertise_ssh | advertise ssh | - | no | (G) | - |
| -[no]savepassword | save password | -savepassword | yes | (G) | - |
| -[no]setpassword | set password | -nosetpassword | no | (G) | - |
| -client_polling | client polling | - | no | (G) | - |
| -hostname | hostname | - | - | (G) | デフォルトでは gethostname() を使用 |
| -loginmesg | login message | - | - | (G)/(V) | - |
| -guestname | guest account | nobody | nobody | (G) | - |
| -passwdfile | passwd file | afppasswd | afppasswd | (G) | - |
| -passwdminlen | passwd minlen | - | - | (G) | - |
| -tickleval | tickleval | 30 | 30 | (G) | - |
| -timeout | timeout | 4 | 4 | (G) | - |
| -sleep | sleep time | 10 | 10 | (G) | - |
| -dsireadbuf | dsireadbuf | 12 | 12 | (G) | - |
| -server_quantum | server quantum | 303840 | 1048576 | (G) | - |
| -volnamelen | volnamelen | 80 | 80 | (G) | - |
| -setuplog | log level | default log_note | default:note | (G) | - |
| -setuplog | log file | - | - | (G) | - |
| -admingroup | admingroup | - | - | (G) | - |
| -k5service | k5 service | - | - | (G) | - |
| -k5realm | k5 realm | - | - | (G) | - |
| -k5keytab | k5 keytab | - | - | (G) | - |
| -uampath | uam path | etc/netatalk/uams | lib/netatalk | (G) | 厳密には $libdir に移動 |
| -ipaddr | afp listen | - | - | (G) | - |
| -cnidserver | cnid server | localhost:4700 | localhost:4700 | (G)/(V) | - |
| -port | port | 548 | 548 | (G) | - |
| -signature | signature | auto | - | (G) | - |
| -fqdn | fqdn | - | - | (G) | - |
| -unixcodepage | unix charset | LOCALE | UTF8 | (G) | - |
| -maccodepage | mac charset | MAC_ROMAN | MAC_ROMAN | (G)/(V) | - |
| -closevol | close vol | - | no | (G) | - |
| -ntdomain | nt domain | - | - | (G) | - |
| -ntseparator | nt separator | - | - | (G) | - |
| -dircachesize | dircachesize | 8192 | 8192 | (G) | - |
| -tcpsndbuf | tcpsndbuf | - | - | (G) | OS のデフォルト |
| -tcprcvbuf | tcprcvbuf | - | - | (G) | OS のデフォルト |
| -fcelistener | fce listener | - | - | (G) | - |
| -fcecoalesce | fce coalesce | - | - | (G) | - |
| -fceevents | fce events | - | - | (G) | - |
| -fceholdfmod | fce holdfmod | 60 | 60 | (G) | - |
| -mimicmodel | mimic model | - | - | (G) | - |
| -adminauthuser | admin auth user | - | - | (G) | - |
| -noacl2maccess | map acls | - | rights | (G) | - |
| -[no]tcp | - | -tcp | - | - | 常に TCP を有効 |
| -[no]ddp | appletalk | -ddp | no | (G) | 4.0.0で復活 |
| -[no]transall | - | -transall | - | - | 常に TCP を有効 |
| -nodebug | - | - | - | - | 廃止 |
| -[no]slp | - | -noslp | - | - | SLP サポートが廃止 |
| -[no]uservolfirst | - | -nouservolfirst | - | - | uservol が廃止 |
| -[no]uservol | - | -uservol | - | - | uservol が廃止 |
| -proxy | - | - | - | - | 廃止 |
| -defaultvol | - | AppleVolumes.default | - | - | afp.conf のみ |
| -systemvol | - | AppleVolumes.system | - | - | extmap.conf のみ |
| -loginmaxfail | - | - | - | - | 廃止 |
| -unsetuplog | - | - | - | - | 廃止 |
| -authprintdir | - | - | - | - | CAP スタイル認証印刷が廃止 |
| -ddpaddr | ddp address | 0.0 | 0.0 | (G) | 4.0.0で復活 |
| -[no]icon | legacy icon | -noicon | - | (G) | 4.0.2で復活 |
| -keepsessions | - | - | - | - | 廃止。kill -HUP を使用 |
afp_ldap.conf から afp.conf への対応表
| 旧 afp_ldap.conf | 新 afp.conf | 旧デフォルト値 | 新デフォルト値 | セクション | 詳細 |
|---|---|---|---|---|---|
| ldap_server | ldap server | - | - | (G) | - |
| ldap_auth_method | ldap auth method | - | - | (G) | - |
| ldap_auth_dn | ldap auth dn | - | - | (G) | - |
| ldap_auth_pw | ldap auth pw | - | - | (G) | - |
| ldap_userbase | ldap userbase | - | - | (G) | - |
| ldap_userscope | ldap userscope | - | - | (G) | - |
| ldap_groupbase | ldap groupbase | - | - | (G) | - |
| ldap_groupscope | ldap groupscope | - | - | (G) | - |
| ldap_uuid_attr | ldap uuid attr | - | - | (G) | - |
| ldap_uuid_string | ldap uuid string | - | - | (G) | - |
| ldap_name_attr | ldap name attr | - | - | (G) | - |
| ldap_group_attr | ldap group attr | - | - | (G) | - |
AppleVolumes.* から afp.conf への対応表
| 旧 AppleVolumes.* | 新 afp.conf | 旧デフォルト値 | 新デフォルト値 | セクション | 詳細 |
|---|---|---|---|---|---|
| （ピリオドで始まる行） | - | - | - | - | extmap.conf で使用する |
| :DEFAULT: | - | options:upriv,usedots | - | - | “vol preset” を使用する |
| 一番目のフィールド (“~”) | - | - | - | - | [Homes] セクションを使用する |
| 一番目のフィールド (“/path”) | path | - | - | (V) | - |
| 二番目のフィールド | volume name | - | セクション名を使用する | (V) | 4.2.0で追加 |
| allow: | valid users | - | - | (V) | - |
| deny: | invalid users | - | - | (V) | - |
| rwlist: | rwlist | - | - | (V) | - |
| rolist: | rolist | - | - | (V) | - |
| volcharset: | vol charset | UTF8 | unix charset を使用する | (G)/(V) | - |
| maccharset: | mac charset | MAC_ROMAN | MAC_ROMAN | (G)/(V) | - |
| veto: | veto files | - | - | (V) | - |
| cnidscheme: | cnid scheme | dbd | dbd | (V) | - |
| casefold: | casefold | - | - | (V) | - |
| adouble: | appledouble | v2 | ea | (V) | 4.2.0で廃止 |
| cnidserver: | cnid server | localhost:4700 | localhost:4700 | (G)/(V) | - |
| dbpath: | vol dbpath | （ボリュームディレクトリ） | $prefix/var/netatalk/CNID | (G) | 厳密には $localstatedir に移動 |
| umask: | umask | 0000 | 0000 | (V) | - |
| dperm: | directory perm | 0000 | 0000 | (V) | - |
| fperm: | file perm | 0000 | 0000 | (V) | - |
| password: | password | - | - | (V) | - |
| root_preexec: | - | - | - | 4.1.0で廃止 | |
| preexec: | preexec | - | - | (V) | - |
| root_postexec: | - | - | - | - | 4.1.0で廃止 |
| postexec: | postexec | - | - | (V) | - |
| allowed_hosts: | hosts allow | - | - | (V) | - |
| denied_hosts: | hosts deny | - | - | (V) | - |
| ea: | ea | auto | 自動検出 | (V) | 空白のママにすると自動検出される |
| volsizelimit: | vol size limit | - | - | (V) | 4.0.0で復活 |
| perm: | - | - | - | - | directory perm 及び file perm を使用する |
| forceuid: | - | - | - | - | 廃止 |
| forcegid: | - | - | - | - | 廃止 |
| options:ro | read only | - | no | (V) | - |
| options:invisibledots | invisible dots | - | no | (V) | - |
| options:nostat | stat vol | - | yes | (V) | - |
| options:preexec_close | preexec close | - | no | (V) | - |
| options:root_preexec_close | - | - | - | - | 4.1.0で廃止 |
| options:upriv | unix priv | - | yes | (V) | - |
| options:nodev | cnid dev | - | yes | (V) | - |
| options:illegalseq | illegal seq | - | no | (V) | - |
| options:tm | time machine | - | no | (V) | - |
| options:searchdb | search db | - | no | (V) | - |
| options:nonetids | network ids | - | yes | (V) | - |
| options:noacls | acls | - | yes | (V) | - |
| options:followsymlinks | follow symlinks | - | no | (V) | - |
| options:nohex | - | - | - | - | “:2f” は “:” に自動変換される |
| options:usedots | - | - | - | - | “:2e” は “.” に自動変換される |
| options:nofileid | - | - | - | - | 廃止 |
| options:prodos | prodos | - | no | (V) | 4.0.0で復活 |
| options:mswindows | - | - | - | - | 廃止 |
| options:crlf | - | - | - | - | 廃止 |
| options:noadouble | - | - | - | - | 廃止 |
| options:limitsize | legacy volume size | - | no | (V) | 4.0.0で復活 |
| options:dropbox | - | - | - | - | 廃止 |
| options:dropkludge | - | - | - | - | 廃止 |
| options:nocnidcache | - | - | - | - | 廃止 |
| options:caseinsensitive | - | - | - | - | 廃止 |
