# Perform a major upgrade using installer for RHEL

Supported in: This document explains how to perform a major upgrade for an existing Remote
Agent using the installer for Red Hat Enterprise Linux (RHEL) 8.7.
This procedure involves installing and configuring prerequisite packages before executing the upgrade script.
For more information on how to install an agent on a new deployment, see
[Create an agent using installer on RHEL.](https://docs.cloud.google.com/chronicle/docs/soar/working-with-remote-agents/create-agent-with-installer-for-rhel.md.txt)

If your host runs RHEL 9 or 10 (or later) with a containerized deployment, see
[Perform a major upgrade of a Podman image](https://docs.cloud.google.com/chronicle/docs/soar/working-with-remote-agents/upgrade-agent-podman-image.md.txt)
or
[Perform a major upgrade of a Docker image](https://docs.cloud.google.com/chronicle/docs/soar/working-with-remote-agents/upgrade-agent-docker-image.md.txt).

> [!NOTE]
> **Note** : To install all the packages, you must have superuser privileges. However, to ensure some dependencies remain accessible to non-root users, don't change the root user's `umask` from the default value of `0022`.

**Important:** Keep the shell session open until you finish all steps.

To install and configure required packages to upgrade Remote Agents with version 2.0.0 and higher, follow these steps:

1. Run the following command to install Linux packages:

   ```bash
   dnf install perl-core -y
   ```
2. Run the following commands separately to install OpenSSL 3.0.7:

   ```bash
       cd /usr/local/src
       wget https://www.openssl.org/source/openssl-3.0.7.tar.gz
       tar -xf openssl-3.0.7.tar.gz
       cd openssl-3.0.7
       ./config --prefix=/usr/local/ssl --openssldir=/usr/local/ssl shared zlib
       make -j$((`nproc`+1))
       make install
   ```
3. Run the following commands separately to configure OpenSSL environment variables:

   ```bash
       cd /etc/ld.so.conf.d/
       echo /usr/local/ssl/lib64 > openssl-3.0.7.conf
       ldconfig -v
       echo PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/local/ssl/bin" > /etc/environment
       source /etc/environment
       ln -sf  /usr/local/ssl/bin/openssl /usr/bin/openssl
       export LDFLAGS="$LDFLAGS -L/usr/local/ssl/lib64"
       export LD_LIBRARY_PATH=/usr/local/ssl/lib64
   ```

**Need more help?** [Get answers from Community members and Google SecOps professionals.](https://security.googlecloudcommunity.com/)