# Trilio 4.1 HF13 Release

## Release Artifacts <a href="#release-artifacts" id="release-artifacts"></a>

|   | **Artifacts** | **Reference**                                                          |
| - | ------------- | ---------------------------------------------------------------------- |
| 1 | Release Date  | Oct 5, 2022                                                            |
| 2 | Debian URL    | deb \[trusted=yes] <https://apt.fury.io/triliodata-4-1/> /             |
| 3 | RPM URL       | <http://trilio:XpmkpMFviqSe@repos.trilio.io:8283/triliovault-4.1/yum/> |
| 4 | PIP URL       | <https://pypi.fury.io/triliodata-4-1/>                                 |

## 1. Introduction <a href="#id-1.-introduction" id="id-1.-introduction"></a>

This document provides information on TVO-4.1.HF13 Release.

***Important Info:***

*To use this hotfix (4.1.HF13)*

1. Customers (*except Canonical Openstack*) and having Openstack Ussuri need to have an already deployed and working TVO-4.1 GA OR TVO-4.1.HF1 OR TVO-4.1.HF2 OR TVO-4.1.HF3 OR TVO-4.1.HF4 OR TVO-4.1.HF5 OR TVO-4.1.HF6 OR TVO-4.1.HF7 OR TVO-4.1.HF8 OR TVO-4.1.HF9 OR TVO-4.1.HF10 OR TVO-4.1.HF11 OR HF12
2. Customers (*except Canonical Openstack*) and having Openstack Victoria OR TripleO Train need to follow the TVO-4.1 GA deployment process and directly upgrade to 4.1.HF13 containers/packages. The high-level flow below:
   1. *Deplo T4O-4.1 GA appliance.*
   2. *Upgrade to 4.1.HF13 packages on the appliance.*
   3. **Kolla & TripleO**
      1. *Deploy Trilio components via 4.1.HF13 containers/packages on Openstack Victoria/TripleO Train.*
   4. **Openstack Ansible**
      1. *Deploy Trilio components Openstack Victoria \[This will deploy 4.1 GA packages]*
      2. Upgrade *TrilioVault packages* to *4.1.HF13 on Openstack Victoria.*
   5. Configure the Trilio appliance.
3. Canonical users having Openstack Ussuri can either upgrade (*on top of 4.1 GA*) using Trilio upgrade documents OR do a fresh deployment using 4.1 Deployment documents.
4. Canonical users having Openstack Victoria can either upgrade (*on top of 4.1.HF4*) using Trilio upgrade documents OR do a fresh deployment using 4.1 Deployment documents.

*The deploy/upgrade documentations provide the detailed steps to deploy/upgrade to the hotfix.*

## 2. Release Scope <a href="#id-2.-release-scope" id="id-2.-release-scope"></a>

**Current Hotfix release targets the following:**

1. Verification of Jira issues targeted for 4.1.HF13 release.
2. As part of the new process, the delivery will be via packages; end users would need to do the rolling upgrade on top of 4.1 GA OR 4.1.HF1 OR 4.1.HF2 OR TVO-4.1.HF3 OR TVO-4.1.HF4 OR TVO-4.1.HF5 OR TVO-4.1.HF6 OR TVO-4.1.HF7 OR TVO-4.1.HF8 OR TVO-4.1.HF9 OR TVO-4.1.HF10 OR TVO-4.1.HF11 OR TVO-4.1.HF12

## 3. Tag References for Rolling Upgrades <a href="#id-3.-tag-references-for-rolling-upgrades" id="id-3.-tag-references-for-rolling-upgrades"></a>

|   | **Tag Reference in Upgrade Docs** | **Value**                                                      | **Comments**                                                                              |
| - | --------------------------------- | -------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| 1 | 4.1-HOTFIX-LABEL                  | hotfix-13-TVO/4.1                                              | Label against the Trilio repositories from where required code to be pulled for upgrades. |
| 2 | 4.1-RHOSP13-CONTAINER             | 4.1.94-hotfix-16-rhosp13                                       | RHOSP13 Container tag against 4.1.HF13                                                    |
| 3 | 4.1-RHOSP16.1-CONTAINER           | 4.1.94-hotfix-16-rhosp16.1                                     | RHOSP16.1 Container tag against 4.1.HF13                                                  |
| 4 | 4.1-RHOSP16.2-CONTAINER           | 4.1.94-hotfix-16-rhosp16.2                                     | RHOSP16.2 Container tag against 4.1.HF13                                                  |
| 5 | 4.1-KOLLA-CONTAINER               | <p>4.1.94-hotfix-13-ussuri</p><p>4.1.94-hotfix-12-victoria</p> | Kolla Container tag against 4.1.HF13                                                      |
| 6 | 4.1-TRIPLEO-CONTAINER             | 4.1.94-hotfix-12-tripleo                                       | TripleO Container tag against 4.1.HF13                                                    |

