<commit_before># Octane upgrade workflow

## Prerequisites

In this manual we assume that user manages their environment with Fuel 5.1.1 and
has successfully upgraded it to Fuel 7.0 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 (Optional)
- No additional services installed (like Sahara, Murano, Ceilometer, etc)

## 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]# yum install -y git python-pip python-paramiko
[root@fuel bin]# ./octane prepare
```

## Install 7.0 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.

Use Octane script to create Upgrade Seed environment.

```
[root@fuel bin]# octane upgrade-env <ORIG_ID>
```

Remember the ID of resulting environment for later use, or store it to variable.
We will refer to it as <SEED_ID> later on.

### Upgrade controller #1

Choose a controller node from the list of nodes in 5.1.1 environment:

```
[root@fuel bin]# fuel node --env <ORIG_ID>
```

Remember the ID of the node and run the following command replacing <NODE_ID>
with that number:

```
[root@fuel bin]# octane -v --debug install-node --isolated <ORIG_ID> <SEED_ID> \
     <NODE_ID> [<NODE_ID>, ...]
```<commit_msg>[doc] Update README instructions for 3 controllers scenario<commit_after># Octane upgrade workflow

## Prerequisites

In this manual we assume that user manages their environment with Fuel 5.1.1 and
has successfully upgraded it to Fuel 7.0 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 (Optional)
- No additional services installed (like Sahara, Murano, Ceilometer, etc)

## 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]# yum install -y git python-pip python-paramiko
[root@fuel bin]# ./octane prepare
```

## Install 7.0 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.

Use Octane script to create Upgrade Seed environment.

```
[root@fuel bin]# octane upgrade-env <ORIG_ID>
```

Remember the ID of resulting environment for later use, or store it to variable.
We will refer to it as <SEED_ID> later on.

### Upgrade controller #1

Choose added controller nodes from the list of unallocated nodes:

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

Remember the IDs of the nodes and run the following command replacing <NODE_ID>
with that number:

```
[root@fuel bin]# octane -v --debug install-node --isolated <ORIG_ID> <SEED_ID> \
     <NODE_ID> [<NODE_ID>, ...]
```
{'fraction_non_alphanumeric': 0.08639705882352941, 'fraction_numerical': 0.006827731092436975, 'mean_word_length': 4.210670314637483, 'pattern_counts': {'":': 0, '<': 18, '<?xml version=': 0, '>': 18, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '4452484', 'n_tokens_mistral': 1199, 'n_tokens_neox': 1092, 'n_words': 531}