> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ocient.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ocient Software Upgrade

export const Ocient = "Ocient®";

To upgrade the {Ocient} software, you must upgrade the DEB or RPM package on each node in the cluster. Versions of the Ocient software must match across the cluster, so upgrades must be done in an all-or-nothing fashion. Contact Ocient Support for assistance with the upgrade process.

<Info>
  The Ocient System does not support the downgrade of the software.
</Info>

<Warning>
  Consult the release notes for the target version. The version might have changes to any of the supported operating systems, the required operating system configuration, or the `rolehostd` configuration.
</Warning>

## Ocient System Prerequisites

* An existing Ocient installation is present on each node in the cluster.
* The RPM or DEB file is locally available on the file system.
* No jobs are running on the Ocient cluster.
* All nodes have stopped the `rolehostd` service.  For details about stopping the `rolehostd` service, see the [Startup and Shutdown Procedure](/startup-and-shutdown-procedure).

## RPM Upgrade

<Warning>
  Consult the documentation of the package manager of your operating system for specific options and command-line syntax.
</Warning>

Use this command to upgrade using an Ocient RPM package from the local file system. Include `./` or specify the full path to the RPM file, otherwise the `dnf` command attempts to search the configured repositories instead of installing the local RPM file. In this example, replace `XX` with the Ocient package version of the provided file.

```shell Shell theme={null}
sudo dnf install ./ocient-XX-x86_64.rpm
```

After the upgrade is complete, you must run the startup procedures on all nodes. For details, see [Startup and Shutdown Procedure](/startup-and-shutdown-procedure).

## DEB Upgrade

Use this command to upgrade using an Ocient DEB package from the local file system. Include `./` or specify the full path to the DEB file, otherwise the `apt` command attempts to search the configured repositories instead of installing the local DEB file. In this example, replace `XX` with the Ocient package version of the provided file.

```shell Shell theme={null}
sudo apt install ./ocient-XX-amd64.deb
```

After the upgrade is complete, you must run the startup procedures on all nodes. For details, see the [Startup and Shutdown Procedure](/startup-and-shutdown-procedure).

## Related Links

[Maintenance Overview](/maintenance-overview)

[OcientAIQ Unified Data Platform Release Notes](/ocientaiq-unified-data-platform-release-notes)
