Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Code blocks removed from expand sections, expand sections removed

...

This section describes how to upgrade from Abiquo 5.2.0 or above to an Abiquo 5.4.x version. Please contact Abiquo Support for further information.

Table of Contents

 


Numberedheadings
start-numbering-ath2


This is a non-official upgrade document from which you can easily cut and paste the commands for each to prepare your own upgrade document.

  • The official upgrade document, that you must read and refer to for your upgrade is still

Abiquo YUM repositories are no longer open, please contact Abiquo Support to obtain your credentials

This upgrade process starts from Abiquo 5.4.0 or above. To upgrade from earlier versions, please see


false
  • The upgrade will overwrite lang_en_US.json. If you have customized labels or translations, back them up before the upgrade and restore them afterwards accordingly.
  • The upgrade will overwrite the SAML login configuration for multiple IdPs. If you use SAML with multiple IdPs, back up the configuration files before the upgrade and add the multiple IdPs afterwards accordingly. See


The upgrade to Abiquo 5.3 includes a migration to provider ID as the identifier of a deployed VM.

See

Prepare the provider ID migration before your upgrade. See


Prevent cloud users from performing VM operations

  1. In the UI in the Infrastructure view, select each physical machine and click Disable
  2. Using the API, set the state of each physical machine to DISABLED





API Servers

On each API Server do these steps. If you have a separate DB server, do the DB upgrade steps on that server.

API Server upgrade procedure

Additional API and UI upgrade steps

  1. Add translations for new to lang_xx_XX_custom.json. See

  2. Optionally add new configuration to client-config-custom.json. See Configure Abiquo UI

  3. In your UI configuration, check that the API endpoint is pointing to your Abiquo API server:

    {
        "config.endpoint""http://<API_IP_ADDRESS>/api"
    }


  4. Add new API properties to the abiquo.properties file found in the /opt/abiquo/config/ folder. See Changes to Abiquo Configuration Properties

  5. If you are using SAML with multiple IDPs, restore the configuration as described at Restore SAML security beans after upgrade.




Remote Services Servers

On each Remote Services Server do these steps

Remote Services Server upgrade procedure



Additional RS upgrade steps

  1. Add new RS properties to the abiquo.properties file found in the /opt/abiquo/config/ folder. See Changes to Abiquo Configuration Properties




Monitoring Servers

On each Watchtower Moniitoring Server do these steps

Monitoring Server upgrade procedure








Start Abiquo server and services

Start all servers in the correct order.

Start Abiquo servers procedure





Reporting server

To upgrade the Abiquo Reports Server for the upgrade to Abiquo 5.3.x, contact Abiquo Support for more information.

  1. The Abiquo Reports Server now runs with JasperReports v7.8.0

...