Chat now with support
Chat with Support

Metalogix ControlPoint 8.2 - Administration Guide

Preface Configuring the Environment in Which ControlPoint Will Run The ControlPoint Configuration Site Managing Your Farm List Managing Your ControlPoint License Configuring Web Applications and Content Databases for ControlPoint Configuring ControlPoint Services Using Discovery to Collect Information for the ControlPoint Database Cache Using Sensitive Content Manager Services Managing ControlPoint Configuration and Permissions Modifying ControlPoint Configuration Settings
Changing Default Settings for Actions and Analyses
Supress "Item is inherited - no processing done" Message(SkipNotDoneMsg) Maximum Line Items in Real-time (REPCAP) "Use Cached Data" Default Value (CACHEDREP) Abort Report Processing on Error (ABORTREPORTONERROR) Display "Include users with AD group membership" Parameter (SHOWADGROUPS) Copy/Move Default Temporary Location (TEMPLOCATION) Time to Retain Page Data in Cache (CACHEREPORT4) Time to Retain Temporary UI Objects in Cache (UICACHEDURATION) Number of Reports to Keep in Memory After Drill-Down (RVSESSIONSKEPT) Exclude Web Application(s) from Statistics List (DASHBOARDWAPEXCLUDE) Number of List Items to Display in Selection Grid (DISPLAYSINGLELISTITEMS) Use Activity Min. Date as Start Date (UseActivityDbDate) Show unique permissions only" Default Value (SHOWUNIQUEPERMONLY) Duplicate Files Report Limit (DuplicateFilesReportLimit) Users to Exclude from Reports (EXCLUDEDUSERS) Eliminate Claims Prefix from Username in Reports (UseCleanedLoginNameInReports) Maximum Number of Orphaned Users to Delete Per Scheduled Batch (OrphanDeleteBatchSize) CSV Delimiter Character (CSVDELIMETER) Largest Active Directory Group to Expand in Reports (MAXMEMBERS) Maximum Number of Users to Act On (MAXUSERSFORACTION) Hide the "Set User Direct Permissions" Action in Permissions Management (PREVENTUSERPERMS) Prevent Set Site Collection Quotas (PreventSetSCQuota) Show Nested Active Directory Groups (PROCESSADHIERARCHY) Hide Interactive Analysis Link (RESTRICTSL) Use Minimum Activity Date as Start Date (USEACTIVITYDBDATES)
Changing Default Settings to Improve Application Performance Audit Log Configuration Settings Changing Settings for Anomalous Activity Detection Restricting Functionality for Members of the Business Administrators Group Changing Default Settings for ControlPoint User Groups Changing Settings to Improve Discovery Performance Changing Settings to Accommodate Special Environmental Factors Changing Default Settings for Navigation Changing Trace Switch Logging Levels Changing Default Settings for Compliance Managing Site Provisioning Settings Specifying Global Settings for ControlPoint Policies Setting Preferences for the ControlPoint Scheduler Miscellaneous and Custom Configuration Settings Special-Purpose Configuration Settings
Archiving SharePoint Audit Log Data Troubleshooting
ControlPoint Log Files Troubleshooting Configuration Errors Troubleshooting the ControlPoint Application Interface Troubleshooting Discovery Troubleshooting SharePoint Users and Permissions Troubleshooting Site Provisioning Troubleshooting ControlPoint Operations

Running the Archive Process from the ControlPoint Application Interface

You can archive audit log data for the entire farm or for individual Web applications from the ControlPoint application interface.  This is especially useful before moving a site collection, because once a site collection has been deleted from the source location its audit log data remains in the content database and becomes "orphaned."  

1From the Manage ControlPint tree, choose ControlPoint Management > Audit Log Archive.

Archive Audit Log from UI

2In the Available items section, select either the farm node or the individual Web applications whose audit log data you want to archive.

3Select the Parameters tab then enter the Number of Days to Keep in Audit Logs (that is, any audit log data that has been captured before this time period will be archived).  If you want to archive all audit log data before deleting or moving a site collection, enter 0.

