Procedure: Fast upgrade Unica Plan
Plan pre-upgrade
About this task
- Existing customers who want to upgrade to JBoss + 12.1, must perform the
following steps:
- Clear the recent items for all the users. Note: Administrator: Please communicate to all the users to clear their respective recent items prior to the migration to JBoss.
- Clear the directory <PLAN_HOME>/recentdata.
- Migrate to JBoss + 12.1.
- No change is required to be done by new customers who are installing JBoss + 12.1. This is because recent items will not be present in their case.
For a Plan pre-upgrade, perform the following steps:
Procedure
Upgrading Unica Plan
Updating JDBC files
About this task
Procedure
Upgrade to 12.1 config
About this task
Procedure
Upgrading Plan database
Procedure
Unica Plan post-upgrade
Unica Plan Configuration changes
About this task
About log4j
upgrade
Prior to 11.1, log4j1x
API was used by the Plan
source.
For 11.1 and later versions
- The syntax of
<PLAN_HOME>/conf/plan_log4j.xml has been
changed to
log4j2
format.The configuration file contains the following lines at the top:<?xml version="1.0" encoding="UTF-8"?> <Configuration packages="com.unica.afc.logger" monitorInterval="60">
Prior to upgrade to 12.1, if you had upgraded Unica Plan version to 11.1, a file plan_log4j.11.1.0.0.xml is available in the <PLAN_HOME>/conf/ location, which contains the earlier mentioned syntax.
In this case, the syntax of plan_log4j.xml file in the <PLAN_HOME>/conf/ location would not be as per
log4j2
formatIn such a case the file plan_log4j.11.1.0.0.xml should be used in the following properties:- -Dlog4j2.configurationFile
- -Dlog4j.configurationFile
Note:In case of 12.1.0.4, plan_log4j.11.1.0.0.xml should be used in the following properties:- -Dplan.log4j.config=<Plan_home>\conf\plan_log4j.11.1.0.0.xml
- log4j2x API is used by Plan source.
- log4j1x API is still used by unica_common.jar inside Plan JVM, because the Platform source (which results in unica_common) has not been changed to use log4j2x. For this reason, we provide the plan_log4j_1x.xml, which is as per the log4j1x syntax .This file is not used by the source code in Unica Plan (this is valid only till version 12.1.0.3 and not for later versions).
Procedure
Setting the Plan – Help About > Version
About this task
Procedure
Plan Post Upgrade Functional check
About this task
Perform UAT on the plan application. Ensure that all the Plans, Programs, Projects, Tasks, Approvals are opening and that the data is successfully imported. Ensure if all the configurations nodes are available.