1

Cloud Readiness Tool User Guide

Contents
.................................................................................................................................................................. 1
Introduction ...................................................................................................................................... 2
Application Readiness utility .............................................................................................................. 2
Database Readiness utility ................................................................................................................. 2
Installation and Usage of Application Readiness Utility: ...................................................................... 2
Installation and Usage of Database Readiness utility:.......................................................................... 5
 2

Introduction
The first step in any Migration is to identify any rules, configurations, or customizations in the application
and database that do not comply with the standard Pega Cloud deployment. This document is intended
to comprehensively capture the capabilities of the Cloud Readiness Tool.

The Cloud Readiness Tool consists of two utilities

1. Application Readiness

2. Database Readiness.

Application Readiness utility

For the given application, it aims at identifying the usage of incompatible rules such as Connect-SQL,
Function Alias, Data Tables, Authentication service rules, Connectors and Services, System Information,
JVM Details etc.

It also identifies the integration rules, Rule Compliance score, Rule set Stack, Strategic Applications Used,
BIX, IAC etc. This tool identifies potential areas of the application that need mitigation in order to be
complaint with the standard of latest Pega Cloud architecture.

Database Readiness utility

The Database Readiness utility aims to identify custom database objects such as procedures, views,
triggers, sequences, functions etc. The custom database objects are not supported moving to new Pega
Cloud 2.x. This Tool also helps to identify the list of tables which does not have the primary keys. Its
always best practice to have the primary key for the table and DMS expects the primary key to move the
BLOB data

Installation and Usage of Application Readiness Utility:

This is built on Pega and it is a Rule-Admin-Product (RAP) which needs to be imported in the application
where readiness check needs to be performed in Pre-prod environment which is closer to production
environment

1. Use Application->Distribution-> Import option to import the Product RAP.

2. Include the Ruleset part of your application
 3

3. Run the activity "GenerateApplicationGapsReport".

4. This will generate the .xls file as output. Attached the sample output file which is generated after
the execution of this activity.

customer_Name_01.
01.01.xlsx

It has multiple tabs like Application summary, Connectors-Services, Connect-SQL, Data Tables, System
Information, Other Gaps and Infrastructure Gaps
 4

Application Summary:

This list the application and if any strategic application used in the application along with corresponding
version. It captures application rulesets used in the application. Additionally, it also display all the different
types of integration Rule Types

Connectors-Services

It captures all integration rules used in the application

Connect-SQL

It captures all the SQL connect rules. We can identify any data type specific functions, if any hard-coded
schema or table names used

Data Tables

It lists all the data tables used in the application. This needs to be converted to local repository

System Information

This shows Pega platform version information, Application server and Database information

Other Gaps

It highlights if BIX/IAC components used in the application. Guardrail score of application will be fetched
automatically

Infrastructure Gaps (To Be Filled manually)

Information specific to infrastructure needs to capture manually Example: Any customization to load
balancer, custom certificates, custom servlets, TLS version, cron jobs and custom domain
 5

Installation and Usage of Database Readiness utility:

This is built on Java and uses the prmaster-schema.jar as reference to find the custom DB objects as per
the selected Database. The tool contains a jar file and properties files. This tool is compatible with
ORACLE/DB2/MSSQL DB.

Steps to follow:

1) Extract and move the content of DBReadiness.zip to Database server.

2) Update the DatabaseConnection.properties file with the database Connection Parameter values which
are mandatory. Rules and data schema passwords are optional.

3) sql_queries.properties file list all DB specific queries which will be used to fetch required information.
This properties file is pre-loaded with all the required queries.

4) Execute/ Run the below command

Java -jar DatabaseReadiness_V2.jar

5) This will generate a xls file which displays the custom DB objects and in addition to that, it has Schema
wise Size in GB, Allocated Data base size and Used space.
 6

Attached the sample DatabaseConnection.properties, SQL_Queries.properties and sample report.

 7

DatabaseConnectio SQL_Queries.proper GapAnalysis.txt DBGapAnalysis.xls

n.properties ties

Sample Reports
Application Readiness Report
 8

Database Readiness Report