Steps for Upgrading User Portal

This section details the steps required to upgrade User Portal.

Gain root terminal access to the User Portal machine. Stop the User Portal services to prevent changes to the User Portal database:
```
# supervisorctl stop all
```
(Optional) We recommend that you back up the User Portal database in case you need to restore the previous User Portal version. Consult PostgreSQL documentation for additional information about backing up the database.
Copy and extract the Key Manager installation package onto the User Portal machine (replace /path/ to/sshmgr-7.0.0-*.x86_64.tar with the path to the Key Manager installation package):
```
# tar -xvf /path/to/sshmgr-7.0.0-*.x86_64.tar
```
Navigate to the directory created from extracting the package:
```
# cd sshmgr-7.0.0-*/
```
Subsequent commands are provided with the assumption that they are performed from this filesystem location.
Install the OS-specific support packages required by User Portal. The required packages differ depending on the OS on which you are installing User Portal:
- For Red Hat 8.x/Rocky Linux 8.4 installations, install the following support packages:
```
# yum install os-support/rhel8/*.rpm
```
- For Red Hat 9.x/Rocky Linux 9.4 installations, install the following support packages:
```
# yum install os-support/rhel9/*.rpm
```
Enable the User-Portal process controller to automatically start on boot:
```
# systemctl enable supervisord
```

Install the new User Portal package:

# yum install sshmgr-user-portal-*.x86_64.rpm

Run the upgrade script to update User Portal data:
```
# /opt/sshmgr-user-portal/sbin/upgrade
```
Restart User Portal services:
```
# supervisorctl restart all
```
Restart Nginx web server:
```
# service nginx restart
```
The User Portal instance has now been upgraded to version 7.0.0. You can verify the User Portal version via the User Portal GUI and/or the Management Portal.