Introduction to the PIM planner
What does it do?
- The PIM planner connects to the Abiquo kinton database and extracts the data for the PIM migrator tool.
- It doesn't make any changes to the platform
How do we install it?
- The abiquo-pim-tools package with the planner and migrator is part of the Abiquo 5.3 upgrade. Would they need to install it on a datanode
- The default install folder is /opt/abiquo/pim-tools.
What is the output?
- A log in standard output (you should redirect it to a file)
- A migration plan in ZIP format called migration-plan.data
Requirements
The PIM planner requires:
- Access to the MariaDB kinton schema via the JDBC URL.
- It encrypts the DB credentials at runtime and it does not export them to
Run the PIM planner
To run the PIM planner do these steps:
Before you run the PIM planner you MUST:
- Start the Abiquo upgrade to 5.3 as usual including
- Stop the Abiquo platform
- Create backups including snapshots, Database dump, and Redis dump
- Upgrade the database
- STOP the upgrade
- Log in to the Abiquo API Server
Run the PIM planner against your database Should they copy it to the DB server and run there.
Redirect the standard output of the PIM planner to a file should they use a .txt for easier viewing
For example:java -jar /opt/abiquo/pim-tools/pimplanner.jar --jdbc-url="jdbc:mysql://my.database.server:3306/kinton?autoReconnect=true&user=root&password=root" > output_pimplanner.log
The PIM planner will process each VM to:
- Compute the provider ID
- Define the rename of any backup jobs or groups
- Define the rename of any firewalls and load balancers
- Check the output file from the PIM planner
If there are any warnings or errors, resolve them before you continue. If you have any doubts, please contact Abiquo Support. - For ALL of your Remote Services servers
- Copy the migration-plan.data file to each of your Remote Services servers
- Copy the pimmigrator
PIM planner options
Option | Alias | Required | Description |
---|---|---|---|
jdbcurl | --jdbc-url | yes | Kinton JDBC URL including user and password |
-output | --output-file | no | The output file. The default is 'migration-plan.data' |