Overview

This document provides information on how you can complete an application server upgrade for CRM.COM software.

Prerequisites

Before upgrading CRM.COM software please make sure you have read the /wiki/spaces/V4ReleaseNotes/pages/888043on Discover.

Upgrade process

The following section includes a step by step guide to complete the application server upgrade.

Copy the installation files provided by CRM.COM to the /install directory

Before installing CRM.COM application make sure that you locate the EAR file and possible custom rar files in the following directory: /install/crm.com/YYYY-MM-DD

Where YYYY-MM-DD is the date stamp of the last installation that took place in this app server.

For example:

 $ ll /install/crm.com/2016-10-19
-rw-r--r--. 1 root root 143155773 Oct 18 18:21 Crm_10.1.0(201610181820WFL).ear
-rw-r--r--. 1 root root    583511 Oct 19 12:59 org1_10.1.0(78606).rar
$

The example above shows that directory /install/crm.com/2016-10-19 has both a CRM release 10.1.0 built on 2016-10-18 at 18:20

And also a custom archive for organisation ORG1 with build version 78606 intended for CRM.COM release 10.1.0.

Stop the scheduler

Make sure the scheduler is stopped by navigating to FOUNDATION > UTILITIES > MANAGE SCHEDULED PROCESSES

 Image Modified

From the ACTIONS menu select STOP SCHEDULER

 Image Modified

Make sure the scheduler is in 'Stand by Mode'

 Image Modified

Perform the upgrade

To upgrade CRM.COM follow the steps below:

$ cd /install/crm.com
$ copyinstallfiles.sh 2016-10-19
$ installear.sh

Within a few minutes the installation will be completed and Wildfly will be restarted.

Run the DB update utility.

The DB update utility is used to bring the database schema to the correct version for the release that was just upgraded. It may also include necessary data migration scripts. It is always advisable that you apply the release update on a test or staging server before you apply it on the production server.

To run the DB update utility, navigate to the following URL: https://<hostname>:28443/crm/dbupdate.jsp

 Image Modified

Note that to run this utility the user should be a defined as a Supper user. 

After login in the following screen appears listing all the Organisations that exist in the Ecenter:

 Image Modified

The status column shows weather the schema needs to be updated (UPDATES AVAILABLE) or it is already updated (UP TO DATE).

Select the ones that are marked as UPDATES AVAILABLE and press UPDATE DATABASES link.

Image Modified 

After a few minutes the update will be complete and you can logout from the utility.

Post installation tasks

After upgrading the App servers make sure that the all the /wiki/spaces/V4ReleaseNotes/pages/888043 instructions which may include additional system configuration are performed. 

The last step is to start the scheduler.