部署 OCP

本节为您介绍如何白屏化部署 OCP。

MetaDB 是 OCP 重要组成部分，MetaDB 为 OCP 管理元信息及监控数据提供底层存储能力，OCP-Server 通过调用 MetaDB 数据为您提供 OceanBase 数据库全生命周期管理服务。您可选择以下任意一种 MetaDB 的配置方式来部署 OCP：

• （默认）创建全新的 OceanBase 数据库作为 OCP 的 MetaDB。
• 使用已有的 OceanBase 数据库作为 OCP 的 MetaDB。

前提条件

已参见 安装准备 获取 ocp-server-all-in-one-4.0.3.0-YYYYMMDDhhmmss.el7.x86_64.tar.gz 软件包，将软件包上传至 OCP 宿主机的任一目录，并执行如下命令进行解压。

tar zxf ocp-server-all-in-one-4.0.3.0-YYYYMMDDhhmmss.el7.x86_64.tar.gz

创建全新的 OceanBase 数据库作为 OCP 的 MetaDB

步骤一：启动 ocp-installer

1. 登录 OCP 宿主机。

2. 执行如下命令进入解压后软件包的 bin 目录下，并安装部署程序。

   cd ocp-server-all-in-one/bin && sh install.sh
   

3. 执行如下命令，使环境变量生效。

   source ~/.ocp-server-all-in-one/bin/env.sh
   

4. 执行 ocp-installer install ，并在返回信息中获取部署向导页面的 IP 地址。

   

步骤二：进入 OCP 部署向导页面

1. 通过浏览器访问 步骤一 获取的 IP 地址，进入部署向导页面，单击 开始部署。

   

2. 选择 创建全新的 OceanBase 数据库，用以作为 OCP 的 MetaDB，并单击 确定。

   

步骤三：配置 MetaDB

创建全新的 MetaDB，MetaDB 与 OCP-Server 将使用相同的主机部署服务。OCP-Server 将访问本地 MetaDB 以获得更好的服务可靠性。

1. 配置系统相关信息。

   注意

   为了避免操作系统用户冲突，请为 MetaDB 及 OCP 配置独立的操作系统用户。

   参数	说明
   选择主机	选择部署 MetaDB 的主机，支持配置多台主机。
   主机用户	需提供主机操作系统的用户以便安装程序进行自动化配置。默认值为 root，支持非 root 账号，非 root 账号需具有创建用户的权限。
   用户密码	需输入 用户账号 的对应密码。当主机已设置免密时，可忽略此项配置。

   

2. 配置 MetaDB 相关信息。

   参数	说明
   集群名称	自定义待管理的集群的名称。默认为 ocpmetadb，支持修改。集群名称必须以英文字母开头，可支持大小写字母、数字和下划线，长度为 2~48 字符。
   root@sys 密码	支持自定义或随机生成。 密码需要满足以下复杂度条件： 长度为 8~32 个字符 支持字母、数字和特殊字符，且至少包含大、小写字母、数字和特殊字符各 2 个 支持的特殊字符为 ~!@#%^&*_-+=`|(){}[]:;',.?/
   软件路径	MetaDB 的安装路径，默认值为 /home/admin，支持自定义目录。
   数据路径	MetaDB 的数据存储路径，默认值为 /data/1，支持自定义目录。
   日志路径	MetaDB 的日志存储路径，默认值为 /data/log1，支持自定义目录。
   SQL 端口	MetaDB 的 SQL 端口，默认值为 2881，支持自定义端口。
   RPC 端口	MetaDB 的 RPC 端口，默认值为 2882，支持自定义端口。
   网卡名称	选择 自动配置 或 手动配置。推荐 自动配置，OCP 会自动获取 OBServer 绑定的网卡名称；当自动配置失败或 OBServer 的网卡为代理模式时，您可选择 手动配置 方式。

   注意

   需保证 软件路径、数据路径 及 日志路径 所在目录的磁盘空间充足，否则将配置失败。

   

