You are here: RPM Installation > Upgrading > Upgrading Moab Insight (RPM)

3.28 Upgrading Moab Insight (RPM)

This topic provides instructions to upgrade Moab Viewpoint to the latest release version using the RPM upgrade method. It includes instructions for migrating your database schema to a new version if necessary.

Because many system-level files and directories are accessed during the installation, the instructions in this guide should be executed with root privileges.

You will see that the instructions execute commands as the root user. Please note that the same commands will work for a non-root user with the sudo command.

3.28.1 Upgrade the Insight Server

Insight version 9.0.2 or 9.0.3 is required to upgrade to Insight version 9.1.0 or after.

Do the following:

If upgrading from an Insight version prior to 9.0.2, you need to first upgrade Insight to version 9.0.2 or 9.0.3. Those upgrade instructions are available from the Adaptive Computing Documentation page.
On the Moab Server Host, stop Moab from sending messages to Insight.
```
[root]# mschedctl -s
```
If you are upgrading Insight from a version prior to 9.1.0, confirm the MongoDB database is upgraded to 3.2.x. See 3.23 Upgrading to MongoDB 3.2.x (RPM) for more information.
On the Insight Server Host, do the following:
1. If you have not already done so, complete the steps to prepare the Insight Server Host for the upgrade. See 3.19 Preparing for RPM Upgrades for more information.
2. Stop Insight
```
[root]# service insight stop
```
3. Back up the Insight home directory.
```
[root]# cp -r /opt/insight /opt/insight-<version>-backup
```
  Where <version> if the product version being backed up.

If upgrading from version 9.0.2 or 9.0.3, the Insight PostgreSQL database is no longer used. You can optionally backup the PostgreSQL database. On the host where the Insight PostgreSQL database resides, do the following:

[root]# su - postgres
[postgres]$ pg_dump moab_insight > /tmp/moab_insight_<version>.dump
[postgres]$ pg_dump moab_insight_reference > /tmp/moab_insight_reference_<version>.dump
[postgres]$ exit
[root]# mv /tmp/moab_insight_<version>.dump /opt
[root]# mv /tmp/moab_insight_reference_<version>.dump /opt

On the Insight Server Host, do the following:
1. Install the upgrade.
```
[root]# yum update moab-insight
```
2. Merge the new configuration from /opt/insight/etc/config.groovy.rpmnew into /opt/insight/etc/config.groovy.
3. Verify the insight user has read access to the /opt/insight/etc/config.groovy file.
```
[root]# ls -l /opt/insight/etc/config.groovy
-rw-------. 1 insight insight 4687 Oct 24 17:57 /opt/insight/etc/config.groovy
```
4. Verify the following line is added to the end of /opt/insight/etc/insight.conf:
```
JAVA_HOME="/usr/java/latest"
```
5. Start Insight.
```
[root]# service insight start
```
6. Wait for and confirm the database upgrade completed. All data must be transferred before the upgrade is complete.
  When the upgrade is completed, you will see output similar to the following in your /opt/insight/log/insight.log file.
```
2016-06-28T06:25:13.120-0600	main	INFO	com.ace.insight.data.service.dbinit.DbUpgradeService 0 Database has been upgraded to current version
```
On the Moab Server Host, have Moab resume sending messages to Insight.
```
mschedctl -r
```