## Home

#### Upgrading Unravel from version 4.6.1.9 to 4.7.x.x

1. Navigate to the ansible-installation directory and create a copy of the vars_template.yml file.

cp vars_template.yml vars.yml
2. Edit vars.yml by using any editor. For example, the vi editor.

vi vars.yml
3. In the vars.yml file, update values for the following parameters:

Variable

Description

unravel_tar_url

Specify the URL of the Unravel distribution.

unravel_user

Specify the username of the Linux user who owns Unravel.

unravel_group

Specify the names of the user groups to which the Linux user belongs.

unravel_root_path

Specify the path where Unravel is installed.

unravel_version

Specify the Unravel version to which you want to upgrade.

skip_precheck

Specify whether you want to skip the upgrade.

skip_download_untar

• Y: If you set this variable to Y, it skips the step to download and extract the Unravel tarball and configures or sets up Unravel.

• N: If you set this variable to N, it downloads and extracts the Unravel installation tarball.

data_dir:

Specify if you want to configure a separate data directory outside the Unravel directory.

license_path

Specify the path of the license file. The file must be readable by the unravel user.

### Note

If you define the license_path variable, the license setup is automatically run.

4. Navigate to the ansible-installation > group_vars directory.

5. In the all > all file, change the value of async_time to 25200 (7 hours) and async_poll to 300 (5 minutes) if the Elasticsearch data is large (more than 20GB).

### Note

To check the current size of the Elasticsearch data, run the following command:

du -hs <unravel_data_dir>/elasticsearch_1
6. In the cloud_node > cloud_node.yml file, specify the hosts file (if the Unravel upgrade is for a cloud platform).

7. In the core_node > core_node.yml and edge_nodes > edge_nodes.yml files, set the corresponding hosts file (if the Unravel upgrade is for an on-premise platform).

8. Back up the data directory.

tar czf /tmp/unravel-data.tar.gz /srv/unravel
9. If you are using an external database, create a copy of the database. For example, if you are using MySQL1 database, run the following command:

mysqldump -u <username> –p <password> <database_name> > [dump_file.sql]
10. From the Unravel server, run the Ansible playbook.

ansible-playbook -i inventories 4619_upgrade.yml -e @vars.yml -vvv

Unravel is upgraded to the specified version.

11. Start Unravel services on all hosts.

ansible-playbook -i inventories/ install_unravel.yml -vvv -e @vars.yml --tags start_unravel
12. Check the status of Unravel services on all hosts.

ansible-playbook -i inventories/ install_unravel.yml -vvv -e @vars.yml --tags status_unravel