If your SharePoint environment has been upgraded using the "database attach" method, you can use the ControlPoint Database Recovery utility to make data that has been collected in the ControlPoint Service (xcAdmin) database available for use in the upgraded environment. The utility accomplishes this by mapping Farm- and Web Application-level GUIDs in the original environment to those in the upgraded environment.
In order to perform this procedure, Discovery must have been run on both the source and upgraded farms. Instructions can be found in the Quest® ControlPoint Administration Guide.
Data That Can Be Recovered
For any portion of the farm on which the ControlPoint Discovery job has been run, the utility can recover:
·historical information, including site collection storage and activity
·definitions of ControlPoint Policies
NOTE: It will be necessary to re-register those policies, which will enable the event handlers that actually perform the enforcement.
·Group associations used by the Manage (Linked) SharePoint Groups operation.
NOTE: Associated (linked) group will continue to display in ControlPoint, regardless of whether the content database in which they reside has been migrated.
·Information reported in the ControlPoint Task Audit.
·Scheduled ControlPoint operations.
EXCEPTIONS:
§Scheduled jobs to restore permissions will remain but will fail because permissions backups are not recovered.
§Set Site Properties operations will run if the operation includes the setting of icons or theme.
§For Set List Properties operations, the template URL may not be properly reset for the new environment.
§Any job that references content that has not been migrated will fail until that content that has been migrated.
Data That Cannot Be Recovered
The utility will not recover the following:
·User-specific information (such as last temporary location use in Copy/Move operations).
·Permissions backups.
Prerequisites
Before running the ControlPoint Database Recovery Utility, ensure that:
·the upgraded farm has been created
·ControlPoint has been installed and configured on the upgraded farm (with the existing xcAdmin database specified as the ControlPoint Service (xcAdmin) Database)
·The xcAdmin database is accessible to software running on the upgraded farm
·The content databases for which you want to run the utility have been attached and imported
NOTE: If you are attaching content databases in stages, the utility can be re-run as needed. Remember to also run Manage ControlPoint Licenses for newly attached content databases.
·ControlPoint Discovery has been run on all portions of the upgraded farm for which you want to recover xcAdmin data
The utility assumes that if more than one content database is associated with a Web application, those content databases will continue to be associated with the same Web application. If content databases are reorganized or regrouped, the utility will not work properly.
To run the ControlPoint Database Recovery Utility:
1Launch a browser session and enter the following url:
http://<server_name>:<port_number>/_layouts/axceler/xcControlPointDatabaseRecovery.aspx
where <server_name> is the name of either the server you are upgrading to or the server you are upgrading from and <port_number> is the number of the port that hosts the ControlPoint Web application (1818 is the ControlPoint default value).
2From the Current Farm drop-down, select the farm to which content databases have been imported (that is, the upgraded farm)..
NOTE: If the upgraded farm does not appear in the drop-down, make sure that:
§the ControlPoint Service (xcAdmin) database of the old farm has been designated as the Database Server for the upgraded farm, and
§Discovery has been run on some portion of the upgraded farm.
3From the Recovered Farm drop-down, select the farm from which the content databases were imported.
Two sets of drop-downs display, which enable you to map Web applications in the old farm with corresponding Web applications in the upgraded farm.
4For each Web application whose ControlPoint xcAdmin data you want to recover, map the Current Web Application to its corresponding Recovered Web Application.
Note that the Recovered Farm list may include the names of Web applications that no longer exist.
5When you have finished mapping Web applications, click [Run Now].
Note that it may take some time for the progress indicator to appear. When the operation is completed, a ControlPoint Task Audit is generated for the action and displays in the Results section.
© 2025 Quest Software Inc. ALL RIGHTS RESERVED. Terms of Use Privacy Cookie Preference Center