Merging Migration Packages

Pulse allows you to merge existing packages if they haven’t already been executed. This allows you to aggregate multiple changes into one large package that can be provided to your operations or run team to upgrade your test and/or production system.

You can merge both Live or Offline packages but you can only merge into the same type. 

The merge package page lists all of the packages and provides a panel on the right that has the order in which one or more packages are merged. The first package in the list is where all of the subsequent packages will be merged into, the target. Only packages that have not been executed can be the target package. This is to ensure that the history of execution matches the contents of the package. If the package has already been executed it will be displayed in pink to show that it is invalid and can’t be merged.

The packages listed below the target package will be merged in order from top to bottom. This is carried out one package at a time, if there are the same objects in 2 or more packages they will be overwritten as the package is merged. This means that the most important package is at the bottom.

A package that has already been executed can’t be merged into:

To maintain the history of packages as they are created in is recommended that you create a empty package and then merge the rest of the packages into this one.

To create an empty package follow these steps:

1. Go to Migration > Create Package
2. Select the Manual option (the instance isn’t important)
3. Don’t select any objects and click Next.
4. Click Next on the Review Changes step.
5. Click Next on the Dependencies step.
6. Add a Name and Description.
7. It is important that you select the correct package type, you can only merge packages of the same type.
8. Click Save.

The package is now ready for packages to be merged into to it.

1. Go to the package you want to merge into and click Merge.
2. Find each package you want to merge into the target and click Merge checkbox.
3. Repeat until all packages have been added.
4. Reorder as necessary, the packages at the end of the list will override existing items if they already exist.
5. Click on the Merge button.