Upgrade Procedure

Start by pulling in the latest trustbuilder-appliance installation package:


# sudo yum update trustbuilder-appliance


After that you configure the version of TB you want to install.

Modify the file /opt/trustbuilder/appliance/config/environment.yml

To install 9.2 your file should look like the example below:

- hosts: localhost
  become: yes
  roles:
    - { role: environment,
        tb_repo: "production",
        tb_version: "9",
        tb_version_major: "2",
        tb_version_minor: "0",
        update_packages: true
      }

If you don't want to upgrade all the packages (non-trustbuilder) to this version immediately set upgrade_packages to false.

Run the environment.yml file as trustbuilder user

ansible-playbook -v  /opt/trustbuilder/appliance/config/environment.yml


Verify the folder /etc/yum.repos.d only contains the files: 

trustbuilder-epel-centos-custom.repo and trustbuilder.repo


Now you can re-run your playbook that you used to install the appliances.

# cd /opt/trustbuilder/appliance/config

# ansible-playbook -v my-playbook.yml

The database role can sometimes be unstable for clustered environments. You can leave this role out of the playbook when running an upgrade.

In rare cases it could be that the Gateway Service will not start. The root cause can be found by executing the following command:

sudo systemctl status tb-gw-default


or 'sudo systemctl status tb-gw-{your-instance-id}' in case you specified a custom instance id for your gateway

Any errors need to be fixed manually and then you can rerun the ansible-playbook again.

If everything runs correctly TrustBuilder should be up and running.

All that is left now is to update the database scheme of idhub. You can do this by accessing https://your-hostname/idhub/install

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments

0 comments

Please sign in to leave a comment.