常见问题

如何指定使用组件的版本？

您可在部署配置文件中使用版本声明。例如，如果您使用的是 OceanBase-CE 3.1.0 版本，可以指定以下配置：

oceanbase-ce:
  version: 3.1.3  # 指定版本

您可根据部署方式（离线或在线）的不同，通过如下命令获取组件的版本。

• 在线部署时，获取组件版本的命令如下，输出中的 version 即为版本号。

  obd mirror list oceanbase.community.stable
  

• 离线部署时，获取组件版本的命令如下，输出中的 version 即为版本号。

  obd mirror list local
  

如何指定使用特定版本的组件？

您可在部署配置文件中使用 package_hash 或 tag 声明。 如果您给自己编译的 OceanBase-CE 设置了 tag，您可以使用 tag 来指定。如：

oceanbase-ce:
  tag: my-oceanbase

您也可以通过 package_hash 来指定特定的版本。

oceanbase-ce:
  package_hash: 589c4f8ed2662835148a95d5c1b46a07e36c2d346804791364a757aef4f7b60d

您可根据部署方式（离线或在线）的不同，通过如下命令获取组件软件包 hash。

• 在线部署时，获取组件软件包 hash 的命令如下，输出中的 md5 值即为 package_hash。

  obd mirror list oceanbase.community.stable
  

• 离线部署时，获取组件软件包 hash 的命令如下，输出中的 md5 值即为 package_hash。

  obd mirror list local
  

我修改了 OceanBase-CE 的代码，需要修改启动流程怎么办？

您可修改 ~/.obd/plugins/oceanbase-ce/ 下的启动相关插件。比如您为 3.1.0 版本的 OceanBase-CE 添加了一个新的启动配置，可以修改 ~/.obd/plugins/oceanbase-ce/3.1.0/start.py。

如何在离线模式下更新 obd 本地镜像？

当您安装 obd 的机器不能连接公网，却需要更新 obd 或其他组件时，您可按以下步骤进行操作：

1. 在一台可以连通公网的机器下载好您需要的 RPM 包。

2. 将 RPM 包拷贝到安装有 obd 的机器中。

3. 通过 obd mirror clone 命令将新的 RPM 包加到 local mirror 中。

此处以更新本地仓库中的 obd 镜像为例：

# 先在一台可以连通公网的机器上下载 obd 最新的 RPM 包
# 最新的 RPM 包链接可以在对应的组件的 git 仓库中的 release note 或 OceanBase 开源官网（https://open.oceanbase.com/softwareCenter/community）中获得
wget https://github.com/oceanbase/obdeploy/releases/download/vx.x.x/ob-deploy-x.x.x-xxx.rpm
# 将下载好的 RPM 包拷贝到安装有 obd 的机器（obd_server）上
sh ob-deploy-x.x.x-xxx.rpm obd_server:~
# 将下载好的镜像加入到 local 中
obd mirror clone ob-deploy-x.x.x-xxx.rpm
# 关闭远程镜像源
obd mirror disable remote

obd 升级后无法启动 ODP 服务如何解决？

obd 升级后会初始化 ODP 的密码，若您设置了 obproxy_sys_password，则需执行如下命令连接到 proxysys：

obclient -h<obproxy_ip> -uroot@proxysys -P<obproxy_port> -p<obproxy_pwd>

之后使用命令 alter proxyconfig set obproxy_sys_password = '' 将 proxysys 的密码设置为空，或者使其与配置文件中 obproxy_sys_password 的密码保持一致。

如何配置 Java 环境？

您可登录到需配置 Java 环境的机器，根据该机器的联网情况，参考如下方式安装 Java 环境。

在线安装

在 CentOS 或 RedHat 系统上，执行如下命令安装：

sudo yum install java-1.8.0-openjdk 

在 Ubuntu 或 Debian 系统上，执行如下命令安装：

sudo apt-get update
sudo apt-get install openjdk-8-jre

离线安装

1. 单击部署所需安装包 x86_64 架构，arm 架构。

2. 将下载的安装包上传至对应机器，并在安装包所在目录下执行如下命令解压安装。

   # 解压资源包
   tar -zxvf Alibaba_Dragonwell_Extended_8*.tar.gz
   # 进入解压后的目录
   cd dragonwell*
   # 创建软连
   ln -s `pwd`/bin/java /usr/bin/java
   

使用 obd 升级 OCP 后，如何管理原 metadb 集群？

使用 obd 升级 OCP 后，若您想使用 obd 管理原 OCP 的 metadb 集群，您可将原 metadb 集群的信息复制到 obd 目录下即可，命令如下：

cp -rf ~/.ocp-installer/cluster/<metadb_cluster_name> ~/.obd/cluster/

其中，metadb_cluster_name 表示原 metadb 集群的名称，您需根据实际情况替换。

安装 OceanBase All in One 后安装 OBD，无法正常使用怎么办？

若您在已经安装了 OceanBase All in One 的情况下，通过 obd RPM 包安装 obd 时出现如下提示：

Detected residual environment variables of oceanbase-all-in-one in the system. Please execute `rm -rf ~/.obd/version && rm -rf ~/.oceanbase-all-in-one/obd && obd env set OBD_INSTALL_PRE / ` under the user who installed all-in-one and rerun.

为不影响 obd 的正常使用，建议在当前用户下执行提示中的命令修改 OBD_INSTALL_PRE 值：

rm -rf ~/.obd/version && rm -rf ~/.oceanbase-all-in-one/obd && obd env set OBD_INSTALL_PRE /