以前の Netatalk バージョンからのアップグレード

Netatalk 4.5 からのアップグレード

Netatalk 4.6 では、SRP UAM が使用する資格情報ストアの管理方法が変更される。uams_srp.so が有効になっている場合は、新しいサーバーを起動する前に、以下の手順を確認すること。

afppasswd の呼び出し

afppasswd は再び、非デフォルトの資格情報ストアに対して -p path を受け入れる。 SRP モードでは、path は検証ディレクトリであり、afp.conf の srp verifier path と一致する必要がある。-r を使用する場合、それは Randnum パスワードファイルであり、 passwd file と一致する必要がある。コンパイル時に組み込まれたデフォルトは、 パッケージ化されたインストールをカバーしている。

例えば、srp verifier path が /path/to/verifiers に設定されている場合、次のように実行する：

sudo afppasswd -p /path/to/verifiers -a alice

通常のユーザーは、自分の SRP 検証を変更する際に -p を使用できる。追加の特権は付与されない：ファイルシステムのアクセス権がアクセスを強制するため、他人のストアを選択するとアクセスエラーになる。

SRP 検証の移行

SRP はもはや、1 つの共有された afppasswd.srp フラットファイルを使用しない。設定されたパスは、現在、数値 uid ごとに 1 つのファイルを含む root 所有の検証ディレクトリである。各検証ファイルのモードは 0600 である。アクティブな検証はユーザー所有であり、登録済みユーザーが自分の SRP パスワードを変更できるようにするため、afppasswd に昇格した特権を与える必要はない。無効なプレースホルダーは root 所有であり、対応するローカルユーザーによって有効化することはできない。root は afppasswd -a username を使用してユーザーを登録する：実際の検証が書き込まれ同期された後にのみ、所有権がユーザーに移される。

復元によって登録済みの検証の所有権またはモードが変更された場合、afpd を停止し、再起動する前に root としてその uid 名のファイルを修復する。所有権を一致するローカルユーザーに戻し、モードを 0600 に設定する。例えば、カスタムパスにある alice の検証は、chown alice /path/to/verifiers/$(id -u alice) を使用して修復し、その後そのファイルに chmod 0600 を適用することで修復できる。root 所有の無効なプレースホルダーにはこれを適用しないこと：afppasswd -a username を使用してパスワードを設定し、アカウントを再有効化すること。複数のハードリンクを持つ検証は、置き換えるか追加のリンクを削除する必要がある。

afp.conf では、新しい srp verifier path オプションが古い srp passwd file オプションに置き換わる。古い名前は非推奨のエイリアスとしてまだ受け入れられるが、その値は現在ディレクトリとして解釈され、移行警告をログに記録する。

既存の SRP 資格情報は、ユーザーが既存のパスワードでログインできるようにする前に移行する必要がある。移行は afppasswd -m で実行される。

1. netatalk を停止し、完全な移行の間は停止したままにする。

2. afp.conf が明示的に srp passwd file パスを設定している場合、既存のフラットファイルの場所を指す srp verifier path オプションに更新する。

3. root として移行を実行する。標準構成では、次のように使用する：

   sudo afppasswd -m

検証パスがデフォルトでない場合は、そのディレクトリを渡す：

   sudo afppasswd -m -p /path/to/verifiers

移行は既存のソルトと検証を保持するため、ユーザーは SRP パスワードを保持する。 アクティブな資格情報はユーザー所有となる。無効なプレースホルダーは root 所有のままであり、使用する前に root の afppasswd -a が必要である。 すべてのレコードとローカルアカウントを検証し、新しいディレクトリを原子性に作成し、 元のフラットファイルを afppasswd.srp.legacy（または番号付きの兄弟）として保持する。 移行が失敗した場合は netatalk を起動しないこと。まず報告された条件を解決すること。

