Documentation

Skip to end of metadata
Go to start of metadata

Abiquo Wiki
Upgrading 3.2 to 3.2.x

v3.1.2 2014-11-19

1. Abiquo upgrade summary

This upgrade covers ALL versions from 3.2 to 3.2x.

Please read the release notes for each version, below.

Upgrade instructions

From Abiquo 3.2 or 3.2.x to the latest patch version of Abiquo, see Abiquo 3.2 patch version upgrade. Follow this document to upgrade every server as marked in the table below.

From Abiquo 3.1.x, please see Upgrade from Abiquo 3.1.x to 3.2.x

Upgrade all required servers

The purpose of this section is to describe the servers you would need to upgrade in a multi-version upgrade. If you are upgrading directly from Abiquo 3.2, in addition to the servers upgraded for the current version, you may need to perform steps or upgrades on servers that were only included in an earlier patch version, for example, KVM. From Abiquo 3.2.7 we recommend that you run the database upgrade script for every version of Abiquo to ensure that all upgrades are performed correctly.

Follow the Abiquo 3.2 patch version upgrade documentation to upgrade every server marked in this table.

Serverv3.2.1v3.2.2 (red star)v3.2.3v3.2.43.2.53.2.63.2.7
Abiquo Monolithic Server API and UI(tick)(tick) (blue star) (green star)(tick)(tick) (blue star)(tick)(tick)(tick)
Abiquo Database Server(tick)(tick)(tick)(tick)(tick)(tick)(tick)
Abiquo Distributed Server(tick)(tick)(tick)(tick)(tick)(tick)(tick)
Remote Services(tick)(tick)(tick)(tick)(tick)(tick)(tick)
V2V Services (distributed)------(tick)
KVM Server-(tick)-----
LVM Server-------

(warning) - upgraded in a previous version and must be upgraded in an upgrade from any version other than the latest minor version

(red star) - requires new signing key. See Upgrade instructions

(blue star) - requires new client-config.json properties

(green star) - requires separate abiquo-tutorials install or upgrade

 

1.1. Upgrade elements

Specific upgrade elements required when upgrading from earlier versions.

Release Versionv3.2.1v3.2.2v3.2.3v3.2.4
Abiquo-
  • Signing key
  • Google Maps properties
  • Tutorials install and configuration
-
  • Password recovery property
Other-KVM- 

 

2. Latest package versions

This table shows the latest versions of any packages changed in an upgrade from 3.2 to the latest version.

 Package versions 3.2.1Package versions 3.2.2Package versions 3.2.3Package versions 3.2.4Package versions 3.2.5Package versions 3.2.6Package versions 3.2.7
Appliance managerabiquo-am-3.2.0-1.el6.noarch.rpmabiquo-am-3.2.2-4.el6.noarchabiquo-am-3.2.2-4.el6.noarchabiquo-am-3.2.2-4.el6.noarch.rpmabiquo-am-3.2.2-4.el6.noarch.rpmabiquo-am-3.2.2-4.el6.noarch.rpmabiquo-am-3.2.7-2.el6.noarch.rpm
API
abiquo-api-3.2.1-1.el6.noarchabiquo-api-3.2.2-4.el6.noarchabiquo-api-3.2.3-2.el6.noarchabiquo-api-3.2.4-1.el6.noarchabiquo-api-3.2.5-1.el6.noarch.rpmabiquo-api-3.2.6-1.el6.noarch.rpmabiquo-api-3.2.7-1.el6.noarch.rpm
Business Process Managerabiquo-v2v-3.2.0-1.el6.noarch.rpmabiquo-v2v-3.2.0-1.el6.noarch.rpmabiquo-v2v-3.2.0-1.el6.noarch.rpmabiquo-v2v-3.2.0-1.el6.noarch.rpmabiquo-v2v-3.2.0-1.el6.noarch.rpmabiquo-v2v-3.2.0-1.el6.noarch.rpmabiquo-v2v-3.2.7-1.el6.noarch.rpm
Cloud provider proxyabiquo-cpp-3.2.1-1.el6.noarchabiquo-cpp-3.2.2-4.el6.noarch

abiquo-cpp-3.2.3-1.el6.noarch

abiquo-cpp-3.2.3-1.el6.noarchabiquo-cpp-3.2.5-1.el6.noarch.rpmabiquo-cpp-3.2.6-1.el6.noarch.rpmabiquo-cpp-3.2.7-1.el6.noarch.rpm
Outbound APIabiquo-m-3.2.1-1.el6.noarchabiquo-m-3.2.2-4.el6.noarch

