使用命令行部署 OCP

步骤一：创建配置文件

执行如下命令创建配置文件，此处以 distributed-ocp.yaml 为例，您可自定义配置文件名。

vim distributed-ocp.yaml

步骤二：修改配置文件

1. 修改用户信息

   您可复制如下内容，根据自身实际场景进行修改。

   ## Only need to configure when remote login is required
   user:
     username: admin
   #   password: your password if need
     key_file: /home/admin/.ssh/id_rsa
   #   port: your ssh port, default 22
   #   timeout: ssh connection timeout (second), default 30
   

   username 为登录到目标机器的用户名，确保您的用户名有家目录的写权限。password 和 key_file 均用于验证用户，通常情况下只需要填写一个。

   注意

   在配置秘钥路径后，如果您的秘钥不需要口令，请注释或者删除 password，以免 password 被视为秘钥口令用于登录，导致校验失败。

2. 修改 OceanBase 数据库配置

   您可复制如下内容，根据自身实际场景进行修改。

   oceanbase-ce:
     version: 4.2.1.8
     # release: 100000242024032211.el7
     # package_hash: c4a03c83614f50c99ddb1c37dda858fa5d9b14b7
     servers:
       - name: server1
         ip: 10.10.10.1
       - name: server2
         ip: 10.10.10.2
       - name: server3
         ip: 10.10.10.3
     global:
       appname: obcluster
       cluster_id: 1711955629
       mysql_port: 2881
       rpc_port: 2882
       home_path: /home/admin/oceanbase
       data_dir: /home/admin/oceanbase/data
       redo_dir: /home/admin/oceanbase/redo
       obshell_port: 2886
       scenario: htap
       memory_limit: 64G
       system_memory: 30G
       log_disk_size: 192G
       datafile_size: 192GB
       ocp_meta_tenant:
         tenant_name: ocp_meta
         max_cpu: 2.0
         memory_size: 4G
       ocp_meta_username: root
       ocp_meta_password: ********
       ocp_meta_db: meta_database
       ocp_monitor_tenant:
         tenant_name: ocp_monitor
         max_cpu: 2.0
         memory_size: 8G
       ocp_monitor_username: root
       ocp_monitor_password: ********
       ocp_monitor_db: monitor_database
       proxyro_password: ********
       root_password: ********
       enable_syslog_recycle: true
       enable_syslog_wf: false
       max_syslog_file_count: 4 
       cpu_count: 20
     server1:
       zone: zone1
     server2:
        zone: zone2
     server3:
        zone: zone3
   

   OceanBase 数据库的配置项详细介绍可参见 配置文件说明 中 配置项说明，OCP 相关的配置项如下：

   配置项	是否必选	默认值	修改后生效方式	说明
   ocp_meta_tenant	必选	tenant_name: meta_tenant max_cpu: 1 memory_size: 2147483648	重新部署	OCP 元信息租户信息。 tenant_name：设置 OCP 元信息租户的租户名。 max_cpu：为 OCP 元信息租户分配的最大 CPU。 memory_size：为 OCP 元信息租户分配的内存容量。
   ocp_meta_username	可选	meta	重启进程	连接 OCP 元信息租户的用户名。
   ocp_meta_password	必选	oceanbase	重启进程	ocp_meta_username 对应用户名的密码。
   ocp_meta_db	可选	meta_database	重新部署	存放 OCP 元信息的 database 名。
   ocp_monitor_tenant	必选	tenant_name: monitor_tenant max_cpu: 1 memory_size: 2147483648	重新部署	OCP 监控数据租户信息。 tenant_name：设置 OCP 监控数据租户的租户名。 max_cpu：为 OCP 监控数据租户分配的最大 CPU。 memory_size：为 OCP 监控数据租户分配的内存容量。
   ocp_monitor_username	可选	monitor_user	重启进程	连接 OCP 监控数据租户的用户名。
   ocp_monitor_password	必选	oceanbase	重启进程	ocp_monitor_username 对应用户名的密码。
   ocp_monitor_db	可选	monitor_database	重新部署	存放 OCP 监控数据的 database 名。

