安装、升级、版本回退和卸载 OCP

本文介绍如何使用 OAT 安装、升级、版本回退和卸载 OCP。

前提条件

在安装 OCP 之前，您需要确认以下信息：

• 您已安装并使用超级管理员或运维人员账号登录 OAT。更多信息，参考 安装 OAT。
• 您已添加待安装 OCP 的服务器。更多信息，参考 添加服务器。
• 您的服务器满足安装 OCP 的要求。更多信息，参考 OCP 资源规划。
• 您已为 OCP 创建元数据库 MetaDB 组件。更多信息，参考 创建 MetaDB。

安装 OCP

按照以下步骤安装 OCP：

1. 在左侧导航栏，单击 产品服务 > 产品。

2. 在 产品管理 页面，单击右上角的 安装产品，选择 安装 OCP。

3. 在 安装 OCP 页面，配置各项参数。

   OCP 基础配置参数如下：

   参数	说明
   OCP 镜像	OCP 的 Docker 镜像。 说明 OCP V3.3.0 以下版本不支持搭配 OpenSearch 使用。
   产品名称	产品名称，不允许与其他产品重名。
   多可用区模式	启用多可用区安装。
   服务器	待安装 OCP 的服务器 IP 地址。
   OCP 代理 IP	与多可用区模式关联，当多可用区模式开启时，需要填写此可用区的 OCP 访问入口 IP，此 IP 为虚拟 IP。
   OCP 代理端口	与多可用区模式关联，当多可用区模式开启时，需要填写此可用区的 OCP 访问入口端口号，默认值为 80，此端口为虚拟端口，实际端口为 HTTP 端口。
   CPU	OCP 在服务器上可用的 CPU，默认为 8C。
   内存	OCP 在服务器上可用的内存，默认为 20G。
   HTTP 端口	OCP 的 HTTP 端口号，默认为 8080。
   多集群模式	启用多集群安装模式。
   日志目录	OCP 的日志存储路径。

   OCP 元数据库 MetaDB 配置参数如下：

   参数	说明
   存储数据库类型	选择 MetaDB 的类型。
   选择已创建的 MetaDB	为 OCP 选择已创建的 MetaDB。
   OCP Meta 租户	OCP MetaDB 的专用租户。
   OCP Monitor 租户	OCP MonitorDB 的专用租户。
   租户名	租户名称。
   租户密码	租户密码。
   CPU	MetaDB 在服务器上可用的 CPU，默认为 2C。
   内存	MetaDB 在服务器上可用的内存，默认为 5G。
   CPU	MonitorDB 在服务器上可用的 CPU，默认为 4C。
   内存	MonitorDB 在服务器上可用的内存，默认为 16G。
   接管 MetaDB 集群	勾选以接管 MetaDB 集群。接管后可以在 OCP 中看到此 MetaDB 集群。每个 OceanBase 集群只能被一个 OCP 接管。

   （可选）负载均衡配置参数如下：

   参数	说明
   负载均衡模式	选择负载均衡模式。
   MetaDB TCP 代理 IP	TCP 协议地址，用来连接 MetaDB。
   MetaDB TCP 代理端口	TCP 协议端口号。
   OCP HTTP 代理域名	HTTP 协议地址，用来访问 OCP 的控制台。
   OCP HTTP 代理端口	HTTP 协议端口号。

   OpenSearch 配置：

   OAT 在 V4.1.2 版本中，新增 OpenSearch 配置，用户在创建 OCP 时，可以选择配置 OpenSearch。

   OpenSearch 配置的模式分为如下三种：

   • 已创建的 OpenSearch：用户可以在下拉框内选择通过 OAT 创建的 OpenSearch，关于 OpenSearch 的创建可参考 创建和卸载 OpenSearch
   • 外部的 OpenSearch：需要填写外部部署的 OpenSearch 的 URL、用户名、密码。
   • 不使用。

4. OCP 配置完成后，点击 提交。 如果您的配置有误，点击 重置 一键恢复默认配置。

升级 OCP

