コンポーネントの再インストールと復元

このドキュメントでは、Edge コンポーネントの再インストールと復元について説明します。バックアップを復元する前に Edge コンポーネントを再インストールする必要がある場合は、この手順を使用します。

Apache ZooKeeper

スタンドアロン ノードを 1 つ復元する

1. ZooKeeper を停止します。

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

2. 古い ZooKeeper ディレクトリを削除します。

   /opt/apigee/data/apigee-zookeeper
   /opt/apigee/etc/apigee-zookeeper.d

3. ZooKeeper を再インストールします。

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper install

4. ZooKeeper を復元します。

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restore 2019.03.17,14.40.41

   コンポーネントを復元するときは、バックアップ ファイルのディレクトリ パスは指定しません。また、接頭辞「backup-」や接尾辞「.tar.gz」は指定しないことに注意してください。バックアップ ファイルの名前の日時部分のみを指定します。

   必要に応じて restore コマンドのバックアップ ファイルを省略すると、Edge はコンポーネントのバックアップ ディレクトリにある最新のバックアップ ファイルを使用します。

5. すべてのコンポーネントを再起動します。

   /opt/apigee/apigee-service/bin/apigee-all restart

1 つのクラスタノードを復元する

アンサンブルに含まれる単一の ZooKeeper ノードで障害が発生した場合、同じホスト名/IP アドレスで新しいノードを作成して、ZooKeeper を再インストールできます。新しい ZooKeeper ノードが ZooKeeper アンサンブルに参加すると、リーダーから最新のスナップショットを取得し、クライアントへのサービス提供を開始します。このインスタンスでデータを復元する必要はありません。

1. ZooKeeper を再インストールします。

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper install

2. 元のノードのインストール時に使用したのと同じ構成ファイルを使用して、ZooKeeper ノードでセットアップを実行します。

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper setup -f configFile

3. ZooKeeper を起動します。

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper start

クラスタ全体を復元する

1. クラスタ全体を停止します。
2. 単一ノードの場合と同様に、バックアップ ファイルからすべての ZooKeeper ノードを復元します。
3. ZooKeeper クラスタを起動します。
4. すべてのコンポーネントを再起動します。

Apache Cassandra

スタンドアロン ノードを 1 つ復元する

1. Cassandra を停止します。

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

2. 古い Cassandra ディレクトリを削除します。

   /opt/apigee/data/apigee-cassandra

3. Cassandra を再インストールします。

   /apigee/apigee-service/bin/apigee-service apigee-cassandra install

4. Cassandra を復元します。

   /apigee/apigee-service/bin/apigee-service apigee-cassandra restore 2019.03.17,14.40.41

   コンポーネントを復元するときは、バックアップ ファイルのディレクトリ パスは指定しません。また、接頭辞「backup-」や接尾辞「.tar.gz」は指定しないことに注意してください。バックアップ ファイルの名前の日時部分のみを指定します。

   必要に応じて restore コマンドのバックアップ ファイルを省略すると、Edge はコンポーネントのバックアップ ディレクトリにある最新のバックアップ ファイルを使用します。

5. すべてのコンポーネントを再起動します。
   

   /apigee/apigee-service/bin/apigee-all restart

1 つのクラスタノードを復元する

アンサンブルの一部である 1 つの Cassandra ノードで障害が発生した場合、同じホスト名/IP アドレスで新しいノードを作成できます。Cassandra を再インストールするだけで、データを復元する必要はありません。

1. Cassandra を再インストールします。

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra install

2. 元のノードのインストール時に使用したのと同じ構成ファイルを使用して、Cassandra ノードでセットアップを実行します。

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra setup -f configFile

3. Cassandra を起動します。

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start

4. Cassandra をインストールし、ノードが稼働したら（すべてのキースペースで RF>=2 であると仮定）、次の nodetool コマンドを実行してノードを初期化します。
   

   /opt/apigee/apigee-cassandra/bin/nodetool [-u username -pw password] -h localhost repair -pr

   ユーザー名とパスワードを渡す必要があるのは、Cassandra に対して JMX 認証を有効にした場合のみです。

クラスタ全体を復元する

1. クラスタ全体を停止します。
2. バックアップ ファイルからすべての Cassandra ノードを復元します。
3. Cassandra クラスタを起動します。
4. すべてのコンポーネントを再起動します。

PostgreSQL データベース

スタンドアロンまたはマスターとして実行される PosgreSQL

1. すべてのノードで Management Server、Qpid Server、Postgres Server を停止します。

   /apigee/apigee-service/bin/apigee-service edge-management-server stop
   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop

2. PostgreSQL データベースを再インストールします。

   /apigee/apigee-service/bin/apigee-service apigee-postgresql install 

