重新安装和恢复组件

本文档介绍了如何重新安装和恢复 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 节点发生故障，您可以使用 使用相同的主机名/IP 地址并重新安装 ZooKeeper。当新的 ZooKeeper 节点加入 ZooKeeper 集成学习将获取领导者的最新快照，并开始为客户服务。 您无需恢复此实例中的数据。

1. 重新安装 ZooKeeper：

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

2. 使用安装 原始节点：

   /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 节点发生故障，您可以使用同一主机名/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. 例如，在上面的实例中，种子列表有 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 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 数据库时所用的同一配置文件重新配置 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 服务器：

   /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 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. 重启所有管理服务器：

   /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. 移除旧的 Message Processor 目录：

   /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. 停止界面：

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

2. 移除旧的界面目录：

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

3. 重新安装界面：
   

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

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

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

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

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

5. 重启界面：
   

   /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. 启动管理服务器
   7. 启动路由器和消息处理器
   8. 启动 Qpid 服务器
   9. 启动 Postgres 服务器
   10. 启动 Apigee 界面