バックアップからの復元

コマンドラインを使って、バックアップから Enterprise Server のインスタンスを復元できます。バックアップサービスでは、構成やユーザーデータを含む完全なインスタンスの復元がサポートされています。

警告

バックアップから復元すると、インスタンスの既存データがすべて上書きされます。この操作を元に戻すことはできません。

復元できるスナップショットは、ターゲットインスタンスのバージョンより最大 2 つ前の機能バージョンまでのみです。

次に例を示します。

バージョン 3.17 のスナップショットは、3.17.x、3.18.x、または 3.19.x を実行しているターゲットに復元できます。
3.17 のスナップショットを 3.20 に復元することは、2 バージョンより後であるため、できません。

また、新しいバージョンから古いバージョンに復元することもできません。たとえば、3.18 のスナップショットを 3.17 のインスタンスに復元しようとすると、次のエラーが発生します: Error: Snapshot can not be restored to an older release of Enterprise Server.

バックアップを復元する前に:

ターゲットインスタンスでメンテナンスモードを有効にします。「メンテナンスモードの有効化とスケジューリング」を参照してください。
スナップショットが格納されているバックアップストレージにアクセスできることを確認します。
干渉するサービスを一時的に停止する: 高可用性 (HA) をお使いの場合、レプリケーションが停止されていることを確認します。
Actions を準備する: 有効になっている場合、ターゲットインスタンスで正しい外部ストレージが構成されていることを確認します。詳しくは、「 Actions が有効になっている場合の復元」をご覧ください。

スナップショットから復元するには:

admin ユーザーとしてターゲットインスタンスに SSH で接続します。
次のいずれかのコマンドを実行します。
- 最新のスナップショットを復元します。
```
ghe-restore
```
- 特定のスナップショットを復元します。 <SNAPSHOT_TIMESTAMP> を復元するスナップショットのタイムスタンプ (例: YYYYMMDDTHHMMSS) に置き換えます。
```
ghe-restore -s <SNAPSHOT_TIMESTAMP>
```
- (省略可能) 構成、証明書、ライセンスデータを強制的に上書きします。
```
ghe-restore -c          # Latest snapshot
ghe-restore -s <SNAPSHOT_TIMESTAMP> -c  # Specific snapshot
```
[Management Console] の最終処理を行う:
- すべての構成設定 (ネットワーク、認証、TLS など) を確認します。
- [Save settings] をクリックしてそれらを適用し、サービスを開始します。
- このステップが完了するまで、インスタンスは完全には動作しません。
復元されたインスタンスを検証して、すべてが意図したとおりに動作していることを確認します。
HA をお使いの場合は、最初にスタンドアロンインスタンスでの復元を済ませます。次に、HA を再構成します。
- 同期の問題 (ghe-repl-status での古い UUID など) が発生する場合は、ghe-repl-teardown を実行します。
- ヘルプが必要な場合は、 Support に連絡してください。
復元によって以前のトークンが無効にされるため、セルフホステッド Actions ランナーを再登録します。

スナップショットは、データ保持の設定に基づいて自動的に除去されます。

最新の n 個のスナップショットのみが保持されます (構成に応じて)。
バックアップが成功するたびに、古いスナップショットが削除されます。
スナップショットには、簡単に参照できるように、タイムスタンプ (YYYYMMDDTHHMMSS) を使って名前が付けられます。
変更されていないファイルについては、完全復元の機能を維持しながら効率的に格納するため、ハードリンクが使われます。

復元操作が失敗する場合は、次のことを調べます。

バックアップの完全性: スナップショットが中断されたり破損したりしていないことを確認します。
ストレージのアクセス: インスタンスでバックアップボリュームのマウントと読み取りが可能であることを確認します。
バージョンの不一致: スナップショットのバージョンとターゲットインスタンスの間に互換性があることを確認します。
ログ: /var/log/-backup/restore-verbose-[timestamp].log でエラーを確認します。

[Management Console] で一般的なエラーが示される場合は、インスタンスに SSH で接続して詳細なログにアクセスします。

この記事の内容