Versions Compared

Old Version 12

changes.mady.by.user MS

Saved on

compared with

New Version 13

changes.mady.by.user MS

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Warning

You must test this update in a lab environment before you run it in your production environment.

Before you upgrade to Abiquo 5.3 you must:

  1. Create a full backup of the platform
  2. Create dumps of the database and Redis.

...

PIM

...

processes

As part of the upgrade to Abiquo 5.3, do these steps

  1. Run In your lab environment, run the PIM tools in your lab environmentCreate a test systemas part of an upgrade test.
  2. On a test VM, add a dump of your production database, run liquibase to update the database to 5.3, and run the PIM planner. See Create a test VM and run PIM planner Run on a database dump 
  3. On your production system (during a quiet time), run the PIM migrator in dry-run mode on mode (this is the default mode)
  4. On your production systemPerform , perform the Abiquo upgrade, and after you update the database, stop the upgrade, run the PIM tools, and then continue the upgrade

...

  1. Perform the upgrade with the usual process, and after you update the database, run the PIM tools as described here.
  2. Run the PIM planner tool against your database. This tool will create a migration plan for all of your VMs and list the required migration steps. 
  3. Check the migration planthe output of the planner tool. If there are any warnings or errors, resolve them and then run the PIM planner again.
  4. For ALL Remote Services servers, copy the migration plan to the server.
  5. On each Remote Services server, run the migration plan. 
    (tick) By default the PIM migrator tool will run in "dry run" mode. For each entity in the migration plan, the PIM migrator tool will connect to the provider and compute the provider ID.
  6. Check the output of the PIM migrator tool. If there are any warnings or errors, resolve them and then run the PIM planner and PIM migrator again (question)
  7. Run the PIM migrator tool in update mode with the "--no-dry-run" option.
    1. The PIM migrator tool will update VMs, as well as backup jobs, firewalls, load balancers, (question).
    2. The PIM migrator tool will output an SQL update file.
  8. While the Abiquo platform is still stopped, run the migrator's SQL update file.
    (info) The SQL update will issue warnings if you run it with Java 8
  9. After you complete the migration and restart your environment, check it as described below

...

To run the PIM tools on the dump of your production database, you will need:

  • Docker or VM with the same MySQL version
  • Dump A dump of your production database
  • Abiquo RPMs
    • Abiquo PIM tools package
    • Abiquo model package

See Create a test VM and run PIM planner on a database dump

Check your environment

The migration should only change the identification of deployed VMs in Abiquo. After you migrate to provider ID, you can perform the following checks: 

...