适用于私有云的 Edge v4.18.01
哪些 Edge 版本可以更新到 4.18.01
您可以使用此过程更新 Apigee Edge 4.17.0x 版。
<ph type="x-smartling-placeholder">如果您使用的 Edge 版本低于 4.16.01,则必须先迁移到 然后更新到版本 4.18.01。
谁可以执行更新
运行更新的用户应与最初安装 Edge 的用户相同,或者 以 root 身份运行的用户。
安装 Edge RPM 后,任何用户都可以对其进行配置。
您必须更新哪些组件
您必须更新所有 Edge 组件。Edge 不支持包含组件的设置 从多个版本中提取。
保持兼容性
将适用于私有云的 Apigee Edge 升级到 4.18.01 时,您必须确保生成的 实现仅引用其配置文件中支持的属性。
<ph type="x-smartling-placeholder">属性 | 位置 | 说明 |
---|---|---|
conf_load_balancing_load.balancing. |
router.properties |
从 router.properties 文件中移除此属性。设置重试选项
在 4.18.01 版本中,请使用虚拟
主机配置属性。 |
自动传播属性 设置
如果您通过修改 /opt/apigee/customer/application 中的 .properties 文件设置了任何属性,则这些 值。
必须添加 SMTPMAILFROM 配置参数
Edge 4.17.05 向启用 SMTP 服务器如果您从 4.17.01 开始更新,则必须在配置文件中设置 SMTPMAILFROM 。
API BaaS 4.17.09 版还添加了对 SMTPMAILFROM 属性的支持。 从 4.17.01 或 4.17.05 更新 API BaaS 时,您必须在 配置文件
此参数的格式如下:
SMTPMAILFROM="My Company <myco@company.com>"
必须升级到 Postgres 9.6
此版本的 Edge 包含对 Postgres 9.6 的升级。在此次升级过程中 Postgres 数据会迁移到 Postgres 9.6。
大多数 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.17.0x) 版本的 Postgres 备用服务器,而不是 4.18.01 版。
如需执行安装,请使用您用于安装当前版本的同一配置文件
如需创建新的 Postgres 备用节点,请执行以下操作:
- 在当前 Postgres 主实例上,修改
/opt/apigee/customer/application/postgresql.properties
文件来设置以下内容: 令牌:conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust\ \nhost replication apigee new_slave_ip/32 trust
其中 existing_slave_ip 是当前 Postgres 的 IP 地址 备用服务器;new_slave_ip 是新备用节点的 IP 地址。
如果
postgresql.properties
文件不存在,请创建并使用chown
,以向apigee
用户授予对它的访问权限,如以下示例所示 显示:chown apigee:apigee /opt/apigee/customer/application/postgresql.properties
- 重启 apigee-postgresql
执行以下命令:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
- 通过查看
/opt/apigee/apigee-postgresql/conf/pg_hba.conf
,验证是否已添加新的备用节点 主文件上的文件您应在该文件中看到以下几行内容:host replication apigee existing_slave_ip/32 trust host replication apigee new_slave_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
- 按照在 Edge apigee-setup 实用程序。
- 下载 Edge bootstrap_4.17.0x.sh 文件
(其中 4.17.0x 为 4.17.01、4.17.05,
或 4.17.09)更改为
/tmp/bootstrap_4.17.0x.sh
:curl https://software.apigee.com/bootstrap_4.17.0x.sh -o /tmp/bootstrap_4.17.0x.sh
- 安装 Edge
apigee-service
实用程序并 依赖项:sudo bash /tmp/bootstrap_4.17.0x.sh apigeeuser=uName apigeepassword=pWord
- 使用
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 正在运行:
> /opt/apigee/apigee-service/bin/apigee-all 状态
如果 Postgres 未运行,请将其启动:
> /opt/apigee/apigee-service/bin/apigee-all start - 通过对新备用节点运行以下 c网址 命令来获取新备用节点的 UUID
备用节点:
>curl -u sysAdminEmail:password http://<node_IP>:8084/v1/servers/self
您应该会在输出末尾看到该节点的 UUID,格式如下:
“类型”: [ "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 复制 apigee existing_slave_ip/32 信任 - 在 Postgres 主实例上重启 apigee-postgresql:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart - 查看 /opt/apigee/apigee-postgresql/conf/pg_hba.conf,验证新的备用节点已被移除
主文件上的文件您在该文件中应该只会显示以下行:
主机复制 Apigee existing_slave_ip/32 信任 - 执行以下 Edge 管理操作,从 ZooKeeper 中删除备用节点的 UUID
管理服务器节点上的 API 调用:
>curl -u sysAdminEmail:password -X 删除 http://<ms_IP>:8080/v1/servers/<new_slave_uuid>
更新前提条件
在升级 Apigee Edge 之前,请先满足以下前提条件:
- 备份所有节点
在更新之前,建议您对所有节点执行完整的备份以确保安全 。请按照适用于当前 Edge 版本的过程执行备份。
这样,您就可以有备用方案,以防无法更新到新版本 功能。有关备份的详细信息,请参阅备份 和恢复。 - 确保 Edge 正在运行
使用以下命令确保 Edge 在更新过程中已启动并运行:
> /opt/apigee/apigee-service/bin/apigee-all 状态
处理失败的更新
如果更新失败,您可以尝试纠正问题,然后运行 update.sh 。您可以多次运行更新,系统会从上次更新的位置继续更新 关闭。
如果失败操作要求您将更新回滚到先前版本,请参阅 4.18.01 回滚流程了解详情。
Logging 更新信息
默认情况下,update.sh 实用程序将日志信息写入到:
/opt/apigee/var/log/apigee-setup/update.log
如果运行 update.sh 实用程序的用户无权访问 该目录下,它会将日志以名为 update_username.log 的文件写入 /tmp 目录。
如果用户无权访问 /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.17.0x 的相同。
操作步骤 在具有外部互联网连接的节点上更新到 4.18.01
按照以下步骤更新节点上的 Edge 组件:
- 如果您当前将 Postgres 主备用复制与本地存储结合使用,
按照安装新的 Postgres
备用节点。
如果您使用的是网络存储空间,则无需安装新节点。相反, Postgres 使用的数据存储区的网络快照。如需了解详情,请参阅必须升级到 Postgres 9.6。 - 停用任何配置为在 Cassandra 上执行修复操作的 CRON 作业(如果存在) 直到更新完成为止。
- 以 root 身份登录您的节点以安装 Edge RPM。
注意:虽然 RPM 安装需要 root 访问权限,但您可以执行 Edge, 配置。 - 安装 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 更新 rh-amazon-rhui-client.noarch
>sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional - 将 Edge 4.18.01 bootstrap_4.18.01.sh 文件下载到 /tmp/bootstrap_4.18.01.sh:
>curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh - 安装 Edge 4.18.01 apigee-service 实用程序,并且
依赖项:
>sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uNameuName apigeepassword=pWord
其中,uName:pWord 是您通过 Google 发送的用户名和密码 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 更新 - 更新 apigee-validate
实用程序:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate 更新 - 更新 apigee-provision
实用程序:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision 更新 - 按照下文中“Compute Engine 的机器顺序
更新”下方:
> /opt/apigee/apigee-setup/bin/update.sh -c 组件 -f configFile
对配置文件的唯一要求是配置文件必须可供访问 可由“apigee”读取用户。
使用“-c”选项指定要更新的组件。可能的 组件包括:
ldap = OpenLDAP
cs = Cassandra
zk = ZooKeeper
qpid = qpidd
ps = postgresql
edge =所有 Edge 组件 以下边缘界面除外:管理服务器、消息处理器、路由器、QPID 服务器、Postgres 服务器
ui = 边缘界面
all = 更新 机器(仅用于 Edge aio 安装配置文件或 API BaaS asa 安装) 个人资料)
e = ElasticSearch
b = API BaaS 堆栈
p = API BaaS 门户
ebp = ElasticSearch、API BaaS 堆栈和 API BaaS 门户位于同一节点上 - 通过在 Management 上运行 apigee-validate 实用程序来测试更新 服务器,如测试安装中所述。
- 如果您安装了新的 Postgres 备用节点,请按上述方法停用该节点
请参阅停用
Postgres 节点。
如果您使用的是网络存储空间,则无需安装新节点。如需了解详情,请参阅必须升级到 Postgres 9.6。
如需在稍后回滚更新,请按照 4.18.01 回滚流程中所述的步骤进行操作。
从本地服务器更新到 4.18.01 的过程 代码库
如果您的 Edge 节点受防火墙保护,或以其他方式被禁止访问 Apigee 代码库,然后便可从本地代码库执行更新, 也就是 Apigee 代码库的镜像
创建本地 Edge 代码库后,您可以通过以下两种方式从 本地代码库:
- 创建代码库的 .tar 文件,将 .tar 文件复制到节点,然后从 .tar 文件。
- 在具有本地代码库的节点上安装网络服务器,以便其他节点可以访问该服务器。 Apigee 提供 Nginx Web 服务器供您使用,您也可以使用自己的 网络服务器
如需从本地 4.18.01 代码库更新,请执行以下操作:
- 如果您当前正在使用 Postgres 主备用复制,请安装新的 Postgres
如上文安装新的 Postgres
备用节点。
如果您使用的是网络存储空间,则无需安装新节点。相反, Postgres 使用的数据存储区的网络快照。如需了解详情,请参阅必须升级到 Postgres 9.6。 - 按照“创建本地 Apigee 代码库”中的说明创建本地 4.18.01 代码库安装 Edge apigee-setup 实用程序。
注意:如果您已有 4.17.0x 代码库,则可以 4.18.01 代码库,如“更新本地 Apigee 代码库”中所述安装 Edge apigee-setup 实用程序。 -
如需从 .tar 文件安装 apigee-service,请执行以下操作:
<ph type="x-smartling-placeholder">
- </ph>
- 在具有本地代码库的节点上,使用以下命令打包本地代码库
转换为名为 /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz 的单个.tar 文件:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror 软件包 - 将 .tar 文件复制到您要在其中更新 Edge 的节点。例如,将其复制到 /tmp 目录下的 新节点。
- 在新节点上,将文件解压缩到 /tmp 目录:
>tar -xzf apigee-4.18.01.tar.gz
此命令会在包含 .tar 文件的目录中创建一个名为 repos 的新目录 文件。例如 /tmp/repos。 - 安装 /tmp/repos 中的 Edge apigee-service 实用程序和依赖项:
>sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
请注意,您在此命令中加入了代码库目录的路径。
- 在具有本地代码库的节点上,使用以下命令打包本地代码库
转换为名为 /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz 的单个.tar 文件:
-
如需使用 Nginx Web 服务器安装 apigee-service,请执行以下操作:
<ph type="x-smartling-placeholder">
- </ph>
- 按照“使用 Nginx 从代码库安装”中的说明配置 Nginx Web 服务器 webserver"Install the Edge apigee-setup 实用程序,
- 在远程节点上,下载 Edge bootstrap_4.18.01.sh 文件,
/tmp/bootstrap_4.18.01.sh:
>/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
其中,uName:pWord 是您在上述步骤中设置的用户名和密码 remoteRepo 是代码库的 IP 地址或 DNS 名称 代码库节点。 - 在远程节点上,安装 Edge apigee-service 实用程序和依赖项:
>sudo bash /tmp/bootstrap_4.18.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
其中 uName:pWord 是 Repo 用户名和密码。
- 使用 apigee-service 执行以下操作:
更新 apigee-setup 实用程序:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup 更新 - 更新 apigee-validate
管理服务器上的实用程序
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate 更新 - 更新 apigee-provision
实用程序:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision 更新 - 按照下文“机器的顺序”部分所述的顺序在您的节点上运行更新实用程序,
更新”下方:
> /opt/apigee/apigee-setup/bin/update.sh -c 组件 -f configFile
对配置文件的唯一要求是配置文件必须可供访问 可由“apigee”读取用户。
使用“-c”选项指定要更新的组件。可能的 组件包括:
ldap = OpenLDAP
cs = Cassandra
zk = ZooKeeper
qpid = qpidd
ps = postgresql
edge =所有 Edge 组件 以下边缘界面除外:管理服务器、消息处理器、路由器、QPID 服务器、Postgres 服务器
ui = 边缘界面
all = 更新 机器(仅用于 Edge aio 安装配置文件或 API BaaS asa 安装) 个人资料)
e = ElasticSearch
b = API BaaS 堆栈
p = API BaaS 门户
ebp = ElasticSearch、API BaaS 堆栈和 API BaaS 门户位于同一节点上 - 通过在 Management 上运行 apigee-validate 实用程序来测试更新 服务器,如测试安装中所述。
- 如果您安装了新的 Postgres 备用节点,请按照说明停用该节点
请参阅上述停用
Postgres 节点。
如果您使用的是网络存储空间,则无需安装新节点。如需了解详情,请参阅必须升级到 Postgres 9.6。
如需在稍后回滚更新,请按照 4.18.01 回滚流程中所述的步骤进行操作。
机器更新顺序
在 Edge 安装中更新机器的顺序很重要。最 更新时需要考虑的重要事项包括:
- 在更新任何 Cassandra 和 ZooKeeper 节点之前,您必须更新 其他节点
- 对于具有多个边缘组件(管理服务器、消息处理器、 路由器、QPID 服务器,但不包括 Postgres 服务器),请使用“-c 边缘”更新所有选项 。
- 如果某个步骤指定在多台机器上执行,请在 指定机器顺序
- 更新创收功能没有单独的步骤。当您指定“-c” 边缘"选项。
对于单主机独立式服务器 安装
- 如果您是从 4.17.01 开始更新,在以下情况下,请在配置文件中设置 SMTPMAILFROM:
您已在 Edge 上启用 SMTP。此参数的格式为:
SMTPMAILFROM="我的公司 <myco@company.com>” - 更新 Cassandra 和 ZooKeeper:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - 更新 Qpid:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - 更新 LDAP:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - 停止 Postgres Server、Qpid 服务器和 PostgreSQL:
> /opt/apigee/apigee-service/bin/apigee-serviceEdge-postgres-server stop
>/opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - 更新 postgresql:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - 更新 Postgres 数据库:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - 更新其余 Edge 组件:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - 更新 Edge 界面:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
对于双主机独立式设备 安装
如需查看 Edge 的列表,请参阅安装拓扑 拓扑和节点编号。
- 如果您是从 4.17.01 开始更新,在以下情况下,请在配置文件中设置 SMTPMAILFROM:
您已在 Edge 上启用 SMTP。此参数的格式为:
SMTPMAILFROM="我的公司 <myco@company.com>” - 在机器 1 上更新 Cassandra 和 ZooKeeper:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - 更新机器 2 上的 Qpid:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - 更新机器 1 上的 LDAP:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - 更新机器 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 - 更新机器 2 上的 postgresql:
<ph type="x-smartling-placeholder">
- </ph>
- 停止 Postgres Server、Qpid 服务器和 postgresql:
> /opt/apigee/apigee-service/bin/apigee-serviceEdge-postgres-server stop
>/opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - 更新 postgresql:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f 配置文件 - 更新 Postgres 数据库:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - 更新机器 2 上的 Edge 组件:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- 停止 Postgres Server、Qpid 服务器和 postgresql:
对于包含 5 个主机的集群 安装
如需查看 Edge 的列表,请参阅安装拓扑 拓扑和节点编号。
- 如果您是从 4.17.01 开始更新,在以下情况下,请在配置文件中设置 SMTPMAILFROM:
您已在 Edge 上启用 SMTP。此参数的格式为:
SMTPMAILFROM="我的公司 <myco@company.com>” - 确保您已按照上述说明安装了新的 Postgres 备用节点
安装
一个新的 Postgres 备用节点。
如果您使用的是网络存储空间,则无需安装新节点。相反, Postgres 使用的数据存储区的网络快照。如需了解详情,请参阅必须升级到 Postgres 9.6。 - 在机器 1、2 和 3 上更新 Cassandra 和 ZooKeeper:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - 更新机器 4 和 5 上的 Qpid:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - 更新机器 1 上的 LDAP:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - 更新机器 1、2、3 上的 Edge 组件:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - 更新机器 1 上的界面:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile -
??更新
机器 4 和 5:
<ph type="x-smartling-placeholder">
- </ph>
- 停止机器 4 上的 Postgres 服务器和 Qpid 服务器:
> /opt/apigee/apigee-service/bin/apigee-serviceEdge-postgres-server stop
>/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop - 在机器 5 上停止 Postgres 服务器、Qpid 服务器和 postgresql:
> /opt/apigee/apigee-service/bin/apigee-serviceEdge-postgres-server stop
>/opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - 如果已安装,请在新备用实例上停止 Postgres 服务器和 postgresql
您为回滚添加的节点:
> /opt/apigee/apigee-service/bin/apigee-serviceEdge-postgres-server stop
>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - 更新机器 4:
上的 postgresql > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - 更新机器 4 上的 Postgres 数据库(仅限 Postgres 主实例):
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - 更新机器 5 上的 postgresql:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - 在机器 4 和 5 上启动 Postgres 服务器和 Qpid 服务器:
> /opt/apigee/apigee-service/bin/apigee-serviceedge-postgres-server 启动
>/opt/apigee/apigee-service/bin/apigee-serviceedge-qpid-server 启动 - 通过在机器上运行以下命令,将 Postgres 配置为备用节点
5:
>cd /opt/apigee/data/apigee-postgresql/pgdata
>rm -rf *
>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile - 通过在两台服务器上发出以下脚本来验证复制状态。通过
系统应该在两台服务器上显示相同的结果,
复制:
在机器 4(即主节点)上,运行以下命令:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
验证其是否表明自己是主实例。
在机器 5 上,备用节点:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
验证它是否表明它是备用实例。
- 停止机器 4 上的 Postgres 服务器和 Qpid 服务器:
- 更新机器 4、5 上的 Edge 组件:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - 确保按照上述步骤停用新的备用节点
在退役中
Postgres 节点。
如果您使用的是网络存储空间,则无需安装新节点。如需了解详情,请参阅必须升级到 Postgres 9.6。
对于包含 9 个主机的集群 安装
如需查看 Edge 的列表,请参阅安装拓扑 拓扑和节点编号。
- 如果您是从 4.17.01 开始更新,在以下情况下,请在配置文件中设置 SMTPMAILFROM:
您已在 Edge 上启用 SMTP。此参数的格式为:
SMTPMAILFROM="我的公司 <myco@company.com>” - 确保您已按照上述说明安装了新的 Postgres 备用节点
安装
一个新的 Postgres 备用节点。
如果您使用的是网络存储空间,则无需安装新节点。相反, Postgres 使用的数据存储区的网络快照。如需了解详情,请参阅必须升级到 Postgres 9.6。 - 在机器 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 - 更新机器 1 上的 LDAP:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - 按如下顺序更新机器 6、7、1、4 和 5 上的 Edge 组件:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - 更新机器 1 上的界面:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile? - 更新机器 8 和 9:
<ph type="x-smartling-placeholder">
- </ph>
- 在机器 8 上停止 Postgres 服务器:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop - 在机器 9 上停止 Postgres 服务器和 postgresql:
> /opt/apigee/apigee-service/bin/apigee-serviceEdge-postgres-server stop
>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - 停止机器 6 和 7 上的 Qpid 服务器:
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop - 如果已安装,请在新备用实例上停止 Postgres 服务器和 postgresql
您为回滚添加的节点:
> /opt/apigee/apigee-service/bin/apigee-serviceEdge-postgres-server stop
>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - 更新机器 8 上的 postgresql:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - 更新机器 8 上的 Postgres 数据库(仅限 Postgres 主实例):
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - 更新机器 9 上的 postgresql:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - 在机器 8 和 9 上启动 Postgres 服务器服务器:
> /opt/apigee/apigee-service/bin/apigee-serviceedge-postgres-server 启动 - 在机器 6 和 7 上启动 Qpid 服务器服务器:
> /opt/apigee/apigee-service/bin/apigee-serviceedge-qpid-server 启动 - 通过在机器上运行以下命令,将 Postgres 配置为备用节点
9:
>cd /opt/apigee/data/apigee-postgresql/pgdata
>rm -rf *
>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile - 通过在两台服务器上发出以下脚本来验证复制状态。通过
系统应该在两台服务器上显示相同的结果,
复制:
在机器 8(即主节点)上,运行以下命令:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
验证其是否表明自己是主实例。
在机器 9 上,备用节点:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
验证它是否表明它是备用实例。
- 在机器 8 上停止 Postgres 服务器:
- 更新机器 8 和 9 上的 Edge 组件:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - 确保按照上述步骤停用新的备用节点
在退役中
Postgres 节点。
如果您使用的是网络存储空间,则无需安装新节点。如需了解详情,请参阅必须升级到 Postgres 9.6。
对于包含 13 个主机的集群 安装
如需查看 Edge 的列表,请参阅安装拓扑 拓扑和节点编号。
- 如果您是从 4.17.01 开始更新,在以下情况下,请在配置文件中设置 SMTPMAILFROM:
您已在 Edge 上启用 SMTP。此参数的格式为:
SMTPMAILFROM="我的公司 <myco@company.com>” - 确保您已按照上述说明安装了新的 Postgres 备用节点
安装
一个新的 Postgres 备用节点。
如果您使用的是网络存储空间,则无需安装新节点。相反, Postgres 使用的数据存储区的网络快照。如需了解详情,请参阅必须升级到 Postgres 9.6。 - 在机器 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 - 更新计算机 4 和 5 上的 LDAP:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - 按如下顺序更新机器 12、13、6、7、10 和 11 上的 Edge 组件:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - 更新机器 6 和 7 上的界面:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile?? - 更新机器 8 和 9:
<ph type="x-smartling-placeholder">
- </ph>
- 在机器 8 上停止 Postgres 服务器:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop - 在机器 9 上停止 Postgres 服务器和 postgresql:
> /opt/apigee/apigee-service/bin/apigee-serviceEdge-postgres-server stop
>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - 在机器 12 和 13 上停止 Qpid 服务器:
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop - 如果已安装,请在新备用实例上停止 Postgres 服务器和 postgresql
您为回滚添加的节点:
> /opt/apigee/apigee-service/bin/apigee-serviceEdge-postgres-server stop
>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - 更新机器 8 上的 postgresql:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - 更新机器 8 上的 Postgres 数据库(仅限 Postgres 主实例):
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - 更新机器 9 上的 postgresql:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - 在机器 8 和 9 上启动 Postgres 服务器:
> /opt/apigee/apigee-service/bin/apigee-serviceedge-postgres-server 启动 - 在机器 12 和 13 上启动 Qpid 服务器服务器:
> /opt/apigee/apigee-service/bin/apigee-serviceedge-qpid-server 启动 - 通过在机器上运行以下命令,将 Postgres 配置为备用节点
9:
>cd /opt/apigee/data/apigee-postgresql/pgdata
>rm -rf *
>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile - 通过在两台服务器上发出以下脚本来验证复制状态。通过
系统应该在两台服务器上显示相同的结果,
复制:
在机器 8(即主节点)上,运行以下命令:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
验证其是否表明自己是主实例。
在机器 9 上,备用节点:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
验证它是否表明它是备用实例。
- 在机器 8 上停止 Postgres 服务器:
- 更新机器 8 和 9 上的 Edge 组件:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile?? - 确保按照上述步骤停用新的备用节点
在退役中
Postgres 节点。
如果您使用的是网络存储空间,则无需安装新节点。如需了解详情,请参阅必须升级到 Postgres 9.6。
对于包含 12 个主机的集群 安装
如需查看 Edge 的列表,请参阅安装拓扑 拓扑和节点编号。
- 如果您是从 4.17.01 开始更新,在以下情况下,请在配置文件中设置 SMTPMAILFROM:
您已在 Edge 上启用 SMTP。此参数的格式为:
SMTPMAILFROM="我的公司 <myco@company.com>” - 确保您已按照上述说明安装了新的 Postgres 备用节点
安装
一个新的 Postgres 备用节点。
如果您使用的是网络存储空间,则无需安装新节点。相反, Postgres 使用的数据存储区的网络快照。如需了解详情,请参阅必须升级到 Postgres 9.6。 - 更新 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>
- 更新 qpidd
机器 4:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - 在机器 5 上重复执行第 1 步。
- 更新 qpidd
机器 4:
- 数据中心 2 中的机器 10、11
<ph type="x-smartling-placeholder">
- </ph>
- 更新 qpidd
机器 10:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - 在机器 11 上重复执行第 1 步。
- 更新 qpidd
机器 10:
- 数据中心 1 中的机器 4、5
<ph type="x-smartling-placeholder">
- 更新 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、1、2、3
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - 数据中心 2 中的机器 10、11、7、8、9
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- 数据中心 1 中的机器 4、5、1、2、3
- 更新界面:
<ph type="x-smartling-placeholder">
- </ph>
- 数据中心 1 中的机器 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile - 数据中心 2 中的机器 7:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- 数据中心 1 中的机器 1:
-
?更新
数据中心 1 的机器 6 和数据中心 2 的机器 12:
<ph type="x-smartling-placeholder">
- </ph>
- 在机器 6 上停止 Postgres 服务器:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop - 在机器 12 上停止 Postgres 服务器和 postgresql:
> /opt/apigee/apigee-service/bin/apigee-serviceEdge-postgres-server stop
>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - 停止机器 4、5、10 和 11 上的 Qpid 服务器:
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop - 如果已安装,请在新备用实例上停止 Postgres 服务器和 postgresql
您为回滚添加的节点:
> /opt/apigee/apigee-service/bin/apigee-serviceEdge-postgres-server stop
>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - 更新机器 6 上的 postgresql:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - 更新机器 6 上的 Postgres 数据库(仅限 Postgres 主实例):
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - 更新机器 12 上的 postgresql:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - 在机器 6 和 12 上启动 Postgres 服务器服务器:
> /opt/apigee/apigee-service/bin/apigee-serviceedge-postgres-server 启动 - 在机器 4、5、10 和 11 上启动 Qpid 服务器服务器:
> /opt/apigee/apigee-service/bin/apigee-serviceedge-qpid-server 启动 - 通过在机器上运行以下命令,将 Postgres 配置为备用节点
12:
>cd /opt/apigee/data/apigee-postgresql/pgdata
>rm -rf *
>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile - 通过在两台服务器上发出以下脚本来验证复制状态。通过
系统应该在两台服务器上显示相同的结果,
复制:
在机器 6(即主节点)上,运行以下命令:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
验证其是否表明自己是主实例。
在机器 12 上,备用节点:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
验证它是否表明它是备用实例。
- 在机器 6 上停止 Postgres 服务器:
- 更新机器 6 和 12 上的 Edge 组件:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - 确保按照上述步骤停用新的备用节点
在退役中
Postgres 节点。
如果您使用的是网络存储空间,则无需安装新节点。如需了解详情,请参阅必须升级到 Postgres 9.6。
对于包含 7 个主机的 API BaaS 安装
- 在您的
配置文件此参数的格式为:
SMTPMAILFROM="我的公司 <myco@company.com>” - 在机器 5、6 和 7 上更新 Cassandra:
> /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile -
更新机器 1、2 和 3 上的 ElasticSearch 和 API BaaS Stack:
> /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile - 在机器 4 上更新 API BaaS 门户:
> /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
对于包含 10 个主机的 API BaaS 安装
- 在您的
配置文件此参数的格式为:
SMTPMAILFROM="我的公司 <myco@company.com>” - 在机器 8、9 和 10 上更新 Cassandra:
> /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile - 更新机器 1、2 和 3 上的 ElasticSearch:
> /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile - 更新机器 4、5 和 6 上的 API BaaS 堆栈:
> /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile - 在机器 7 上更新 API BaaS 门户:
> /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
对于双数据中心 API Baas 安装
此过程要求您更新两个数据中心中的 Cassandra 节点。如果您 与 Edge 共享这些 Cassandra 节点,则您通常需要在 正在更新 Edge。
- 在您的
配置文件此参数的格式为:
SMTPMAILFROM="我的公司 <myco@company.com>” - 使用正确的复制因子为两个数据中心更新 Cassandra 键空间。您
只需在任一数据中心的任何 Cassandra 服务器上运行此步骤一次即可:
注意:下面的命令全部将复制因子设置为“3”,表示 三个 Cassandra 节点根据需要修改此值,以便安装。- 启动 Cassandra cqlsh 实用程序:
> /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP - 在“cqlsh>”处执行以下 CQL 命令提示设置复制
级别:
<ph type="x-smartling-placeholder">
- </ph>
- cqlsh>替代 KEYSPACE“Apigee_Baas_dc_1”WITH 复制 = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3'};
- cqlsh>替代 KEYSPACE“Apigee_Baas”WITH 复制 = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3'};
- cqlsh>替代 KEYSPACE“Apigee_Baas_Locks”WITH 复制 = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3'};
- cqlsh>更改键区 “system_traces”WITH 复制 = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3'};
- cqlsh>替代 KEYSPACE“Apigee_Baas_dc_2”WITH 复制 = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3'};
- 使用以下命令查看键空间:
cqlsh>选择 * 从 system.schema_keyspaces; - 退出 cqlsh:
cqlsh>退出
- 启动 Cassandra cqlsh 实用程序:
- (仅适用于在更新过程中未更新 Cassandra 的情况
更新数据中心 1 中的 Cassandra 节点,一次一台机器:
> /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile - (仅适用于在更新过程中未更新 Cassandra 的情况
更新数据中心 2 中的 Cassandra 节点,一次一台机器:
> /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile - 在数据中心 1 的机器上更新 ElasticSearch,一次一台机器:
> /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile - 在数据中心 2 的机器上更新 ElasticSearch,一次一台机器:
> /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile - 更新数据中心 1 中机器的 API BaaS 堆栈,一次一台机器:
> /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile - 更新数据中心 2 中机器的 API BaaS 堆栈,一次一台机器:
> /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile - 在数据中心 1 的机器上更新 API BaaS 门户,一次一台机器:
> /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile - 在数据中心 2 的机器上更新 API BaaS 门户,一次一台机器:
> /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile - 更新 BaaS 键空间值。这些键空间必须在安装时设置才能进行复制
但不一定是在运行时取消复制还可以节省 Cassandra 内存。
您只需在任一数据中心的任何 Cassandra 服务器上运行此步骤一次: <ph type="x-smartling-placeholder">- </ph>
- 启动 Cassandra cqlsh 实用程序:
> /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP - 执行以下 CQL 命令,设置 Cassandra 的复制级别
键空间:
<ph type="x-smartling-placeholder">
- </ph>
- cqlsh>更改键区 "Apigee_Baas_dc_1"WITH 复制 = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3' };
- cqlsh>更改键区 "Apigee_Baas_dc_2"WITH 复制 = { 'class': 'NetworkTopologyStrategy', 'dc-2': '3' };
- 使用以下命令查看键空间:
cqlsh>选择 * system.schema_keyspaces; - 退出 cqlsh:
cqlsh>退出
- 启动 Cassandra cqlsh 实用程序:
对于非标准安装
如果您进行非标准安装,请更新以下 Edge 组件, 订单:
- ZooKeeper
- Cassandra
- qpidd、ps
- LDAP
- 边缘,表示“-c 边缘”依次为:配备 Qpid 服务器的节点、
Postgres 服务器、管理服务器、消息处理器和路由器。
注意:如果节点同时安装了 Qpid 服务器和 Postgres 服务器,请运行 “-c Edge”个人资料步骤 - Edge 界面