3. 修改 ODP 配置

   您可复制如下内容，根据自身实际场景进行修改。配置项的具体含义可参见 配置文件说明 中 配置项说明。

   obproxy-ce:
     # version: 4.2.3.0
     # package_hash: 7ca6c000887b90db111093180e6984bf4cf8f7380a948870f3eb2ac30be38f37
     # release: 3.el7
     depends:
       - oceanbase-ce
     servers:
       - 10.10.10.1
     global:
       home_path: /home/admin/obproxy
       prometheus_listen_port: 2884
       listen_port: 2883
       obproxy_sys_password: ********
       skip_proxy_sys_private_check: true
       enable_strict_kernel_release: false
       enable_cluster_checkout: false
       proxy_id: 5150
       client_session_id_version: 2
   

4. 修改 OCP 配置

   您可复制如下内容，根据自身实际场景进行修改。配置项的具体含义可参见 配置文件说明 中 配置项说明。

   注意

   依赖 OceanBase 数据库部署 OCP 时，obd 会依赖 OceanBase 数据库组件下的配置获取 OCP 元数据库的信息，此时配置 jdbc_xxx 这三个配置项会报错。

   ocp-server-ce:
     # version: 4.2.2
     # package_hash: 84a65bf0ec004e73b772938696b2b896a0ef2b2f
     # release: 20240315150922.el7
     depends:
       - oceanbase-ce
       - obproxy-ce
     servers:
       - 10.10.10.1
     global:
       home_path: /home/admin/ocp
       soft_dir: /home/admin/ocp/software
       log_dir: /home/admin/ocp/logs
       ocp_site_url: http://10.10.10.1:8080
       port: 8080
       admin_password: ********
       memory_size: 8G
   

步骤三：部署 OCP

1. 部署 OCP

   obd cluster deploy ocp -c distributed-ocp.yaml
   

   命令里的 ocp 为集群名，您可根据实际情况自定义集群名。部署成功后命令行会输出对应的启动命令，输出如下：

   ocp deployed
   Please execute ` obd cluster start ocp ` to start
   Trace ID: 990e7dba-0223-11ef-ab25-00163e0808cc
   If you want to view detailed obd logs, please run: obd display-trace 990e7dba-0223-11ef-ab25-00163e0808cc
   

2. 启动 OCP

   obd cluster start ocp
   

   启动成功后会输出集群的相关信息，输出如下：

   +-------------------------------------------------+
   |                     observer                    |
   +---------------+---------+------+-------+--------+
   | ip            | version | port | zone  | status |
   +---------------+---------+------+-------+--------+
   | 10.10.10.1    | 4.2.1.8 | 2881 | zone1 | ACTIVE |
   | 10.10.10.2    | 4.2.1.8 | 2881 | zone2 | ACTIVE |
   | 10.10.10.3    | 4.2.1.8 | 2881 | zone3 | ACTIVE |
   +---------------+---------+------+-------+--------+
   obclient -h10.10.10.1 -P2881 -uroot -p'********' -Doceanbase -A
   
   +-------------------------------------------------+
   |                     obproxy                     |
   +---------------+------+-----------------+--------+
   | ip            | port | prometheus_port | status |
   +---------------+------+-----------------+--------+
   | 10.10.10.1    | 2883 | 2884            | active |
   +---------------+------+-----------------+--------+
   obclient -h10.10.10.1 -P2883 -uroot@proxysys -p'********' -Doceanbase -A
   
   +----------------------------------------------------------+
   |                      ocp-server-ce                       |
   +---------------------------+----------+----------+--------+
   | url                       | username | password | status |
   +---------------------------+----------+----------+--------+
   | http://10.10.10.1:8080    | admin    | ******** | active |
   +---------------------------+----------+----------+--------+
   ocp running