Change Auditor 7.5 - User Guide

Upgrade Change Auditor for SharePoint

Upgrade Change Auditor for SharePoint

Use this upgrade procedure if you have a previous version of Change Auditor for SharePoint installed and have existing SharePoint auditing templates defined.

•	Step 1: Upgrade Change Auditor components

•	Step 2: Run SharePoint Solution Manager

•	Step 3: Edit existing SharePoint Auditing templates

Step 1: Upgrade Change Auditor components

Step 1: Upgrade Change Auditor components

If you have a previous version of Change Auditor installed, upgrade the Change Auditor components in the following order:

NOTE: For detailed instructions on upgrading Change Auditor, see the Change Auditor Installation Guide.

1	Change Auditor coordinator (and database schema)

NOTE: If you are upgrading from Change Auditor for SharePoint 6.0, you will not require a new license for this product (or any of the other Change Auditor products).

2	Change Auditor client

3	Change Auditor agents

 

NOTE: Deploy an agent on one of the SharePoint Web Front End servers in the SharePoint farm to be monitored.

 

Step 2: Run SharePoint Solution Manager

Step 2: Run SharePoint Solution Manager

Users with existing SharePoint auditing in place must run the SharePoint Solution Manger on all SharePoint Central Administration servers.

NOTE: If any existing SharePoint auditing templates are edited after a 6.5 upgrade, the wizard checks the Solution Deployment .wsp file and alerts you if the SharePoint Solution Manager has not been run.

1	On the local SharePoint farm server, run the SharePoint Solution Manager utility:

▪	SharePoint 2016: SharePointSolutionManagerCALauncher2016.exe

▪	SharePoint 2019: SharePointSolutionManagerCALauncher2019.exe

These utilities can be found in the Plug-in for SharePoint folder under the Change Auditor agent installation folder. For example, the default location is: %ProgramFiles%\Quest\ChangeAuditor\Agent\Plug-in for SharePoint.

Running the SharePoint Solution Manager scans the topology and displays the message ‘Solution needs to be upgraded’.

2	Select both check boxes under the Remove previous and Install heading:

▪	Add solution to SharePoint solution store

▪	Deploy solution to all SharePoint web applications

Click Run.

3	A progress dialog appears. When completed, the Change Auditor SharePoint Solution status is updated at the top of the dialog. Click Close.

4	A message appears explaining that the old solution was removed and that the new solution was added and deployed.

5	Click Close to close the message box.

6	Restart the Change Auditor agent to enable auditing of SharePoint events.

Step 3: Edit existing SharePoint Auditing templates

Step 3: Edit existing SharePoint Auditing templates

Change Auditor for SharePoint 5.9 and later includes the GUID of the SharePoint farm server in the template name. Therefore if you are upgrading from a pre-5.9 version, you must open and edit each of your existing SharePoint auditing templates to capture this additional information.

NOTE: You must edit all exiting SharePoint templates before you can add any new ones. Ensure that all SharePoint templates contain a GUID in their Farm name (Farm field on SharePoint Auditing page) before adding new templates.

To edit an existing SharePoint Auditing template:

1	Open the Administration Tasks tab.

2	Click Auditing.

3	Select SharePoint (under the Applications heading in the Auditing task list) to open the SharePoint Auditing page.

4	Select the template to be edited and click Edit.

The wizard automatically appends the GUID associated with the selected SharePoint Farm to the name displayed in the SharePoint Farm field. In addition, the drop-down option to ‘Find a new SharePoint Farm’ is not available.

5	Click through the wizard pages. No changes are required.

6	On the last page of the wizard, click Refresh Change Auditor Solution Status and verify that the Change Auditor SharePoint Solution has been successfully added and deployed to the SharePoint farm.

7	Click Finish to save the updated template.

Once the existing SharePoint Auditing templates are updated, you can add new SharePoint Auditing templates to monitor other SharePoint farms.