3. PostgreSQL を起動します。

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start

4. バックアップ ファイルから PostgreSQL データベースを復元します。

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restore 2019.03.17,14.40.41

   PostgreSQL コンポーネントを復元する場合、バックアップ ファイルのディレクトリ パスは指定しません。また、「.dump」接尾辞も指定しません。バックアップ ファイルの名前の日時部分のみを指定します。

   必要に応じて restore コマンドのバックアップ ファイルを省略すると、Edge はコンポーネントのバックアップ ディレクトリにある最新のバックアップ ファイルを使用します。

5. すべてのノードで Management Server、Qpid Server、Postgres Server を起動します。

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server start
   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start

スタンバイとして実行される PosgreSQL

1. PostgreSQL データベースを再インストールします。

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql install

2. インストールに使用したのと同じ構成ファイルを使用して PostgreSQL データベースを再構成します。
   

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup -f configFile

3. PostgreSQL を起動します。

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start 

Postgres サーバー

1. すべてのマスターノードとスタンバイ ノードで Postgres Server を停止します。

   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop

2. 古い Postgres Server ディレクトリを削除します。

   /opt/apigee/data/edge-postgres-server /opt/apigee/etc/edge-postgres-server.d

3. Postgres Server を再インストールします。

   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server install

4. バックアップ ファイルから Postgres Server を復元します。

   /opt/apigee/apigee-service/bin/apigee-service edge-postgre-server restore 2019.03.17,14.40.41

   コンポーネントを復元するときは、バックアップ ファイルのディレクトリ パスは指定しません。また、接頭辞「backup-」や接尾辞「.tar.gz」は指定しないことに注意してください。バックアップ ファイルの名前の日時部分のみを指定します。

   必要に応じて restore コマンドのバックアップ ファイルを省略すると、Edge はコンポーネントのバックアップ ディレクトリにある最新のバックアップ ファイルを使用します。

5. すべてのマスターノードとスタンバイ ノードで Postgres Server を起動します。

   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start

Qpid Server と Qpidd

1. すべてのノードで Qpidd、Qpid Server、Postgres Server を停止します。
   

   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd stop

2. 古い Qpid Server ディレクトリと Qpidd ディレクトリを削除します。

   /opt/apigee/data/edge-qpid-server
   /opt/apigee/etc/edge-qpid-server.d
   /opt/apigee/data/apigee-qpidd
   /opt/apigee/etc/apigee-qpidd.d 

3. Qpidd を再インストールします。

   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd install 

4. Qpidd を復元します。

   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd restore 2019.03.17,14.40.41

   コンポーネントを復元するときは、バックアップ ファイルのディレクトリ パスは指定しません。また、接頭辞「backup-」や接尾辞「.tar.gz」は指定しないことに注意してください。バックアップ ファイルの名前の日時部分のみを指定します。

   必要に応じて restore コマンドのバックアップ ファイルを省略すると、Edge はコンポーネントのバックアップ ディレクトリにある最新のバックアップ ファイルを使用します。

5. Qpidd を起動します。

   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd start 

6. Qpid Server を再インストールします。

   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server install

7. Qpid Server を復元します。

   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restore 2019.03.17,14.40.41

   コンポーネントを復元するときは、バックアップ ファイルのディレクトリ パスは指定しません。また、接頭辞「backup-」や接尾辞「.tar.gz」は指定しないことに注意してください。バックアップ ファイルの名前の日時部分のみを指定します。

   必要に応じて restore コマンドのバックアップ ファイルを省略すると、Edge はコンポーネントのバックアップ ディレクトリにある最新のバックアップ ファイルを使用します。

8. すべてのノードで Qpid Server、Qpidd、Postgres Server を再起動します。

   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd restart
   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart

OpenLDAP

1. OpenLDAP を停止します。

   /opt/apigee/apigee-service/bin/apigee-service apigee-openldap stop

2. OpenLDAP を再インストールします。

   /opt/apigee/apigee-service/bin/apigee-service apigee-openldap install

3. 古い OpenLDAP ディレクトリを削除します。

   /opt/apigee/data/apigee-openldap /opt/apigee/etc/apigee-openldap.d

4. OpenLDAP の復元:

   /opt/apigee/apigee-service/bin/apigee-service apigee-openldap restore 2019.03.17,14.40.41

   コンポーネントを復元するときは、バックアップ ファイルのディレクトリ パスは指定しません。また、接頭辞「backup-」や接尾辞「.tar.gz」は指定しないことに注意してください。バックアップ ファイルの名前の日時部分のみを指定します。

   必要に応じて restore コマンドのバックアップ ファイルを省略すると、Edge はコンポーネントのバックアップ ディレクトリにある最新のバックアップ ファイルを使用します。

5. OpenLDAP を再起動します。

   /opt/apigee/apigee-service/bin/apigee-service apigee-openldap start

6. すべての Management Server を再起動します。

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

管理サーバー

1. Management Server を停止します。

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server stop

2. 既存の Management Server ディレクトリを削除します。

   /opt/apigee/data/edge-management-server /opt/apigee/etc/edge-management-server.d

3. Management Server を再インストールします。

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server install

4. バックアップ ファイルから Management Server を復元します。

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server restore 2019.03.17,14.40.41

   コンポーネントを復元するときは、バックアップ ファイルのディレクトリ パスは指定しません。また、接頭辞「backup-」や接尾辞「.tar.gz」は指定しないことに注意してください。バックアップ ファイルの名前の日時部分のみを指定します。

   必要に応じて restore コマンドのバックアップ ファイルを省略すると、Edge はコンポーネントのバックアップ ディレクトリにある最新のバックアップ ファイルを使用します。

5. Management Server を再起動します。

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server start

Message Processor

1. Message Processor を停止します。

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop

2. 古い Message Processor ディレクトリを削除します。

   /opt/apigee/data/edge-message-processor
   /opt/apigee/etc/edge-message-processor.d

3. Message Processor を再インストールします。

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor install

4. バックアップ ファイルから Message Processor を復元します。

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restore 2019.03.17,14.40.41

   コンポーネントを復元するときは、バックアップ ファイルのディレクトリ パスは指定しません。また、接頭辞「backup-」や接尾辞「.tar.gz」は指定しないことに注意してください。バックアップ ファイルの名前の日時部分のみを指定します。

   必要に応じて restore コマンドのバックアップ ファイルを省略すると、Edge はコンポーネントのバックアップ ディレクトリにある最新のバックアップ ファイルを使用します。

5. Message Processor を再起動します。

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor start

ルーター

1. ルーターを停止します。

   /opt/apigee/apigee-service/bin/apigee-service edge-router stop

2. 古いルーターのディレクトリを削除します。

   /opt/apigee/data/edge-router
   /opt/apigee/etc/edge-router.d

3. Router を再インストールします。
   

   /opt/apigee/apigee-service/bin/apigee-service edge-router install

4. バックアップ ファイルからルーターを復元します。

   /opt/apigee/apigee-service/bin/apigee-service edge-router restore 2019.03.17,14.40.41

   コンポーネントを復元するときは、バックアップ ファイルのディレクトリ パスは指定しません。また、接頭辞「backup-」や接尾辞「.tar.gz」は指定しないことに注意してください。バックアップ ファイルの名前の日時部分のみを指定します。

   必要に応じて restore コマンドのバックアップ ファイルを省略すると、Edge はコンポーネントのバックアップ ディレクトリにある最新のバックアップ ファイルを使用します。

5. Router を再起動します。
   

   /opt/apigee/apigee-service/bin/apigee-service edge-router start

Edge UI

1. UI を停止します。

   /opt/apigee/apigee-service/bin/apigee-service edge-ui stop

2. 古い UI ディレクトリを削除します。

   /opt/apigee/data/edge-ui
   /opt/apigee/etc/edge-ui.d

3. UI を再インストールします。
   

   /opt/apigee/apigee-service/bin/apigee-service edge-ui install

4. バックアップ ファイルから UI を復元します。

   /opt/apigee/apigee-service/bin/apigee-service edge-ui restore 2019.03.17,14.40.41

   コンポーネントを復元するときは、バックアップ ファイルのディレクトリ パスは指定しません。また、接頭辞「backup-」や接尾辞「.tar.gz」は指定しないことに注意してください。バックアップ ファイルの名前の日時部分のみを指定します。

   必要に応じて restore コマンドのバックアップ ファイルを省略すると、Edge はコンポーネントのバックアップ ディレクトリにある最新のバックアップ ファイルを使用します。

5. UI を再起動します。
   

   /opt/apigee/apigee-service/bin/apigee-service edge-ui start

サイトの復元を完了する

1. すべてのコンポーネント ノードを停止します。サブシステムを停止する順序は重要です。まずすべての Edge ノードを停止してから、すべてのデータストア ノードを停止してください。
2. 前述のように、すべてのコンポーネントを復元します。
3. 次の順序ですべてのコンポーネントを起動します。サブシステムの起動順序は重要です。
   1. ZooKeeper クラスタを起動する
   2. Cassandra クラスタを起動する
   3. OpenLDAP が稼働していることを確認する
   4. qpid を起動する
   5. PostgreSQL データベースが稼働していることを確認する
   6. Management Server を起動する
   7. Router と Message Processor を起動する
   8. Qpid Server を起動する
   9. Postgres Server を起動する
   10. Apigee UI を起動する