FAQ

How do I specify the version of the component to use?

You can use a version declaration in the deployment configuration file. For example, if you are using OceanBase-CE 3.1.0, you can specify the following configuration:

oceanbase-ce:
  version: 3.1.3  # Specify the version

You can use the following commands to obtain the component version based on your deployment method (offline or online).

• For online deployment, use the following command to obtain the component version. The version in the output is the version number.

  obd mirror list oceanbase.community.stable
  

• For offline deployment, use the following command to obtain the component version. The version in the output is the version number.

  obd mirror list local
  

How do I specify a specific version of the component?

You can use package_hash or tag in the deployment configuration file. If you have set a tag for your self-compiled OceanBase-CE, you can use tag to specify it. For example:

oceanbase-ce:
  tag: my-oceanbase

You can also use package_hash to specify a specific version.

oceanbase-ce:
  package_hash: 589c4f8ed2662835148a95d5c1b46a07e36c2d346804791364a757aef4f7b60d

You can use the following commands to obtain the component package hash based on your deployment method (offline or online).

• For online deployment, use the following command to obtain the component package hash. The md5 value in the output is the package_hash.

  obd mirror list oceanbase.community.stable
  

• For offline deployment, use the following command to obtain the component package hash. The md5 value in the output is the package_hash.

  obd mirror list local
  

What should I do if I modify the code of OceanBase-CE and need to modify the startup process?

You can modify the startup-related plugins in the ~/.obd/plugins/oceanbase-ce/ directory. For example, if you add a new startup configuration for OceanBase-CE 3.1.0, you can modify the ~/.obd/plugins/oceanbase-ce/3.1.0/start.py file.

How do I update the local image of obd in offline mode?

If the machine where you installed obd cannot connect to the public internet, but you need to update obd or other components, you can follow these steps:

1. Download the required RPM package on a machine that can connect to the public internet.

2. Copy the RPM package to the machine where obd is installed.

3. Use the obd mirror clone command to add the new RPM package to the local mirror.

Here is an example of updating the local image of obd:

# First, download the latest RPM package of obd on a machine that can connect to the public internet.
# The latest RPM package link can be found in the release notes of the corresponding component's Git repository or on the OceanBase Open Source website (https://open.oceanbase.com/softwareCenter/community).
wget https://github.com/oceanbase/obdeploy/releases/download/vx.x.x/ob-deploy-x.x.x-xxx.rpm
# Copy the downloaded RPM package to the machine where obd is installed (obd_server).
sh ob-deploy-x.x.x-xxx.rpm obd_server:~
# Add the downloaded image to the local mirror.
obd mirror clone ob-deploy-x.x.x-xxx.rpm
# Disable the remote mirror source.
obd mirror disable remote

How do I resolve the issue where ODP service cannot be started after obd upgrade?

After obd is upgraded, the password of ODP is initialized. If you have set obproxy_sys_password, you need to execute the following command to connect to proxysys:

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

Then, use the command alter proxyconfig set obproxy_sys_password = '' to set the proxysys password to an empty string, or make it consistent with the password in the configuration file's obproxy_sys_password.

How do I configure the Java environment?

Log in to the machine where you want to configure the Java environment and install the Java environment based on the machine's network connectivity.

Online installation

On CentOS or RedHat systems, execute the following commands:

sudo yum install java-1.8.0-openjdk 

On Ubuntu or Debian systems, execute the following commands:

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

Offline installation

1. Click the x86_64 architecture and arm architecture links to download the required installation package.

2. Upload the downloaded installation package to the corresponding machine and execute the following commands in the directory where the installation package is located to decompress and install it.

   # Decompress the resource package
   tar -zxvf Alibaba_Dragonwell_Extended_8*.tar.gz
   # Enter the decompressed directory
   cd dragonwell*
   # Create a symbolic link
   ln -s `pwd`/bin/java /usr/bin/java
   

How do I manage the original metadb cluster after upgrading OCP using obd?

After upgrading OCP using obd, if you want to use obd to manage the original OCP's metadb cluster, you can copy the information of the original metadb cluster to the obd directory. The command is as follows:

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

Here, metadb_cluster_name represents the name of the original metadb cluster, which you need to replace based on your actual situation.

What should I do if I cannot use obd properly after installing it on a machine that already has OceanBase All in One installed?

If you encounter the following prompt when installing obd using the obd RPM package on a machine that already has OceanBase All in One installed:

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.

To ensure the normal use of obd, it is recommended to execute the command in the current user environment to modify the OBD_INSTALL_PRE value:

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