Performing AR reconciliation

Perform reconciliation on your development system. The following types of object properties are required for reconciliation:

• Old Definition —  Describes the definition of the base application objects before upgrading the server (This definition comes from the current production server.)
• New Definition — Describes the definition of the application objects after upgrading the server and includes the changes introduced in the upgrade process
• Overlay Definition —  Describes the definition of the overlay application objects before upgrading the server

Three-way reconciliation

When you review an object to reconcile during the reconciliation process, you will see a comparison of the three definitions. The following example shows the differences for a workflow object.

For reconciling AR customizations, you can copy and merge the changes from a new definition to your overlay definition that you created in the previous version. The reconciliation process allows you to reconcile changes that you made in your overlays with changes introduced by BMC during an upgrade. You can compare the changes by viewing all three definitions at once and replicate changes made during an upgrade into your overlays or modify or remove changes already present in your overlays.

Only the Overwrite type of overlay is used for comparison. Additive overlay changes are included in the upgrade, and objects with no overlay have no changes that need to be merged.

To reconcile objects automatically

You can fix the reconcilable changes automatically by using the Deployment Management Console. Perform the following steps before you deploy the deployment package:

1. Estimate conflicts:

   1. Open the AR System Deployment Management Console. From the IT Home page, select Applications > AR System Administration > AR System Deployment Management Console.

   2. Select Operations > Estimate Conflicts
      The Estimate Conflicts option creates a report by comparing the definition files in the package and the definition files on your server. The report contains the definition files which can be used for reconciliation for each object. You can also estimate the time taken for auto-reconciliation from this report.
2. Reviewing the report:
   Review the report to know which customizations will be reconciled automatically. Deploy the package if all the reported customizations are OK.

3. Merge changes:

   1. After deploying the package, click Merge Changes.
      The Merge Changes option will try to reconcile all the objects automatically. All the changes will be done to the overlay created by you.
4. Exporting the Conflicts report:
   1. Click Export Conflicts Report.
      This option will generate a report containing all the conflicts that are not reconciled automatically. You can perform the changes manually in the Developer Studio for the remaining conflicts using the Conflicts report.

To reconcile objects using snapshots

1. Compare the snapshot and generate the Objects to Reconcile list.
   1. Open BMC Remedy Developer Studio.
   2. Log in to your AR System upgraded server (development) as well as the current production server.
   3. On the AR System Navigator, right-click the server name and click Compare with Snapshot.
   4. Select the snapshot source by selecting the snapshot XML file that you captured from the server before the upgrade. 

      If you are reconciling objects by using more than one instance of Developer Studio, use the same snapshot for all Developer Studio instances.

   5. Select the comparison list that you want to generate.
      The list contains only the objects that are of Overwrite Overlay type. The following options are provided: 
      • Report objects to reconcile — This option lists all of the objects that need to be reconciled. These are objects that BMC changed and that were also changed through overlays in a way that masks the BMC changes.

      • Report objects changed in base — This option lists all of the objects that are modified during an upgrade. The old base definition is compared with the new base definition.

        You might want to choose this second option to see what changed between releases. If logic in an application changed, simply reconciling overlays might not provide all of the information you need. For example, suppose you are working with an application that has a form. You created an archive of the form by creating a custom form and attaching workflow to the original BMC form. The BMC form moves records to your custom form. In an upgraded version of the application, BMC added a field to the form, and enabled archiving on it. You might not clearly see how your customizations were affected, but they no longer work. When your workflow copies records to the form now, they are now missing a field. In this case, you would want to see what changed in the application.

        Note

        When you select the Report objects changed in base option, follow the procedure described in the Viewing and reconciling objects changed in the new base.

   6. (Optional) Select the Additional html/csv report output for viewing the comparison results in a CSV or HTML format output.

      You can save this file for comparison after reconciliation as well.

      Note

      You can also generate a report file later from the Snapshot Results menu on AR System Navigator. Right-click Objects to reconcile and select Create Report.

   7. Click Finish.
      The Objects list is generated in the Snapshot Results directory in your new server in AR System Navigator. See Reviewing the Objects to Reconcile list. 

2. Create a new packing list.

   All of the changes that you make as you reconcile will be added to the packing list. Later in the upgrade process, you will export this packing list to migrate your reconciled customizations. For more information, see Migrating customizations.
   

   Note

   If you rename a packing list, it will be added as a new list.

   1. View the Objects to Reconcile list that opens in AR System Navigator when you complete step 1.
   2. Open the Settings panel.
      
   3. From the Old Definition Source for Reconciliation drop-down list, select the current production server name.
   4. Select the Add Reconciled Objects to Packing list option. 
   5. Enter the packing list name.
      
   6. Click Apply.
      
3. Review the Differences List.
   1. Right-click the object and click View Differences.
      
      The Differences List for the object is displayed. See Reviewing the changes using the Differences List.
   2. Double-click the difference node.
      A Difference Editor for the object is displayed. For more information, see Reviewing the object definitions using the Difference Editor.
      
4. Perform the reconciliation as described in the following procedures:
   

• • Reconciling form, application, and menu objects
  • Reconciling fields, view, and fields in view overlay
  • Reconciling workflow objects

Where to go from here