Table of contents
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.
- In the UI in the Infrastructure view, select each physical machine and click Disable
- Using the API, set the state of each physical machine to DISABLED
2. 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
# Log in as root
sudo su -
# Check that the Abiquo RabbitMQ queues are empty (API or Datanode).
# The number of messages in all queues must be 0.
# rabbitmqctl list_queues messages name
# Back up the UI
tar cvfz /var/www/html/ui.tgz-$(date +%Y%m%d_%H%M%S) /var/www/html/ui
# Back up the /opt/abiquo folder
tar cvfz /opt/abiquo.tgz-$(date +%Y%m%d_%H%M%S) /opt/abiquo
# Back up Redis
redis-cli save
cp -a /var/lib/redis /var/lib/redis-$(date +%Y%m%d_%H%M%S)
# On DB Server, back up the Abiquo MySQL DBs
mysqldump --routines --triggers kinton > kinton.sql-$(date +%Y%m%d_%H%M%S)
mysqldump --routines --triggers kinton_accounting > kinton_accounting.sql-$(date +%Y%m%d_%H%M%S)
# IF you are using SAML with multiple IdPs, backup security beans files
cp
/opt/abiquo/tomcat/webapps/api/WEB-INF/classes/springresources/security/saml/security-saml-generated-beans.xml /opt/abiquo/tomcat/webapps/api/WEB-INF/classes/springresources/security/saml/security-saml-generated-beans.xml-$(date
+%Y%m%d_%H%M%S)
# Stop services
systemctl stop httpd
systemctl stop abiquo-tomcat
# Prepare yum repository
yum-config-manager --enable abiquo-base
yum-config-manager --enable abiquo-updates
# Perform update
yum clean all && yum makecache
yum update 'abiquo-*'
# Upgrade the Abiquo databases
abiquo-db [-h DB hostname] [-P DB port] [-u user] [-p password] update
# IF the database upgrade fails because of checksums
abiquo-db [-h DB hostname] [-P DB port] [-u user] [-p password] clearCheckSums
abiquo-db [-h DB hostname] [-P DB port] [-u user] [-p password] update
# PIM STEP
# If your upgrade passes through Abiquo 5.3
# 1. ON ALL your servers, upgrade to the PIM STEP and STOP
# 2. On the API Server, run the PIM planner
# 3. On the Remote Services, run the PIM migrator
# 4. On the API (database) Server, update the database for PIM
# 1. Run the PIM planner
# Install the Abiquo PIM tools package
yum install abiquo-pim-tools
# Run the PIM planner against your database and redirect the output to a file
java -jar /opt/abiquo/pim-tools/pimplanner.jar --jdbc-url="jdbc:mysql://<DATABASE_SERVER_IP>:3306/kinton?autoReconnect=true&user=<USER>&password=<PASSWORD>" | tee output_pimplanner.log
# Check the output of the PIM planner for errors
# Copy the migration-plan.data file to EVERY Remote Services server
scp migration-plan.data root@<REMOTE_SERVICES_01_IP>:/opt/abiquo
scp migration-plan.data root@<REMOTE_SERVICES_02_IP>:/opt/abiquo
...
# NOW go to the REMOTE SERVICES and run the PIM MIGRATOR
4. Run the PIM database update
# Update the Abiquo database with all of the update.sql files. For example
mysql kinton < update_DC1.sql
mysql kinton < update_DC2.sql
...
# POST PIM STEPS
# Post-upgrade step for API
chown -R tomcat /opt/abiquo
Additional API and UI upgrade steps
Add translations for new UI Labels to lang_xx_XX_custom.json. See Abiquo UI Client Language Configuration
Optionally add new configuration to client-config-custom.json. See Configure Abiquo UI
In your UI configuration, check that the API endpoint is pointing to your Abiquo API server:
{
"config.endpoint" : "http://<API_IP_ADDRESS>/api"
}
|
Add new API properties to the abiquo.properties file found in the /opt/abiquo/config/ folder. See Changes to Abiquo Configuration Properties
If you are using SAML with multiple IDPs, restore the configuration as described at Restore SAML security beans after upgrade.
3. Remote Services Servers
On each Remote Services Server do these steps
Remote Services Server upgrade procedure
# Log in as root
sudo su -
# On V2V servers, check for active conversions
# ps aux | grep v2v
# ps aux | grep mechadora
# Back up the /opt/abiquo folder
tar cvfz /opt/abiquo.tgz-$(date +%Y%m%d_%H%M%S) /opt/abiquo
# Back up Redis
redis-cli save
cp -a /var/lib/redis /var/lib/redis-$(date +%Y%m%d_%H%M%S)
# Stop services
systemctl stop abiquo-tomcat
# Prepare yum repository
yum-config-manager --enable abiquo-base
yum-config-manager --enable abiquo-updates
# Perform update
yum clean all && yum makecache
yum update 'abiquo-*'
# PIM STEPS
# If your upgrade passes through Abiquo 5.3:
# 1. Upgrade ALL your servers to the PIM STEP and STOP
# 2. On the API Server, run the PIM planner
# 3. On the RS Servers run the PIM migration
# 4. Update the database for PIM
# 3. Run the PIM migration
# Install the PIM tools
yum install abiquo-pim-tools
# Move the PIM migraton plan to the PIM tools folder
mv migration_plan.data pim-tools
# Obtain the datacenter-id of the Remote Services server from the value of the abiquo.datacenter.id property in the abiquo.properties file.
# e.g. abiquo.datacenter.id=abq_dc1
# Run the PIM migrator in dry-run mode and save the output to a file
java -jar /opt/abiquo/pim-tools/pimmigrator.jar -dc=abq_dc1 -redishost=localhost -plan=migration-plan.data -noseed -output=update_DC1.sql | tee pimmigrator_dry_run_DC1.log
# Check the output file for errors or warnings
# Run the PIM migrator in update mode, by setting the "no dry run" option to true.
java -jar /opt/abiquo/pim-tools/pimmigrator.jar -nodry -dc=abq_dc1 -redishost=localhost -plan=migration-plan.data -noseed -output=update_DC1.sql | tee pimmigrator_DC1.log
# Copy the SQL file from the Remote Services server to the Abiquo database server.
scp update_DC1.sql root@<DATABASE_SERVER_IP>:~/
scp update_DC2.sql root@<DATABASE_SERVER_IP>:~/
...
# Go the Abiquo database (API) server and run the PIM update
# POST PIM STEPS
# Post upgrade steps for RS
chown -R tomcat /opt/abiquo
chown -R tomcat /opt/vm_repository
chmod -R a+r /opt/vm_repository
cd /usr/share/doc/abiquo-redis/redis/
bash ./4.2.3/00-old-vsm-definitions.sh
Additional RS upgrade steps
Add new RS properties to the abiquo.properties file found in the /opt/abiquo/config/ folder. See Changes to Abiquo Configuration Properties
4. Monitoring Servers
On each Watchtower Moniitoring Server do these steps
Monitoring Server upgrade procedure
# Log in as root and stop services
sudo su -
systemctl stop abiquo-emmett
systemctl stop abiquo-delorean
systemctl stop kairosdb
systemctl stop cassandra
# Really kill Cassandra by getting its process number (e.g. XXXXX) and killing it
ps auwx | grep cassandra
kill -9 XXXXX
# Prepare yum repository
yum-config-manager --enable abiquo-base
yum-config-manager --enable abiquo-updates
# Perform update
yum clean all && yum makecache
yum update 'abiquo-*'
# Update watchtower database
watchtower-db [-h DB hostname] [-P DB port] [-u user] [-p password] update
# PIM STEP - STOP THE UPGRADE HERE
# If your upgrade passes through Abiquo 5.3:
# 1. Upgrade ALL your servers to the PIM STEP and STOP
# 2. On the API Server, run the PIM planner
# 3. On the RS Servers run the PIM migration
# 4. Update the database for PIM
5. Start Abiquo server and services
Start all servers in the correct order.
Start Abiquo servers procedure
# After you have run the provider ID migration
# and the POST PIM STEPS
# On API Server
service httpd restart
service abiquo-tomcat start
# On Remote Services including V2V
service abiquo-tomcat start
# On the Monitoring Server, start the Cassandra service
sudo service cassandra start
# WAIT about 5 minutes until Cassandra is up and running
# Start the KairosDB service
sudo service kairosdb start
# Start the other services in this order
sudo service abiquo-emmett start
sudo service abiquo-delorean start
6. Reporting server
To upgrade the Abiquo Reports Server for the upgrade to Abiquo 5.3.x, contact Abiquo Support for more information.
- The Abiquo Reports Server now runs with JasperReports v7.8.0