Patch upgrade 8.5.2 to 8.5.5

General
, ,
1

Hi All,

I am fairly new to the upgrade process and we are performing an in-place patch upgrade from 8.5.2 to 8.5.5 in our Tomcat and PostgreSQL instance. I have requested and downloaded into my local environment version 8.5.5 from the Digital Delivery. I’ve looked at https://docs-previous.pega.com/keeping-current-pega/85/applying-patch-place but I have not been able to find answers to my questions.

In order to perform the patch upgrade well import the 117075_Pega8.55.zip file into our tomcat server, but what directory should I place the zip file in? After extracting the files, I’ll modify the setupDatabase.properties files with the values in setupDatabase.properties on my current installation and run patch.sh from /scripts.

Do I need to make any other changes to perform a patch upgrade? Thank you all in advance for your help and patience.

2

@andym509 :

what directory should I place the zip file in?

→ Any directory with execution privilege ( if this is linux/unix OS), The server should have access to Pega DB.

Do I need to make any other changes to perform a patch upgrade?

→ JAVA_HOME need to to be set. Since this is in-place, shutdown all pega nodes.

Please refer links:

For post patch steps refer;

3

@SuhasKumar Thank you for your kind help. I have imported the .zip file and modified setupDatabase.properties to include the information in my current installation setupDatabase.properties when i try to run ./patch.sh I get the following error:

ubuntu@ip-10-0-1-250:~/testdata/scripts$ ./patch.sh
Buildfile: /home/ubuntu/testdata/scripts/setupDatabase.xml

upgrade:

startover_or_resume:
[pega:propertyparser] Reading Properties from: /home/ubuntu/testdata/scripts/setupDatabase.properties
[pega:compareconnectiondetails] resume props file path = /home/ubuntu/testdata/scripts/resume.properties
[pega:propertyparser] Reading Properties from: /home/ubuntu/testdata/scripts/resume.properties
[echo] Detected resume.properties and automatic.resume flag in setupDatabase.properties is set to true.
[echo] Resuming upgrade…

Initialization:
[echo] Performing Upgrade Finalization
[echo] Using logging configuration from: ./config/deploylogging.properties
[pega:propertyparser] Reading Properties from: /home/ubuntu/testdata/scripts/setupDatabase.properties
[pega:propertyparser] system.name=pega
[pega:propertyparser] customerdata.schema.name=
[pega:propertyparser] pega.jdbc.driver.class=org.postgresql.Driver
[pega:propertyparser] production.level=2
[pega:propertyparser] db2zos.udf.wlm=
[pega:propertyparser] pega.jdbc.url=jdbc:postgresql://pega-dev-db.cnyr0x1pglqg.us-east-1.rds.amazonaws.com:5432/pega-uat-db
[pega:propertyparser] pega.admin.password=*****
[pega:propertyparser] data.schema.name=dataschema
[pega:propertyparser] pega.database.type=postgres
[pega:propertyparser] automatic.resume=true
[pega:propertyparser] bypass.udf.generation=true
[pega:propertyparser] update.existing.applications=false
[pega:propertyparser] run.ruleset.cleanup=true
[pega:propertyparser] bypass.pega.schema=
[pega:propertyparser] pega.jdbc.username=postgres
[pega:propertyparser] rules.schema.name=rulesschema
[pega:propertyparser] pega.zos.properties=
[pega:propertyparser] pega.jdbc.password=*****
[pega:propertyparser] multitenant.system=false
[pega:propertyparser] update.applications.schema=false
[pega:propertyparser] user.temp.dir=
[pega:propertyparser] pega.jdbc.driver.jar=/opt/tomcat/lib/postgresql-42.2.2.jar
[echo] *** JVM Arguments -Xmx4g -XX:+HeapDumpOnOutOfMemoryError ***
[propertyfile] Updating property file: /home/ubuntu/testdata/scripts/resume.properties
[propertyfile] Updating property file: /home/ubuntu/testdata/scripts/resume.properties
[pega:hasenoughspace] Not Able to Check for Free space on ‘/home/ubuntu/testdata/scripts/${user.temp.dir.root}’
[echo] Driver Path: /opt/tomcat/lib/postgresql-42.2.2.jar
[pega:getbuildcodesetversion] Found runtime codeset version FS_ONLY
[pega:getbuildcodesetversion] Found manifest codeset version 08-05-06

BUILD FAILED
/home/ubuntu/testdata/scripts/setupDatabase.xml:353: The following error occurred while executing this line:
/home/ubuntu/testdata/scripts/setupDatabase.xml:1210: Directory /tmp/PegaInstallTemp-13-December-2021-21.31.19/load creation was not successful for an unknown reason

Total time: 1 second
Ant Process returned a non 0 value

4

@andym509

In setupDatabase.properties, set value for “user.temp.dir=” to a location where user running script has “rwx” privilege

5

@SuhasKumar once again thank you for your kind help. I was able to run patch.sh and the update is in progress. I have a question about the post patch steps.

https://docs-previous.pega.com/keeping-current-pega/85/apache-tomcat-redeploying-pega-platform

to summarize steps taken:

  1. I created a directory ‘Pega_855’ in /home/ubuntu and unzipped the patch release .zip file there
  2. I also created a directory ‘temp’ in Pega_855 with “rwx” privileges and added the location to “user.temp.dir=” in setupDatabase.properties along with the connection information and same values as in setupDatabase.properties in current version.
  3. ran patch.sh from /Pega_855/scripts/ and the update is in progress.

After the update completes. I will:

  • remove the current prweb.war from webapps directory. This is the prweb.war file for my current version 8.5.2.
  • copy prweb.war from /Pega_855/archives/ (prweb.war file for patch upgrade version) to Tomcat_home/webapps/ directory (replacing prweb.war file for version 8.5.2)
  • restart the application server
  • shutdown the server and delete prweb.war from Tomcat_home/webapps/
  • start the server and access Pega platform through the browser

Please let me know if I am missing something for the post patch steps.

Regards, Andy.

6

@andym509 these post steps should be sufficient for patch updates

7

@SuhasKumar Huge thank you for your time and help. After adding the temp directory value to “user.temp.dir=” in setupDatabase.properties It worked and I have upgraded to 8.5.5.