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
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
On the Abiquo API Server, install the Abiquo PIM tools package
yum install abiquo-pim-tools
By default, it should install in the /opt/abiquo/pim-tools folder
Run the PIM planner against your database. 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 Remote Services servers
- Copy the migration-plan.data file to each Remote Services server
- Follow the instructions to run the PIM migrator on each Remote Services server
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' |