Metalogix ControlPoint for Office 365 SharePoint Administration (ControlPoint Online) is installed and runs as a .NET application. During installation:
·a dedicated application pool is created in IIS for the primary ControlPoint Configuration site, which is installed under the root site of a hosted site collection
· the ControlPoint Service database (xcAdmin) is created for configuration information and analysis data
·the ControlPoint Online App is registered with Microsoft Azure to allow the use of Modern Authentication
Before You Begin
·The site collection that will host the ControlPoint Configuration Site must exist on the host and be in the English language.
·The machine on which you are installing ControlPoint must meet System Requirements.
·Make sure the machine on which you are installing ControlPoint has access to the Internet if you want to be able to activate your ControlPoint license online.
Have the following information ready (you may wish to record it in the spaces provided):
§The URL for the site collection that will host the primary ControlPoint Configuration Site* and the URL of the SharePoint Administration site hosting the site collection.
ControlPoint Configuration Site Collection URL: ______________________________________
SharePoint Administration Site URL: _____________________________________________
*REMINDER: The ControlPoint Configuration Site must be created in an English-language site collection.
§The name and port number that you want IIS to use to manage the ControlPoint Configuration Site (The default port number is 2828, but you can set it to any available value.)
Web Site Name:______________________________
Port Number: _____________________________
§The account under which you want the application pool for the ControlPoint Configuration Site to run (This is normally a domain account, but if you are running an evaluation version of the productand the database is on the same machine as ControlPointyou may use a local account.)
App Pool Service Account: ____________________________________
§The email credentials that you want to use as the "from" account for correspondence sent on behalf of ControlPoint.
Local SMTP Server: ___________________________________
Email address: ___________________________________
§The name of the SQL server that will host the ControlPoint Service (xcAdmin) database, as well as the authentication method to be used:
(This is where the content database for the ControlPoint application will reside.)
Database Server Name: __________________________
SQL Server ID ___________________________ Password _______________________
§The ControlPoint Online license activation code: ________________________________
§The Site Collection Administrator account that will be used to create the ControlPoint Configuration Site.
Site Collection Administrator Account: _____________________________________
NOTE: If you do not already have a license activation code, contact Quest to obtain one.
First Time Installation and Configuration Process
The ControlPoint Online first time installation and configuration process consists of the following stages:
C.Optionally, configuring ControlPoint Services.
It is recommended that you temporarily disable virus checkers on all Web front end servers in the farm as they can slow the solution deployment enough to trigger timeout errors.
To install ControlPoint Files:
REMINDER: If UAC enabled on your server, you may have to "Run as Administrator."
1Unzip the downloaded zip file then launch the installer (Metalogix ControlPoint Installer.exe).
NOTE: Make sure you keep the entire downloaded folder intact as there are files that are required by the installer.
A splash screen displays, followed by the ControlPoint Installer Welcome screen.
2Click Install ControlPoint.
The License Agreement dialog displays.
3Read the license agreement. Click I accept the terms of the license agreement, then click [Next].
4Select Install ControlPoint Online.
NOTE: If SharePoint is not installed on the server, this will be the only selectable option.
5 When the Metalogix ControlPoint InstallShield Welcome dialog displays, click [Next].
The InstallShield Wizard specifies a default install directory (C:\Program Files\Metalogix\ControlPoint Online), but you can click [BROWSE] and select a different one.
NOTE: This directory is where the installer will place the files needed to complete the installation.
The Configuration Wizard installs the ControlPoint files to the specified Destination Folder. When completed, a pop-up displays asking whether you want to configure ControlPoint.
NOTE: If you want to configure the ControlPoint Online application at a later time, click [No]. You can launch the ControlPoint Online Configuration Wizard from the Start menu or a Desktop shortcut.
Continue with Configuring the ControlPoint Online Application.
After ControlPoint is installed the application must be configured.
Summary of ControlPoint Configuration Process
The ControlPoint Configuration Wizard out the following tasks:
A.Checks for ControlPoint Installed Components.
B.Validates License: Checks the validity of the license key you enter as well as the terms of the license.
C.Creates ControlPoint Service database: Creates the ControlPoint Service database (xcAdmin) on the selected database server. This database is where administrative information and cached data used for analysis and reporting is collected. (Note that in a multi-farm installation, this database is shared among farms.)
D.Creates the ControlPoint Online application pool, website, and virtual directory in IIS.
E.Configures the ControlPoint Online website.
NOTE: If you change the host name, the Configuration Wizard will also create the bindings in IIS, update the redirect URI in the registered ControlPoint Online Application, and updates the ControlPoint Setting 'Inbound ControlPoint Url' to use the host header.
F. License Activation: Activates your ControlPoint license.
G.Windows Service Configuration (optional): If you elect to use server-side Windows Services for Discovery and/or Sensitive Content Manager, installs and configures the service(s) you selected.
H.ControlPoint Online Application Registration: To allow the use of Microsoft Modern Authentication, an app called ControlPoint Online is registered in the Azure Active Directory.
To configure the ControlPoint Online application:
1Use the information in the following table to determine the appropriate action to take.
you are starting directly from the ControlPoint installer (that is, after performing the install you chose to Launch ControlPoint Configuration
go to the next step.
after installing ControlPoint you chose to configure at a later time (that is, after performing the install you chose not to Launch ControlPoint Configuration
double-click the ControlPoint Online Configuration desktop icon.
The installer checks your environment for the presence of installed components.
NOTE: For a first time installation, once the components check is complete only the Fetching ControlPoint Configuration Data box should be checked (). All other options will appear with a right-facing arrow. ()
3Click [Configure ControlPoint].
4Enter the license key provided by Quest.
5.Use the information in the following to determine the appropriate License Validation option to select.
NOTE: Most systems can use the Online activation method as long as the system has internet access. If you are unable to use the online activation method due to security settings or lack of internet access, the Offline activation option can be used. This option will still require some internet access, but allows for the authentication to be done from another machine that is not as restricted by security or has a connection to the internet.
If you want to validate the license...
accept the default option (Activate Online).
a)Select Activate Offline.
The Offline Activation window displays. You can either Copy Activation Data To Clipboard or use the Save Activation Data To File option to save the key into a text file (in case it needs to be copied to another machine).
b)From a machine that has internet access, go to https://support.quest.com/offline-activation.
c)Follow the instructions on the Offline Activation web page to activate your license, using the Upload activation data option.
NOTE: Remember to save the Activation File to a location that is accessible by the machine on which you are installing ControlPoint.
d)Return to the ControlPoint Installer License Validation dialog.
e)Use the Step 3: Browser Activation Response File option to select the file retured by Quest.
If the license is validated successfully a License Validation pop-up displays the terms and current status of the license.
7Dismiss the pop-up and click [Next].
The System Prerequisite check begins. Any item that fails the check is identified by a red X.
NOTE: If you fix the problem immediately, you can then Rerun the System Check. If you choose to Quit and fix the problem at a later time, the next time you launch the ControlPoint Configuration Wizard, it will start from the beginning.
8When all system prerequisites checks have completed successfully, click [Next] to display the O365 Configuration dialog.
9Enter the following urls:
§For Primary ControlPoint Configuration Site URL, the url of the hosted site collection in which the ControlPoint Configuration site will be created.
§For SharePoint Administration URL, the url of the primary page for configuring the hosted SharePoint environment.
10.Enter the Username and Password of the account that will be Site Collection Administrator for the Primary ControlPoint Administration Site.
11Click [Next] to display the IIS Configuration dialog.
12Complete the dialog as follows:
a)For Web Site Name, if different from the default (ControlPoint Online), enter the name that you want IIS to use to manage the site.
NOTE: The name that is entered in this field is for IIS purposes only. The name of the site will appear in SharePoint and ControlPoint under the name ControlPoint Configuration Site.
b)For Port number, either:
§accept the default value (2828)
§enter a different, unused Port number.
c)For Host Name, if different from the default (the machine name), enter the host header (alias) that will be used.
NOTE: If a host header is entered, the installer will also create the bindings in IIS.
d)Enter the name and password of the Service Account under which you want the application pool that will host the ControlPoint Configuration Site to run.
REMINDER: If your databases reside on a different server, then the Service Account must be a domain account.
NOTE: The certificate must be located in either the Personal or WebHost store.
If you want to ...
use an existing certificate
·Select a Store Name; either My (for the Personal Store) or WebHosting, from the drop-down.
The Use Existing Certificate drop-down will be populated with available certificates in the selected store.
·Make sure Use Existing Certificate is selected, then select a certificate from the drop-down.
NOTE: If the ControlPoint Installer cannot find a Certificate in the Store, this option will be disabled.
create a new self-signed certificate (default option)
Select Create new Self Signed Certificate, then enter a Certificate Name.
The ControlPoint installer will create a self-signed certificate file in the local machine Personal store.
13Click [Next] to display the Create the ControlPoint Service (xcAdmin) Database dialog.
14Specify the Database Server where you want to host the ControlPoint Service (xcAdmin) database:
§enter the server name
§click [Browse] to choose a different database server.
15If you want to view, update, and/or test the xcAdmin database connection string:
a)Click the (Advanced) Edit Connection String Directly box.
NOTE: If you are choosing to reuse an existing xcAdmin database, you will be unable to update the connection string and the field will be disabled. If you need to update the connection string after completing the installation, you can do so by updating the parameter <connectionStrings> in the CPConfiguration.exe.config file Refer to the ControlPoint for Office 365 Administration Guide for details.
IMPORTANT: Update the connection string only if your SQL connection requires the addition of one or more custom keywords. For example, if you are using authentication with encryption and a self-signed server certificate, you would need to add Encrypt=yes;TrustServerCertificate to the string. Refer to the Microsoft article Using Connection String Keywords with SQL Server Native Client for more information.
b)Click [Test Connection.].
Note that if the connection is not successful, the parameter that caused it to fail will be identified.
16Click [Create] (or if you are using an existing xcAdmin database, [Update]).After the Configuration Wizard has successfully created the new database (or updated an existing database), click [Continue Installation] then click [Next].
17Enter the email information for the O365 Email Address or Local Email Address (including local SMTP Server Address) that will be used as the "from" account for any correspondence sent on behalf of ControlPoint.
18Click [Next] to display the Deploy ControlPoint dialog.
19Click [Start Deployment].
20When the deployment has successfully completed, click [Finish].
22If you want to configure Discovery and/or SCM services, click [Yes] and follow the instructions for Configuring ControlPoint Services.
NOTE: You can also configure services at a later time by launching the installation from the Start menu or desktop shortcut.
23When you ave finished configuring services, continue with Registering the ControlPoint Online App for Modern Authentication.
NOTE: If the ControlPoint Online app is already registered, this step will be skipped.
Toward the end of ControlPoint configuration process you have the option to configure the following Windows service(s):
·The ControlPoint Discovery Service is an alternative to the (default) FullDiscoveryJob, which runs as a Windows scheduled task. The ControlPoint Discovery Service runs as a Windows Service, and is especially suited to very large SharePoint environments as it can significantly reduce Discovery run time.
·If Sensitive Content Manager is installed in your environment, ControlPoint Sensitive Content Manager (SCM) Services will allow you to use it within ControlPoint:
§as a means of checking for:
oContent Analysis (CA) jobs ready to be uploaded from ControlPoint to Sensitive Content Manager for scanning.
oScan results ready to be downloaded from Sensitive Content Manager to ControlPoint for further action.
§Because they support multi-threading, SCM Services are especially suited to very large content analysis jobs.
NOTE: If you want to configure services at a later time, you can do so by launching the Configuration Wizard from the server on which ControlPoint is installed (using the same login account that was used to install the ControlPoint application). After the Wizard has finished checking installed components, select Configure Services.
To configure ControlPoint Services:
1On the Configure Services dialog, select the service(s) you want to configure.
§The Service Account must meet all of the requirements of the ControlPoint Service Account, as well as permission to Run as a Service.
§Keep in mind that the latest version of ControlPoint Sensitive Content Manager Service will only work with version 2.0 or later of Metalogix Sensitive Content Manager.
2Select the service(s) you want to configure.
4Click [Start Deployment].
The installer deploys the selected Windows service(s).
5When the services have been successfully deployed, click [Finish].
Additional Setup Requirement for the ControlPoint Discovery Service
Before you can use the ControlPoint Discovery Service for the first time, you must also perform the following configuration tasks on the General tab of the Discovery Setup application (located, by default, in the folder C:\Program Files\Metalogix\ControlPointOnline\ControlPointFeatures\Services\Discovery):
·For Configure Discovery to run under, select SharePoint Local, and
·Add the SQL Server Connection String for xcAdmin Database.
NOTE: You can copy the Connection String from the file CPConfiguration.exe.config, located, by default, in the folder C:\Program Files\Metalogix\ControlPointOnline\ControlPointFeatures. Use the portion of the string that starts with the words Data Source and ends with Integrated Security = <value>.
You can also change a service's default settings from its Setup application. Refer to the ControlPoint for Office 365 Administration Guide for complete details.