PHARMACY PRODUCT SYSTEM – NATIONAL (PPS-N) INSTALLATION GUIDE December 2016 Version 1.2 Department of Veterans Affairs Office of Information and Technology (OIT) PPS-N Installation Guide v1.2 i December 2016 Revision History Date Version Revised Description Author Pages November 1.2 All Updated content with installation REDACTED. HPE 2016 instructions for Fixed Medication Copay FMCT Team. Tiers (FMCT) Release 1.2. May 2015 1.1.02 Updated date and version number to 1.1.02. Enterprise Updated the PPS-N EAR file name. Application Maintenance August 1.1.01 Updated version number to 1.1.01, updated Enterprise 2014 the PPS-N EAR file name and the PPSNS Application MUMPS KIDS file name. Maintenance Added instructions to Undeploy the application. And made some formatting changes. November 1.0.01 Updated version number to 1.0.01, updated Enterprise 2013 the PPS-N EAR file name and the PPSNS Application MUMPS KIDS file name. Maintenance January 1.0 Updated document to modify formatting SwRI 2013 based on NRR Review. December 1.0 No applicable updates for this document SwRI 2012 November 1.0 Updated section 10.5.1 to include a SwRI 2012 reference to other applications updating the image folder October 1.0 Version 1.0 updates SwRI 2012 September 1.0 Version 1.0 SwRI 2012 PPS-N Installation Guide v1.2 ii December 2016 TABLE OF CONTENTS 1 PROJECT SCOPE ....................................................................................................................... 1 1.1 Project Identification ...................................................................................................................... 1 1.2 Project Description ......................................................................................................................... 1 1.3 PRE Project Goals and Objectives ................................................................................................. 2 2 DOCUMENT OVERVIEW ........................................................................................................ 3 2.1 Document Background ................................................................................................................... 3 2.2 Overview ........................................................................................................................................ 3 3 INSTALLATION INSTRUCTIONS .......................................................................................... 4 3.1 Terminology ................................................................................................................................... 5 3.2 Assumptions ................................................................................................................................... 6 3.3 Database Tier Installation ............................................................................................................... 6 3.3.1 Oracle Database (National) ............................................................................................................ 6 3.3.1.1 Oracle Installation .......................................................................................................................... 7 3.3.1.2 Oracle Components ........................................................................................................................ 7 3.3.1.3 Oracle User Creation ...................................................................................................................... 8 3.3.1.4 Oracle Configuration ...................................................................................................................... 9 3.3.1.4.1 Oracle Database Parameters ........................................................................................................... 9 3.3.1.4.2 Oracle Tablespaces ....................................................................................................................... 10 3.3.2 EPL Data Load ............................................................................................................................. 10 3.3.2.1 Dependency Installation ............................................................................................................... 10 3.3.2.1.1 Java SE Development Kit (JDK) Installation ............................................................................... 10 3.3.2.1.2 Apache Ant Installation ................................................................................................................ 11 3.3.2.2 Ant Build Data Load .................................................................................................................... 11 3.4 VistA/M System Installation User and Role Installation ............................................................. 12 3.5 Install SQL Load Script Files ....................................................................................................... 13 3.6 WebLogic Installation Instructions .............................................................................................. 13 3.6.1 WebLogic Listen Address ............................................................................................................ 13 3.6.2 Dependency Installation ............................................................................................................... 14 3.6.3 Class Path ..................................................................................................................................... 14 3.6.4 JTA Transaction Timeout ............................................................................................................. 15 3.6.5 JDBC Data Source Configuration ................................................................................................ 18 3.6.6 Server Logs and Log4J configuration .......................................................................................... 24 3.6.6.1 Warning: Application Server’ Disk Space and Log Files ............................................................ 25 3.6.6.1.1 Domain Logging .......................................................................................................................... 26 3.6.6.1.2 Managed Server Logging ............................................................................................................. 27 3.6.6.2 Installation of Log4J ..................................................................................................................... 29 3.6.7 Site Deployment Configuration.................................................................................................... 32 3.6.7.1 WebLogic Deployment Descriptor .............................................................................................. 32 3.6.7.2 KAAJEE Station Numbers ........................................................................................................... 33 3.6.8 Deployment .................................................................................................................................. 33 3.6.9 Installation of FDB_Images ......................................................................................................... 42 3.6.9.1 Deployment of FDB_Images........................................................................................................ 42 3.7 Upgrading to v1.2 for Fixed Medication Copayment Tiers ......................................................... 43 3.7.1 Prerequisites ................................................................................................................................. 43 3.7.2 Upgrade Instructions .................................................................................................................... 43 3.7.2.1 Prepare the Deployment Server .................................................................................................... 43 3.7.2.2 Apply database updates. ............................................................................................................... 45 PPS-N Installation Guide v1.2 iii December 2016 3.7.2.3 Update WebLogic Settings ........................................................................................................... 47 3.7.2.4 Deploy the v1.2 EAR file ............................................................................................................. 48 3.7.3 Back Out Instructions ................................................................................................................... 48 3.7.3.1 Prepare the Deployment Server .................................................................................................... 48 3.7.4 PPS-N v1.2 Database Migration Rollback ................................................................................... 48 3.7.4.1 Reset the WebLogic Settings ....................................................................................................... 49 3.7.4.2 Deploy the v1.1 EAR file ............................................................................................................. 49 4 FUNCTIONALITY TEST ......................................................................................................... 49 4.1 Assumptions ................................................................................................................................. 49 4.2 Deployment Verification .............................................................................................................. 49 5 BACKOUT PROCEDURES ....................................................................................................