Archive Audit Log PARAMETERS

Now you can either:

·run the operation immediately (by clicking the [Run Now] button)

OR

·schedule the operation to run at a later time or on a recurring basis.

OR

·save the operation as XML Instructions that can be executed at a later time.

 

Running the Archive Process from the ControlPoint xcUtilities Interface

To run the archive process from the ControlPoint xcUtilities interface:

1On the Web front-end server where the archive was set up, open xcUtilities.exe, located in C:\Program Files\Metalogix\ ControlPoint\ControlPointFeatures.

2Under Archive Audit Log,  enter the # Of Days to Keep in SharePoint.

Any audit log data that has been captured before this time period will be archived.

Archive Audit Log from Utility

3To initiate the archive process, click [Archive Audit Log].

NOTE:  If you click [Cancel Archive] after the process has been initiated, the utility will finish archiving data for the current process interval before terminating.

 

Running the Archive Process from a Command Line

To run the archive process from a command line:

1On the Web front-end server where the archive was set up, open a command window and point to C:\Program Files\Metalogix\ControlPoint\CotrolPointFeatures.

Archive Audit Log from Command Prompt

2Enter the string: xcUtilities /archiveauditlogs /daystoretain <#days>

where <# days> is an integer representing the number of days worth of audit log that you want to retain (that is, any audit log data that has been captured before this time period will be archived).

NOTE:  You can also include the optional argument /processInterval <override> if you want to override the ControlPoint Configuration Setting ArchiveAuditLogProcessInterval with an integer representing the number of hours’ worth of archive data to process at one time.

Archive Audit Log from Command Prompt 2

 

Scheduling the Archive Process via Windows Task Scheduler

Note that the procedural steps for creating a Windows scheduled task are different for Server 2003 and Server 2008.  Consult your Microsoft Server documentation for complete instructions.

To schedule the archive process:

For Server 2003:

1On the Web front-end server where the archive was set up, open the Windows Task Scheduler and Initiate a scheduled task.

2Complete the Task tab Run field with the following string:

C:\Program Files\Metalogix (or Axceler)\ControlPoint\ControlPointFeatures (or AxcelerFeature)\xcUtilities /archiveauditlogs /daystoretain <#days>

NOTE:  For a 64-bit operating system, the program directory is Program Files (x86) only if you first installed ControlPoint prior to version 4.5.

where <# days> is an integer representing the number of days worth of audit log data that you want to retain (that is, any audit log data that has been captured before this number of days will be archived).

NOTE:  You can also include the optional argument /processInterval <override> if you want to override the ControlPoint Configuration Setting ArchiveAuditLogProcessInterval with an integer representing the number of hours’ worth of archive data to process at one time.

Archive Audit Log Task Scheduler

3Complete the Schedule tab with the scheduling information that is appropriate for your environment.

Archive Audit Log Task Scheduler 2

For Server 2008 and 2012:

4On the Web front-end server where the archive was set up, open the Windows Task Scheduler and Initiate a scheduled task.

5Complete the Action dialog as follows:

a)For Action, make sure Start a Program is selected.

b)For Program/script, enter (or browse to) the following path:

C:\Program Files\Metalogix (or Axceler)\ControlPoint\ControlPointFeatures (or AxcelerFeature)\xcUtilities

NOTE:  For a 64-bit operating system, the program directory is Program Files (x86) only if you first installed ControlPoint prior to version 4.5.

c)For Add arguments, enter /archiveauditlogs /daystoretain <#days>

where <# days> is an integer representing the number of days worth of audit log data that you want to retain (that is, any audit log data that has been captured before this number of days will be archived).

NOTE:  You can also include the optional argument /processInterval <override> if you want to override the ControlPoint Configuration Setting ArchiveAuditLogProcessInterval with an integer representing the number of days’ worth of archive data to process at one time.

Archive Audit Log Task Scheduler 2012

6Complete the Trigger dialog with the scheduling information that is appropriate for your environment.

Archive Audit Log Task Scheduler 2012 2

 

Related Documents