Chat now with support

Get Live Help
Complete Registration

Sign In

Request Pricing

Contact Sales

ControlPoint 8.7 - Administration Guide

Table of Contents

Preface Configuring the Environment in Which ControlPoint Will Run

Configuring ControlPoint Services Moving ControlPoint to A Different Web Front-End Server

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

Using the Discovery Service

Launching the Discovery Setup Application 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 Run Detail

Running Discovery Interactively from the ControlPoint Application

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

Customizing Your Favorites

Defining Custom Properties to Apply to SharePoint Sites 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) 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

Enabling Anomalous Activity Detection via the ControlPoint Scheduled Job Review Changing the Subject and/or Body of Anomalous Activity Detection Emails

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) Exclude Web Parts from the Discovery (EXCLUDEWEBPARTS) 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 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..." 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 No User Profile Application available to service the request If you Cannot Resolve an Issue with a ControlPoint Operation

Troubleshooting the ControlPoint Application Interface

Recent Change Does Not Show Up in the SharePoint Hierarchy

Issue

During your current ControlPoint session, an action you performed (such as a Delete Site, Set User Permissions, or Add User to Group) isn't reflected in the SharePoint Hierarchy.

Possible Resolution

·Try Refreshing the SharePoint Hierarchy.

OR

·If a site collection has been added or deleted and the ControlPoint Application Administrator has configured the application to load site collections from a server-side cache, you may try refreshing this cache.

Remote Farms Do Not Display in SharePoint Hierarchy

Issue

In a multi-farm environment, only the home farm displays in the SharePoint Hierarchy.

Possible Reasons

·The ControlPoint Configuration Setting How to Display Multiple Farms in SharePoint Hierarchy is set to 1 (Display Home Farm Only).

OR

·The multi-farm environment includes different editions of ControlPoint installed (Standard, Non-Standard, and/or ControlPoint Online), and remote farm display is not supported for the edition selected as the home farm.

Solutions

·Make sure the ControlPoint Configuration Setting How to Display Multiple Farms in SharePoint Hierarchy is set to either 2 (Display home farm expanded and remote farm(s) collapsed) or 3 (Display all farms collapsed).

·If the environment includes different editions of ControlPoint, make sure the home farm is an edition that supports remote farm display, using the guidelines in the following table.

If the multi-farm installation ...	Then ...
includes ControlPoint Standard along with Non-Standard and/or ControlPoint Online	a Standard farm must be the home farm.
consists of only Non-Standard and ControlPoint Online	a Non-Standard farm must be the home farm.

NOTE: Regardless of whether or not all farms display in the SharePoint Hierarchy, you will always be able to change the active farm by selecting from the Available Farms drop-down.

Site Collections Display as "Inaccessible"

Issue

Site Collections display in the SharePoint Hierarchy followed by the text Inaccessible.

Reason

When a Content Database is added to a Web application, the ControlPoint Service Account must be granted access to it.

Solution

The ControlPoint Application Administrator can Grant the ControlPoint Service Account access to the content database(s) within the Web application(s).

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