Migrate to v3

Migrate from OIBus v1 and v2 into the new OIBus v3 version with our migration tool and a few manuel steps.

Download link

Windows

OIBus migration tool

Windows (x64)

Linux

OIBus migration tool

Linux (x64)

MacOS

OIBus migration tool

macOS (Intel chip)

Download specific version

OIBus version

The migration will work only with the 3.3.1 OIBus version. If you want to migrate to a later version, first install OIBus v3.3.1 from one of the links below, and then update OIBus from v3.3.1 to a later version.

Windows

OIBus v3.3.1 (installer)

Windows (x64)

OIBus v3.3.1 (zip)

Windows (x64)

Installation

Linux

OIBus v3.3.1

Linux (x64)

Installation

MacOS

OIBus v3.3.1

MacOS (Intel chip)

Installation

Migration steps

1. Stop the OIBus service.

提示

You can zip the data folder, or at least the configuration file oibus.json and its keys as a backup.

2. Install OIBus v3.3.1. Be careful to specify the same data folder. Check that OIBus v3 run properly by login on http://localhost:2223 with admin / pass. If everything works, go on with the next step.

3. Stop OIBus v3.

4. Copy the migration tool in the OIBus binary folder.

5. Run the OIBus migration tool. Be sure to specify the appropriate data folder.

./oibus-upgrade --config ./data-folder

./build/bin/macos-arm64/oibus-upgrade --config ./data-folder

6. Start OIBus v3.

提示

The file upgrade-journal.log contains the logs of the migration.