3. 单击 下一步，校验当前输入的配置。

   系统会对所填配置的主机、用户权限、路径及端口进行校验，每台主机需要 1 分钟左右的校验时间。

   • 若配置检查未通过，可根据弹窗中的检查结果进行排查及修改。弹窗支持拖拽及收起，并支持在弹窗未收起的情况下对底层页面进行操作。

   • 若配置检查通过，在弹窗中对 MetaDB 集群进行资源分配，并单击 确定。

     说明

   • 系统将根据当前环境最小可用资源进行计算，为您提供 MetaDB 资源分配的最优建议。
   • 最小资源定义：以不同类型的资源在不同主机上的大小取最小值作为最小可用资源，如 A 主机内存为 50GB，B 主机内存为 30GB，则取值为 30GB；如 A 主机存储空间为 50GB，B 主机存储空间为 100GB，则取值为 50GB。

   建议为 MetaDB 分配的资源如下：

   参数	说明
   内存分配图	根据主机的资源规划展示内存的预分配信息，主要包括： 系统预占用：10%，向上取整，不可调整。 memory_limit：10%，向下取整，根据下方的内存调整动态变化。 sys 租户预留：10%，向下取整，不可调整。 OCP 服务预留：10%，向下取整，不可调整。 普通租户预留：剩余所有内存，不可调整。
   memory_limit	OceanBase 系统预留内存大小，不能分配给租户使用。 默认：10%，向下取整。 下限：1GB。 上限：系统内存的 20%，向上取整。
   数据文件 clog_disk_utilization_threshold 和日志文件 clog_disk_utilization_threshold	如果配置的软件路径、数据文件、日志文件挂载在同一个盘，则默认： 数据文件下限：1GB。 数据文件默认：（剩余空间 - 软件空间（2GB）） * 60%，向下取整。 数据文件上限：剩余空间 - 软件空间（2GB）- 日志文件大小。 日志文件下限：1GB。 日志文件默认：（剩余空间 - 软件空间（2GB）） * 40%，向下取整。 日志文件上限：剩余空间 - 软件空间（2GB）- 数据文件大小。 如果配置的数据文件、日志文件挂载在同一个盘，则默认： 数据文件下限：1GB。 数据文件默认：剩余空间 * 60%，向下取整。 数据文件上限：剩余空间 - 日志文件大小。 日志文件下限：1GB。 日志文件默认：剩余空间 * 40%，向下取整。 日志文件上限：剩余空间 - 数据文件大小。 如果配置的软件路径与数据路径或日志路径任意盘混用，则剩余空间需 - 2GB 进行计算。 如果设置的数据路径、日志路径分开挂载，则： 下限：1GB。 默认和上限：剩余最大可用空间 * 90% ，向下取整。 关于 CPU，系统参数保持 cpu_count = 0 ，sys 租户 CPU 取核心数的 10%，向上取整。关于 memory_limit_percentage，保持默认 80%。

   

步骤四：MetaDB 预检查

MetaDB 预检查将验证您的环境是否满足安装和配置 MetaDB 的所有最低要求。

• 若存在检查失败项，OCP 提供修复方案说明，您可参考修复方案对问题进行排查修复。针对可自动修复的检查项，支持单击 自动修复 进行修复。

  修复完成后，您可单击 重新检查 重新执行环境预检查程序。

• 若检查通过，单击 下一步。

步骤五：部署 MetaDB

MetaDB 部署过程中，您可以通过 部署日志 模块查看详细安装日志。

• 若部署失败，请查看日志信息获取失败原因，并联系技术支持同学进行处理。待定位安装失败问题原因且修复问题后，单击 重新部署 重新执行安装程序。

• 若部署成功，单击 下一步。

步骤六：配置 OCP

本步骤用于配置 OCP 服务及租户信息。

1. 配置 OCP 服务。

   参数	说明
   选择主机	此处默认填写 MetaDB 配置 中配置的主机，不支持修改。
   集群名称	自定义待管理的集群的名称。集群名称必须以英文字母开头，可支持大小写字母、数字和下划线，长度为 2~48 字符。
   Admin 密码	配置 OCP 管理员账号密码，密码需要满足以下复杂度条件： 长度为 8~32 个字符 支持字母、数字和特殊字符，且至少包含大、小写字母、数字和特殊字符各 2 个 支持的特殊字符为 ~!@#%^&*_-+=`|(){}[]:;',.?/
   软件路径	OCP 的安装路径，默认值为 /home/部署用户，支持自定义软件路径，需保证此路径的磁盘空间充足。
   服务端口	OCP 的服务端口，默认值为 8080，支持自定义端口。
   ocpagent 管理端口	OCP 的 ocpagent 管理端口，默认值为 62888，支持自定义端口。
   ocpagent 监控端口	OCP 的 ocpagent 监控端口，默认值为 62889，支持自定义端口。

   

