8 Patchset Setup

This topic describes about the Patchset setup using Oracle Banking Microservices Architecture Installer.

Prerequisites

1. Check for existing setup or the environment is available.
2. Updated Patch Set Installation script with respective to the current release upgrade is available in the respective VM’s. If not copy the required scripts from SVN.

8.1 Foundation Setup Upgrade

Installer Path

You can download the installer from Oracle Software Delivery Cloud (OSDC). The following table provides the download path of the installer.

Table 8-1 Installer Path

Application	Archive Name	OSDC Path
OBMA patch Installer	obma_patch.zip	INSTALLER/
OBCR patch Installer	obcr_patch.zip	INSTALLER/

8.1.1 Download Installer

The patch installer is available in OSDC zip of each product.

To download the installer:

1. Launch putty and login to the VM (where the installation is planned) with OS user.
2. Create a directory obma_patch_installer in /scratch.

   mkdir -p /scratch/obma_patch_installer

   chmod 755 /scratch/obma_patch_installer

3. Navigate to the new directory obma_patch_installer.

   cd /scratch/obma_patch_installer

4. Download the patch installer zip file from the OSDC zip to obma_patch_installer directory.
5. Unzip installer zip file by executing the below command.

   unzip <product zip file>

Before you proceed, please refer section Kafka Databags Update for Kafka SSL and Kafka scram passwords update.

8.1.2 Update Properties File

To update properties file:

1. Navigate to the path /scratch/obma_patch_installer/chef-repo/.

   Open the respective OBMA properties file and update the obma_patch_properties.rb with below details.

2. Update the local user and its group.

   Figure 8-1 Update Local User and Group

   
   

   
   Description of "Figure 8-1 Update Local User and Group"

   
   
3. Verify the version of java, update if required, and ensure the same version is available in the software's directory.

   Figure 8-2 Verify Java Version

   
   

   
   Description of "Figure 8-2 Verify Java Version"

   
   
4. Verify the configuration service details, update if required.

   Figure 8-3 Verify Configuration Details

   
   

   
   Description of "Figure 8-3 Verify Configuration Details"

   
   
5. Verify the Java home and certificate names.

   Figure 8-4 Verify Java Home and Certificate Names

   
   

   
   Description of "Figure 8-4 Verify Java Home and Certificate Names"

   
   
6. Verify the Kafka details as below.

   Figure 8-5 Verify Kafka Details

   
   

   
   Description of "Figure 8-5 Verify Kafka Details"

   
   
7. Verify the plato router details, update if required.

   Figure 8-6 Verify Plato Router

   
   

   
   Description of "Figure 8-6 Verify Plato Router"

   
   
8. Update database details under “#Database details for weblogic datasource configuration”.

   Figure 8-7 Update Database Details

   
   

   
   Description of "Figure 8-7 Update Database Details"

   
   

8.1.3 Update Roles File

To update roles file:

1. Navigate to the path /scratch/obma_patch_installer/chef-repo/roles.

   Update the obma_patch_install.rb with below details.

2. If you are upgrading from one version to another, then the version to be undeployed needs to be added in the below section app_undeployment.

   Figure 8-8 App Undeployment

   
   

   
   Description of "Figure 8-8 App Undeployment"

   
   
3. In the app_deployment section, update the new version to be deployed.

   Figure 8-9 App Deployment

   
   

   
   Description of "Figure 8-9 App Deployment"

   
   
4. Navigate to the bottom of the file and verify the recipes to be executed. All the listed recipes will be executed in sequential order as shown below.

   1. run_list ['recipe[obma_jk_kafka_upgrade::delete_topic]','recipe[obma_jk_kafka_upgrade::delete_scram_users]','recipe[obma_jk_kafka_upgrade::stop_kafka]','recipe[obma_jk_kafka_upgrade::stop_zookeeper]']

      Once run, please make sure Kafka and Zookeeper are stopped. If they are still up, please stop them by performing step 1 of section Restart Kakfa.

   2. run_list ['recipe[obma_jk_kafka_upgrade]','recipe[obma_patchset::undeployapp]','recipe[obma_patchset::stopman]','recipe[obma_patchset::addjdbcconnections_plato]','recipe[obma_patchset::updatesetuseroverrides_patch]','recipe[obma_patchset::startman]','recipe[obma_patchset::deployapp]']

      Once run, please make sure all services are up.

   3. run_list ['recipe[obma_patchset::deployapigateway_router]']

      This step would bring up the plato-apigateway-router at the port specified. To confirm the same please visit the router logs at the location /scratch/work_area/logs.

8.2 Oracle Banking Collections and Recovery Patch Installation

To upgrade the OBCR product using patch installer, first perform steps mentioned in section Download Installer.

8.2.1 Update Properties File

To update properties file:

1. Navigate to the path /scratch/obma_patch_installer/chef-repo/.

   Open the respective product properties file and update the obcr_patch_properties.rb with below details.

2. Update the local user and its group.

   Figure 8-10 Update Local User and Group

   
   

   
   Description of "Figure 8-10 Update Local User and Group"

   
   
3. Verify Java home and certificate names.

   Figure 8-11 Verify Java Home

   
   

   
   Description of "Figure 8-11 Verify Java Home"

   
   

8.2.2 Update Roles File

To update roles file:

1. Navigate to the path /scratch/obma_patch_installer/chef-repo/roles and update obcr_patch_install.rb file with below details.
2. If you are upgrading from one version to another, then the version to be undeployed needs to be added in the below section app_undeployment.

   Figure 8-12 App Undeployment

   
   

   
   Description of "Figure 8-12 App Undeployment"

   
   
3. In the app_deployment section, update the new version to be deployed.

   Figure 8-13 App Deployment

   
   

   
   Description of "Figure 8-13 App Deployment"

   
   
4. Navigate to the bottom of the file and verify the recipes to be executed. All the listed recipes will be executed in sequential order as shown below.

   run_list ['recipe[obma_patchset::undeployapp]','recipe[obma_patchset::stopman]','recipe[obma_patchset::updatesetuseroverrides_patch]','recipe[obma_patchset::startman]','recipe[obma_patchset::deployapp]']