abiquo-m-3.2.3-1.el6.noarch

abiquo-m-3.2.3-1.el6.noarchabiquo-m-3.2.3-1.el6.noarchabiquo-m-3.2.3-1.el6.noarch.rpmabiquo-m-3.2.7-1.el6.noarch.rpm
Discovery managerabiquo-nodecollector-3.2.1-1.el6.noarchabiquo-nodecollector-3.2.2-4.el6.noarchabiquo-nodecollector-3.2.3-1.el6.noarchabiquo-nodecollector-3.2.3-1.el6.noarchabiquo-nodecollector-3.2.5-1.el6.noarch.rpmabiquo-nodecollector-3.2.5-1.el6.noarch.rpmabiquo-nodecollector-3.2.7-1.el6.noarch.rpm
Orchestratorabiquo-server-3.2.1-1.el6.noarchabiquo-server-3.2.2-5.el6.noarchabiquo-server-3.2.2-5.el6.noarchabiquo-server-3.2.2-5.el6.noarch.rpmabiquo-server-3.2.2-5.el6.noarch.rpmabiquo-server-3.2.2-5.el6.noarch.rpmabiquo-server-3.2.7-1.el6.noarch.rpm
Tutorials-- previously integrated in the UI --abiquo-tutorials-3.2.0-2.el6.noarchabiquo-tutorials-3.2.0-2.el6.noarchabiquo-tutorials-3.2.0-2.el6.noarchabiquo-tutorials-3.2.0-2.el6.noarchabiquo-tutorials-3.2.0-2.el6.noarch.rpmabiquo-tutorials-3.2.0-2.el6.noarch.rpm
UIabiquo-ui-3.2.1-1.el6.noarchabiquo-ui-3.2.2-8.el6.noarchabiquo-ui-3.2.3-2.el6.noarchabiquo-ui-3.2.4-1.el6.noarchabiquo-ui-3.2.5-1.el6.noarch.rpmabiquo-ui-3.2.6-1.el6.noarch.rpmabiquo-ui-3.2.7-1.el6.noarch.rpm
Virtual factoryabiquo-virtualfactory-3.2.1-1.el6.noarchabiquo-virtualfactory-3.2.2-4.el6.noarchabiquo-virtualfactory-3.2.3-2.el6.noarchabiquo-virtualfactory-3.2.3-2.el6.noarchabiquo-virtualfactory-3.2.5-1.el6.noarch.rpmabiquo-virtualfactory-3.2.6-1.el6.noarch.rpmabiquo-virtualfactory-3.2.7-2.el6.noarch.rpm
Monitor managerabiquo-vsm-3.2.1-1.el6.noarchabiquo-vsm-3.2.2-4.el6.noarchabiquo-vsm-3.2.3-1.el6.noarchabiquo-vsm-3.2.3-1.el6.noarchabiquo-vsm-3.2.5-1.el6.noarch.rpmabiquo-vsm-3.2.6-1.el6.noarch.rpmabiquo-vsm-3.2.7-2.el6.noarch.rpm
Storage system managerabiquo-ssm-3.2.1-1.el6.noarchabiquo-ssm-3.2.1-1.el6.noarchabiquo-ssm-3.2.1-1.el6.noarchabiquo-ssm-3.2.3-1.el6.noarchabiquo-ssm-3.2.3-1.el6.noarchabiquo-ssm-3.2.1-1.el6.noarch.rpmabiquo-ssm-3.2.7-1.el6.noarch.rpm
Abiquo AIM for KVMoriginal 3.2.0 versionabiquo-aim-3.2.2rel2.4.3-1.el6.x86_64.rpmabiquo-aim-3.2.2rel2.4.3-1.el6.x86_64.rpmabiquo-aim-3.2.2rel2.4.3-1.el6.x86_64.rpmabiquo-aim-3.2.2rel2.4.3-1.el6.x86_64.rpmabiquo-aim-3.2.2rel2.4.3-1.el6.x86_64.rpmabiquo-aim-3.2.2rel2.4.3-1.el6.x86_64.rpm

 

3. Release Notes

3.1. Abiquo 3.2.1

3.1.1. Improvements

Key

Summary

7840

Improve Apps library flow in public cloud. See Usability Improvements in Abiquo 3.2#Apps library view

7850

VirtualMachineTemplate list pagination should be aware of master-instance relation

7864

Separate private datacenters and public cloud regions in Infrastructure view. See Usability Improvements in Abiquo 3.2#Infrastructure view

