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

このドキュメントでは、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 つのクラスタノードを復元する

アンサンブルの一部である 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 つのクラスタノードを復元する

アンサンブルの一部である単一の Cassandra ノードに障害が発生した場合、同じホスト名/IP アドレスで新しいノードを作成できます。Cassandra を再インストールして、いくつかの追加手順を実行するだけで済みます。バックアップからデータを復元する必要はありません。障害が発生したノードのデータを復元するために、他のノードで利用可能なレプリカを使用できます。この手順は通常、ハードウェアの誤動作などが原因で Cassandra クラスタ内のノードがクラッシュした場合に適用されます。

で確認できます。

障害が発生したノードにアクセスできなくなった場合は、ノードを破棄してネットワークを分離し、誤って Cassandra クラスタに再参加することのないようにします。次に、元のノードと同じ IP アドレスで新しいノードを起動し、通常の Apigee ブートストラップの手順を実行します。

ノードにまだアクセスでき、再利用したい場合は、次の手順を行います。

1. ノード上の Cassandra プロセスを停止します。
   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
2. ノードから Cassandra ソフトウェアをアンインストールします。
   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
3. ノードからデータ ディレクトリをワイプします。
   rm -rf /opt/apigee/data/apigee-cassandra

上記の手順を完了すると、障害が発生したノードと同じ IP アドレスを持つノードが作成され、Apigee ソフトウェアをインストールする準備が整います。次の手順を行います。

1. データセンターのシードノードを特定する。
   1. 復元するノードと同じデータセンター内の稼働可能な Cassandra ノードで、次のコマンドを実行します。

      apigee-service apigee-cassandra configure -search conf_cassandra_seeds

   2. 次のような出力が表示されます。

      Found key conf_cassandra_seeds, with value, "127.0.0.1", in /opt/apigee/apigee-cassandra/token/default.properties
      Found key conf_cassandra_seeds, with value, 127.0.0.1, in /opt/apigee/apigee-cassandra/token/application/cassandra.properties
      Found key conf_cassandra_seeds, with value, "10.1.0.1,10.1.0.2", in /opt/apigee/token/application/cassandra.properties
      apigee-configutil: apigee-cassandra: # OK

   3. 出力の最後の行を参照してください。リストされているカンマ区切りの IP アドレスは、このデータセンターのノードで使用されるシードノードです。
2. 復元する新しいノードで、次のファイルを作成または編集します。
   

   vi /opt/apigee/customer/application/cassandra.properties
   

3. Add the following line:
   

   conf_jvm_options_custom_settings=-Dcassandra.replace_address=<ip-address-of-dead-node>

4. このノードがシードノードのいずれかである場合（ノードの IP アドレスがステップ 1 のシードノード リストに表示されている場合）は、ファイルに次の行を追加します。
   

   conf_cassandra_seeds="<comma-separated-seed-list-except-this-node’s-ip>"

   <ph type="x-smartling-placeholder">
   </ph>
   1. たとえば、上記のインスタンスでは、シードリストに 10.1.0.1 と 2 つの IP があります。10.1.0.2.復元するノードが 10.1.0.1 の場合は、次のような行を追加します。
      

      conf_cassandra_seeds="10.1.0.2"

5. ファイルを保存して、ファイルのオーナーが、Apigee ユーザーが読み取り可能にします。
   

   chown apigee:apigee /opt/apigee/customer/application/cassandra.properties

6. Cassandra ソフトウェアをインストールします。
   

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

7. Cassandra の設定を実行します。
   

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

8. この設定では、Cassandra サービスを内部的にブートストラップしようとします。他のノードからストリーミングするデータ量や、ネットワーク スループットなどによっては、時間がかかることがあります。
9. [詳細オプション] ノードで次の nodetool コマンドを実行することで、データのストリーミングを高速化できます。
   

   nodetool setstreamthroughput <value>
   nodetool setcompactionthroughput <value>

10. Cassandra ノードが復旧したら、次のような標準コマンドを使用して、ノードがリングに正常に参加していることを確認します。
    

    /opt/apigee/apigee-cassandra/bin/nodetool ring
    /opt/apigee/apigee-cassandra/bin/nodetool status

11. ノードが正常に稼働していることを確認したら、/opt/apigee/customer/application/cassandra.properties ファイルを再度編集し、この手順で手順 3 と 4 で追加した行を削除します。
12. ノードで Cassandra サービスを再起動します。
    

    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart

クラスタ全体を復元する

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

PostgreSQL データベース

スタンドアロンまたは マスター

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. Router を停止します。

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

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

   /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. すべてのコンポーネントを次の順序で起動します。なお、 重要です。 <ph type="x-smartling-placeholder">
   </ph>
   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 を起動する