サポート対象の移行を使用してownCloud ClassicをoCISに移行する

ownCloud専用migrate-to-ocisアプリとそのoccコマンドを使用して、ownCloud Classic 10から、別途インストールしたownCloud Infinite Scale(oCIS)インスタンスに、ユーザー、グループ、ファイル、およびサポートされている共有を転送します。これは段階的な移行であり、インプレースアップグレードではありません。移行先はアクセス可能で、認証となりすましに対応できる状態であり、競合するデータが存在しない状態である必要があります。パスワードのリセット、ロールの再割り当て、および外部マウントの手動処理についても計画しておいてください。

この移行がお使いの環境に適合するかどうか確認してください。

ownCloudの最新のServer 10.16移行ドキュメントでは、ownCloudが提供するアプリを使用したガイド付き移行手順がサポートされています。このアプリはマーケットプレイスでは入手できません。入手するにはownCloudサポートにお問い合わせください。移行元と移行先の両方が設定済みで、実行中で、相互に通信できる状態である必要があります。また、ClassicサーバーへのSSHアクセス権限と、occWebサーバーユーザーとしてコマンドを実行できる権限も必要です。

文書化された移行では、有効なユーザーとグループ、各有効ユーザーのホームディレクトリ内のファイル、およびユーザー、グループ、リンクの共有が転送されます。無効なユーザー、無効なユーザーが所有するファイル、パスワード、外部マウントは転送されません。外部マウント場所にある受信共有とファイルは、ファイル転送から除外されます。ユーザーがマウントされた SMB/S3 ストレージ、共有管理者マウント、または既存の外部リポジトリに依存している場合は、それらをインベントリし、切り替えをスケジュールする前に、別途コピーと再作成のプロセスを計画してください。

例えば、ローカルアカウントと個人ホームディレクトリにファイルを持つ小規模チームであれば、組み込みのローカルユーザー移行フローを利用できる可能性があります。LDAPにアカウントを持つ企業は、まずoCISが同じユーザーとグループを解決できることを確認し、次にLDAP固有の要件に従う必要があります。ローカルユーザーとLDAPユーザーが混在する環境は、この手順ではサポートされていません。本番環境や大規模な展開においては、ownCloudは、組み込みのoCIS IDMの機能制限よりも、本格的なLDAPまたは外部のID管理システムの使用を推奨します。

移行コマンドを実行する前に、両方のサーバーを準備してください。

  1. インベントリとバックアップ。有効/無効のアカウント、グループメンバーシップ、ストレージマウント、共有リンク、アプリケーション統合、およびデータセット全体を記録します。Classic データベースとデータの復元可能なバックアップを取得して検証し、ターゲット構成をバックアップします。移行はバックアップではありません。ユーザーが新しいサービスを確認するまで、元の Classic インスタンスを利用可能な状態にしておきます。
  2. 移行アプリをインストールします。ownCloudサポートからアプリを入手し、Classicディレクトリまたは適切な所有権を持つディレクトリmigrate-to-ocisにインストールして有効化します。デフォルトのインストールパスとApacheアカウントを想定する例:appsapps-externalwww-data
sudo -u www-data php /var/www/owncloud/occ app:enable migrate_to_ocis