## 4. Resolved Issues <a href="#id-4.-resolved-issues" id="id-4.-resolved-issues"></a>

*Issues logged by Customers to be documented in this section*

|   | **Summary**                                                                           |
| - | ------------------------------------------------------------------------------------- |
| 1 | horizon logs getting dumped with errors                                               |
| 2 | T4O 4.1 vulnerability reported by Fortinet                                            |
| 3 | All the network ports of a project are deleted in case Restore Network Topology fails |

## 5. Deliverables against 4.1.HF13 <a href="#id-5.-deliverables-against-4.1.hf13" id="id-5.-deliverables-against-4.1.hf13"></a>

|    | **Package/Container Names** | **Package Kind** | **Package/Container Version/Tags** |
| -- | --------------------------- | ---------------- | ---------------------------------- |
| 1  | dmapi                       | deb              | 4.1.94.3                           |
| 2  | dmapi                       | rpm              | 4.1.94.3-4.1                       |
| 3  | python3-dmapi               | rpm              | 4.1.94.3-4.1                       |
| 4  | python3-dmapi               | deb              | 4.1.94.3                           |
| 5  | tvault-contego              | rpm              | 4.1.94.10-4.1                      |
| 6  | tvault-contego              | deb              | 4.1.94.10                          |
| 7  | python3-tvault-contego      | deb              | 4.1.94.10                          |
| 8  | python3-tvault-contego      | rpm              | 4.1.94.10-4.1                      |
| 9  | s3fuse                      | python           | 4.1.94.7                           |
| 10 | s3-fuse-plugin              | deb              | 4.1.94.7                           |
| 11 | python3-s3-fuse-plugin      | deb              | 4.1.94.7                           |
| 12 | python3-s3fuse-plugin       | rpm              | 4.1.94.7-4.1                       |
| 13 | python-s3fuse-plugin-cent7  | rpm              | 4.1.94.7-4.1                       |

### Following packages changed/added in the current release <a href="#following-packages-changed-added-in-current-release" id="following-packages-changed-added-in-current-release"></a>

|    | **Package/Container Names**       | **Package Kind** | **Package/Container Version/Tags**                             |
| -- | --------------------------------- | ---------------- | -------------------------------------------------------------- |
| 1  | workloadmgr                       | deb              | 4.1.95.22                                                      |
| 2  | workloadmgr                       | python           | 4.1.94.23                                                      |
| 3  | tvault\_configurator              | python           | 4.1.94.17                                                      |
| 4  | tvault-horizon-plugin             | rpm              | 4.1.94.7-4.1                                                   |
| 5  | tvault-horizon-plugin             | deb              | 4.1.94.7                                                       |
| 6  | python3-tvault-horizon-plugin     | deb              | 4.1.94.7                                                       |
| 7  | python3-tvault-horizon-plugin-el8 | rpm              | 4.1.94.7-4.1                                                   |
| 8  | RHOSP16.1 Containers              | Containers       | 4.1.94-hotfix-16-rhosp16.1                                     |
| 9  | RHOSP16.2 Containers              | Containers       | 4.1.94-hotfix-16-rhosp16.2                                     |
| 10 | RHOSP13 Containers                | Containers       | 4.1.94-hotfix-16-rhosp13                                       |
| 11 | Kolla Containers                  | Containers       | <p>4.1.94-hotfix-13-ussuri</p><p>4.1.94-hotfix-12-victoria</p> |
| 12 | TripleO Containers                | Containers       | 4.1.94-hotfix-12-tripleo                                       |

## 6. T4O Deployment Coverage <a href="#id-8.-tvo-deployment-coverage" id="id-8.-tvo-deployment-coverage"></a>

The following table gives the overview of coverage against Trilio Deployment with Openstack:

|   | TVault Deployment Tool       | Covered ? | Comments                                                      |
| - | ---------------------------- | --------- | ------------------------------------------------------------- |
| 1 | Shell Script                 | NO        | Scoped out since TVO-4.1                                      |
| 2 | Ansible (*Openstack native*) | YES       | For Kolla & Openstack ansible                                 |
| 3 | Debian Packages              | YES       | Used on Ubuntu based distro via all TVault Deployment methods |
| 4 | RPM Packages                 | YES       | Used on RH based distro via all TVault Deployment methods     |
| 5 | RH Director                  | YES       | For RHOSP                                                     |
| 6 | TripleO                      | YES       | For TripleO                                                   |
| 7 | Juju/Charms                  | YES       | For Canonical Openstack                                       |

