Versions Compared

Key

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

...

  • An SQL file to run on the kinton database
  • A log in standard output (you should redirect it to a file)

Requirements

The PIM migrator requires the following.

...

Warning

Before you run the PIM migrator you MUST:

  1. Start the Abiquo upgrade to 5.3 as usual including
    1. Stop the Abiquo platform
    2. Create backups including snapshots, Database dump, and Redis dump
  2. Upgrade the database
  3. STOP the upgrade
  4. Run the PIM planner and obtain the migration plan

Run the PIM migrator

Log in to ALL to ALL Remote Services Servers and do these steps on EACH server:.

  1. Install the PIM tools

    Code Block
    yum install abiquo-pim-tools

    The default install folder is /opt/abiquo/pim-tools

  2. Obtain the datacenter-id of the Remote Services server from the value of the abiquo.datacenter.id property in the abiquo.properties file.

    Code Block
    abiquo.datacenter.id=abq_dc1

    In this case, the value of the datacenter-id parameter will be "abq_dc1"

  3. Run the PIM migrator.

    We recommend that you save the log in standard output to a file. And we recommend that you give the output files names that will identify the Remote Services server.

    For example:

    Code Block
    java -jar /opt/abiquo/pim-tools/pimmigrator.jar -dc=abq_dc1 -redishost=localhost -plan=migration-plan.data -noseed -output=update_DC1.sql > pimmigrator_DC1.log


  4. Check the output file. If there are any errors or warnings, resolve them.
    If necessary, contact Abiquo Support.
  5. Copy the SQL file from the Remote Services server to the Abiquo database server.

    For example

    Code Block
    scp update_DC1.sql root@my.database.server:~/


...

  1. Update the Abiquo database with all of the update.sql files


    Code Block
    mysql kinton < update_DC1.sql
    mysql kinton < update_DC2.sql


Now continue with the Abiquo upgrade

PIM migrator options

Option

Alias

Required

Description

-dc

--datacenter-id

yes

ID of the current datacenter to migrate

-nodry

--no-dry-run

no

Set to 'true' in order to perform the changes (default: false)

-noseed

--no-seed

no

Don't use seed file, ignores seed property value (default: false)

-output

--output-file

no

SQL output file (by default 'update.sql')

-plan

--migration-plan-file

yes

Migration plan data file

-redishost

--redis-host

yes

Redis server host for this datacenter

-redisport

--redis-port

no

Redis server port for this datacenter (by default 6379)

-seed

--seed-file

no

Seed file (by default '/etc/abiquo/.store')


PIM migrator notes

The migrator does not process the following providers.

...