Opereto provides two mechanisms for upgrade: software updates and box migration. A software update is a new version of the opereto server software running on a given server. The upgrade replaces the old software version with a new one but makes no changes in the server (virtual appliance) configuration or operating system configuration and libraries. Box migration is a replacement of the old virtual appliance with a new one. In box migration, we export the old configuration and metadata from the old virtual appliance to an external storage (e.g. AWS S3) and after starting the new virtual appliance, we import the data from the external storage.
Opereto version string is based on 4 digits, for instance, 18.104.22.168. The first two digits identify the server configuration (operating system, libraries, database structure etc.) whereas the last two digits identify the software.
|Box Major Release||Box Minor Release||Software Release||Software Build|
Software upgrades always refer to the same box, so in software upgrades, the first two digits of the old version upgrading from and the new version are the same. For instance, upgrade from 22.214.171.124 to 126.96.36.199 or from 188.8.131.52 to 184.108.40.206. In box migration, at least one of the first two digits of the old and new versions is different. For instance, migrating from 220.127.116.11 to 18.104.22.168.
You can learn about newer software of box versions available by clicking on Support-->Check Updates (must be an admin for that). In addition, when software new versions are available, the following icon will be presented in the user interface (again, visible to admins only): Clicking on the icon pops up the upgrade information.
Updating the software is fairly simple. To update to the latest version, connect to your server via ssh (login with user opereto and your private ssh key) and run:
>/operetoadmin upgrade Version to install: 22.214.171.124 Upgrade installation? Enter 'y' to continue:
Please note that the upgrade process may take a few minutes and during that time the server will be down. You can revert to your old version or change to any other version by specifying the version string as follows:
## revert to previous installation >/operetoadmin upgrade --revert ## install a specific version >/operetoadmin upgrade --opereto-version=126.96.36.199
For server migration, you must have a shared storage for micro services and export/import data. If you did not configure your current server to work with remote storage, you may learn how to do it in the following article: Customizing your opereto server
Step 1: Launch a new server instance
Step 2: Configure the new server to work with the shared storage as the old server does (basically, follow the steps of the customization article mentioned above).
Step 3: Export the data from the old server and import to the new one
curl -k -u user:pass -X POST -H "Content-Type: application/json" https://OLD_SERVER/export curl -k -u user:pass -X POST -H "Content-Type: application/json" https://NEW_SERVER/import
- opereto does not export/import processes data. If you need an access to your old processes and logs, you may keep your old server running
- export operation requires admin privileges
- import operation requires both admin privileges but also must be done by user admin only
Step 4: Shut down your old server (we do not recommend to terminate it, keep it for a while for rollback if needed or to keep/access old processes and logs).