2. 配置租户信息。

   OCP 需要在 MetaDB 配置必要的租户以实现对 OceanBase 数据库全生命周期管理，配置完成后，系统将自动创建 元信息租户 和 监控数据租户。

   • 配置元信息租户信息：

     参数	说明
     租户名称	元信息租户名称，支持自定义。
     密码	配置元信息租户的账号密码，默认与 OCP 服务配置 中的 Admin 密码 保持一致。支持自定义，密码需要满足以下复杂度条件： 长度为 8~32 个字符 支持字母、数字和特殊字符，且至少包含大、小写字母、数字和特殊字符各 2 个 支持的特殊字符为 ~!@#%^&*_-+=`|(){}[]:;',.?/
     确认密码	需与 密码 保持一致。

   • 配置监控数据租户信息：

     参数	说明
     租户名称	监控数据租户名称，支持自定义。
     密码	配置监控数据租户的账号密码，默认与 OCP 服务配置 中的 Admin 密码 保持一致。支持自定义，密码需要满足以下复杂度条件： 长度为 8~32 个字符 支持字母、数字和特殊字符，且至少包含大、小写字母、数字和特殊字符各 2 个 支持的特殊字符为 ~!@#%^&*_-+=`|(){}[]:;',.?/
     确认密码	需与 密码 保持一致。

   

3. 单击 下一步，校验当前输入的配置。

   系统会对所填配置的主机、用户权限、路径及端口进行校验，每台主机需要 1 分钟左右的校验时间。

   • 若配置检查异常，可根据弹窗中的检查结果进行排查及修改。弹窗支持拖拽及收起，并支持在弹窗未收起的情况下对底层页面进行操作。

   • 若配置检查通过，在弹窗中对 OCP 集群进行资源分配，并单击 确定。

     说明

     系统将根据主机上的资源规划，为您提供资源分配的最优建议。

     建议为 OCP 集群分配的资源如下：

     参数	说明
     系统资源分配图	根据主机的资源规划展示内存的预分配信息。 OCP 服务内存：展示下方配置的值，根据下方的内存调整动态变化。 元信息租户内存：展示下方配置的值，根据下方的内存调整动态变化。 监控数据租户内存：展示下方配置的值，根据下方的内存调整动态变化。 其他已使用内存：包含系统及其他应用已使用、system_memory 使用、sys 租户及其他租户使用的内存总和，向上取整。 剩余内存：剩余所有内存，不可调整。 注意 关于剩余内存： CPU：以最低 8C 计算，理想情况下 sys 租户占用 1C，剩余 7C，则最低 ocp 1C，元信息租户 2C，监控数据租户 4C。 内存以最低 16GB 计算，理想情况下 system_memory 占用 1GB，sys 租户占用 1GB，系统占用 1GB，剩余 13GB，则最低 ocp 1GB，元信息租户 4GB，监控数据租户 8GB。
     OCP-Server	CPU：默认 1C，最小 1C，支持调整，调整上限为剩余的核心数。 下限：1 GB。 内存：默认 1G，最小 1GB，支持调整，调整上限为剩余的内存数，如果上限超过 5GB，则默认 5GB。
     元信息租户	CPU：默认 2C，最小 1C，支持调整，调整上限为剩余的核心数。 内存：默认 4GB，最小 2GB，支持调整，调整上限为剩余的内存数。
     监控数据租户	CPU：默认 4C，最小 2C，支持调整，调整上限为剩余的核心数。 内存：默认 8GB，最小 4GB，支持调整，调整上限为剩余的内存数。

     说明

     当 步骤一 中执行的启动命令中包含 -mix 参数时，仅展示 OCP 租户，不再区分 元信息租户 和 监控数据租户，仅通过数据库用户名做访问区分。

     

步骤七：OCP 预检查

OCP 预检查将验证您的环境是否满足安装和配置 OCP 的所有最低要求。