7506

Microsoft Azure networks. See Microsoft Azure#Microsoft Azure Networks and known issue below

 

3.1.2. Resolved Issues

Key

Summary

7752

Template definition validation should be related to definition name in tracer

7756

Deleting last IP address from deployed VM causes NET-16 error

7758

Combo box in create persistent template dialog does not match other combos

7775

Enterprise box in Home view looks overlapped

7795

The privilege "Access Infrastructure view" should not show the create, edit and delete button on the Remote Services tab

7801

Privilege "Assign load balancers" is in VDC privileges group on Privileges page of UI instead of VApp privileges group

7803

Static routes raises GEN-13 if fields are sent empty

7804

Manage user privileges must be enough to view the VDC list in case of edit/create user. A user allowed to restrict virtual datacenters to other users, should be able to access the VDC list

7805

Infrastructure-Servers view is not auto-refreshed

7812

External network creation fails if "from IP" field on Create IPs dialog is not filled in

7814

Capture VM process allows users to create VApps in VDCs that are not valid for capturing the VM

7821

Hard to choose chef cookbooks because of abbreviation of elements such as recipe names

7825

List columns are not properly shown in popups, e.g. static routes and public cloud networks

7826

Edit an RS and set an already existing URI fails with 500 internal server error

7827

It is not possible to add a remote service from the Datacenters tab. This functionality should be disabled until we refactor the Remote Services page on the Datacenters tab

7832

Wrong label in create network from VM configuration screen

7833

Editing a VM, creating an existing IP that is not used by a VM does not trigger any response

7845

List of persistent VM templates is empty if any of the persistent templates do not have a link to a volume, i.e. because the volume creation or dump to volume failed

7849

Small issues with UI labels but no changes to the meaning of label texts

7858

Location list edit window for RS overlaps box

7860

Selecting a template to create a persistent template, the view does not use pagination

3.1.3. Changes also applied in recent versions

This section is designed to assist customers who have just commenced using Abiquo 3.2 and may need to know when bugfixes present in Abiquo 3.1.x versions were applied in Abiquo 3.2.x versions.

Improvements

Key

Summary

7829

Add support for VIRTIO disk and network controllers on KVM hypervisors

 

Resolved Issues

Key

Summary

7736

accounting_event_vm CPU and RAM not updating when reducing quantity directly on hypervisor

7824

Physical machine Save button not enabled until data is updated in the IPMI port field. This bug fix requires a database delta

7836

User search only works with visible enterprises

7837

Poor performance of /publicips/purshased/{id} resource

7838

When API loses connection to ZooKeeper, it is not able to reconnect to consumers

7842

Warning periodically appears in logs; it is related to persistent disks when checking standard ones

7843

Enable users to copy remote access password

7844

Issue with sessions endpoint

7851

External network creation form does not show all enterprises in pull-down list, so cannot create external network for enterprise not on first page

7852

Values in home view statistics and enterprise allocation limits are different. Units change between screens and the value in allocation limits is being rounded down. This bug was fixed by using the same units on both screens to avoid rounding issues.

 

3.1.4. Known Issue

7883

Azure networking only recognizes the default subnet. Users should not create private datacenter networks in Azure to prevent conflicts with the default subnet

3.2. Abiquo 3.2.2

 

3.2.1. Changes in Abiquo 3.2.2

New Signing Keys

You must add new signing keys to access the Abiquo yum repository for this upgrade. See Abiquo 3.2 patch version upgrade

Usability Improvements and UI Configuration Changes

See Usability Improvements in Abiquo 3.2 for full details of all the improvements mentioned in these release notes.

In Abiquo 3.2.2 there are two new client configuration properties related to Google maps. These properties are mandatory in the client-config.json file.

You must add the following Google maps properties when upgrading to Abiquo 3.2.2 or the UI will not function properly. Remember to check your JSON file format: you must add a comma after each property, except for the last one. If you make an error in the file format, the UI will not load.

Edit /var/www/html/ui/config/client-config.json. Go to the section where the other client.google properties can be found.

To enable Google Maps, set the enabled property to true. Include your Google Maps API key if required: see How to Obtain and Install a Google Maps API Key.

    ...
	"client.google.maps.enabled": true,
    "client.google.maps.key": "",
	...

A sample configuration file with these properties included is available on the Abiquo Server at the following location

 /var/www/html/ui/config/client-config.json.rpmnew
 

Abiquo Tutorials

