ストレージサービスの管理¶
Archivematicaストレージサービスは、複数のArchivematicaパイプラインに関連するストレージスペースの構成を 可能にします。これにより、ストレージ管理者は、ローカルおよびリモートの各Archivematicaインストールで利用可能な ストレージを設定できます。
このページでは
ストレージサービスの用語集と構成¶
パイプライン¶
パイプラインとは、Archivematicaダッシュボードの単一インストールを指します。1つのストレージサービスを使用して、複数のArchivematicaパイプラインを設定することができます。
スペース¶
A space models a specific storage device. That device might be a locally- accessible disk, a network share, or a remote system accessible via a protocol like FEDORA, SWIFT, DuraCloud, or LOCKSS. The space provides the Storage Service with configuration to read and/or write data stored within itself.
パッケージはスペース内に直接保存されるのではなく、スペースの組織化された区分であるロケーション内に保存されます。
ロケーション¶
ロケーションはスペースの区分です。それぞれのロケーションには、AIPストレージ、DIPストレージ、転送元または転送バックログなどの特定の目的が割り当てられており、スペース内のコンテンツを組織的に構造化するための手段を提供します。
パッケージ¶
ストレージサービスはパッケージを保存することに特化しています。パッケージとは、外部サービスから転送された一つ以上のファイルの束です。例えば、パッケージはAIP、バックログされた転送、またはDIPかもしれません。各パッケージはロケーションに保存されます。
Archivematicaの設定¶
Archivematicaのインストール中に、ストレージサービスを設定するためのオプションが提示されます。
もし異なるURLでストレージサービスをインストールしている場合は、ここで変更してください。
デフォルトの転送元 & AIPストレージ場所を使用 オプションは、Archivematica用のデフォルトの場所を自動的に設定し、新しいパイプラインを登録し、ストレージサービスが利用できない場合にエラーを生成しようとします。ストレージサービスによって設定されたデフォルト値を自動的にセットアップしたい場合は、このオプションを使用してください。
このパイプラインを登録&転送元とAIPストレージの場所を設定 オプションは、新しいパイプラインをストレージサービスに登録しようとするだけで、ストレージサービスが見つからなくてもエラーは発生しません。また、提供されたストレージサービスのURLへのリンクを開き、場所を手動で設定できるようにします。デフォルトの値が望ましくない場合や、ストレージサービスがまだ稼働していない場合は、このオプションを使用してください。転送が処理される前や、AIPが保存される前に、場所を手動で設定する必要があります。
ストレージサービスが稼働している場合は、そのURLを提供し、ArchivematicaはダッシュボードのUUIDを新しいパイプラインとして登録しようとします。そうでない場合は、ダッシュボードのUUIDが表示され、Archivematicaインスタンス用のパイプラインを手動で作成し設定することができます。ダッシュボードのUUIDは、Archivematicaの「管理 -> 一般」の下でも利用可能です。
ウェブサーバーの設定でポートを変更する¶
ストレージサービスはデフォルトでnginxを使用します。ポートを変更するには、ファイル /etc/nginx/sites-enabled/storage を編集し、listen 8000; と記述された行を変更して、8000を使用するポートに置き換えてください。
デフォルトのArchivematicaインストールでは、ダッシュボードはポート80でApache上で実行されていることに注意してください。同じマシン上でnginxをポート80で実行することはできません。もしストレージサービスを独自のサーバーにインストールする場合は、ポート80を使用するよう設定できます。
管理 -> 一般の下にあるArchivematicaダッシュボードでダッシュボードUUIDを調整してください。
パイプライン¶
ArchivematicaのパイプラインとはArchivematicaダッシュボードのことです。全てのパイプラインは、その固有のユニバーサル識別子(UUID)を使ってストレージサービスに登録する必要があります。UUIDは、管理 -> 一般設定の下にあるArchivematicaダッシュボードで見つけることができます。Archivematicaを初めてインストールすると、Archivematica on <hostname> の説明と共にパイプラインのUUIDをストレージサービスに自動的に登録しようとします。
1つのストレージサービスは複数のパイプラインに接続することができます。既存のストレージサービスにパイプラインを接続するには、ストレージサービスのパイプラインタブで**新しいパイプラインを作成する**をクリックしてください。
フィールド:
UUID: Archivematicaパイプラインの一意の識別子。
説明: ユーザーに表示されるパイプラインの説明。例:
開発サイト。リモート名: パイプラインサーバーのベースURL。APIコールを行う際に利用されます。
APIユーザー名: パイプラインへのAPIコールを行う際に使用するユーザー名。
APIキー: パイプラインへのAPIコールを行う際に使用するAPIキー。
有効: チェックが入っている場合、このパイプラインは関連するロケーションにアクセスできます。チェックが入っていない場合、このパイプラインに関連するすべてのロケーションは無効になります。
デフォルトロケーション: チェックが入っている場合、管理->設定で選択されたデフォルトロケーションは、新しいパイプラインに対して作成されるか、関連付けられます。
スペース¶
スペースは、Archivematicaをストレージロケーションに接続するために必要なすべての情報を含んでいます。スペースは、NFSエクスポートパスやホスト名、またはSSH経由でのみアクセス可能なシステムのユーザー名など、プロトコル固有の情報が保存される場所です。
各スペースには、選択されたアクセスプロトコルに応じた特定の設定フィールドがあります。詳細については、以下の アクセスプロトコル を参照してください。
注釈
スペースは通常、ロケーションフォルダの直接の親です。例えば、 /home/artefactual/archivematica-sampledata と /home/artefactual/maildir_transfers にある二つの転送元ロケーションを定義したい場合、スペースのパスは /home/artefactual/ になります。
アクセスプロトコル¶
アーカイバム¶
Archivematicaはバージョン0.7以降でアーカイバムのA-Storをアクセスプロトコルとして使用できます。A-StorはCIFS共有をストレージサービスに露出させ、たとえば、ストレージサービスがファイルをA-StorデータプールにコピーしてAIPストレージとして利用できるようにします。
ストレージサービスの /etc/fstab にエントリを追加し、その後A-StorのCIFS共有をマウントします。
例:
//ARK00092/astor /mnt/astor cifs
defaults,guest,file_mode=0666,dir_mode=0777,uid=archivematica,gid
=archivematica,forcegid,forceuid,rw 0 1
この例では、ARK00092はアプライアンスの名前であり、DNSを通じて解決可能であるか、または /etc/hosts にエントリとして設定する必要があります。
次に、アクセスプロトコルとしてアーカイバムを選択し、ストレージサービスに新しいスペースを作成します。
フィールド:
サイズ: このスペースに許される最大サイズ。0に設定するか、無制限の場合は空白のままにします。このフィールドはオプショナルです。
パス: ストレージサービスマシン上のCIFS共有のローカルパスです。例えば
/mnt/astorステージングパス: ステージングエリアへの絶対パス。UNIXファイルシステムに互換性が必要で、可能であればパスと同じファイルシステム上にあるのが望ましいです。例えば
/mnt/astor/archivematica1/tmpホスト: Arkivumウェブインスタンスのホスト名、またはポートを含むIPアドレス、例えば
arkivum.example.com:8443リモートユーザー: パスワードなしSSHでアクセス可能なリモートマシン上のユーザー名。このフィールドはオプショナルです。
リモート名: リモートマシンの名前またはIP。このフィールドはオプショナルです。
Dataverse¶
Dataverseの統合は、Archivematica v1.8(およびそれ以上)およびストレージサービスv0.13(およびそれ以上)でサポートされています。
フィールド:
サイズ: このスペースに許される最大サイズ。0に設定するか、無制限の場合は空白のままにします。このフィールドはオプショナルです。
パス: ローカルファイルシステム上のスペースへの絶対パス。
ステージングパス: ステージングエリアへの絶対パスです。UNIXファイルシステムと互換性がある必要があり、できればパスと同じファイルシステム上に位置していることが望ましいです。
ホスト: Dataverseインスタンスのホスト名またはIPアドレスです。例:
test.dataverse.orgAPIキー: Dataverseによって特定のユーザーアカウント向けに生成されるキーです。
エージェント名: ArchivematicaのMETSファイルにおいて、このDataverseインスタンスをPREMISエージェントとして特定するために使用される文字列です。例:
My Institution's Dataverse Instance。エージェントタイプ: ArchivematicaのMETSファイルで上記のPREMISエージェントのタイプを特定するために使用される文字列です。例:
organization。エージェント識別子: ArchivematicaのMETSファイルにおいて、上記のPREMISエージェントを一意に識別するために使用される文字列です。
Dataverseのスペースは、「トランスファーソースロケーション」を支援しています(その他の目的のロケーションは現在サポートされていません)。トランスファーソースとして少なくとも1つのロケーションが作成されている必要があります。
このロケーション内の相対パスは、Dataverse検索APIで利用可能なパラメータの2つを設定するために使用することができます。q(または「クエリ」)パラメータは一般的な検索パラメータです。「subtree」パラメータはサブデータバースを示すために使うことができます。例えば、'Relative Path'に以下のエントリを追加すると:
Query:*
Subtree:Archivematica
Archivematicaデータバース内の全てのデータセットを返します。他のAPIパラメータは、スペースに対して上述のフィールドを使用して設定されるか、固定値で設定されます。使用されるパラメータは以下です:
URL: https://<Host field set in Space configuration>/api/search/
{
'q': '<Relative Path field set in Location configuration>',
'sort': 'name',
'key': u '<API Key field set in Space configuration>',
'start': 50,
'per_page': 50,
'show_entity_ids': True,
'type': 'dataset',
'subtree': '<Relative Path field set in Location configuration>',
'order': 'asc'
}
検索結果は現在50データセットに限定されています。50を超えるデータセットがあるリポジトリには、より具体的な検索基準で複数のロケーションを作成することをお勧めします。APIパラメータの詳細については、 Dataverse api guide を参照してください。
DuraCloud¶
Archivematicaはバージョン0.5以降のストレージサービスのアクセスプロトコルとしてDuraCloudを使用することができます。ストレージサービスのスペースは、DuraCloud内のスペースと一対一の関係があります。
ArchivematicaインスタンスをDuraCloudで設定するには、 ArchivematicaでDuraCloudを使用する を参照してください。
フィールド:
アクセスプロトコル: DuraCloud
サイズ: このフィールドは任意です。
パス: このフィールドは空白のままにしてください。
ステージングパス: Archivematicaがステージング用にファイルを配置するための、ローカルディスク上の場所です。例えば
var/archivematica/storage_service/duracloud_stagingがこれに該当します。ホスト: DuraCloudインスタンスのホスト名。例:
site.duracloud.orgユーザー名: DuraCloudで作成したArchivematicaユーザーのユーザー名。
パスワード: DuraCloudで作成したArchivematicaユーザーのパスワード。
Duraspace: このストレージサービスのスペースを作成するためにDuraCloudで指定するスペースの名前です(例: transfer-source, aip-store など)。
REST APIを経由するDSpace¶
REST APIを経由するDSpaceは、AIPおよびDIPのストレージ場所の両方をサポートしています。通常DSpaceは公開向けシステムとして使用されるため、AIP用の他のアクセスプロトコルを使用する場合とは挙動が異なります。DSpaceに預ける際には、AIPはオリジナルと正規化されたオブジェクトおよびそれらに関連するメタデータを含む単一の圧縮オブジェクトファイル(ビットストリーム)として預けられます。DIPは圧縮されていないファイルとして、フォルダ構造をフラットにして預けられます。
現在のところ、ストレージサービスおよびダッシュボードはAIPのダウンロードや再構築を行う機能を持っていません。これらの操作はDSpaceのインターフェースから手動で行う必要があります。
DSpace 経由の REST API スペースは、自動化の度合いを高めるための新しい方法を提供します。CSV または JSON ファイルとして 転送時のメタデータ を供給することが可能です。ルートフォルダ objects のエントリで、任意の数の Dublin Core メタデータ要素セットのプロパティを定義でき、これらは AIP/DIP に対して作成される対応する DSpace レコードにマッピングされます。さらに、定義可能な3つのオプションのカスタムプロパティがあります:
dspace_dip_collection: DIP が預けられる DSpace コレクションの UUID です。例:a12d749c-7727-4121-b6be-478cacde658fdspace_aip_collection: AIP が預けられる DSpace コレクションの UUID です。例:80c3519d-7a07-4830-beae-a868c149ecbearchivesspace_dip_collection: 子デジタルオブジェクトが作成され、DSpace DIP レコードにリンクされるアーカイブオブジェクトの識別子です。例:135569
注釈
DSpace 経由の REST API スペースは DSpace 6.x のみをサポートし、他のバージョンの DSpace はサポートしていないことに注意してください。
フィールド:
サイズ: このスペースに許される最大サイズ。0に設定するか、無制限の場合は空白のままにします。このフィールドはオプショナルです。
パス: ローカルファイルシステム上のスペースへの絶対パス。
ステージングパス: ステージングエリアへの絶対パスです。UNIXファイルシステムと互換性がある必要があり、できればパスと同じファイルシステム上に位置していることが望ましいです。
REST URL: 「REST」ウェブアプリへの URL。例:
http://localhost:8080/rest/; 本番システムでは、このアドレスは例えばhttps://demo.dspace.org/rest/のようにわずかに異なります。User: 認証を許可するのに十分な権限を持つ DSpace インスタンスのユーザー名。
パスワード: 上記のユーザー名用のパスワード。
デフォルトDSpace DIPコレクションID: 転送メタデータファイルで指定されていない場合にDIPが預けられるコレクションのUUID。
デフォルトDSpace AIPコレクションID: 転送メタデータファイルで指定されていない場合にAIPが預けられるコレクションのUUID。
注釈
次の7つのフィールドはオプションであり、DSpaceへの接続のみが必要な場合は安全に無視してもかまいません。
SWORD2を介したDSpaceスペースは ダッシュボード管理タブ を使用して単一のArchivesSpaceを設定するのに対して、RESTを介したDSpaceスペースでは、スペースごとに異なるArchiveSpacesのインスタンスを設定する選択肢があります。
ArchivesSpace URL: ArchiveSpaceサーバーのURL。例:
http://sandbox.archivesspace.org/。ArchivesSpaceユーザー: 認証に使用するArchivesSpaceのユーザー名
ArchivesSpaceパスワード: 認証に使用するArchivesSpaceのパスワード
デフォルトArchivesSpaceリポジトリ: デフォルトのArchivesSpaceリポジトリの識別子
デフォルトArchivesSpaceアーカイブオブジェクト: 転送メタデータファイルで指定されていない場合に使用される、デフォルトのArchivesSpaceアーカイブオブジェクトの識別子
Tivoli Storage ManagerへのAIP送信: これはエジンバラ大学の要望に基づいて開発された機能で、
dsmcというバイナリを使用してbashコマンドを実行します。SSL証明書の検証: Requestsはウェブブラウザと同様にHTTPSリクエストのSSL証明書を検証します。デフォルトではSSL検証が有効になっており、証明書を検証できない場合はSSLErrorが発生します。
DSpaceを経由するSWORD2 API¶
DSpaceを経由するSWORD2の場所は現在、AIPストレージの場所に対してのみサポートされています。DSpaceは通常、パブリックフェイシングシステムとして使用されるため、AIPストレージのための他のアクセスプロトコルを使用する場合とは動作が異なります。DSpaceに預けると、AIPは2つの部分に分割されます:
すべてのオリジナルおよび標準化されたオブジェクトを含む、圧縮されたオブジェクトファイル(ビットストリーム)
すべてのバッグアーティファクト、メタデータ、およびログを含む、メタデータファイル(ビットストリーム)
メタデータビットストリームはオプションで制限することができます。 以下を参照してください 。現在、ストレージサービスおよびダッシュボードはAIPのダウンロード/再構成ができません。これはDSpaceインターフェースから手動で行う必要があります。
ArchivesSpaceのワークフローにおいてDSpaceをAIPの保管場所として使用する場合、 鑑定タブ にて、AIPを保管した後に、DspaceのハンドルをArchivesSpaceのデジタルオブジェクトレコードに送信する「Store AIP」後処理フックがあります。ArchivesSpaceの設定は、 ダッシュボード管理タブ で設定されます。
注釈
DSpace via SWORD2 APIスペースはDSpace REST APIを使用してメタデータファイルの権限を変更します。これは、REST APIが適切に設定されていることを確認する必要があることを意味します。詳細は DSpace 5 REST APIドキュメント を参照してください。
DSpace via SWORD2 APIスペース機能はDSpace 5のみをサポートし、他のバージョンはサポートしていません。バージョン5とバージョン6の間でのDSpace REST APIの認証の変更については、 DSpace 6 REST APIドキュメント をご覧ください。
フィールド:
サイズ: このスペースに許される最大サイズ。0に設定するか、無制限の場合は空白のままにします。このフィールドはオプショナルです。
パス: ローカルファイルシステム上のスペースへの絶対パス。
ステージングパス: ステージングエリアへの絶対パスです。UNIXファイルシステムと互換性がある必要があり、できればパスと同じファイルシステム上に位置していることが望ましいです。
サービスドキュメントIRI: サービスドキュメントのURLです。例:
http://demo.dspace.org/swordv2/servicedocumentここでのservicedocumentは、デポジットに使用されるコミュニティまたはコレクションのハンドルです。User: 認証を許可するのに十分な権限を持つ DSpace インスタンスのユーザー名。
REST URL: 「REST」ウェブアプリへの URL。例:
http://localhost:8080/rest/; 本番システムでは、このアドレスは例えばhttps://demo.dspace.org/rest/のようにわずかに異なります。パスワード: 上記のユーザー名用のパスワード。
制限されたメタデータポリシー: メタデータビットストリームへのアクセスを制限するために使用します。JSONでオブジェクトのリストとして指定する必要があります。例えば、
[{"action":"READ","groupId":"5","rpType":"TYPE_CUSTOM"}]などです。これにより、既存のポリシーが上書きされます。
Fedora via SWORD2¶
SWORD2経由のFedoraは、現在、アクセスプロトコルとしてStorage Serviceでサポートされており、IslandoraからArchivematicaへの素材の取り込みを可能にする Archidoraプラグイン の使用を容易にしています。このワークフローは、Storage Service 0.9/Archivematica 1.5/Islandora 7.x-1.6 の時点でベータテスト中です。
フィールド:
サイズ: このスペースに許される最大サイズ。0に設定するか、無制限の場合は空白のままにします。このフィールドはオプショナルです。
パス: ローカルファイルシステム上のスペースへの絶対パス。
ステージングパス: ステージングエリアへの絶対パスです。UNIXファイルシステムと互換性がある必要があり、できればパスと同じファイルシステム上に位置していることが望ましいです。
Fedoraユーザー: Fedoraユーザー名(SWORD機能用)。
Fedoraパスワード: Fedoraパスワード(SWORD機能用)。
Fedora名: リモートFedoraマシンの名前またはIP。
注釈
また、FEDORAデポジットの目的で、ロケーション(以下参照)を作成する必要があります。
Archivematicaダッシュボードで、トランスファーが自動的に承認されるように、Storage ServiceのIP をREST APIのIPホワイトリストに追加する必要があります。
IslandoraがArchivematicaに保存された後に削除可能なオブジェクトをリストすることができるように、ポストストアコールバックを設定できます。 管理 セクションを参照してください。
ローカルファイルシステム上のGPG暗号化¶
GPG暗号化空間を作成することにより、ユーザーは暗号化されたAIPおよびトランスファーを作成することができます。GPG暗号化空間では、AIPストレージ、トランスファーバックログ、レプリケーターロケーションのみを作成できます。
暗号化されたAIPと転送は、ストレージサービスとArchivematicaダッシュボードを介して、暗号化されていない状態でダウンロードすることが可能です。
GPG暗号化スペースを作成する前に、 管理ページ でGPGキーを作成またはインポートしていることを確認してください。
フィールド:
サイズ: このスペースに許される最大サイズ。0に設定するか、無制限の場合は空白のままにします。このフィールドはオプショナルです。
パス: ローカルファイルシステム上のスペースへの絶対パス。
ステージングパス: ステージングエリアへの絶対パスです。UNIXファイルシステムと互換性がある必要があり、できればパスと同じファイルシステム上に位置していることが望ましいです。
キー: スペースに対して使用される暗号キー。
重要
未圧縮のAIPを暗号化し、tarファイルとして保存することができます。
未圧縮のAIPはポインターファイルを持っていないため、スペースのキーが変更され元のキーが削除/不明な場合、Archivematicaは復号化用のキーの記録を持っていません。
ローカルファイルシステム¶
ローカルファイルシステムスペースは、ストレージサービスを実行しているマシン上のローカルに使用可能なストレージを扱います。通常はマシンに添付されたハードドライブ、SSD、またはRAIDアレイですが、すでにマウントされたリモートストレージも含むことがあります。ローカルにマウントされたリモートストレージに関しては、利用可能な場合はより具体的なスペースを使用することを推奨します。
フィールド:
サイズ: このスペースに許される最大サイズ。0に設定するか、無制限の場合は空白のままにします。このフィールドはオプショナルです。
パス: ローカルファイルシステム上のスペースへの絶対パス。
ステージングパス: ステージングエリアへの絶対パスです。UNIXファイルシステムと互換性がある必要があり、できればパスと同じファイルシステム上に位置していることが望ましいです。
LOCKSS¶
Archivematicaは、LOCKSS-O-Maticを使用してAIPを LOCKSS ネットワークに保存できます。これは、ストレージサービスとプライベートLOCKSSネットワーク(PLN)間の通信にSWORDを使用します。
フィールド:
サイズ: このスペースに許される最大サイズ。0に設定するか、無制限の場合は空白のままにします。このフィールドはオプショナルです。
パス: ローカルファイルシステム上のスペースへの絶対パス。
ステージングパス: ステージングエリアへの絶対パスです。UNIXファイルシステムと互換性がある必要があり、できればパスと同じファイルシステム上に位置していることが望ましいです。
サービスドキュメントIRI: LOCKSS-o-maticサービスドキュメントIRIのURL。例:
http://lockssomatic.example.org/api/sword/2.0/sd-iri。コンテンツプロバイダーID: LOCKSS-o-maticと通信する際のOn-Behalf-Of値。
外部公開ドメイン: LOCKSSがアクセス可能なこのサーバーのベースURL。一般的にはストレージサービスのホームページのURLです。
ローカルコピーを保持しますか?: LOCKSSに保存された後でもAIPのローカルコピーを保存する場合、このボックスにチェックを入れてください。
注釈
LOCKSSスペース用のロケーションを作成する際(下記参照)、そのロケーションの目的はAIPストレージでなければなりません。
NFS¶
NFSスペースは、ストレージサービスサーバーとArchivematicaパイプラインにマウントされたNFSエクスポート用です。
フィールド:
サイズ: このスペースに許される最大サイズ。0に設定するか、無制限の場合は空白のままにします。このフィールドはオプショナルです。
パス: ストレージサービスにローカルなファイルシステム上でスペースがマウントされている絶対パス。
ステージングパス: ステージングエリアへの絶対パスです。UNIXファイルシステムと互換性がある必要があり、できればパスと同じファイルシステム上に位置していることが望ましいです。
リモート名: NFSマウントをエクスポートしているリモートコンピュータのホスト名またはIPアドレス。
リモートパス: NFSサーバー上のエクスポートパス
バージョン: ファイルシステムのバージョン。例:
nfsやnfs4のように、マウントコマンドに渡す形式。手動マウント:これはまだ利用できない機能のためのプレースホルダーです。
パイプラインローカルファイルシステム¶
パイプラインローカルファイルシステムは、Archivematicaのパイプラインにはローカルであるが、ストレージサービスにはリモートであるストレージを指します。このスペースが適切に機能するためには、ストレージサービスのホストとArchivematicaのホスト間でパスワードなしのSSHが設定されている必要があります。
例えば、ストレージサービスがstorage_service_hostでホストされていて、Archivematicaがarchivematica1で実行されているとします。Archivematicaの転送ソースはarchivematica1にローカルに格納されていますが、ストレージサービスがそれらにアクセスする必要があります。その転送ソースのスペースはパイプラインローカルファイルシステムになります。
注釈
ストレージサービスのホストとArchivematicaが実行されているコンピュータ間には、パスワードなしのSSHが設定されている必要があります。
フィールド:
サイズ: このスペースに許される最大サイズ。0に設定するか、無制限の場合は空白のままにします。このフィールドはオプショナルです。
パス: ストレージサービスにローカルなファイルシステム上でスペースがマウントされている絶対パス。
ステージングパス: ステージングエリアへの絶対パスです。UNIXファイルシステムと互換性がある必要があり、できればパスと同じファイルシステム上に位置していることが望ましいです。
リモートユーザー:リモートホスト上のユーザー名。
リモート名:Archivematicaを実行しているコンピュータのホスト名またはIPアドレス。これはストレージサービスのコンピュータからSSHでアクセス可能であるべきです。
rsyncデーモンによるファイルサービングを行うリモートホストを想定:チェックされている場合、ストレージサービスはデフォルトのリモートシェルを使ったrsyncではなく、rsyncデーモンスタイルのコマンドを使用します。
Rsyncパスワード:rsyncデーモンのパスワード
RClone¶
rclone はクラウドストレージのファイルを管理するためのコマンドラインプログラムであり、Storage Service 0.20以降のアクセスプロトコルとして利用可能です。
RCloneスペースは、アーカイブソース、AIPストア、DIPストアおよびレプリケータの場所として、40を超えるクラウドプロバイダーをArchivematicaと共に使用することを可能にします。アクセスキーなどの詳細構成は、構成ファイルまたは環境変数を介して行うことができます(推奨される方法)。詳細は rcloneドキュメントの環境変数を通じた構成 を参照してください。
フィールド:
アクセスプロトコル: RClone
サイズ: このフィールドは任意です。
パス: このフィールドは空白のままにしてください。
ステージングパス: Archivematicaがステージング目的でファイルを配置できるローカルディスク上の場所, 例:
var/archivematica/storage_service/rclone_staging。リモート名: このスペースで使用するrclone構成のリモート名。環境変数の値と一致する必要があり、大文字小文字を区別しません。
コンテナ/バケット名: 構成されたリモートで使用するコンテナまたはバケット名(rclone経由で使用されるサービスに応じてオプション)。
Swift¶
OpenStackのSwiftは、Storage Service 0.7以降のアクセスプロトコルとして利用可能です。
フィールド:
サイズ: このスペースに許される最大サイズ。0に設定するか、無制限の場合は空白のままにします。このフィールドはオプショナルです。
パス: ローカルファイルシステム上のスペースへの絶対パス。
ステージングパス: ステージングエリアへの絶対パスです。UNIXファイルシステムと互換性がある必要があり、できればパスと同じファイルシステム上に位置していることが望ましいです。
認証URL: 認証に対するURL。
認証バージョン: OpenStackの認証バージョン。
ユーザー名: 認証に使用されるSwiftのユーザー名。
パスワード: 上記のユーザー名のパスワードです。
コンテナ: Swiftコンテナの名前です。あなたのSwiftインストールで使用可能なコンテナをリストするには、コマンドラインから
swift listを実行してください。テナント: テナント/アカウント名で、auth 2.0システムに接続する際に必要です。
リージョン: Swift内のリージョンです。このフィールドはオプションです。
注釈
5GBを超えるオブジェクト(圧縮されていないパッケージの場合)または合計5GBのオブジェクト(圧縮されたパッケージの場合)を含む転送にはSwiftは使用できません。これは、転送元、バックログ、AIP、およびDIPのロケーションに適用されます。
5GBを超えるオブジェクト/パッケージはアプリケーションによって分割されなければならず、現在Swiftスペースでは利用できない機能です。大きなオブジェクトについてのSwiftドキュメントを参照してください Swift documentation for large objects 。
S3 (アマゾン)¶
アマゾンS3は、ストレージサービスのバージョン0.12からアクセスプロトコルとして利用できます。S3内のロケーションは、AIPストレージ、DIPストレージ、レプリケータ、そして転送元として使用できます locations 。
フィールド:
サイズ: このスペースに許される最大サイズ。0に設定するか、無制限の場合は空白のままにします。このフィールドはオプショナルです。
パス: 必須ではありません:下記を参照。
ステージングパス: ストレージサービスと同じサーバー上のステージングエリアへの絶対パスです。
S3エンドポイントURL: S3エンドポイントのURLです、例えば
https://s3.amazonaws.com。認証するためのアクセスキーID: S3によって生成された公開キー。必須ではありません:下記を参照
認証に使用する秘密アクセスキー: S3によって生成された秘密キー。必須ではありません:下記を参照
リージョン: S3インスタンスが使用するリージョン。例:
us-east-2。S3バケット: 指定されたS3バケットの名称。このフィールドは任意です。
注釈
S3ストレージを設定する際に、すべてのフィールドが必要なわけではありません。しかし、それらは依然として使用できます。
S3のパスとロケーションの相対パス( locations を参照)が構成された場合、ストレージサービスは次のようにユーザーに表示されるS3バケットを作成しようとします(各改行はネストされたディレクトリを示しています):
この例では:
d6d618dd-2b7f-4177-8b59-10e242066cb7は設定されたS3ストレージスペースのUUIDです。cd20f886-0c40-4202-af80-399b6ca9f1f1は保存したいAIPのUUIDです。storage-space-pathはストレージスペースパスに構成されています (先頭スラッシュなし)。storage-location-relative-pathはロケーション(相対パス)として構成されています (先頭スラッシュなし)。
ストレージスペースの Path 、およびロケーションの``Relative Path``の値は、構成された通りに表示されます:
s3
└── d6d618dd-2b7f-4177-8b59-10e242066cb7
└── storage-space-path
└── storage-location-relative-path
└── cd20
└── f886
│
└── ...additional pair-tree folders...
│
└── f1f1
└── cd20f886-0c40-4202-af80-399b6ca9f1f1.7z
Access Key IDおよびSecret Access Keyが設定されている場合、ストレージサービスはそれらの詳細で認証を試みます。
これらの値が設定されていない場合、ストレージサービスは AWS_ACCESS_KEY_ID および AWS_SECRET_ACCESS_KEY 環境変数によって提供される認証詳細を使用しようとします。
バケット名が設定されている場合、そのバケットが使用されます。そうでない場合はスペースのIDが代わりに使用されます。いずれの場合も、バケットは必要に応じて自動的に作成されますが、AWSユーザーにその権限がある場合のみです。
警告
ストレージスペースで設定された Path およびロケーションで設定された`Relative Path は、先頭にスラッシュ( /`)がないように設定するのが最善です。これはS3サービスで保存されたパッケージを削除する機能に影響を与える可能性があるためです。これはS3 APIコールを行うために使用されるサードパーティ製ライブラリの影響です。
ユーザーが先頭にスラッシュがあるパスにパッケージを保存しており、それらがS3から削除されない場合は、スラッシュを削除するように構成を変更することを検討してください。その際には慎重に行い、結果としてAIPの保存に何らかの影響があった場合は先頭にスラッシュを戻す準備をしておいてください。
S3のデバッグ¶
S3ストレージアダプターをデバッグする必要があることがあります。例えば、S3の実装に接続できないために転送が完了できない場合などです。
ストレージサービス用に書かれたS3アダプターは、 Boto3 S3 SDK(ソフトウェア開発キット)に大きく依存しています。このライブラリはGitHubでホストされており、Boto3のGitHubの問題点は、潜在的なアップストリームの問題を理解しようとする際の良い出発点になります。
ストレージサービスでは、Boto3アダプターのデバッグログを増やすことができます。ストレージサービスのデフォルトを上書きする方法についての詳細は インストールのREADME.md にあります。
ログ設定 で、管理者は主要な2つのBoto3コンポーネントのエントリを見つけることができるはずです:
"boto3": {"level": "INFO"},
"botocore": {"level": "INFO"}
これらのエントリのログレベルをINFOからDEBUGに変更すると、Boto3 SDKを通して、ストレージサービスとS3実装との間の完全なワイヤートレースが出力されます。標準のBoto3ログは高レベルの情報を提供し、botocoreはさらに詳細な情報を提供します。
From the documentation, the Boto3 developers are careful to note as follows:
警告
'botocore'から何かをログに記録すると、完全なワイヤトレースがログに表示されることに注意してください。ペイロードに機密データが含まれている場合、これは本番環境では使用しないでください。
注釈
デバッグ設定を更新する際に、Boto3のエントリーが存在しない場合は手動で追加することができます。これらを手動で追加する場合は、JSONの整合性を損なわないように変更する必要があることに注意してください。
ローカルファイルシステム上のライトオンリー・レプリカステージング¶
ライトオンリーレプリカステージングスペースは、ユーザーがAIPレプリカをローカルファイルシステム上にステージングし、テープロボットなどのオフラインストレージシステムに配信することを可能にします。ライトオンリーレプリカステージングスペースにはレプリケータのロケーションのみを作成できます。
フィールド:
サイズ: このスペースに許される最大サイズ。0に設定するか、無制限の場合は空白のままにします。このフィールドはオプショナルです。
パス: ローカルファイルシステム上のスペースへの絶対パス。
ステージングパス: ステージングエリアへの絶対パスです。UNIXファイルシステムと互換性がある必要があり、できればパスと同じファイルシステム上に位置していることが望ましいです。
重要
ライトオンリーレプリカステージングは、書き込みが一度だけ可能なスペースです。ライトオンリーレプリカステージングスペース内のレプリケータロケーションに保存されたレプリカは、保存後にダウンロードや削除、整合性チェックを行うことができません。
重要
ライトオンリーレプリカステージングスペース内に書き込まれたレプリカは、通常のUUID四つ組のディレクトリ内ではなく、直接レプリケータのロケーションのパス内に保存されます。これにより、オフラインストレージシステムによるスペース内に保存されたパッケージの効率的な取り出しが可能になります。
ロケーション¶
ロケーションはスペース内に格納され、Archivematica システムで定義された目的を持ちます。各ロケーションは少なくとも一つのパイプラインに関連付けられています。パイプラインは任意のロケーションを複数持つことができ、また、ロケーションは任意の数のパイプラインに関連付けることができますが、バックログおよび現在の処理中のロケーションについては、パイプラインごとに1つだけである必要があります。
ロケーションは9つの目的のうちの1つを持つことができます:AIPリカバリー、AIPストレージ、現在の処理、DIPストレージ、FEDORAデポジット、ストレージサービス内部処理、転送バックログ、転送ソース、またはレプリケーター。
フィールド:
目的: このロケーションが果たす機能です、例えば
AIP storage。詳細は ロケーションの目的 を参照してください。パイプライン: このロケーションを使用できるArchivematicaのインスタンスです。
相対パス: これに含まれるスペースに対するこのロケーションへのパス。
説明: ユーザーに表示されるロケーションの説明です。
クオータ: このスペースの許容最大サイズ。0に設定するか、無制限のために空白のままにします。このフィールドはオプションです。
有効: 選択されている場合、このロケーションは関連付けられたパイプラインからアクセス可能になります。選択されていない場合、いかなるパイプラインからも利用できません。
目的のためにグローバルデフォルトの位置を設定する: このオプションをチェックすると、ユーザーが処理中にArchivematicaに特別な指示をしない限り、この場所がその目的のデフォルトの場所となります。
注釈
DSpace経由のSWORD2の場所 を設定する際には、転送の目的地コレクションのURLである相対パスが必要です。例: https://demo.dspace.org/10673/60/ 。
場所の目的¶
AIP復旧¶
AIP復旧場所は、 AIP復旧 機能がAIPを復旧するために探す場所です。一つのパイプラインには一つ以上のAIP復旧場所を関連付けるべきではありません。デフォルト値はローカルファイルシステムの /var/archivematica/storage_service/recover です。これはAIP復旧が使用される場合にのみ必要です。
AIP保管¶
AIP保管場所は、完成したAIPが長期保管のために置かれる場所です。デフォルトの場所を使用するパイプラインの場合、デフォルトパスはローカルファイルシステムの `/var/archivematica/sharedDirectory/www/AIPsStore `です。AIPを保管および取得するためにはAIP保管場所が必要です。
現在の処理¶
Archivematicaでは、現在処理中の場所がそのパイプラインに関連付けられており、アクティブな処理中に素材を格納するために使用されています。正確に1つの現在処理中の場所が特定のパイプラインに関連付けられるべきです。デフォルトの場所を使用しているパイプラインには、ローカルファイルシステム内のデフォルトパスは /var/archivematica/sharedDirectory です。現在処理中の場所はArchivematicaの実行に必要です。
DIPストレージ¶
DIPストレージ場所は、アクセスシステムにアップロードできるまでDIPを保存するために使用されます。デフォルトの場所を使用しているパイプラインの場合、デフォルトパスはローカルファイルシステム内の /var/archivematica/sharedDirectory/www/DIPsStore です。DIPストレージ場所はDIPを保存および取得するために必要ですが、DIPをアクセスシステムにアップロードするためには必要ありません。
FEDORAデポジット¶
FEDORAデポジット場所はArchidoraプラグインと共に使用し、Islandoraから素材を取り込むために使われます。これはFEDORAスペースでのみ利用可能で、そのスペースにのみ必要です。
ストレージサービス内部処理¶
一つのストレージサービスインストールに対して、ストレージサービス内部処理の場所は一箇所のみであるべきです。デフォルトの場所を使用するパイプラインの場合、デフォルトパスはローカルファイルシステム内の /var/archivematica/storage_service です。これはストレージサービスを実行するために必要であり、ストレージサービスにローカルで利用可能でなければなりません。この場所はいかなるパイプラインとも関連付けられるべきではありません。
転送バックログ¶
転送バックログの場所は、ユーザーがそれらの処理を続けるまで転送を保管します。デフォルトの場所を使用するパイプラインの場合、デフォルトパスはローカルファイルシステム内の /var/archivematica/sharedDirectory/www/AIPsStore/transferBacklog です。これはバックログ内の転送を保存し取り出すために必要です。
転送ソース¶
転送ソースの場所のリストは、Archivematicaパイプラインの 転送タブ 上の転送ソースドロップダウンに表示されます。転送ソース内の任意のフォルダを選択して転送にすることができます。デフォルト値はローカルファイルシステム内の /home です。
レプリケーター¶
レプリケーターの場所は、一つまたは複数のAIP保管場所にあるAIPを複製するように設定することができます。レプリケーターは、ストレージサービスがサポートする以下のプロトコルそれぞれについて設定することができます:
Duracloud。
ローカルファイルシステム(GPGで暗号化されたもの、書き込み専用のレプリカステージングを含む)。
S3。
レプリケータは、ストレージロケーションの設定ページを通じてAIPストレージロケーションと関連付けられています。したがって、レプリケータはAIPストアと併用するために選択される前に設定されなければなりません。これに関する追加情報は configure location で参照できます。レプリケートされたAIPを暗号化したい場合は、 encrypted space でロケーションを作成してください。
注釈
同じスペースに複数の目的を持たせたい場合は、異なる目的の複数のロケーションを作成することができます。
レプリケータの結果¶
1つのAIPを多くのレプリケータへ:
AIPストレージロケーションに設定された*n-* 個のレプリケータがある場合、AIPは n- 回複製されます。
再取り込み時に、レプリカは置き換えられ新しい識別子が与えられます:
再取り込みの間、以前のレプリカは削除され、「ストレージサービスパッケージ」タブで削除済みとしてマークされます。新しいレプリカが作成され、アップロード済みとしてマークされます。新しいレプリカには新しいUUIDが割り当てられます。ポインタファイルは、ソースとレプリカ間、逆にレプリカとソース間の正確な参照で更新されます。
再取り込みはレプリカの更新または削除に利用できます:
レプリケータが無効になっている場合、再取り込みにより、特定のレプリカをそのレプリカの場所から選択的に削除することができます。新しいレプリケータが有効になった場合には、再取り込みを使って、そのレプリカの場所に既存のAIPをレプリケートすることができます。
再取り込みなしにレプリカを作成・更新する:
レプリカは再取り込みを必要とせずに、 AIPレプリカの作成 管理コマンド を使用して一括で作成・更新することもできます。
ソースAIPの削除はレプリカも削除されます:
ソースAIPがArchivematicaまたはストレージサービス経由で削除されると、レプリカも削除されます。逆に、レプリカが削除された場合、指定された場所にあるレプリカのみが影響を受けます。
レプリケータの制限¶
パイプライン内のAIPストレージとの強い結合:
レプリケーションはAIPストレージと密接に関連しています。そのため、ソースAIPが成功してもレプリカの保存に失敗した場合、Archivematicaのパイプラインは処理中に失敗します。これは、Archivematica内のアーカイバルストレージタブでのAIPのインデクシングに影響を与え、ストレージサービス内のステージングにレプリカパッケージを残します。ストレージサービスのユーザーインターフェースでは、レプリカパッケージのステータスを明確にSTAGINGとしてマークします。
再取り込み中の新しいUUID:
再収集すると新しいUUIDがAIPに与えられるので、ストレージサービス内のパッケージを追跡している外部サービス、特にレプリカは、それぞれの記録を同期する必要があります。
How to configure a location¶
新しい「ロケーション」を作成および構成するには:
ストレージサービスで「スペース」タブに移動します。
ロケーションを追加したいスペースの下で、「ここにロケーションを作成」をクリックします。
目的(例:AIPストレージ)とパイプラインを選択し、「相対パス」(例:
var/mylocation)とわかりやすい説明を入力します。相対パスは、ロケーションを追加しているスペースで定義されているパスに関連しています。たとえば、デフォルトのスペースではパスは/なので、ロケーションのパスはそれに対して相対的になり(ここで例として挙げた場合、完全なパスは/var/mylocationになります)。注釈
ロケーションで定義しているパスが存在しない場合は、手動で作成し、Archivematicaユーザーが書き込み可能であることを確認する必要があります。
AIPストレージロケーションに対して、必要に応じてレプリケーター・ロケーションを選択します。複数を選択する場合は、レプリカのUUIDをクリックしながらctrlキーを押し続けます。
注釈
選択するためには、1つ以上のレプリケーター位置があらかじめ設定されていなければなりません。レプリケーター位置が後で設定された場合、このページから追加することができます。
レプリカAIPは、位置がレプリケーターに関連付けられた後にのみ作成されますが、 create AIP replicas マネジメントコマンド を介して遡って作成することもできます。
位置設定を保存します。
新しい位置は、ダッシュボード上の適切なオプションの下で選択可能になります。例えば、転送位置(ダッシュボードの「管理」タブで有効にする必要があります)やAIPストレージの目的地として使用できます。
パッケージ¶
パッケージは、Archivematicaがストレージサービスに保存したファイルで、一般的にはアーカイブ情報パッケージ(AIP)です。保存された普及情報パッケージ(DIP)やバックログに送信された転送も、パッケージタブにリストされます。
AIPは、ストレージサービスインターフェイスを介して作成または削除することはできませんが、ストレージサービスの管理者が承認または拒否する必要がある削除リクエストをArchivematicaを通じて送信することができます。AIPの削除についての詳細は、 Deleting an AIP を参照してください。
保存されたDIPは、ストレージサービスインターフェースから「アクション」列の「削除」オプションを選択することで削除できます。
転送のオブジェクト全てがAIPに正常に保存されると、転送の削除リクエストが自動的に生成されます。
フィクシティ状態についての詳細情報は、 フィクシティ を参照してください。
管理¶
管理セクションでは、ストレージサービスのユーザーと設定を管理します。
設定¶
設定ページを使用すると、ストレージサービスの動作を制御できます。
**作成時にパイプラインを無効にする**では、新しく作成されたArchivematica パイプライン が割り当てられた ロケーション にアクセスできるかどうかを決定できます。新しく作成されたパイプラインを無効にすることで、割り当てられた場所のファイルへの不要な閲覧や、許可されていないArchivematicaインスタンスによる使用に対するいくつかのセキュリティを提供できます。これは、ストレージサービスのウェブサイトを通じて手動でパイプラインを作成する際にも個別に設定することができます。
**スペース内のオブジェクトカウントを無効にする**では、転送ソースのロケーションを含むスペースなど、カウント情報をユーザーに表示するスペースの自動オブジェクトカウントを無効にすることができます。オブジェクトカウントを有効にしていると、ダッシュボードで遅延やタイムアウトが発生する可能性があります。
オブジェクトカウント有効時の転送ブラウザです。¶
オブジェクトカウント無効時の転送ブラウザです。¶
復旧リクエスト¶
これらのフィールドを使用して、AIP削除ワークフローに関連するイベント、例えば削除の承認や拒否の通知を設定することができます。
フィールド:
復旧リクエスト:通知するURL: ストレージサービスからJSONエンコーディングされたイベントメッセージを受け取るサーバー。
復旧リクエスト通知:ユーザー名(任意): 基本アクセス認証用のユーザー名。
復旧リクエスト通知:パスワード(任意): 基本アクセス認証用のパスワード。
デフォルトの場所¶
デフォルトの場所の設定により、ストレージサービスに登録された新しいパイプラインのデフォルトの場所を定義することができます。次のデフォルトの場所を定義できます:
転送元
AIPストレージ
DIPストレージ
転送バックログ
AIP復旧
複数の転送元またはAIPストレージ場所は、選択時に Ctrl キーを押し続けることで設定することができます。
現在処理中の場所も、新しいパイプラインごとに作成されます。必要なので。
ユーザー¶
ユーザーセクションでは、ストレージサービスのユーザーを管理できます。登録されたユーザーのみがストレージサービスにログインできます。
ユーザーロールは4種類あります:管理者、マネージャー、レビュアー、リーダー。
**リーダー**は、すべての情報パイプライン、スペース、場所、パッケージタブを閲覧できますが、それらのタブで編集や削除要求の管理、その他のアクションを行うことはできません。管理タブでは、リーダーは自分のユーザープロファイルを編集できます。リーダーは、ストレージサービスインタフェースの言語を自分自身で変更することもできます。
**レビュアー**は上記のすべての権限を持ち、さらにパッケージの回復と削除の要求をレビュー、承認、または拒否することができます。
**マネージャー**は上記のすべての権限を持ち、さらにパイプライン、スペース、場所の作成、編集、無効化、削除を行うことができます。マネージャーはストレージサービスを構成したり、コールバックを作成したり、キーの作成および削除も行うことができます。
**管理者**は上記のすべての権限を持ち、さらに他のストレージサービスユーザーを作成および管理することができます。管理者は特別なイベントが発生したときにもメール通知を受け取ります。
バージョン¶
バージョンページには、ストレージサービスのインストールにおける現在のバージョンと具体的 なgitコミットが表示されます。
サービスコールバック¶
コールバックを使うことで、アーカイブマティカストレージサービスは特定のアクションを実行した後にREST呼び出しを行い、内部アクションが発生したときに外部サービスに通知できます。AIP、DIP、またはAICが保存された場合に外部サービスを警告するためのコールバックを作成することができます。
新しいコールバックを作成するには、新しいコールバックの作成 をクリックします。これにより、コールバック情報を入力できるフォームが表示されます。
フィールド:
イベント: このコールバックが実行されるべきイベントのタイプ(例: AIPストア後、DIPストア後)
URI: コールバック実行時に連絡するURL。
メソッド: URLに接続する際に使用するHTTPリクエストメソッド(例: GET、POST)
ヘッダ(キー/値): リクエストのヘッダ。
ボディ: 各リクエストのボディ内容。'Content-type'ヘッダを適切に設定してください。
期待されるステータス: サーバーからの予期されるHTTP応答で、コールバック応答の妥当性を検証するために使用されます。
有効: コールバックを有効にするためのボックスにチェックを入れてください。
利用可能なイベントタイプには以下が含まれます:
ポスト・ストアAIP(ソースファイル): AIPが保存された後に発生し、AIPの各ソースファイルに対してリクエストを実行することになります。
ポスト・ストアAIP、ポスト・ストアAIC、ポスト・ストアDIP: AIP、AIC、またはDIPが保存された後に発生し、パッケージに対して単一のリクエストを実行することになります。
URIとBodyフィールドには以下のプレースホルダーを使用することができます:
ポスト・ストアAIP(ソースファイル):
<source_id>はソースファイルのUUIDに置き換えられます。ポスト・ストアAIP、ポスト・ストアAIC、ポスト・ストアDIP:
<package_uuid>はAIP、AIC、またはDIPのUUIDに置き換えられます。<package_name>はAIP、AIC、またはDIPの名前に置き換えられ、末尾のUUIDは削除されます。
注釈
転送から直接作成されたAIPの場合、 <package_name> に置き換えられる値は、"Change transfer filenames" マイクロサービスの成功裡な完了後の転送の名前と同じになります。
外部アプリケーションは、 post_store API エンドポイントまたは stored エンドポイントを介して Archivematica と統合することができます。これらのエンドポイントの使用方法については、 APIドキュメント を参照してください。
SCOPE統合のためのコールバックを設定することができます。このコールバックの設定方法については、 SCOPEドキュメント を参照してください。
暗号キー¶
GPG暗号化キーは、暗号化されたAIP、転送、または複製されたAIP/転送をスペースに格納するために作成またはインポートできます。キーはストレージサービスによって作成されることも、インポートされることもできます。
新しいキーを作成するには:
**新しいキーを作成**をクリックします
キーに関連付けたい名前とメールアドレスを入力します。
キーをインポートするには:
**既存のキーをインポート**をクリックします
キーをASCIIアーマード形式で貼り付けます。
言語¶
管理タブのこのエリアでストレージサービスの言語設定を行います。文字列は翻訳プラットフォーム(Transifex)で翻訳が可能です。