Working with Patches

A deployment package that cannot be installed on its own, but has to be installed on top of another package, is referred to as patch package or simply patch. A sequence of patches is referred to as patch chain. When deploying a patch to a target environment, the system will deploy all patches that are required to bring the currently installed application to the selected patch package.

Important! The actions that you can perform depend on your folder permissions, see: Folder Permissions.

Accessing the Patch Chain

If you set a package as getting patched by the current one you can view the whole patch chain that results because of the patch relations. The screen also shows patch packages that patch the current one.

To View the Patch Chain

1. Open the Application.
2. Click the Packages accordion tab and select the appropriate package.
3. Display the Advanced drop-down list in the horizontal menu.
4. Select Patch Chain.

   The screen shows:

   • The package patched by the current package.
   • The sequence of patches (patch chain).
   • The package which patches the current package.

Creating a Patch

1. Open the application.
2. Click the Packages accordion tab and select the appropriate package.
3. Packages can be patched from two different locations:
   • From the Path Chain view (display the Advanced drop-down list in the horizontal menu, select Patch Chain and click Patch)
   • From the Properties view (select Properties in the horizontal menu and click the Assign Package button next to Patches Package)
4. The Select Package dialog is displayed.
5. Select the package you want to patch from the list.
6. Click Select.

Note: You can only patch packages of the same application.

Updating and Removing Patches

You can change or remove the patched package if:

• it is not installed on any Deployment Target
• it is not patched by another Package

To Update or Remove Patches

1. Open the application.
2. Click the Packages accordion tab and select the appropriate package.
3. Patched packages can be removed/updated from two different locations:
   • From the Path Chain view (display the Advanced drop-down list in the horizontal menu, select Patch Chain)
   • From the Properties view (select Properties in the horizontal menu)
4. Click the delete button to delete the patch or click the list button to select a new version of the package and click Select.

Processing Workflow Actions for Patch Packages

You can define if you want to process an action serially for each patch package in the Deployment section of the General tab (Process Monitoring perspective). For more information, see: Working with Patches