The Abiquo tutorials have changed in Abiquo 3.2.2 to allow different releases of tutorials and the user interface

Upgrading custom tutorials

See Abiquo 3.2 patch version upgrade

Create custom tutorials

See Abiquo Tutorials for Onboarding Users

3.2.2. Improvements

Key

Summary

6016

(KVM) Hypervisor plugin support for core count on NUMA CPU architecture. Our KVM plugin should compute CPUs as "CPU socket(s)" * "NUMA cell(s)" * "Cores x socket(s). Fix requires KVM upgrade

7867

Add a Documentation button to the top menu (next to Events)

7868

Change the format of "Add a Layer" in the Virtual Appliance section from icon to button

7869

Navigate directly to VAPP/VDC from Homepage using double-click

7870

Navigate directly to VAPP from VDC page using double-click

7886

Translate event time to browser locale

7893

Open Apps library to private / public tab that has locations registered

7909

Improvements to VSM for improved public cloud performance with different cloud provider credentials

 

3.2.3. Resolved Issues

Key

Summary

7026

HA fails for persistent VMs due to an invalid requirement of a shared datastore that Abiquo does not use for persistent VMs

7633

Tab key does not work properly when filling in forms

7769

Fields collapsed in Edit firewalls dialog for Inbound/Outbound fields

 

7873

Edit enterprise not working if pricing tab has not been displayed

7874

Apps Library Private / Public tabs show same info if a public cloud region does not exist

7875

Searching for public cloud templates, after clicking on a page and then repeating the search, the user sees the wrong page

7876

Cannot capture a VM if the first disk on the controller is a data disk. Fixed so you can now capture the virtual machine and apply basic reconfigures (CPU/RAM). BUT it is not possible to modify the storage devices

7880

GEN 13 error if Azure credentials do not have a Subscription ID

7882

Fix trace after failed deploy to include Virtual Machine ID

7883

Azure networking only recognizes the default subnet. Fixed so that you can now create multiple subnets. See Microsoft Azure Integration

7890

HTML5 UI client does not work when Google Maps library is not reachable (because there is no Internet conection). Fixed to include new client-config.json properties. See Abiquo 3.2 patch version upgrade

7902

When capturing VMs on ESX, Ethernet drivers of NICs could be changed. Now Abiquo will use the driver of the first NIC (ordered by sequence) to create all the NICs in the captured template

7913

Error on Create user form

7915

Large template upload returns 401 unauthorized error

 

7916

Hypervisor MOVE of imported VM is not fully processed. Retrieved and captured VMs can be duplicated in Abiquo

7918

A MOVE event is detected for a VM between public cloud regions with the same credentials. This is because VMs for all regions in the same provider are registered for each region

 

 

3.2.4. Issues fixed in previous versions

This section is for customers who have just started using Abiquo 3.2. It describes the issues that were recently fixed in the Abiquo 3.1.x branch, which upgrading customers should already have available

Key

Summary

7863

Fix drag&drop and double-click for touch devices

 

3.2.5. Known Issues

Key

Summary

6438

UI refreshes may be uneven, refresh times are too long and sometimes existing data is refreshed

 

7144

Chef client should not run periodically by default

7524

Remote search triggered automatically in Apps library in public cloud

7793

Remove/add some system properties for wiki links. To be removed: add datastore, instance, static routes. To be added: create network IP, manage external networks, modify a VM template

7841

With the UI users can create static routes for networks that do not support them

7854

Footer version does not display correctly

7865

Plugin licenses show 'undefined' if the hypervisors are not available. Unsupported plugins should not be displayed

 

7866

The 'documentation' link is not linked with the correct URL. It must point to client.dashboard.abiquoURL If this URL is not supplied, the documentation button and link should not be displayed

7898

When purchasing several public IPs, the screen refreshes continuously

7905

Double-click to select VM password does not work

3.3. Abiquo 3.2.3

3.3.1. Resolved Issues

Key

Summary

7614

Close button for VNC Remote Access (eye icon) appears in top left-hand corner instead of top-right of window

7941

Azure reconfigure of hardware fails since networking feature was added due to a bug in the Azure API documentation

7944

Improve encryption of credentials

7947

Azure storage account names are not unique and Azure requires unique names as identifiers. Fixed by naming the storage account with a unique code generated from the subscription ID and region, with a configurable prefix for identifying the account in the Azure portal

7949

Azure create virtual datacenter fails if no network exists

7954

Some fields of restore event for virtual machine backup are not correct. The backup date should be shown instead of the restore date

7957

Extra restore events are triggered when a backup is restored

 

3.3.2. Known Issues

7922

Enable branding to change colors of menu bar link text

7928

Unrelated error message logged when a VM that has been retrieved but not captured is vMotioned from host A to host B

7930

IPMI password field should be hidden

7931

In Infrastructure view, when Google Maps is disabled, clicking on a DC opens statistics instead of details view

7942

Veeam results do not correspond with results shown in virtual machine because backup type is wrong

7956

Double-click not working to create a new virtual machine from a persistent template

3.4. Abiquo 3.2.4

3.4.1. Usability Improvements and UI Configuration Changes

 See Usability Improvements in Abiquo 3.2  for full details of all the improvements mentioned in these release notes.  

In Abiquo 3.2.4 there is a new client configuration property to control the display of the password recovery¡ link on the login screen. This property is mandatory in the client-config.json file.

You must add the following client reset password link property to Abiquo 3.2.4 or the UI will not function properly. Remember to check your JSON file format: you must add a comma after each property, except for the last one. If you make an error in the file format, the UI will not load.

Edit /var/www/html/ui/config/client-config.json. Go to the section where the other client properties can be found.

To hide the reset password link, set the property to false. 

    ...
	"client.password.recovery": false,
	...

  A sample configuration file with these properties included is available on the Abiquo Server at the following location

 /var/www/html/ui/config/client-config.json.rpmnew

3.4.2. Improvement

Key

Summary

7958

After disabling "Allow password reset" option in Configuration view, the "Forgot your password?" link still shows on the login screen. You must set the new "client.password.recovery" parameter in client-config.json. When this property is true, the link is shown, and by default the Configuration option to "Allow password reset" is disabled. See Configure Abiquo UI

3.4.3. Resolved Issues

Key

Summary

7959

Protect XSS on popup dialog

7964

Missing event VIRTUAL_MACHINE_ALLOCATE_NICS when a new virtual machine is deployed

7978

Limits should not apply in HA events. In previous versions, if deployed resources are close to hard limits, HA VM moves might fail due to hard limit exceeded error

3.5. Abiquo 3.2.5

3.5.1. Improvements

Key

Summary

8154

Allow consecutive restore for a backup. This means that after a user requests a restore and it completes, the integration can set a status of "success" or "failed" and the Restore request link will be activated again, so the user can request the restore again

8155

Change backup time zone from +XXXX format to a dropdown to make it more understandable

3.5.2. Resolved Issues

Key

Summary

8146

License check has occasional performance issues

8152

Double clicking to enter vApp from VDC screen, the VApp view does not refresh until periodic UI refresh occurs

8158

Wrong label on CPU-Mz metric from ESX. It should be Megahertz rate

8164

List of VDCs at user creation doesn't show all VDCs

3.6. Abiquo 3.2.6

3.6.1. Improvements

Key

Summary

Other versions

8153

HA fails if a VM lacks a subscription in the VSM

3.4.1

8200

ESX HA. In relation to VM pause during first power on described at

http://kb.vmware.com/selfservice/search.do?cmd=displayKC&docType=kc&docTypeID=DT_KB_1_1&externalId=1027096

Abiquo should provide a default answer of "I moved it"

3.4.2

3.6.2. Resolved Issues

Key

Summary

Other fix versions

7890

When Google Maps library and Recaptcha not reachable because there is no Internet connection, Abiquo does not work

3.4.1

8152

Double click to enter vApp does not refresh

3.4.1

8155

New Azure regions do not appear in the list.

3.4.2

 

New Azure regions

Abiquo 3.2.6 includes the following new Azure regions:

  • Japan East
  • Brazil South
  • Australia East
  • Australia Southeast

3.7. Abiquo 3.2.7

3.7.1. Improvements

Key

Summary

Other versions

8381

Provide a way to disable some metrics at plugin level

3.6.1, 3.4.3

Disable metrics at plugin level

See Disable selected metrics

3.7.2. Resolved Issues

Key

Summary

Other fix versions

8348

Duplicated datastores when refreshing physical machine definition after renaming an already configured datastore

3.4.2, 3.6.1

8373

Virtual machine unsubscribed after instance request fail

3.4.3, 3.6.1

8378

Error when collecting metrics from ESX. If there is a problem, e.g. time gap in VSM/vCenter, return empty metrics set

3.4.3, 3.6.1

8387

Prevent the user from requesting another restore if one is already in progress

-

8396

Not able to deploy/reconfigure a VM on ESXi with an extra HD attached

-