• 若存在检查失败项，OCP 提供修复方案说明，您可参考修复方案对问题进行排查修复。针对可自动修复的检查项，支持单击 自动修复 进行修复。

  修复完成后，您可单击 重新检查 重新执行环境预检查程序。

• 若检查通过，单击 下一步。

步骤八：部署 OCP

OCP 部署过程中，您可以通过 部署日志 模块查看详细安装日志。

• 若部署失败，请查看日志信息获取失败原因，并联系技术支持同学进行处理。待定位安装失败问题原因且修复问题后，单击 重新部署 ，系统将清理当前失败的 OCP 安装环境，并重新执行安装程序。

• 若部署成功，单击 完成 退出部署程序。在退出程序前，您可复制访问地址及账密信息，用以登录所部署的 OCP 平台。

使用已有的 OceanBase 数据库作为 OCP 的 MetaDB

此方式适用于使用已有的 OceanBase 数据库作为 OCP 的 MetaDB。

步骤一：启动 ocp-installer

1. 登录 OCP 宿主机。

2. 执行如下命令进入解压后软件包的 bin 目录下，并安装部署程序。

   cd ocp-server-all-in-one/bin && sh install.sh
   

3. 执行如下命令，使环境变量生效。

   source ~/.ocp-server-all-in-one/bin/env.sh
   

4. 执行 ocp-installer install ，并在返回信息中获取部署向导页面的 IP 地址。

   

步骤二：进入 OCP 部署向导页面

1. 通过浏览器访问 步骤一 获取的 IP 地址，进入部署向导页面，单击 开始部署。

   

2. 选择 使用已有的 OceanBase 数据库，用以作为 OCP 的 MetaDB，并单击 确定。

   

步骤三：连接 MetaDB

OCP 将根据所填写的 MetaDB 信息执行部署程序。

1. 填写 OceanBase 数据库的连接信息。

   OCP 将使用该连接信息的数据库作为 MetaDB 存储元信息及监控数据。

   参数	说明
   访问地址	数据库访问 IP 地址，仅支持填写一个，用于 OCP 连接 MetaDB。
   访问端口	数据库连接访问端口。
   访问账号	数据库的访问账号，默认为 root@sys，支持自定义。
   访问密码	数据库 访问账号 的密码。

2. 确认信息无误后，单击 下一步，系统将校验该 MetaDB 是否连接成功。

   

步骤四：配置 OCP

本步骤用于配置 OCP 服务及租户信息。

1. 配置系统相关信息。

   注意

   为了避免操作系统用户冲突，请为 MetaDB 及 OCP 配置独立的操作系统用户。

   参数	说明
   选择主机	选择部署 OCP 的主机，支持配置多台主机。
   管理员账号	需输入操作系统上的用户账号，以便安装程序进行自动化配置。默认为 root，支持非 root 账号，非 root 账号需具有创建用户的权限。
   管理员密码	需输入 管理员账号 的对应密码。当主机已设置免密时，可忽略此项配置。

   

2. 配置 OCP 服务。

   参数	说明
   集群名称	自定义待管理的集群名称。默认为 OCP，支持自定义，集群名称必须以英文字母开头，可支持大小写字母、数字和下划线，长度为 2~48 字符。
   Admin 密码	配置 OCP 管理员账号密码，密码需要满足以下复杂度条件： 长度为 8~32 个字符 支持字母、数字和特殊字符，且至少包含大、小写字母、数字和特殊字符各 2 个 支持的特殊字符为 ~!@#%^&*_-+=`|(){}[]:;',.?/
   软件路径	OCP 的软件安装路径，默认值为 /home/部署用户，支持自定义路径。
   服务端口	OCP 的服务端口，默认值为 8080，支持自定义端口。
   ocpagent 管理端口	OCP 的 ocpagent 管理端口，默认值为 62888，支持自定义端口。
   ocpagent 监控端口	OCP 的 ocpagent 监控端口，默认值为 62889，支持自定义端口。

   

3. 配置租户信息。

   OCP 需要在 MetaDB 配置必要的租户以实现对 OceanBase 数据库全生命周期管理，配置完成后，系统将自动创建 元信息租户 和 监控数据租户。

   • 配置元信息租户信息：

     参数	说明
     租户名称	元信息租户名称，支持自定义。
     密码	元信息租户的账号密码，默认与 OCP 服务配置 中的 Admin 密码 保持一致。支持自定义密码，密码需要满足以下复杂度条件： 长度为 8~32 个字符 支持字母、数字和特殊字符，且至少包含大、小写字母、数字和特殊字符各 2 个 支持的特殊字符为 ~!@#%^&*_-+=`|(){}[]:;',.?/
     确认密码	需与 密码 保持一致。

   • 配置监控数据租户信息：

     参数	说明
     租户名称	监控数据租户名称，支持自定义。
     密码	配置监控数据租户的账号密码，默认与 OCP 服务配置 中的 Admin 密码 保持一致。支持自定义密码，密码需要满足以下复杂度条件： 长度为 8~32 个字符 支持字母、数字和特殊字符，且至少包含大、小写字母、数字和特殊字符各 2 个 支持的特殊字符为 ~!@#%^&*_-+=`|(){}[]:;',.?/
     确认密码	需与 密码 保持一致。

   

4. 单击 下一步，校验当前输入的配置。

   系统会对所填配置的主机、用户权限、路径及端口进行校验，每台主机需要 1 分钟左右的校验时间。

   • 若配置检查异常，可根据弹窗中的检查结果进行排查及修改。弹窗支持拖拽及收起，并支持在弹窗未收起的情况下对底层页面进行操作。

   • 若配置检查通过，在弹窗中对 OCP 集群进行资源分配，并单击 确定。

     说明

     系统将根据主机上的资源规划，为您提供资源分配的最优建议。

     资源分配说明如下：

     参数	说明
     系统资源分配图	根据主机的资源规划展示内存的预分配信息。 OCP Server 内存：展示下方配置的值，根据下方的内存调整动态变化。 元信息租户内存：展示下方配置的值，根据下方的内存调整动态变化。 监控数据租户内存：展示下方配置的值，根据下方的内存调整动态变化。 其他已使用内存：包含系统及其他应用已使用、system_memory 使用、sys 租户及其他租户使用的内存总和，向上取整。 剩余内存：剩余所有内存，不可调整。 注意 关于剩余内存： CPU：以最低 8C 计算，理想情况下 sys 租户占用 1C，剩余 7C，则最低 ocp 1C，元信息租户 2C，监控数据租户 4C。 内存以最低 16GB 计算，理想情况下 system_memory 占用 1GB，sys 租户占用 1GB，系统占用 1GB，剩余 13GB，则最低 ocp 1GB，元信息租户 4GB，监控数据租户 8GB。
     OCP-Server	CPU：默认 1C，最小 1C，支持调整，调整上限为剩余的核心数。 下限：1 GB。 内存：默认 1GB，最小 1GB，支持调整，调整上限为剩余的内存数，如果上限超过 5GB，则默认 5GB。
     元信息租户	CPU：默认 2C，最小 1C，支持调整，调整上限为剩余的核心数。 内存：默认4GB，最小 2GB，支持调整，调整上限为剩余的内存数。
     监控数据租户	CPU：默认 4C，最小 2C，支持调整，调整上限为剩余的核心数。 内存：默认8GB，最小 4GB，支持调整，调整上限为剩余的内存数。

     说明

     当 步骤一 中执行的启动命令中包含 -mix 参数时，仅展示 OCP 租户，不再区分 元信息租户 和 监控数据租户，仅通过数据库用户名做访问区分。

     

步骤五： OCP 预检查

OCP 预检查将验证您的环境是否满足安装和配置 OCP 的所有最低要求。

• 若存在检查失败项，OCP 提供修复方案说明，您可参考修复方案对问题进行排查修复。针对可自动修复的检查项，支持单击 自动修复 进行修复。

  修复完成后，您可单击 重新检查 重新执行环境预检查程序。

• 若检查通过，单击 下一步。

步骤六：部署 OCP

OCP 部署过程中，您可以通过 部署日志 模块查看详细安装日志。

• 若部署失败，请查看日志信息获取失败原因，并联系技术支持同学进行处理。待定位安装失败问题原因且修复问题后，单击 重新部署 ，系统将清理当前失败的 OCP 安装环境，并重新执行安装程序。

• 若部署成功，单击 完成 退出安装程序。在退出程序前，您可复制访问地址及账密信息，用以登录 OCP 平台。