---
title: Ocient Software Upgrade
slug: w6s-oeIDB2TI1FGuouKiI
description: Follow best practices for upgrading Ocient software, ensuring minimal disruption and maximum performance.
docTags: 
createdAt: Thu Jul 21 2022 17:05:13 GMT+0000 (Coordinated Universal Time)
updatedAt: Mon Mar 30 2026 18:52:30 GMT+0000 (Coordinated Universal Time)
---

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.

:::hint{type="info"}
The Ocient System does not support the downgrade of the software.&#x20;
:::

:::hint{type="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.
:::

## 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](<./Maintenance Overview/Startup and Shutdown Procedure.md>).

## RPM Upgrade

:::hint{type="warning"}
Consult the documentation of the package manager of your operating system for specific options and command-line syntax.
:::

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
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](<./Maintenance Overview/Startup and Shutdown Procedure.md>).

## 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
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](<./Maintenance Overview/Startup and Shutdown Procedure.md>).

## Related Links

[Maintenance Overview](<./Maintenance Overview.md>)

[Ocient Hyperscale Data Warehouse Release Notes](<././Release Notes/Ocient Data Intelligence Platform Release Notes.md>)