按以下步骤升级 OCP：

1. 在左侧导航栏，单击 产品服务 > 产品。

2. 找到待升级的 OCP 服务，在对应的 名称 列中，单击产品名称进入详情页。

   说明

   支持名称检索，您可以在页面上方通过产品名称搜索查询。

3. 在详情页右上角，单击 升级。

4. 在弹出的 升级 对话框中，填写相关信息。

   相关字段说明如下：

   字段	描述
   升级方式	停服升级：适用于无业务连续性的产品，升级期间 OAT 会先停止产品旧版本服务，无法对外提供服务。 滚动升级：滚动升级期间，可以访问 OCP 未在升级的节点，提供只读服务。 注意 如果升级的 OCP 是 V4.0.1 或之后的版本，不再需要 OCP 的用户名和密码，表单里也会自动消失。 OCP 滚动升级要求当前 OCP 是 V4.3.0 或之后的版本，且部署架构为多节点。
   请选择升级的镜像文件	目标升级镜像文件。
   用户名	OCP 用户名。
   密码	OCP 密码。

5. 单击 确认。

   说明

   如果您安装的是 OCP V4.1.0 及以上版本，OAT 将提示您为 OCP 设置初始密码。如果您安装的是 OCP V4.1.0 以下版本，OAT 将不做此提示。

版本回退

支持版本回退场景

• OAT 升级产品任务失败，暂时无法解决，在任务中心页面发起版本回退任务，回退为升级前版本。
• OAT 升级产品任务成功，使用产品过程中发现问题，产品回退为上一个版本。

使用版本回退限制

• 使用 OAT V4.3.0 或之后的版本进行的产品升级任务才允许进行版本回退。
• OAT 上发起升级任务三天内允许回退。
• OAT 升级产品任务的备份元数据子任务完成。
• 如果 OCP 是多集群模式，需要用户先回退主集群，然后再发起回退备集群任务。
• 升级前 OCP 为 V3.2.0 或之后的版本。

版本回退执行步骤

OAT 升级 OCP 产品任务成功，按以下步骤回退 OCP 版本：

1. 在左侧导航栏，单击 产品服务 > 产品。

2. 找到待回退的 OCP 服务，在对应的 名称 列中，单击产品名称进入详情页。

   说明

   支持名称检索，您可以在页面上方通过产品名称搜索查询。

3. 在详情页右上角，单击 版本回退。

4. 在弹出的 版本回退 对话框中，填写相关信息。

   相关字段说明如下：

   字段	描述
   选择元数据备份文件	可选项，选择回退使用的元数据文件。
   请选择版本回退的镜像文件	选择回退使用的镜像文件。
   版本回退会丢失所有监控和诊断数据	勾选该选项。 说明 因为数据量太大，无法备份 ocp_monitor 租户下的数据。
   版本回退会丢失当前版本运行期间产生的数据记录，当前版本新增加的功能/服务可能会有异常	勾选该选项。

5. 单击 确定。

回退影响

• 停服回退，回退期间服务不可用。
• 新版本中进行的运维操作信息会丢失，元数据可能会和实际不一致等。
• 监控、诊断信息会丢失。
• 任务列表可能有超前的信息。
• 版本回退后新版本 OCP 增加的功能/服务可能会有异常，比如新版本安装了 binlog，老版本不支持。

卸载 OCP

按以下步骤卸载 OCP：

1. 在左侧导航栏，单击 产品服务 > 产品。

2. 找到待卸载的 OCP 服务，在对应的 名称 列中，单击产品名称进入详情页。

   说明

   支持名称检索，您可以在页面上方通过产品名称搜索查询。

3. 在详情页右上角，单击 卸载。

4. 在弹出的确认框中，单击 卸载。

   OAT 会提示正在卸载中。同时，OAT 还会创建一个卸载任务，您可以在弹出的确认框中单击任务 ID，查看当前卸载任务的执行进度。

后续操作

安装 OCP 后，您可以使用 OCP 监控、运维 OceanBase 数据库。更多信息，参考 OCP 文档。