重新安装和恢复组件

本文档介绍了如何重新安装和恢复 Edge 组件。如果您必须先重新安装 Edge 组件，然后才能恢复备份，请使用此过程 。

Apache ZooKeeper

恢复一个独立节点

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

恢复一个集群节点

如果 ZooKeeper 集群中的单个 ZooKeeper 节点发生故障，您可以创建具有 相同主机名/IP 地址的新节点并重新安装 ZooKeeper。当新的 ZooKeeper 节点加入 ZooKeeper 集群时，它将从 Leader 获取最新的快照并开始为客户端提供服务。 在此实例中，您无需恢复数据。

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. 停止 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

恢复一个集群节点

如果 Cassandra 集群中的单个 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>"

   1. 例如，在上面的实例中，种子名单包含 2 个 IP 地址 - 10.1.0.1 和 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 数据库

PosgreSQL 以独立模式或 主模式运行

1. 停止所有节点上的管理服务器、Qpid 服务器和 Postgres 服务器：

   /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. 启动所有节点上的管理服务器、Qpid 服务器和 Postgres 服务器：

   /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 数据库的相同配置文件重新配置 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 服务器：

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

2. 移除旧的 Postgres 服务器目录：

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

3. 重新安装 Postgres 服务器：

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

4. 从备份文件恢复 Postgres 服务器：

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

   请注意，恢复组件时，您无需指定备份 文件，也无需指定“backup-”前缀或“.tar.gz”后缀。您只需指定备份文件名称的 日期/时间部分。

   您可以选择在 restore 命令中省略备份文件，Edge 将 使用组件备份目录中最新的备份文件。

5. 启动所有主节点和备用节点上的 Postgres 服务器：

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

Qpid 服务器和 Qpidd

1. 停止所有节点上的 Qpidd、Qpid 服务器和 Postgres 服务器：
   

   /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 服务器和 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 服务器：

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

7. 恢复 Qpid 服务器：

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

   请注意，恢复组件时，您无需指定备份 文件，也无需指定“backup-”前缀或“.tar.gz”后缀。您只需指定备份文件名称的 日期/时间部分。

   您可以选择在 restore 命令中省略备份文件，Edge 将 使用组件备份目录中最新的备份文件。

8. 重启所有节点上的 Qpid 服务器、Qpidd 和 Postgres 服务器：

   /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

SymasLDAP

1. 停止 SymasLDAP：

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

2. 重新安装 SymasLDAP：

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

3. 移除旧的 SymasLDAP 目录：

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

4. 恢复 SymasLDAP：

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

   请注意，恢复组件时，您无需指定备份 文件，也无需指定“backup-”前缀或“.tar.gz”后缀。您只需指定备份文件名称的 日期/时间部分。

   您可以选择在 restore 命令中省略备份文件，Edge 将 使用组件备份目录中最新的备份文件。

5. 重启 SymasLDAP：

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

6. 重启所有管理服务器：

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

管理服务器

1. 停止管理服务器：

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

2. 移除旧的管理服务器目录：

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

3. 重新安装管理服务器：

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

4. 从备份文件恢复管理服务器：

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

   请注意，恢复组件时，您无需指定备份 文件，也无需指定“backup-”前缀或“.tar.gz”后缀。您只需指定备份文件名称的 日期/时间部分。

   您可以选择在 restore 命令中省略备份文件，Edge 将 使用组件备份目录中最新的备份文件。

5. 重启管理服务器：

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

消息处理器

1. 停止消息处理器：

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

2. 移除旧的消息处理器目录：

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

3. 重新安装消息处理器：

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

4. 从备份文件恢复消息处理器：

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

   请注意，恢复组件时，您无需指定备份 文件，也无需指定“backup-”前缀或“.tar.gz”后缀。您只需指定备份文件名称的 日期/时间部分。

   您可以选择在 restore 命令中省略备份文件，Edge 将 使用组件备份目录中最新的备份文件。

5. 重启消息处理器：

   /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. 重新安装路由器：
   

   /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. 重启路由器：
   

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

新 Edge 界面

1. 停止新 Edge 界面：

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

2. 移除旧的新 Edge 界面目录：

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

3. 重新安装新 Edge 界面：

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

4. 从备份文件恢复新 Edge 界面：

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

   请注意，恢复组件时，您无需指定备份 文件，也无需指定“backup-”前缀或“.tar.gz”后缀。您只需指定备份文件名称的 日期/时间部分。

   您可以选择在 restore 命令中省略备份文件，Edge 将 使用组件备份目录中最新的备份文件。

5. 重启新 Edge 界面：

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

完整网站恢复

1. 停止所有组件节点。请注意，停止子系统的顺序很重要：先 停止所有 Edge 节点，然后停止所有数据存储节点。
2. 如上所述恢复所有组件。
3. 现在，按以下顺序启动所有组件。请注意，启动 子系统的顺序很重要：
   1. 启动 ZooKeeper 集群
   2. 启动 Cassandra 集群
   3. 确保 SymasLDAP 处于运行状态
   4. 启动 qpid
   5. 确保 PostgreSQL 数据库处于运行状态
   6. 启动管理服务器
   7. 启动路由器和消息处理器
   8. 启动 Qpid 服务器
   9. 启动 Postgres 服务器
   10. 启动新 Edge 界面