PPM Upgrade Refactoring

To facilitate the PPM upgrade, we implemented some improvements in 9.61. This topic describes these improvements in details.

What the improvements bring

The deployment improvements provide the following benefits to you:

Area Benefits
Optimized deployment file structure
  • Consistent PPM code file system among all nodes on the same server.
  • Centralized management of content and customization files.
  • Easy restore of the out-of-the-box PPM code file system.
New upgrade mode
  • Prevalidate before the upgrade to decrease the upgrade downtime.
  • Upgrade PPM code file system and database independently.
  • Avoid long classpath issue in Windows.

Back to top

Optimized deployment file structure

The diagram below illustrates the deployment file structure before and after 9.61.

Major change Description
_common folder

All the PPM nodes on the same server share a same set of PPM code files that are collected under the _common folder.

If you want to deploy multiple nodes on a single server, it helps solve the following issues:

  • Save you from copying the whole PPM code file system to each node.

    If you want to add a new node, you no longer need to copy the PPM code file system. You just need to do the following.

    1. Update the server.conf file.
    2. Run kUpdateHtml.sh.
    3. Run kStart.sh -name<Node_Name>.
  • Make sure all the nodes are always in sync with each other.
_OOTB folder This folder contains a server.zip file that backs up all the out-of-the-box PPM code files. It allows you to restore your current PPM file system when it is corrupted for some reasons.
ppm_hotfix folder This folder contains all the hotfixes you have deployed.
customization folder

This is the folder where all your customizations are put.

The customization folder is structured the same as the <PPM_Home> folder.

If you want to share customizations among servers, you can move the folder to a shared place. Remember to update the com.kintana.core.server.CUSTOMIZATION_LOCATION parameter in the server.conf file to the shared place.

You can use the kSync.sh command to merge contents under this folder to the PPM code file system.

content folder

This is where you put your PPM content files (JSP for reports, Excel Report XLSX templates, etc.).

The content folder behaves in the same way as the customization folder, except that you’re supposed to store files that are not likely to break upon PPM upgrade in the content folder. This provides a convenient way to separate files that are considered to be “customizations” and thus more likely to cause trouble upon upgrade (modifications of built-in JSP files, Java classes that are accessing PPM database without using supported APIs) from “content” files which shouldn’t require any specific scrutiny or testing when upgrading PPM.

Back to top

New upgrade mode

See New upgrade mode.

Back to top

Best practices for upgrade

See Best practices for upgrade.

Back to top

kSync.sh

See kSync.sh.

Back to top