Chat now with support

Get Live Help
Complete Registration

Sign In

Request Pricing

Contact Sales

ControlPoint 8.6.1 - Administration Guide

Table of Contents

Preface Configuring the Environment in Which ControlPoint Will Run

Configuring ControlPoint for Additional Web Front-End Servers Additional Configuring Considerations for Multi-Farm Installations Configuring ControlPoint Services

The ControlPoint Configuration Site Managing Your Farm List Managing Your ControlPoint License

How ControlPoint Counts Users Renewing or Changing the Terms of 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

Nightly Full Discovery

Updating the Nightly Discovery Timer Job Schedule

Using the Discovery Service

Launching the Discovery Setup Application IMPORTANT: Before Running the Discovery Service Changing Discovery Service Configuration and Settings Starting or Stopping the Metalogix ControlPoint Discovery Service and Changing Discovery Service Properties Monitoring the Discovery Service Queue

Viewing Discovery Detail

ControlPoint Settings Used by the Discovery Service

Running a Full or Partial Discovery Manually

Using Sensitive Content Manager Services

Launching the SCM Services Setup Application Changing SCM Services Configuration and Settings Monitoring the Status of ControlPoint Interactions with SCM

Viewing SCM Job Detail

Setting Sensitive Content Manager EndPoints and Managing Scanning Preferences Managing ControlPoint Configuration and Permissions

Managing ControlPoint Users and Permissions

Setting Up ControlPoint Users and Groups Auto-Adding Users to ControlPoint Groups Making ControlPoint Accessible from within SharePoint

Activating ControlPoint Site Administration Features

Configuring ControlPoint Menus

Customizing ControlPoint Menus

Guidelines for Creating Customized Menus for Different Groups of Users Accessing the ControlPoint Menu Maintenance Page Creating a Custom Menu Adding and Editing Custom Items in a Menu Managing Access to ControlPoint Menus Editing and Deleting Custom Menus

Adding Advanced ControlPoint Menu Items Customizing Your Favorites

Defining Custom Properties to Apply to SharePoint Sites Accessing Members of Active Directory Groups in Different Domains or Forests Purging Historical Activity and Storage Data from the ControlPoint Services (xcAdmin) Database Enabling Server Details to Display in the SharePoint Summary Report

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

Time to Run an Operation Before Timing Out (OPERATIONTIMEOUT) Maximum Number of Objects to Processed in Parallel (MaxParallelProcs) Operations Using Parallel Processing (ParallelProcs) Objects Subject to Parallel Processing (ParallelProcSites) SQL Command Timeout Value (COMMANDTIMEOUT) Maximum Number of Objects to Pass to the Selection Builder (MaxObjectsForSelection) Maximum Alert Processing Interval (MaxAlertProcessingPeriod) Number of Seconds After Which Browser Reports Server Timeout (SERVERTIMEOUT) Idle Time Before Session is Ended (STIMEOUT) Maximum Size of Library in Which to Search for Web Part Pages (WEBPAGESLIMIT)

Audit Log Configuration Settings

ArchiveAuditLog Configuration Settings Number of Days to Keep Audit Records (AUDITMAXDAYS) Excluding Users from Audit Log Analyses (ExcludeUsersAudit) Specifying Whether to Display Site Names in Audit Log Analyses (PROCESSAUDITNAMES)

Changing Settings for Anomalous Activity Detection Restricting Functionality for Members of the Business Administrators Group

Prevent Business Admins from Deleting Orphaned users (BAPreventDelete) Prevent Business Admins from Running Cacheable Reports in Real Time (BAPreventRealTime) Preventing Members of the Business Administrators Group from Emailing Scheduled Analyses (BAPreventScheduledEmail) Show Full Hierarchy of Business Admin Sites

Changing Default Settings for ControlPoint User Groups

Show All Site Collections to Farm Admins (SUPERADMIN) Remote Service Account Administrators for Cross-Farm Operations (RSAADMIN) Auto Add Users To ControlPoint Group Maximum Group Size (CPGroupMemberLimit) Permissions Needed to See List Items in Reports (ItemSecurityLevel) Business Administrators Group Name (BADMIN)

Changing Settings to Improve Discovery Performance

