添加主机

本页面为您介绍添加主机的操作步骤，添加主机操作旨在于将线下设备添加到 OCP 控制台中。

前提条件

当前登录 OCP 的用户为 ADMIN 角色或 ORG_ADMIN 角色。

操作步骤

1. 登录 OCP。

2. 在左侧导航栏中单击 主机。

3. 在 主机 页签中，单击页面右上角的 添加主机。

4. 填写 IP 地址 和 SSH 端口号 。输入新主机的 IPv4/IPv6 地址，支持同时添加多个 IP 地址（多个 IP 之间用英文逗号分隔）；SSH 端口号默认 22。

   注意

   当主机 IP 为 IPv6 地址时，具有如下限制：

   • 部署 OceanBase、OBClient 和 OBProxy 时：
     • OceanBase 版本须为 [V4.2.5 BP3 Hotfix3, V4.3.0) 或 [V4.3.5 BP2 Hotfix1, +∞)。
     • OBClient 版本须为 [V2.2.9, +∞)。
     • OBProxy 版本须为 [V4.3.4, +∞)。

   • Binlog 服务暂不支持 IPv6 部署。

5. 选择机型。如果没有对应的机型，可以单击 新增机型，立即在 OCP 中新增机型。

   更多操作详情，可参考 管理机型。

6. 选择机房。如果没有对应的机房，可以单击 新增机房，立即在 OCP 中新增机房。

   更多操作详情，可参考 管理机房 和 管理区域。

7. 选择主机类型，并为主机选择连接凭据。

   参数	说明
   主机类型	选择所添加主机的类型，包括物理机与 ECS。
   凭据	选择密码箱中的凭据，如果没有对应的凭据，可以单击 新增凭据 为该主机创建新的连接凭据。 凭据名：以英文字母开头、英文或数字结尾，可包含英文、数字和下划线，且长度为 2 ~ 32。 授权类型：包含 用户名/密码、SSH 私钥 和 已配置免密 三种方式。 用户类型：连接服务器的用户类型，支持 root 用户 及 普通用户 两种。 root 用户：拥有 ROOT 权限的 SSH 用户。 普通用户：拥有 ROOT 权限的普通用户，该用户需先在 /etc/sudoers 文件中对部分指令配置免密执行 sudo，详情可参考文末的 配置 sudo 权限。 用户名：当用户类型为 普通用户 时填写，填写连接服务器的用户。 密码：当授权类型为 用户名/密码 时填写，填写连接服务器的密码。 私钥：当授权类型为 SSH 私钥 时填写，为服务器添加 SSH 凭证。 OCP 主机私钥文件路径：当授权类型为 已配置免密 时填写，填写主机私钥文件的存放路径，默认为 /home/admin/.ssh/id_rsa。若 OCP 部署方式为 Docker，私钥文件请使用 Docker 内的文件路径。 说明：为凭据补充额外信息。

8. （可选）填写主机别名及说明。

9. 在 OCP Agent 配置 模块，根据实际情况对 OCP Agent 端口、OCP Mgragent 端口及 OCP Monagent 规格进行配置，避免因端口占用或资源不足导致添加主机失败。

   参数	说明
   OCP Agent 端口	OCP-Agent 监控数据监听端口，默认值为 62889。
   OCP Mgragent 端口	OCP-Agent API 监听端口，默认值为 62888。
   OCP Monagent 规格	OCP-Agent 组件的资源配置，默认值为 1C2GiB，建议最大规格为 6C12GiB。

   说明

   在高业务负载或压力测试场景下，建议提升 OCP Agent 的资源规格配置，以防止因资源不足导致 OOM（Out Of Memory，内存不足）或监控数据丢失。

10. 单击 确定 。

配置 sudo 权限

请参考如下命令为相关指令配置免密执行 sudo：

#杀进程
Cmnd_Alias KILL_CMD = /bin/kill -9 *
#查看端口占用
Cmnd_Alias NETSTAT_CMD = /bin/netstat -ant
#动态修改 Agent 配置
Cmnd_Alias AGENT_CONFIG_UPDATE = /home/admin/ocp_agent*/bin/ocp_agentctl -c /home/admin/ocp_agent*/conf/agentctl.yaml config --update *
#重启 agent 进程
Cmnd_Alias AGENT_RESTART = /home/admin/ocp_agent*/bin/ocp_agentctl restart
#启动 agent 进程
Cmnd_Alias AGENT_START = /home/admin/ocp_agent*/bin/ocp_agentctl start
#删除目录
Cmnd_Alias RM_CMD = /bin/rm -rf */tmp/*, /bin/rm -rf */home/admin/ocp_agent*/*
#拷贝软件包
Cmnd_Alias CP_CMD = /bin/cp -r */tmp/* */home/admin/ocp_agent/pkg_store*
#RPM操作
Cmnd_Alias RPM_CMD = /bin/rpm *, /bin/rpm -Uvh *, /bin/rpm -e *
#下载软件包
Cmnd_Alias CURL_CMD = /usr/bin/curl -s -S -k -o /tmp/* *
# 校验文件
Cmnd_Alias SHA1SUM_CMD = /usr/bin/sha1sum *
# Agent 服务管理
Cmnd_Alias AGENT_SERVICE_CMD = /home/admin/ocp_agent*/bin/ocp_agentctl service start *, /home/admin/ocp_agent*/bin/ocp_agentctl service stop *

# debian 系统专用
test ALL=(ALL) NOPASSWD: /usr/bin/install -D * *
# debian 系统专用
test ALL=(ALL) NOPASSWD: /usr/bin/alien -k -i *
# debian 系统专用
test ALL=(ALL) NOPASSWD: /usr/bin/dpkg -P *

# 用户权限配置
test ALL=(ALL) NOPASSWD:KILL_CMD, NETSTAT_CMD, AGENT_CONFIG_UPDATE, AGENT_START, AGENT_RESTART, RM_CMD, CP_CMD, RPM_CMD, CURL_CMD, SHA1SUM_CMD, AGENT_SERVICE_CMD