Octane upgrade workflow

Prerequisites

In this manual we assume that user manages their environment with Fuel 5.1 and has successfully upgraded it to Fuel 6.1 with the standard procedure.

Environments with the following configuration can be upgraded with Octane:

• Ubuntu operating system
• HA Multinode deployment mode
• KVM Compute
• Neutron with VLAN segmentation
• Ceph backend for Cinder AND Glance
• No additional services installed (like Sahara, Murano, Ceilometer, etc)

Clean up nodes for 6.1 Seed environment

This is an optional step. Select nodes in your environment and use live migration to evacuate all virtual instances from the node. Delete the node from environment. Repeat for at least 1 node (Cloud Infrastructure Controller and in 6.1 Seed environment). Wait for nodes to be available in the Fuel Web UI as discover.

Install Octane

Create archive from this repository with git archive command and copy it to your Fuel Master host.

Unpack Octane tarball to /root/ directory. Change to bin/ directory of Octane.

[root@fuel ~]# cd /root/octane/octane/bin

Run Octane script to install necessary packages on Fuel master and patch manifests and source code of components.

[root@fuel bin]# ./octane prepare-fuel

Install 6.1 Seed environment

First, pick the environment of version 5.1.1 you want to upgrade. Log in to Fuel Master node and run:

[root@fuel bin]# fuel env

Find the environment you selected for upgrade and remember its ID. We will refer to it as ORIG_ID below.

Make sure that you have 3 nodes you want to serve as CICs in 6.1 environment added to Fuel in 'discover' status.

[root@fuel bin]# fuel node | grep discover

Memorize IDs of those nodes to use in the next command.

Use Octane script to create Upgrade Seed environment with selected nodes.

[root@fuel bin]# ./octane upgrade-env <ORIG_ID> <NODE1_ID> <NODE2_ID> <NODE3_ID>

State Database contains all metadata and status data of virtual resources in your cloud environment. Octane transfers that data to 6.1 environment as a part of upgrade of CIC.

Before it starts data transfer, Octane stops all services on 6.1 CICs, and disables APIs on 5.1.1 CICs, putting the environment into Maintenance mode.

Replace CICs 5.1.1 with 6.1

Now start all services on 6.1 CICs with upgraded data and redirect Compute nodes from 5.1.1 CICs to 6.1 CICs.

Following Octane script will start all services on 6.1 CICs, then disconnect 5.1 CICs from Management and Public networks, while keeping connection between CICs themselves, and connect 6.1 CICs to those networks:

[root@fuel bin]# ./octane upgrade-cics ORIG_ID SEED_ID

Upgrade nova-compute to 6.1

Run following script to upgrade nova-compute and dependency packages on all hypervisor hosts to version 6.1 without upgrading data plane (i.e. hypervisor, operating system and kernel). This script installs 6.1 source for APT package manager, updates versions of nova-compute package and its dependencies (including Neutron agent), updates configuration file for Neutron agent to work with new version of packages and restarts updated services.

Note that this script will affect all compute nodes in the environment.

[root@fuel bin]# ./octane upgrade-nova-compute ORIG_ID

Upgrade nodes

Pick node for upgrade

Select a node to upgrade from the list of nodes in 5.1.1 environment:

[root@fuel bin]# fuel node --env ORIG_ID

Run Octane script with 'upgrade-node' command to reassign node to 6.1 environment and upgrade it. You need to specify ID of the node as a second argument.

[root@fuel bin]# ./octane upgrade-node SEED_ID NODE_ID

Repeat this process until all nodes are reassigned from 5.1.1 to 6.1 environment.

Finish upgrade

Cleanup 6.1 environment

Run Octane script with 'cleanup' command to delete pending services data from state database.

[root@fuel bin]# ./octane cleanup SEED_ID