Upgrade obd

You can upgrade OceanBase Deployer (obd) online or offline, depending on whether your obd server can connect to the Internet.

Background information

Generally, you can install obd by using the OceanBase All in One package or an RPM package. The upgrade method varies based on the installation method.

• If obd is installed by using the OceanBase All in One package, we recommend that you upgrade obd by referring to the Upgrade the OceanBase All in One package section in Install obd.

• If obd is installed by using an RPM package, we recommend that you upgrade obd by using the obd update command, which is described in this topic.

Online upgrade

If your obd server can connect to the Internet, you can perform the following steps to upgrade obd. An online upgrade automatically upgrades obd to the latest version. If you want to upgrade to a specific version, download the corresponding installation package and follow the steps in the Offline upgrade section.

1. Enable remote image repositories.

   obd mirror enable remote
   

   After the preceding command is successfully executed, you can run the obd mirror list command to confirm whether the remote image repositories are enabled. The output is as follows, where if the values of the remote image repositories in the Enabled column are True, the remote image sources are enabled.

   +-----------------------------------------------------------------------------+
   |                            Mirror Repository List                           |
   +----------------------------+--------+---------+----------+------------------+
   | SectionName                | Type   | Enabled | Available| Update Time      |
   +----------------------------+--------+---------+----------+------------------+
   | local                      | local  | -       | True     | 2025-03-25 13:48 |
   | oceanbase.community.stable | remote | True    | True     | 2025-03-25 13:48 |
   | oceanbase.development-kit  | remote | True    | True     | 2025-03-25 13:48 |
   +----------------------------+--------+---------+----------+------------------+
   

2. Upgrade obd.

   obd update
   

3. Verify the obd version.

   obd --version
   

   The output is as follows, indicating that obd has been upgraded to V3.1.2.

   OceanBase Deploy: 3.1.2
   REVISION: 739be300c448342b2850c71087bee01091dd7cb7
   BUILD_BRANCH: HEAD
   BUILD_TIME: Feb 14 2025 14:43:32OURCE
   Copyright (C) 2025 OceanBase
   License Apache 2.0: Apache version 2 or later <https://www.apache.org/licenses/LICENSE-2.0>.
   This is free software: you are free to change and redistribute it.
   There is NO WARRANTY, to the extent permitted by law.
   

Offline upgrade

If your obd server cannot connect to the Internet, download the desired installation package of obd from OceanBase Download Center and upload it to the server. In the directory where the installation package is located, perform the following steps to upgrade obd:

1. Upload the installation package to the local image repository.

   obd mirror clone ob-deploy-*.rpm
   

   After the preceding command is executed, you can run the obd mirror list local | grep ob-deploy command to query the installation package in the local image repository. The output is as follows:

   | ob-deploy  | 3.1.2   | 1.el7   | x86_64 | 75a9be0ab6bd723754febe30970a27fd52c5cdd7 |
   

2. Disable remote image repositories.

   obd mirror disable remote
   

   After the preceding command is executed, you can run the obd mirror list command to confirm whether the remote image repositories are disabled. The output is as follows, where if the values of the remote image repositories in the Enabled column are False, the remote image sources are disabled.

   +-----------------------------------------------------------------------------+
   |                            Mirror Repository List                           |
   +----------------------------+--------+---------+----------+------------------+
   | SectionName                | Type   | Enabled | Available| Update Time      |
   +----------------------------+--------+---------+----------+------------------+
   | local                      | local  | -       | True     | 2025-03-25 14:04 |
   | oceanbase.community.stable | remote | False   | False    | 2025-03-25 13:53 |
   | oceanbase.development-kit  | remote | False   | False    | 2025-03-25 13:53 |
   +----------------------------+--------+---------+----------+------------------+
   

3. Upgrade obd.

   obd update
   

4. Verify the obd version.

   obd --version
   

   The output is as follows, indicating that obd has been upgraded to V3.1.2.

   OceanBase Deploy: 3.1.2
   REVISION: 739be300c448342b2850c71087bee01091dd7cb7
   BUILD_BRANCH: HEAD
   BUILD_TIME: Feb 14 2025 14:43:32OURCE
   Copyright (C) 2025 OceanBase
   License Apache 2.0: Apache version 2 or later <https://www.apache.org/licenses/LICENSE-2.0>.
   This is free software: you are free to change and redistribute it.
   There is NO WARRANTY, to the extent permitted by law.