## 7. Backup Store Coverage <a href="#id-9.-backup-store-coverage" id="id-9.-backup-store-coverage"></a>

The following table gives the overview of coverage against backup stores covered as part of the development and testing of 4.1.HF9 release.

|   | Backup Storage | Covered? |
| - | -------------- | -------- |
| 1 | AWS S3         | NO       |
| 2 | NFS            | YES      |
| 3 | RH Ceph S3     | YES      |
| 4 | Wasabi S3      | NO       |

## 8. Known Issues <a href="#id-10.-known-issues" id="id-10.-known-issues"></a>

|    | Summary                                                                                                                                                                                                                                                                                                                                                             | Workaround/Comments (if any)                                                                                                                                                                                                                                                                                                                                                         |
| -- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 1  |                                                                                                                                                                                                                                                                                                                                                                     |                                                                                                                                                                                                                                                                                                                                                                                      |
| 2  | <p>restore fails for SRIOV network</p><p><em>(Fixed in 4.1.HF7; documenting single scenario)</em></p>                                                                                                                                                                                                                                                               | If port\_security\_enabled=False on the network , restore will pass and user can attach security group to the restored vm network port later after restore is done.                                                                                                                                                                                                                  |
| 3  | <p>\[Intermittent] All API calls are getting stuck.</p><p><em><strong>Note</strong>: Respective steps added to common T4O upgrade document.</em></p>                                                                                                                                                                                                                | <p>Set oslo.messaging package version to 12.1.6 on all T4O nodes.</p><p><code>/home/stack/myansible/bin/pip install oslo.messaging==12.1.6</code><br>Restart all the wlm services.</p>                                                                                                                                                                                               |
| 4  | <p>Contego package installation failing on HF5 OSA with S3.</p><p><em><strong>Note</strong> : Respective steps added to common T4O components upgrade document against OSA distro.</em></p>                                                                                                                                                                         | Before contego package upgrade unmount /var/triliovault-mounts path                                                                                                                                                                                                                                                                                                                  |
| 5  | In-place restore not working properly with multiattach volume                                                                                                                                                                                                                                                                                                       | <p>Select all the VM's boot disk as well as cinder multiattach disk on the in-place restore window.<br>Restore will work fine for all the VM</p>                                                                                                                                                                                                                                     |
| 6  | Snapshot mount only shows volume group/LVM for one VM when 2 or more VMs have volume group with same name                                                                                                                                                                                                                                                           | NA                                                                                                                                                                                                                                                                                                                                                                                   |
| 7  | <p>Snapshot Disk Integrity Check Disabled for 4.1.HF1 release.</p><p><strong>Impact</strong></p><ol><li>If any snapshot disk OR the chain gets corrupted, T4O will identify it and log the warning message in logs however the snapshot will not be marked failed. Workload reset also will not be happening.</li><li>Restore of such snapshot will fail.</li></ol> | None                                                                                                                                                                                                                                                                                                                                                                                 |
| 8  | Backup and restore should not break for instances with multi-attach volumes.                                                                                                                                                                                                                                                                                        | After upgrade from 4.1 GA to 4.1HF1 , snapshots which trigger just after upgrade for workloads having multi-attach volume would be of “mixed” type after that all snapshots will be of incremental types .                                                                                                                                                                           |
| 9  | \[FRM] Snapshot mount not working                                                                                                                                                                                                                                                                                                                                   | <p>Update permissions of NFS mount point to 755 on the NFS server and retry snapshot mount operation.</p><p>{noformat}chmod 755 /mnt/tvault/tvm4{noformat}</p>                                                                                                                                                                                                                       |
| 10 | \[Intermittent] \[RHOSP 16.1] \[Horizon] After the overcloud deployment, openstack UI messed UP.                                                                                                                                                                                                                                                                    | <p>Login to the Horizon container and run the following commands:</p><ol><li>podman exec -it -u root horizon /bin/bash</li><li>/usr/bin/python3 /usr/share/openstack-dashboard/manage.py collectstatic --clear --noinput</li><li>/usr/bin/python3 /usr/share/openstack-dashboard/manage.py compress --force</li><li>Restart the Horizon container : podman restart horizon</li></ol> |
| 11 | \[DR] Selective restore fails, If original image is deleted in canonical focal-victoria environment                                                                                                                                                                                                                                                                 | None                                                                                                                                                                                                                                                                                                                                                                                 |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.trilio.io/openstack/tvo-4.1/triliovault-4.1-release-notes/triliovault-4.1-hf13-release.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
