Apigee 支持从版本 4.50.00 或 4.51.00 版直接更新到 4.52.00 版。本页介绍了如何执行升级。
谁可以执行更新
运行更新的用户应与最初安装 Edge 的用户相同,或者 以根用户身份运行
安装 Edge RPM 后,任何人都可以对其进行配置。
您必须更新哪些组件
您必须更新所有 Edge 组件。Edge 不支持包含组件的设置 从多个版本中提取。
更新前提条件
在升级 Apigee Edge 之前,请确保满足以下前提条件:
- 备份所有节点
在更新之前,建议您对所有节点执行完整的备份,以确保安全 。请按照适用于当前 Edge 版本的过程执行备份。这样,您就可以有备用计划,以防无法更新到新版本 功能。有关备份的详细信息,请参阅备份 和恢复。
- 确保 Edge 正在运行
使用以下命令确保 Edge 在更新过程中已启动并运行:/opt/apigee/apigee-service/bin/apigee-all status
- 确保 Cassandra 缩减策略为
LeveledCompactionStrategy
确保将 Cassandra 兼容性策略设置为LeveledCompactionStrategy
(如 将 Cassandra 压缩策略。
自动传播媒体资源设置
如果您已经通过修改以下位置中的 .properties
文件来设置任何属性:
/opt/apigee/customer/application
,则更新会保留这些值。
必须升级到 ZooKeeper 3.8.0
此适用于私有云的 Edge 版本包含对 ZooKeeper 3.8.0 的升级。作为 升级期间,所有 ZooKeeper 数据都将迁移到 ZooKeeper 3.8.0。
在升级 Zookeeper 之前,请仔细阅读 动物园 维护指南。大多数 Edge 生产系统都使用一个由 Zookeeper 节点组成的集群, 跨多个数据中心进行扩缩其中一些节点被配置为参与投票的选民 将其他节点配置为观察者。 请参阅 关于领导者、关注者、选民和观察者,了解更多详情。选民节点会选出 leader,之后选民节点本身就会成为关注者。
在更新过程中,可能会出现短暂延迟或写入 ZooKeeper 失败 当主要节点关停时这可能会影响 ZooKeeper,例如代理的部署操作和 Apigee 基础设施更改, (例如添加或移除消息处理器等)对运行时应该没有影响 API: (除非这些运行时 API 调用管理 API) 按照以下步骤操作
概括来讲,升级过程涉及对每个节点进行备份。随后 升级所有观察者和关注者,最后升级主要节点。
进行备份
备份 Zookeeper 的所有节点,以便在需要回滚时使用。请注意, 回滚会将 ZooKeeper 恢复到进行备份时的状态。注意: 任何部署或 自备份(其信息存储在 Zookeeper)在恢复期间将会丢失。
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper backup
如果您使用的是虚拟机并且有相应功能,则还可以创建虚拟机快照或备份 用于恢复或回滚(如有必要)。
确定领导者、关注者和观察者
注意:以下示例命令使用 nc 实用程序 将数据发送到 Zookeeper您可以使用 其他实用程序将数据发送到 Zookeeper
- 如果未安装在 ZooKeeper 节点上,请安装 nc:
sudo yum install nc
- 在节点上运行以下 nc 命令,其中 2181 是 ZooKeeper 端口:
echo stat | nc localhost 2181
您应该会看到如下所示的输出:
Zookeeper version: 3.8.0-5a02a05eddb59aee6ac762f7ea82e92a68eb9c0f, built on 2022-02-25 08:49 UTC Clients: /0:0:0:0:0:0:0:1:41246[0](queued=0,recved=1,sent=0) Latency min/avg/max: 0/0.2518/41 Received: 647228 Sent: 647339 Connections: 4 Outstanding: 0 Zxid: 0x400018b15 Mode: follower Node count: 100597
在节点输出的
Mode
行中,您应该会看到观察器、主要或 Follower(表示非领导者的选民),具体取决于节点配置。 注意:在具有单个 ZooKeeper 节点(Mode
)的独立 Edge 安装中, 已设为“独立” - 在每个 ZooKeeper 节点上重复执行第 1 步和第 2 步。
在观察者和关注者节点上升级 ZooKeeper
在每个观察者和关注者节点上升级 ZooKeeper,如下所示:
- 下载并运行适用于 Private Cloud 4.52 的 Edge 的引导加载程序,如 <ph type="x-smartling-placeholder"></ph> 在具有外部互联网连接的节点上更新到 4.52.00。这个过程很可能会 取决于节点是否具有外部互联网连接或 您正在进行离线安装。
- 升级 ZooKeeper 组件:
/opt/apigee/apigee-setup/bin/update.sh -c zk -f <silent-config-file>
注意:如果这些节点安装了其他组件(例如 Cassandra),您可以进行升级 现在也可以(如使用 cs、zk 配置文件),也可以稍后升级其他组件。Apigee 建议您先升级 ZooKeeper,并确保集群正常运行 然后再升级其他组件 - 对每个 ZooKeeper 观察器和关注者节点重复执行上述步骤。
关闭主要副本
升级所有观测器节点和关注者节点后,关停主要节点。在节点上 可被标识为主副本,请运行以下命令:
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
请注意,在本次活动期间,在选举出新的领导者之前,可能会有短暂延迟或 在 Zookeeper 中发生写入失败的情况这可能会影响向 ZooKeeper 写入数据的操作 例如代理的部署操作或 Apigee 基础设施更改,例如添加或 删除消息处理器等
验证是否已选出新的主要副本
按照确定领先变体 关注者和观察者部分,验证是否已从 关注者。请注意,领先变体可能是在 与当前领导者不同的数据中心。
升级主管
遵循与中相同的步骤操作 在观察者和关注者节点上升级 ZooKeeper。
旧主要节点也升级后,验证集群健康状况并 确保存在主要节点
回滚
如果需要回滚,请执行以下操作:
- 先对观察者和关注者执行回滚步骤。
- 下载并执行将要回滚到的版本(4.50 或 4.51)的引导加载程序。 此过程可能会有所不同,具体取决于节点是否具有外部互联网连接 或者您使用的是离线安装。
- 如果 Zookeeper 在节点上运行,请停止它:
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
- 卸载现有的 zookeeper:
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall
/opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>
恢复备份
请参阅使用备份进行恢复。 请注意,从早期版本的适用于私有云的 Edge(例如 4.50 和 4.51)获取的 ZooKeeper 备份应该为 与适用于 Private Cloud 4.52 的 Edge 中的 ZooKeeper 版本兼容。
必须升级到 Postgres 14
此版本的 Edge 包含对 Postgres 14 的升级。在此次升级过程中 Postgres 数据迁移到 Postgres 14。
大多数 Edge 生产系统使用两个针对主备用复制配置的 Postgres 节点。 在更新过程中,虽然 Postgres 节点停机更新,但分析数据仍会 写入 Qpid 节点在 Postgres 节点更新并恢复在线状态后,分析数据 然后推送到 Postgres 节点
执行 Postgres 更新的方式取决于您为 Postgres 节点:
- 如果您为 Postgres 节点使用本地数据存储,则必须
在升级期间安装新的 Postgres 备用节点。在
升级完成后,您可以停用新的 Postgres 备用节点。
如果必须回滚更新,则需要额外的 Postgres 备用节点 。如果必须回滚更新,则新的 Postgres 备用节点 成为 Postgres 主节点。因此,当您安装 新 Postgres 备用节点,它应该位于满足所有硬件配置要求的节点上 如 Edge 中所定义, 安装要求。
在 Edge 的单节点和双节点配置中,用于原型设计和测试的拓扑, 只有一个 Postgres 节点。你可以直接更新这些 Postgres 节点, 创建一个新的 Postgres 节点。
- 如果您为 Postgres 节点使用网络存储空间,因为
则不必安装新的 Postgres 节点。在
步骤,则可以跳过指定安装并稍后停用新的
Postgres 备用节点。
在开始更新过程之前,请截取 Postgres。之后,如果在更新期间发生任何错误,您被迫执行回滚, 您可以从该快照中恢复 Postgres 节点。
安装新的 Postgres 备用节点
此过程在新节点上创建一个 Postgres 备用服务器。请务必安装新的 适用于现有 Edge 版本(4.50.00 或 4.51.00)的 Postgres 备用服务器; 不适用于版本 4.52.00
如需执行安装,请使用您用于安装当前版本的同一配置文件
如需创建新的 Postgres 备用节点,请执行以下操作:
- 在当前 Postgres 主实例上,修改
/opt/apigee/customer/application/postgresql.properties
文件设置以下令牌。如果该文件不存在,请创建它:conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust
其中 existing_standby_ip 是当前 Postgres 的 IP 地址 备用服务器;new_standby_ip 是新备用节点的 IP 地址。
- 在 Postgres 主实例上重启
apigee-postgresql
:/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
- 通过查看
/opt/apigee/apigee-postgresql/conf/pg_hba.conf
文件。您应该会看到 该文件中包含以下几行内容:host replication apigee existing_standby_ip/32 trust host replication apigee new_standby_ip/32 trust
- 安装新的 Postgres 备用服务器:
<ph type="x-smartling-placeholder">
- </ph>
- 修改您用于安装当前版本 Edge 的配置文件,以指定
以下:
# IP address of the current master: PG_MASTER=192.168.56.103 # IP address of the new standby node PG_STANDBY=192.168.56.102
- 按照说明停用 SELinux 安装 Edge apigee-setup 实用程序。
如果您目前使用的是 Edge 4.51.00:
- 将 Edge bootstrap_4.51.00.sh 文件下载到
/tmp/bootstrap_4.51.00.sh
:curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
- 安装 Edge
apigee-service
实用程序和依赖项:sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord
如果您目前使用的是 Edge 4.50.00:
- 将 Edge bootstrap_4.50.00.sh 文件下载到
/tmp/bootstrap_4.50.00.sh
:curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
- 安装 Edge
apigee-service
实用程序和依赖项:sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord
- 将 Edge bootstrap_4.51.00.sh 文件下载到
- 使用
apigee-service
安装apigee-setup
实用程序:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- 安装 Postgres:
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
- 在新备用节点上,运行以下命令:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
验证它是否为备用实例。
- 修改您用于安装当前版本 Edge 的配置文件,以指定
以下:
执行 Postgres 就地升级
初步步骤
在执行到 Postgres 的就地升级之前,请在主实例和服务器
用于更新
apigee-postgresql
上的 max_locks_per_transaction
个房源:
- 如果不存在,请创建文件
/opt/apigee/customer/application/postgresql.properties
。 - 将此文件的所有权更改为
apigee
:sudo chown apigee:apigee /opt/apigee/customer/application/postgresql.properties
- 将以下属性添加到该文件:
conf/postgresql.conf+max_locks_per_transaction=30000
- 配置
apigee-postgresql
:apigee-service apigee-postgresql configure
- 重启
apigee-postgresql
:apigee-service apigee-postgresql restart
执行就地升级
如需执行到 Postgres 14 的就地升级,请执行以下步骤:
- 在主实例主机上升级 postgres
/opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
- 在主实例主机上运行设置命令:
apigee-service apigee-postgresql setup -f /opt/silent.conf
- 在主实例主机上运行 configure 命令:
apigee-service apigee-postgresql configure
- 重启主实例主机:
apigee-service apigee-postgresql restart
- 将其配置为主实例:
apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf
- 确保主实例主机已启动:
apigee-service apigee-postgresql wait_for_ready
- 停止待机:
apigee-service apigee-postgresql stop
- 升级备用实例。
注意:如果此步骤出现错误/失败,可以忽略。
update.sh
将尝试 以启动配置错误的备用服务器。提供了 Postgres 安装升级到 14,可以忽略该错误。/opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
- 确保备用实例已停止:
apigee-service apigee-postgresql stop
- 移除旧的备用配置:
rm -rf /opt/apigee/data/apigee-postgresql/
- 在备用服务器上设置复制:
apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf
- 从以下位置移除第
conf/postgresql.conf+max_locks_per_transaction=30000
行: 文件/opt/apigee/customer/application/postgresql.properties
主实例主机和备用实例。此行原为 在初步步骤中添加的 ID。
完成此过程后,备用实例将成功启动。
停用 Postgres 节点
更新完成后,停用新的备用节点:
- 确保 Postgres 正在运行:
/opt/apigee/apigee-service/bin/apigee-all status
如果 Postgres 未运行,请将其启动:
/opt/apigee/apigee-service/bin/apigee-all start
- 通过对新备用节点运行以下
curl
命令来获取新备用节点的 UUID 备用节点:curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self
您应该会在输出末尾看到该节点的 UUID,格式如下:
"type" : [ "postgres-server" ], "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
- 通过在新备用节点上运行以下命令来停止新的备用节点:
/opt/apigee/apigee-service/bin/apigee-all stop
- 在 Postgres 主节点上,修改
/opt/apigee/customer/application/postgresql.properties
从conf_pg_hba_replication.connection
中移除新的备用节点:conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust
- 在 Postgres 主实例上重启 apigee-postgresql:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
- 通过查看
/opt/apigee/apigee-postgresql/conf/pg_hba.conf
文件。您应该会看到 仅该文件中的以下行:host replication apigee existing_standby_ip/32 trust
- 执行以下 Edge 管理操作,从 ZooKeeper 中删除备用节点的 UUID
管理服务器节点上的 API 调用:
curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid
Postgres 升级后步骤
在对 Postgres 进行重大升级后,Postgres 的内部统计信息会被清除。这些统计信息有助于 Postgres 查询规划器利用最佳索引和路径来执行查询。
随着查询的执行和 autovacuum 守护程序的运行,Postgres 可以随着时间的推移逐步重建其统计信息。不过,在重新构建统计信息之前,您的查询速度可能会很慢。
如需解决此问题,请在 Postgres 主实例节点上对数据库中的所有表执行 ANALYZE
。或者,您也可以一次对几个表执行 ANALYZE
。
新的 Edge 界面
本部分列出了有关 Edge 界面的注意事项。如需了解详情,请参阅 适用于私有云的全新 Edge 界面。
安装 Edge 界面
完成初始安装后,Apigee 建议您安装 Edge 界面, 这是一个面向私有云的 Apigee Edge 的开发者和管理员的增强界面。
请注意,如要使用 Edge 界面,您需要停用基本身份验证,并使用 IDP,例如 SAML 或 LDAP。
如需了解详情,请参阅安装新的 Edge 界面。
更新 Edge 界面
如需更新 Edge 界面组件,请考虑您 升级前:
- 从 4.51.00 到 4.52.00(已安装新的 Edge 界面):使用
请参阅本节中的升级说明
edge-management-ui
组件。
使用 Apigee mTLS 进行更新
如需更新 Apigee mTLS,请执行以下操作 步骤:
回滚更新
如果更新失败,您可以尝试纠正问题,然后执行
update.sh
。您可以多次运行更新,它会继续进行更新
从上次停止的地方开始
如果失败要求您将更新回滚到先前版本,请参阅 如需查看详细说明,请回滚 4.52.00。
Logging 更新信息
默认情况下,update.sh
实用程序会将日志信息写入:
/opt/apigee/var/log/apigee-setup/update.log
如果运行 update.sh
实用程序的人员无权访问
该目录下,它会将日志以名为/tmp
update_username.log
。
如果此人无权访问 /tmp
,则使用 update.sh
实用程序
失败。
零停机更新
零停机更新或滚动更新,可让您在不停机更新的情况下 弃用了 Edge。
只有采用 5 节点及更大节点的配置才能实现零停机更新。
零停机升级的关键是从负载中移除每个路由器(一次一个) 进行负载均衡。然后,在与它相同的机器上更新路由器和任何其他组件, 然后将路由器添加回负载平衡器
- 按照说明,按照正确的安装顺序更新机器 机器更新的顺序。
- 当需要更新路由器时,请选择任意一个路由器并使其无法访问,因为 启用/停用服务器 (消息处理器/路由器)可达性。
- 更新所选路由器和与其位于同一机器上的所有其他 Edge 组件。 所有 Edge 配置都在同一节点上显示路由器和消息处理器。
- 使路由器再次可连接。
- 对其余的路由器重复步骤 2 到 4。
- 继续更新安装中的所有剩余机器。
更新前后请注意以下事项:
- 在合并了路由器和消息处理器的节点上:
<ph type="x-smartling-placeholder">
- </ph>
- 在更新之前,请执行以下操作:
<ph type="x-smartling-placeholder">
- </ph>
- 使路由器无法访问。
- 使消息处理器无法访问。
- 更新后,请执行以下操作:
<ph type="x-smartling-placeholder">
- </ph>
- 使消息处理器可访问。
- 使路由器可以访问。
- 在更新之前,请执行以下操作:
<ph type="x-smartling-placeholder">
- 在单个路由器节点上:
<ph type="x-smartling-placeholder">
- </ph>
- 在更新之前,请使路由器无法访问。
- 更新后,将路由器设置为可访问。
- 在单个消息处理器节点上:
<ph type="x-smartling-placeholder">
- </ph>
- 在更新之前,请使消息处理器无法访问。
- 更新后,使消息处理器可访问。
使用静默配置文件
您必须将静默配置文件传递给 update 命令。静默配置文件 应与用于安装 Edge 4.50.00 或 4.51.00 的版本相同。
更新为 4.52.00 在具有外部互联网连接的节点上
按照以下步骤更新节点上的 Edge 组件:
- 如果有
cron
作业配置为执行修复操作,请停用相应作业 直到更新完成为止。 - 以 root 身份登录您的节点以安装 Edge RPM。
- 安装
yum-utils
和yum-plugin-priorities
:sudo yum install yum-utils
sudo yum install yum-plugin-priorities
- 按照安装 Edge apigee-setup 实用程序,
- 如果您是在 Oracle 7.x 上安装,请执行以下命令:
sudo yum-config-manager --enable ol7_optional_latest
- 如果要在 AWS 上安装,请执行以下命令
yum-configure-manager
命令:yum update rh-amazon-rhui-client.noarch
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
如果您目前使用的是 Edge 4.51.00:
- 将 Edge
bootstrap_4.52.00.sh
文件下载到/tmp/bootstrap_4.52.00.sh
:curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
- 通过以下方式安装 Edge 4.52.00
apigee-service
实用程序和依赖项 执行以下命令:sudo bash /tmp/bootstrap_4.52.00.sh apigeeuser=uName apigeepassword=pWord
其中,uName:pWord 是您从 Apigee 收到的用户名和密码。如果您 省略 pWord,系统会提示您输入。
默认情况下,安装程序会检查您是否安装了 Java 1.8。否则, 安装程序会为您安装该工具。
使用
JAVA_FIX
选项指定如何处理 Java 安装。JAVA_FIX
采用以下值:I
:安装 OpenJDK 1.8(默认)。C
:不安装 Java 继续操作。Q
:退出。对于此选项,您必须自行安装 Java。
- 使用
apigee-service
更新apigee-setup
实用程序,因为 如下例所示:/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- 更新管理服务器上的
apigee-validate
实用程序,如下所示 显示:/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
- 更新管理服务器上的
apigee-provision
实用程序,如下所示 显示:/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
- 通过执行以下命令,在您的节点上运行
update
实用程序:/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
请按照设备 update。
其中:
- component 是要更新的 Edge 组件。可能的值包括:
<ph type="x-smartling-placeholder">
- </ph>
cs
:Cassandraedge
:除 Edge 界面之外的所有 Edge 组件:管理服务器、消息 处理器、路由器、QPID 服务器、Postgres 服务器ldap
:OpenLDAPps
:postgresqlqpid
:qpiddsso
:Apigee SSO(如果您安装了 SSO)ue
:新的 Edge 界面ui
:经典 Edge 界面zk
:Zookeeper
- configFile 就是 定义您的优势 组件。
您可以通过设置 component 针对所有组件运行
update.sh
设置为“all”,但前提是您使用的是 Edge 一体化 (AIO) 安装配置文件。例如:/opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
- component 是要更新的 Edge 组件。可能的值包括:
<ph type="x-smartling-placeholder">
- 如果您尚未在运行 Edge 界面组件的所有节点上重启该组件,请执行此操作:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- 通过在 Management API 上运行
apigee-validate
实用程序来测试更新 服务器,如测试安装中所述。
如果以后决定回滚更新,请按照 回滚 4.52.00。
从本地代码库更新为 4.52.00
如果您的 Edge 节点受防火墙保护,或以其他方式被禁止访问 Apigee 代码库,然后便可从本地代码库执行更新, 也就是 Apigee 代码库的镜像
创建本地 Edge 代码库后,您可以通过以下两种方式从 本地代码库:
- 创建代码库的 .tar 文件,将 .tar 文件复制到节点,然后从 .tar 文件。
- 在具有本地代码库的节点上安装网络服务器,以便其他节点可以访问该服务器。 Apigee 提供 Nginx Web 服务器供您使用,您也可以使用自己的 网络服务器
如需从本地 4.52.00 代码库更新,请执行以下操作:
- 按照“创建本地 Apigee 代码库”中的说明创建本地 4.52.00 代码库在 安装 Edge apigee-setup 实用程序。
- 如需从 .tar 文件安装 apigee-service,请执行以下操作:
<ph type="x-smartling-placeholder">
- </ph>
- 在具有本地代码库的节点上,使用以下命令打包本地代码库
导出到一个名为
/opt/apigee/data/apigee-mirror/apigee-4.52.00.tar.gz
的 .tar 文件中:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- 将 .tar 文件复制到您要在其中更新 Edge 的节点。例如,将其复制到
新节点上的
/tmp
目录。 - 在新节点上,将文件解压缩到
/tmp
目录:tar -xzf apigee-4.52.00.tar.gz
此命令会在目录中创建一个名为
repos
的新目录 包含 .tar 文件的文件。例如/tmp/repos
。 - 从以下位置安装 Edge
apigee-service
实用程序和依赖项:/tmp/repos
:sudo bash /tmp/repos/bootstrap_4.52.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
请注意,您在此命令中加入了代码库目录的路径。
- 在具有本地代码库的节点上,使用以下命令打包本地代码库
导出到一个名为
- 如需使用 Nginx Web 服务器安装 apigee-service,请执行以下操作:
<ph type="x-smartling-placeholder">
- </ph>
- 按照“使用 Nginx 从代码库安装”中的说明配置 Nginx Web 服务器 webserver"Install the Edge apigee-setup 实用程序,
- 在远程节点上,将 Edge
bootstrap_4.52.00.sh
文件下载到/tmp/bootstrap_4.52.00.sh
:/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh
其中,uName:pWord 是您先前为之设置的用户名和密码 remoteRepo 是代码库节点的 IP 地址或 DNS 名称。
- 在远程节点上,安装 Edge
apigee-setup
实用程序和依赖项:sudo bash /tmp/bootstrap_4.52.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
其中 uName:pWord 是代码库用户名和密码。
- 使用
apigee-service
更新apigee-setup
实用程序,因为 如下例所示:/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- 更新管理服务器上的
apigee-validate
实用程序,如下所示 显示:/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
- 更新管理服务器上的
apigee-provision
实用程序,如下所示 显示:/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
- 按照说明的顺序在您的节点上运行
update
实用程序。 机器更新顺序:/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
其中:
- component 是要更新的 Edge 组件。您通常需要更新
以下组件:
<ph type="x-smartling-placeholder">
- </ph>
cs
:Cassandraedge
:所有 Edge 组件(边缘界面除外):管理服务器、消息处理器、路由器 QPID 服务器、Postgres 服务器ldap
:OpenLDAPps
:postgresqlqpid
:qpiddsso
:Apigee SSO(如果您安装了 SSO)ue
新的 Edge 界面ui
:经典 Edge 界面zk
:Zookeeper
- configFile 就是 定义 Edge 组件 4.50.00 或 4.51.00。
您可以通过设置 component 针对所有组件运行
update.sh
设置为“all”,但前提是您使用的是 Edge 一体化 (AIO) 安装配置文件。例如:/opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
- component 是要更新的 Edge 组件。您通常需要更新
以下组件:
<ph type="x-smartling-placeholder">
- 在运行界面组件的所有节点上重启界面组件(如果您尚未这样做):
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
- 通过在 Management API 上运行
apigee-validate
实用程序来测试更新 服务器,如测试安装中所述。
如果以后决定回滚更新,请按照 回滚 4.52.00。
机器更新顺序
在 Edge 安装中,更新机器的顺序很重要:
- 在更新任何 Cassandra 和 ZooKeeper 节点之前,您必须更新 其他节点
- 对于具有多个边缘组件(管理服务器、消息处理器、
路由器、QPID 服务器,但不包括 Postgres 服务器),请使用
-c edge
选项进行更新 所有操作 - 如果某个步骤指定在多台机器上执行,请在 指定机器顺序
- 更新创收功能没有单独的步骤。当您指定
-c edge
选项。
单节点独立升级
如需将单节点独立配置升级到 4.52.00,请执行以下操作:
- 更新所有组件:
/opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
- (如果您安装了
apigee-adminapi
)更新了apigee-adminapi
实用程序:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
双节点独立升级
为双节点独立安装更新以下组件:
如需查看 Edge 拓扑和节点编号的列表,请参阅安装拓扑。
- 在机器 1 上更新 Cassandra 和 ZooKeeper:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- 在机器 2 上更新 Qpid 和 Postgres:
/opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
- 更新计算机 1 上的 LDAP:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- 更新机器 2 和 1 上的 Edge 组件:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- 更新机器 1 上的界面:
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- (如果您安装了
apigee-adminapi
)更新了机器 1 上的apigee-adminapi
实用程序:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (如果您安装了 Apigee SSO)在机器 1 上更新 Apigee SSO:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
其中 sso_config_file 是您在创建配置文件时创建的配置文件, 已安装 SSO。
- 在机器 1 上重启 Edge 界面组件:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
5 节点升级
为 5 节点安装更新以下组件:
如需查看 Edge 拓扑和节点编号的列表,请参阅安装拓扑。
- 在机器 1、2 和 3 上更新 Cassandra 和 ZooKeeper:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- 在机器 4 上更新 Qpid 和 Postgres:
/opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
- 在机器 5 上更新 Qpid 和 Postgres:
/opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
- 更新计算机 1 上的 LDAP:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- 更新机器 4、5、1、2、3 上的 Edge 组件:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- 更新 Edge 界面:
<ph type="x-smartling-placeholder">
- </ph>
- 传统版界面:如果您使用的是传统版界面,请更新
ui
组件,如以下示例所示:/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- 新版 Edge 界面:如果您安装了新的 Edge 界面,请更新
ue
组件(可能不是机器 1):/opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
- 传统版界面:如果您使用的是传统版界面,请更新
- (如果您安装了
apigee-adminapi
)更新了机器 1 上的apigee-adminapi
实用程序:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (如果您安装了 Apigee SSO)在机器 1 上更新 Apigee SSO:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
其中 sso_config_file 是您在创建配置文件时创建的配置文件, 已安装 SSO。
- 重启界面组件:
<ph type="x-smartling-placeholder">
- </ph>
- 传统版界面:如果您使用的是传统版界面,请重启
edge-ui
组件,如以下示例所示:/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- 新版 Edge 界面:如果您安装了新的 Edge 界面,请重启
相应机器上的
edge-management-ui
组件(可能不是 1):/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
- 传统版界面:如果您使用的是传统版界面,请重启
9 节点集群升级
为 9 节点集群安装更新以下组件:
如需查看 Edge 拓扑和节点编号的列表,请参阅安装拓扑。
- 在机器 1、2 和 3 上更新 Cassandra 和 ZooKeeper:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- 更新机器 6 和 7 上的 Qpid:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- 更新机器 8 上的 Postgres:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- 更新机器 9 上的 Postgres:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- 更新计算机 1 上的 LDAP:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- 按如下顺序更新机器 6、7、8、9、1、4 和 5 上的 Edge 组件:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- 在机器 1 上更新新界面 (
ue
) 或传统版界面 (ui
):/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- (如果安装了
apigee-adminapi
)更新机器 1 上的apigee-adminapi
实用程序:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (如果您安装了 Apigee SSO)在机器 1 上更新 Apigee SSO:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
其中 sso_config_file 是您在创建配置文件时创建的配置文件, 已安装 SSO。
- 重启界面组件:
<ph type="x-smartling-placeholder">
- </ph>
- 传统版界面:如果您使用的是传统版界面,请重启
edge-ui
组件,如以下示例所示:/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- 新版 Edge 界面:如果您安装了新的 Edge 界面,请重启
相应机器上的
edge-management-ui
组件(可能不是 1):/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
- 传统版界面:如果您使用的是传统版界面,请重启
13 节点集群升级
为 13 节点集群安装更新以下组件:
如需查看 Edge 拓扑和节点编号的列表,请参阅安装拓扑。
- 在机器 1、2 和 3 上更新 Cassandra 和 ZooKeeper:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- 在机器 12 和 13 上更新 Qpid:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- 更新机器 8 上的 Postgres:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- 更新机器 9 上的 Postgres:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- 更新计算机 4 和 5 上的 LDAP:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- 按如下顺序更新机器 12、13、8、9、6、7、10 和 11 上的 Edge 组件:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- 在机器 6 及以下版本上,更新新界面 (
ue
) 或传统版界面 (ui
) 7:/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- (如果您安装了
apigee-adminapi
)更新了机器 6 和 7 上的apigee-adminapi
实用程序:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (如果您安装了 Apigee SSO)在机器 6 和 7 上更新 Apigee SSO:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
其中 sso_config_file 是您在创建配置文件时创建的配置文件, 已安装 SSO。
- 重启界面组件:
<ph type="x-smartling-placeholder">
- </ph>
- 传统版界面:如果您使用的是传统版界面,请重启
edge-ui
组件,如以下示例所示:/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- 新版 Edge 界面:如果您安装了新的 Edge 界面,请重启
机器 6 和 7 上的
edge-management-ui
组件:/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
- 传统版界面:如果您使用的是传统版界面,请重启
12 节点集群升级
为 12 节点集群安装更新以下组件:
如需查看 Edge 拓扑和节点编号的列表,请参阅安装拓扑。
- 更新 Cassandra 和 ZooKeeper:
<ph type="x-smartling-placeholder">
- </ph>
- 在数据中心 1 的机器 1、2 和 3 上:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- 在数据中心 2 的机器 7、8 和 9 上
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- 在数据中心 1 的机器 1、2 和 3 上:
- 更新 Qpidd:
<ph type="x-smartling-placeholder">
- </ph>
- 数据中心 1 中的机器 4、5
<ph type="x-smartling-placeholder">
- </ph>
- 更新机器 4 上的
qpidd
:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- 更新机器 5 上的
qpidd
:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- 更新机器 4 上的
- 数据中心 2 中的机器 10、11
<ph type="x-smartling-placeholder">
- </ph>
- 在机器 10 上更新
qpidd
:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- 在机器 11 上更新
qpidd
:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- 在机器 10 上更新
- 数据中心 1 中的机器 4、5
<ph type="x-smartling-placeholder">
- 更新 Postgres:
<ph type="x-smartling-placeholder">
- </ph>
- 数据中心 1 中的机器 6
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- 数据中心 2 中的机器 12
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- 数据中心 1 中的机器 6
- 更新 LDAP:
<ph type="x-smartling-placeholder">
- </ph>
- 数据中心 1 中的机器 1
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- 数据中心 2 中的机器 7
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- 数据中心 1 中的机器 1
- 更新 Edge 组件:
<ph type="x-smartling-placeholder">
- </ph>
- 数据中心 1 中的机器 4、5、6、1、2、3
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- 数据中心 2 中的机器 10、11、12、7、8、9
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- 数据中心 1 中的机器 4、5、6、1、2、3
- 更新新界面 (
ue
) 或传统版界面 (ui
): <ph type="x-smartling-placeholder">- </ph>
- 数据中心 1 的机器 1:
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- 数据中心 2 中的机器 7:
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- 数据中心 1 的机器 1:
- (如果您安装了
apigee-adminapi
)更新了apigee-adminapi
实用程序:- 数据中心 1 的机器 1:
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- 数据中心 2 中的机器 7:
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- 数据中心 1 的机器 1:
- (如果您安装了 Apigee SSO)更新 Apigee SSO:
<ph type="x-smartling-placeholder">
- </ph>
- 数据中心 1 的机器 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
- 数据中心 2 中的机器 7:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
其中 sso_config_file 是您在创建配置文件时创建的配置文件, 已安装 SSO。
- 数据中心 1 的机器 1:
- 重启新版 Edge 界面 (
edge-management-ui
) 或传统版 Edge 界面 (edge-ui
) 组件(在机器 1 和 7 上):/opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart
对于非标准配置
如果您有非标准配置,请在以下文件中更新 Edge 组件 订单:
- ZooKeeper
- Cassandra
- qpidd、ps
- LDAP
- 边缘,表示“-c 边缘”依次为:配备 Qpid 服务器的节点、 Edge Postgres 服务器、管理服务器、消息处理器和路由器。
- Edge 界面(传统版或新版)
apigee-adminapi
- Apigee 单点登录
完成更新后,请务必在运行的所有机器上重启 Edge 界面组件 。
- 将 Edge