Show Menu Items That Require Discovery (DiscoveryEnabled) Abort Discovery on Error (ABORTDISCOVERY) Depth at Which to Stop Discovey When Time Restriction is Reached (DISCOVERYRESUMELEVEL) Discovery Pause Time to Allow Other Operations (DISCOVERYSLEEP) SQL Command Timeout for Discovery Process (DISCOVERYTIMEOUT) Maximum Discovery Run Time (DISCOVERYTIMERESTRICTION) Exclude Web Parts from the Discovery (EXCLUDEWEBPARTS) Tuning Options to Improve Discovery Performance (SPEEDDISCOVERY) Site Collections to Exclude from Full Discovery (URLEXCLUDE) Web Applications to Exclude from Full Discovery (WAPEXCLUDE)

Changing Settings to Accommodate Special Environmental Factors

Alternate Access Mapping Zone for Navigation and Report Links (URLZONE) Enable SharePoint Server Functionality (MOSS)

Changing Default Settings for Navigation

Postpone Security Trimming of SharePoint Hierarchy Until Site Collection is Expanded (PostponeSecurityTrim) Search Using Cached Data (CACHEDSEARCH) How to Display Multiple Farms in SharePoint Hierarchy (FARMNAVIGATION) Maximum Number of Objects to Display Before Foldering (NAVCAP) Preload All Site Collections in Server-side Cache (PRELOADSITECACHE) Show SharePoint Groups with No Permissions in Hierarchy (ShowNoPermSPGroup) Display url or Site Name in SharePoint Hierarchy (SHOWURLASTITLE) Maximum Number of Users to Display in SharePoint Hierarchy (SPUSERCAP) Maximum Number of SharePoint Groups to Display in SharePoint Hierarchy (SPGROUPCAP)

Managing Site Provisioning Settings

Maximum Number of Provisioning Requests in Completed an Rejected Folders Changing the Subject and/or Body of Provisioning Request Emails Configuring the Site Provisioning Workflow Settings (SharePoint Server)

Specifying Global Settings for ControlPoint Policies

Users to Exclude from All ControlPoint Policies (CPPOLICYSUPERUSERS) Content Creation Policy url (POLICYSERVICEURL)

Setting Preferences for the ControlPoint Scheduler

Maximum Number of Scheduled Jobs to Submit at One Time (MAXSUBMIT) Number of Minutes Scheduler Will Wait Before Next Group of Jobs (OVERIDESCHEDULETIMERMINUTES) Maximum Line Items in Scheduled Report Results (SCHEDULEDREPCAP) Defining "Admins" for Scheduled Analysis Results Distribution (SiteAdminCriteria) Permissions Level for Site Admin Definition for Scheduled Report Distribution (SiteAdminPermissionLevel)

Miscellaneous and Custom Configuration Settings

SQL Server Connection String for xcAdmin Database (xcAdminConnectionString) Initial Screen (INITSCREEN) No Dashboard (NODASHBOARD)

Special-Purpose Configuration Settings

Enable Additional Tracing and Logging (DEVENV) Cross-Farm SSP Configuration Look for Site Collection Admin Users in Active Directory Groups (SiteAdminAD) Created (Hidden) Settings

Created Settings to Override ControlPoint Default Security Additional Created Settings

Changing Trace Switch Logging Levels Archiving SharePoint Audit Log Data

How the Audit Log Archiving Process Works

Tips for Archiving a Large Accumulation of Audit Data

Setting Up the Audit Log Data Archive

Creating the Audit_Log_Transfer Database Table Archive Audit Log Table Connection String (ArchiveAuditLogConnectionString)

Running the Archive Audit Log Process

Running the Archive Process from the ControlPoint Application Interface Running the Archive Process from the ControlPoint xcUtilities Interface Running the Archive Process from a Command Line Scheduling the Archive Process via Windows Task Scheduler

Managing Archive Audit Log Configuration Settings

Specifying the Web Applications to Include in the Archiving Process Changing the Archive Audit Log Process Interval (Optional)

Troubleshooting

ControlPoint Log Files

ControlPoint Web Config File (web.config) ControlPoint Administration Log (xcAdmin.log) Logged Errors Report

Troubleshooting Configuration Errors

Blank Page/Unexpected Error Could Not Load File or Assembly If You Cannot Resolve a Configuration Error

Troubleshooting the ControlPoint Application Interface