インストール環境に合わせて、パスとオペレーティングシステムのアカウントを調整してください。移行アプリには独自のrcloneバイナリが同梱されているため、ownCloudから移行プランを入手せずに、ドキュメントに記載されているアプリのワークフローに代えて、別途手動コピーの手順を実行しないでください。

  1. oCIS認証を準備します。サービスと偽装を有効にしますauth-app。ドキュメントに記載されている環境設定はOCIS_ADD_RUN_SERVICES: "auth-app"、、、PROXY_ENABLE_APP_AUTH: trueですAUTH_APP_ENABLE_IMPERSONATION: true。auth-appを使用してoCIS管理者用のアプリトークンを作成します。移行では、管理者ユーザー名とこのトークンを使用してoCIS操作を行います。トークンは安全に保管し、共有シェル履歴や記事構成に貼り付けないでください。
  2. まず、ユーザーIDを解決してください。有効なクラシックユーザーには、それぞれ有効な一意のメールアドレスが必要です。LDAPを使用する場合は、移行前にoCISがユーザーをログインできることを確認し、適切なLDAPユーザー名とスキーマ属性を設定してください。クラシックLDAPユーザー名属性には、 oCIS IDと一致しない内部UUIDではなく、uidやなどの安定したログイン名を使用してくださいsamAccountName。ユーザー名とグループ名は、関連するシステム間で一致している必要があります。移行のID解決段階以降は、アカウントやグループの追加、削除、名前変更を行わないでください。

マイグレーションを順番に実行

以下のコマンドでは/var/www/owncloud、例としてwww-data、、、およびという名前の oCIS ホストを使用していますocis.example.com。これらを実際の値に置き換えてください。管理者パスワードは、移行コマンドによって対話的に要求されます。

  1. ソースを初期化して検証します。初期化によって、以降の手順で使用する宛先ホストが記録されます。
sudo -u www-data php /var/www/owncloud/occ migrate:to-ocis:init ocis.example.com
sudo -u www-data php /var/www/owncloud/occ migrate:to-ocis:verify

検証結果を確認し、欠落または重複しているメールを修正してから続行してください。処理速度を上げるためだけに検証をスキップしないでください。スキップオプションを使用すると、メール関連の問題はユーザーの責任となります。--insecure証明書の問題を理解している管理されたテスト以外では、検証は避けてください。本番環境への移行のためにTLSの信頼関係を修正してください。

  1. ユーザーをプロビジョニングし、役割を割り当てます。ドキュメントに記載されている組み込みIDMフローを使用するローカルユーザーの場合は、以下を実行します。
sudo -u www-data php /var/www/owncloud/occ migrate:to-ocis:migrate:users ocis-admin
sudo -u www-data php /var/www/owncloud/occ migrate:to-ocis:assign-role ocis-admin
sudo -u www-data php /var/www/owncloud/occ migrate:to-ocis:migrate:groups ocis-admin

役割割り当ての手順は必須です。移行されたクラシックユーザーには、選択された oCIS 役割が 1 つ割り当てられます。クラシック役割は保持されず、サブ管理者権限には同等の役割がありません。管理者アカウントを個別に確認し、必要な場合にのみ昇格された oCIS 権限を付与してください。LDAP で既にユーザーがプロビジョニングされている場合は、公式の LDAP ルートに従い、アカウントを重複させる代わりに、指示された箇所でサポートされているスキップ オプションを使用してください。

  1. ファイル転送後、共有を行います。ユーザーとグループのIDが準備できたら、以下の手順を実行してください。
sudo -u www-data php /var/www/owncloud/occ migrate:to-ocis:migrate:files ocis-admin
sudo -u www-data php /var/www/owncloud/occ migrate:to-ocis:migrate:shares ocis-admin

各ユーザーのクラシック ホーム ディレクトリ内のファイルは、そのユーザーの個人スペースに転送されます。外部マウントと受信共有は除外さ​​れます。shares コマンドはユーザー、グループ、およびリンク共有を処理しますが、移行中にユーザーまたはグループが見つからない場合のエラーが報告されることがあります。パスワードで保護されたリンクには、クラシック パスワードと一致しない新しいパスワードが割り当てられます。パスワードなしのリンクは、デフォルトの oCIS ポリシーでは失敗する可能性があります。ユーザーに公開済みのリンクを置き換え、更新されたパスワードを安全なチャネルを通じて配布するように伝えてください。

切り替え前にアクセス権限を検証する