1. netatalk を起動し、SRP ログインをテストする。その後、ローカルユーザーは単に afppasswd を使用してそのユーザーの SRP パスワードを変更する。管理者は afppasswd -a username を使用してユーザーの SRP 資格情報を設定またはリセットする。

あるいは、ユーザーパスワードを保持することが望ましくない場合：レガシーファイル（通常は /etc/netatalk/afppasswd.srp にある）を削除し、afppasswd -c で新しいストアを初期化する。これにより root 所有の無効なプレースホルダーが作成される。afppasswd -a username を使用して root として個別にパスワードを設定し、ユーザーを登録する。

登録後、ユーザーは自分の検証を所有し、直接置き換えることができる。afppasswd の古いパスワードの証明とオプションの CrackLib チェックは、サーバー全体のパスワードポリシーを強制しない。ユーザーの将来の SRP ログインを無効にするには、root として afppasswd -d username を実行する。これにより、uid 検証が root 所有の無効なプレースホルダーに置き換えられる（存在しない場合は作成される）；afppasswd -a username を使用してパスワードを設定し、アカウントを再有効化する。既存のセッションや他の UAM は影響を受けない。

Randnum の強化

Randnum は依然として古いクライアント専用のレガシーで弱い UAM である。その afppasswd ファイルの管理は現在 root のみ：afppasswd -r -a username を使用して Randnum 資格情報をリセットまたは更新する。

Netatalk 3 からのアップグレード

Netatalk 3 から Netatalk 4 へのアップグレードは簡単。古いバージョンの上に新しいバージョンをインストールするだけ。Netatalk 4 での主要な変更点は、Netatalk 2 と Netatalk 3 の間で削除された AppleTalk サービス、構成ファイル、およびツールを一部復活させたことである。

主に、atalkd デーモンと atalkd.conf 設定ファイル、また papd デーモンと papd.conf 設定ファイルが追加された。

afp.conf の一部のオプションは Netatalk v4 のリリース履歴を通じて段階的に変更または削除されている。詳細は以下の新旧オプション名対応表を参照のこと。

afpstats の破壊的変更点

afpstats ツールは Netatalk 3.0 で歴史的な macusers スクリプトの代替として導入された。最初の形では、ツールは D-Bus を介して afpd と通信していたが、Netatalk 4.5 以降はシンプルさと移植性のために標準的な Unix ソケットを使用するように書き換えられた。

以前のバージョンからアップグレードする場合、通常は /usr/share/dbus-1/system.d に保存されている netatalk-dbus.conf ファイルを手動で削除する必要があるかもしれない。

Netatalk 2 からのアップグレード

Netatalk 4 の主要な変更は以下の3点：

1. これまでの AFP 設定ファイルすべてが廃止され、AFP に関してのほぼ全オプション名を変更し、新しい設定ファイルを追加した： afp.conf と extmap.conf

2. ファイルメタデータをファイルシステムの拡張属性に保存する新しいバックエンド。

3. 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 = yes で有効化される。

• 一括で変換する場合 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 プロキシのサポート機能は削除。

アップグレード手段

1. Netatalk 2.x を停止する

2. Netatalk 4 をインストールする

3. 設定 afp.conf 及び extmap.conf を自力で書き換える

4. afpd と cnid_metad の代わりに netatalk 起動にのみ関連している、 Netatalk 起動スクリプトを更新するか、標準の起動スクリプトに置き換える。

5. afp_voluuid.conf 及び afp_signature.conf を localstate ディレクトリ （デフォルトでは $prefix/var/netatalk/）、に移動。 正しいパスを見つけるために afpd -v コマンドが有用

6. Netatalk 4 を起動する

新旧設定ファイル名

新旧オプション対応表

netatalk.conf (Debianの場合は/etc/default/netatalk) から afp.conf への対応表、および起動手段の対応表

afpd.conf から afp.conf への対応表

afp_ldap.conf から afp.conf への対応表

AppleVolumes.* から afp.conf への対応表