Recent Change Does Not Show Up in the SharePoint Hierarchy Remote Farms Do Not Display in SharePoint Hierarchy Site Collections Display as "Inaccessible" Site Collections Grayed-Out and "Locked" When Launched from a Server That Has IE Enhanced Security Configuration Enabled, ControlPoint Fails to Launch Properly Number of Child Objects Specified for an Object in the SharePoint Hierarchy Doesn't Match Number Displayed The Loading of Site Collections in the SharePoint Hierarchy is Extremely Slow Error Occurs When Attempting to Launch ControlPoint from a SharePoint Site A Business Administrator's SharePoint Sites Do Not Display in the SharePoint Hierarchy "A Script on the Page is Causing Internet Explorer to Run Slowly..."

Troubleshooting Discovery

"Discovery is Being Performed Now, Cannot Start" If You Cannot Resolve a Discovery Issue

Troubleshooting SharePoint Users and Permissions

Cannot Locate SharePoint Users Authenticated by Alternate (non-Active Directory) Methods System Exception: "Cannot get the members of the group..." Active Directory Group Membership: "Cannot connect to the domain controller for domain" Properties Dialog: Total Users with Permissions Displays as "Incomplete" Users with Permissions Granted Through a Claim are not Showing Up in Permissions Analysis Results

Troubleshooting Site Provisioning

Site Provision Request Workflow Failed on Start Provisioning Requests Manager: Workflow Status Column is Blank

Troubleshooting ControlPoint Operations

Not All ControlPoint Actions and Analyses Are Available to Me Your Page has Expired Timeout Exception: The server has timed out. Hyperlinks in Activity Analysis Results are broken Number of Users Has Exceeded the Allowable Threshold ASP.NET Session Has Expired Too Many Rows to Display Download as .csv: No Cached Data for Download Export Results to Excel: "The file you are trying to open is in a different format..." Action or Analysis Taking Longer Than Expected Cannot Perform Operations on Central Administration Copy/Move Insufficient Permissions Message Newly-Created Site Does Not Show Up in Manage SharePoint Groups Picker/Cannot be Scheduled Cannot Run Activity Analysis Using Real-time Data Activity Data in Analysis Results is Out of Date Cumulative Hits Only Available Option When Running Activity Analyses Activity Analysis Requests Column Only Shows 0's for Users and Requests Number of Lists in Storage Analysis Results Does not Match Number Displayed in SharePoint Hierarchy Storage Information Reported by ControlPoint is Different than What's Reported by SharePoint Most/Least and ControlPoint Policies Analysis Never Progress Beyond "Loading" Using IE 11 with SharePoint 2010 HRESULT:0x80040E09 No User Profile Application available to service the request If you Cannot Resolve an Issue with a ControlPoint Operation

Hyperlinks in Activity Analysis Results are broken

Issue:

When an attempt is made to link to a SharePoint Web Analytics page from a Site Collection or Site Activity analysis, an error occurs.

Possible Reason:

·You are running SharePoint Foundation, for which the Web analytics is not available.

OR

·You are running SharePoint Server and the Web Analytics Service has not been configured for the farm, is not online, and/or has not been associated with the Web application(s).

Possible Resolution(s):

Make sure the Web Analytics Service:

·is properly configured for the farm,

·is online, and

·is associated with relevant Web application(s).

TIP: You can run a SharePoint Summary Report to view the status of Service applications and their associations with Web applications.

Number of Users Has Exceeded the Allowable Threshold

Issue

When ControlPoint action involving multiple SharePoint users is run, a message similar to the following displays in the Task Audit:

The number of users ([num_users]) has exceeded the allowable threshold of [max_users].

Reason

The number of users to be included in the action exceeds the maximum number allowed.

Resolution

Re-run the operation on a smaller set of users.

The ControlPoint Application Administrator can also change the maximum number of users that can be included in a ControlPoint action.

ASP.NET Session Has Expired

Issue

After drilling-down several times from the results of a ControlPoint analysis, the following text appears in the Results section of the original analysis:

ASP.NET session has expired

Reason

If you had checked the parameter Open drill-downs in new window, when you drill-down in analysis results ControlPoint limits the number of these windows that can be opened at one time.

Resolution

Keep the number of open windows to within the allowable limit. (Ten is the ControlPoint default, but ControlPoint Application Administrators can change this value.

Too Many Rows to Display

Message

This report has more rows than the current row limit of xxxxx. You can raise the limit. You can also narrow the scope or parameters of the analysis

Resolution

If you receive this message, try modifying the parameters to further narrow the scope of your search/analysis.

ControlPoint Application Administrators can increase the maximum number of rows returned by an analysis,

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating

© ALL RIGHTS RESERVED. Feedback Terms of Use Privacy Cookie Preference Center