コマンドの実行が完了したら、ユーザー、グループ、フォルダーツリー、ファイル数、アクセス許可、キー共有のサンプルをインベントリと比較してください。管理者アカウントだけでなく、一般ユーザーアカウントでもテストしてください。別途計画したプロセスで外部ストレージが再作成され、データがコピーされていることを確認してください。移行されたユーザーの古いパスワードは転送されないため、パスワードのリセットまたはオンボーディングの準備をしてください。

変更の検証と通知中は、クラシック サービスを利用可能な状態に保ってください。一貫性のある最終切り替えを行うには、書き込みフリーズをスケジュールし、ソースへの新規変更を防止し、移行実行以降に行われた変更をすべて考慮してください。記載されている手順は、継続的な同期を保証するものではありません。チェックがパスした後でのみ、ユーザーとクライアントをリダイレクトしてください。ロールバック期間と既知の正常なバックアップを保持し、記載されているリセット動作(--force移行状態を再開しますが、既に移行されたターゲット データはそのまま残るため、再開する前にターゲットをクリーンアップする必要があります)を理解せずに、データが投入されたターゲットに対してリセットして再実行しないでください。

公式資料

コメントを残す

サポート対象の移行を使用してownCloud ClassicをoCISに移行する

ownCloud 10からoCISへの移行を計画する際は、サポート対象のアプリ、順序付けられたコマンド、本人確認、および個別に処理する必要のあるデータの明確なリストを用意してください。

テーマアプリとCSSを使用したブランドownCloud Classic 10

ownCloud Classic 10のロゴを置き換え、テーマアプリを使用してWeb UIの色を調整し、アップグレードや整合性チェックの落とし穴を回避します。

ownCloud oCISでユーザーロールごとにデフォルトのストレージクォータを設定する

ownCloud oCISでユーザーロールごとにデフォルトのストレージクォータを設定する

役割ごとに、新しいownCloud Infinite Scaleユーザーにバイト単位のストレージ制限を割り当てます。proxy.yamlの例と安全な検証チェックリストも含まれています。

ownCloud同期証明書のTLSソースエラーを修正する

ownCloud同期証明書のTLSソースエラーを修正する

TLS検証を無効にせずに、サーバーのホスト名、証明書チェーン、プライベートCAの信頼、およびキャプティブポータルの問題を確認することで、ownCloudデスクトップの同期を復元します。

アップグレード後にownCloudの整合性警告をクリアする

無効ファイルレポートを使用して、一致しないコアファイルまたはアプリ署名を特定し、正しいリリースファイルを復元し、整合性チェックを安全に検証します。

ownCloud Infinite ScaleをDocker Composeでインストールする

ownCloud Infinite Scaleを公式のComposeサンプルからデプロイし、ドメインと永続ストレージを設定した後、TLS、コンテナ、および初回ログインを確認します。

ownCloud Infinite Scale 用の S3 Blob Storage の設定

ownCloud Infinite Scale 用の S3 Blob Storage の設定

ownCloud Infinite Scaleがファイルコンテンツを確実に保存できるように、S3NGドライバー、バケットのアクセス許可、永続的なメタデータストレージ、およびアップロードサイズを設定します。

ownCloudのアップロードが99%で止まった場合は、これらの制限を確認してください。

ownCloudのアップロードが99%で止まった場合は、これらの制限を確認してください。

ownCloud Serverへのアップロードが完了間近で停止する原因を特定するには、ファイルの状態、クォータ、一時ディスク容量、PHPの制限、プロキシのタイムアウトなどを確認してください。

ownCloudのApache .htaccess警告を安全にクリアする

ownCloudのApache .htaccess警告を安全にクリアする

ownCloudのウェブルートに対してのみAllowOverride Allを設定し、アクティブなApache仮想ホストを検証し、安全にリロードして.htaccessルールを復元します。

ownCloud Enterprise Auditingを設定し、ログを確認する

ownCloudのエンタープライズ監査アプリを有効にし、admin_auditイベントを保護されたログファイルにルーティングして、実際のユーザー操作が記録されていることを確認します。