Chat now with support
Chat with Support

Metalogix ControlPoint 8.5 - Administration Guide

Preface Configuring the Environment in Which ControlPoint Will Run The ControlPoint Configuration Site Managing Your Farm List Managing Your ControlPoint License Granting ControlPoint Access to Web Applications and Content Databases Configuring ControlPoint Services Using Discovery to Collect Information for the ControlPoint Database Cache Using Sensitive Content Manager Services Setting Sensitive Content Manager EndPoints and Managing Scanning Preferences 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 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
Changing Trace Switch Logging Levels 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 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

 

Managing Archive Audit Log Configuration Settings

The following archive audit log configuration settings are managed within the ControlPoint Configuration site:

·ArchiveAuditLogConnectionString – the connection string for the database where the Audit_Log_Transfer Database table resides.  See Adding the Database Connection String to ControlPoint .

·ArchiveAuditLogIncludedWebApplications –a list of Web application GUIDs that you want to include in the archive process (if different than the default, which is all Web applications in the SharePoint farm).

·ArchiveAuditLogProcessInterval— the number of hours’ worth of data that is processed at one time (if different from the default, which is one (1) hour).

See also Modifying ControlPoint Configuration Settings.

 

Specifying the Web Applications to Include in the Archiving Process

By default, the ControlPoint audit log archive process runs on all Web applications in the SharePoint farm.  ControlPoint Application Administrations can, however, specify which Web applications that they want to include in the process (for example, only those that are subject to regulatory requirements).  

NOTE:  Web applications that you choose to include in the audit log archiving process will automatically be excluded from the purge process (as determined by the Number of Days to Keep Audit Records_ , to ensure that the purge process will not run before data is archived.  

To specify Web applications to include in the archiving process:

Enter the Web application's GUID as the Value of the ControlPoint Setting Edit Settings for Web Applications to Include in Audit Logs.  

TIP:

·To locate a Web application's GUID, select the Web application in the ControlPoint SharePoint Hierarchy, right-click and choose Properties.

·Copy the ID Property Value and paste it directly into the Web Applications to Include in Audit Logs Value field.  

WAP Guid

NOTE: Enter multiple Web applications as a comma-separated list.

Config Setting ArchiveAuditLogIncludeWebApplications

TIP:  Use the Notes field to record the names of included Web applications, as you cannot as easily retrieve a Web application's name based on its GUID.

 

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating