---
title: "添加主机 | OceanBase 文档中心"
description: 添加主机 本页面为您介绍添加主机的操作步骤，添加主机操作旨在于将线下设备添加到 OCP 控制台中。 前提条件 当前登录用户需要具备主机管理权限。 若您需要自定义 agent 的安装目录及端口，可在 系统参数管理 中对以下参数进行修改。 agent 安装目录系统参数： ocp.agent.home.path.prefi…
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*lJTmRZ61jSUAAAAAAAAAAAAADiGDAQ/original) 云平台 OCPV 4.0.3 企业版

# 添加主机

更新时间：2023-08-16 15:51:32

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

## 前提条件

- 当前登录用户需要具备主机管理权限。
 - 若您需要自定义 agent 的安装目录及端口，可在 [系统参数管理](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-10000000001542006) 中对以下参数进行修改。

     - agent 安装目录系统参数：`ocp.agent.home.path.prefix`。
     - agent 启动端口系统参数：`ocp.agent.manager.http.port`、`ocp.agent.monitor.http.port`。

  参数修改成功后约 3 分钟即可生效，您需待参数生效后再进行添加主机操作。

## 操作步骤

1. 登录 OCP。
 2. 在左侧导航栏中单击 **主机** **。**
 3. 在页面右上角单击 **添加主机** 。

   ![05191443](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/401/host-list.png)
 4. 填写 **IP 地址** 和 **SSH 端口号** 。输入新主机的 IPv4 地址，SSH端口号默认 22。
 5. 选择机型。如果没有对应的机型，可以单击新增机型，立即在 OCP 中新增机型。

   机型是用户为配置相同的主机指定的一个标签，建议用户指定有意义的名称，便于更好地管理主机。

   ![1725](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/5295987361/p358646.png)
 6. 选择机房。如果没有对应的机房，可以单击新增机房，立即在 OCP 中新增机房。

      - 区域用于表示主机所处的地理区域，一个物理区域下可以存在一个或多个物理机房。
      - 区域和机房是 OceanBase 负载均衡和 SQL 语句路由策略的参考项，请按照实际情况填写。

#### 说明

OCP V3.1.1 版本开始支持多可用区模式，新增机房时，将在当前 OCP 所在的可用区中创建新的机房。

![1726](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/5295987361/p358647.png)

7. 在 **选择凭据** 列表中选择主机的登录凭据。

   ![1728](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/5295987361/p358649.png)

   | 参数 | 说明 |
   | --- | --- |
   | 凭据名 | 以英文字母开头、英文或数字结尾，可包含英文、数字和下划线，且长度为 2 ~ 32 |
   | 授权类型 | 包含用户名/密码和 SSH 私钥两种方式。 |
   | 用户类型 | 支持拥有 ROOT 权限的 SSH 用户，拥有 ROOT 权限的普通用户须先配置免密执行 sudo 指令。OCP 目前仅支持配置所有指令免密执行 sudo，即在 /etc/sudoers 文件中，添加 `username ALL=(ALL) NOPASSWD:ALL`。 |
 8. （可选）填写主机说明。
 9. 单击 **确定** 。

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线
