SMaRT AFIX Installation Guide v. March 2018 Support Services For general support on this product, contact your system administrator or help desk. For up-to-date documentation, visit the STC Documentation Portal at https://documentation.stchome.com/. Additional Information This documentation describes the following: SMaRT AFIX installation. (20180507) Table of Contents SMaRT AFIX Installation Instructions ............................................................................ 1 Components ........................................................................................................... 1 New Application Installations .................................................................................... 2 Linux Instructions ...................................................................................................... 4 Build a Linux (CentOs) Server ................................................................................... 4 Install CentOS 7 Minimal and Configure ................................................................... 4 Forecaster Installation Instructions - Linux ................................................................. 5 Install Oracle Express ............................................................................................ 5 Install the SAF Database (New Installation) ............................................................. 6 Run Database Patches (Upgrades) .......................................................................... 7 Install the Web Application .................................................................................... 7 Postgres Database Installation - Linux ....................................................................... 8 Install on Linux CentOS 7 ...................................................................................... 8 Modify Postgres Server Configuration Settings .......................................................... 9 Add Fuzzy Search Module to Postgres DB............................................................... 10 SMaRT AFIX Database Initialization - Linux ............................................................... 11 Prerequisite Tasks .............................................................................................. 11 Initialize a New Database (for the First Time Only) ................................................. 11 Upgrade/Migrate an Existing Database .................................................................. 12 Set Up a Daily Job / Drop Partition ........................................................................ 13 SMaRT AFIX Database Initialization - RDS ................................................................ 13 Prerequisite Tasks .............................................................................................. 13 Initialize a New Database (for the First Time Only) ................................................. 14 Upgrade/Migrate an Existing Database .................................................................. 15 Set Up a Daily Job / Drop Partition ........................................................................ 15 SMaRT AFIX Database Migration from EC2 Postgres to RDS ........................................ 16 Prerequisite Tasks .............................................................................................. 16 Create Dump File from Postgres ........................................................................... 16 Initialize a New Database (for the First Time Only) ................................................. 16 Set Up a Daily Job / Drop Partition ........................................................................ 17 SMaRT AFIX Online Tool Web Service Installation - Linux ........................................... 18 Prerequisites ...................................................................................................... 18 Installation Steps................................................................................................ 18 Jaspersoft ETL Installation - Linux ........................................................................... 19 Prerequisites ...................................................................................................... 19 i Install Jaspersoft ETL .......................................................................................... 20 Start/Stop Jaspersoft ETL Services ........................................................................ 21 Configure the Admin Console ............................................................................... 22 SMaRT AFIX Jaspersoft ETL Deployment - Linux ........................................................ 27 Pre-Migration Checklist ........................................................................................ 27 New Installation Instructions (for the First Time Only) ............................................. 27 Upgrade Instructions ........................................................................................... 36 JasperReports Server Installation - Linux .................................................................. 40 Prerequisites ...................................................................................................... 40 Installation Steps................................................................................................ 40 Update the License File ........................................................................................ 42 Increase the JasperReports Session Timeout Period ................................................ 42 Start/Stop the JasperReports Server ..................................................................... 43 JasperReports Configuration with Keycloak ............................................................ 43 Steps to Debug Issues Related to Keycloak/JasperReports Server Integration ............ 46 JasperReports Server Upgrade - Linux ..................................................................... 48 Prerequisites ...................................................................................................... 48 Plugin Installation Steps ...................................................................................... 49 Validation Steps ................................................................................................. 49 SMaRT AFIX JasperReports Deployment - Linux......................................................... 51 Pre-Migration Checklist ........................................................................................ 51 Procedure Steps ................................................................................................. 52 Node.js Installation - Linux ..................................................................................... 56 SMaRT AFIX Application Installation Instructions - Linux............................................. 57 Prerequisites ...................................................................................................... 57 Installation and Deployment of SMaRT AFIX, iQ, and VOMS ..................................... 58 Install the Oracle Instant Client ............................................................................ 58 Install Redis ....................................................................................................... 58 Install the Deployment Package............................................................................ 58 Configure the Application Dashboard and Quick Links .............................................. 58 Configure the Reverse Proxy ................................................................................ 59 General Product Configuration Options .................................................................. 59 SMaRT AFIX-Specific Configuration Options ............................................................ 60 Standalone SMaRT AFIX vs. Multiple Application Deployment ................................... 61 Run the Application ............................................................................................. 62 Start the Products upon Bootup ............................................................................ 62 Windows Instructions................................................................................................ 63 Forecaster Installation Instructions - Windows .......................................................... 63 ii Install Oracle Express .......................................................................................... 63 Install the SAF Database (New Installation) ........................................................... 64 Run Database Patches (Upgrades) ........................................................................ 64 Install the Web Application .................................................................................. 65 Postgres Database Installation - Windows ................................................................. 66 Install on Windows ............................................................................................. 66 Modify Postgres Server Configuration Settings ........................................................ 67 SMaRT AFIX Database Initialization - Windows .......................................................... 69 Prerequisite Tasks .............................................................................................. 69 Initialize a New Database (for the First Time Only) ................................................