Chat now with support
Chat with Support

Metalogix ControlPoint 8.1 - Advanced Installation Guide

Installing ControlPoint Files

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.

Installer INSTALL CONTROLPOINT

The License Agreement dialog displays.

3Read the license agreement. Click I accept the terms of the license agreement, then click [Next].

4Click Install ControlPoint On-premises.

Installer SELECT ON PREM

5 When the Metalogix ControlPoint InstallShield Welcome dialog displays, click [Next].

The InstallShield Wizard specifies a default install directory (C:\Program Files\Metalogix\ControlPoint), but you can click [BROWSE] and select a different one.  

Instaler DESTINATIOM FOLDER

NOTE:  This directory is where the installer will place the files needed to complete the installation.  If you choose to change the default directory, you should not use the SharePoint hive.

6Click [Install].

The installer checks for ControlPoint Components.  Note that, for a first time installation, only Fetching ControlPoint Configuration Data will display a check mark.  All other options will display a right-pointing arrow.

Installer Checking for Components

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.

Installer Launch Configuration

NOTE:  If you want to configure the ControlPoint application at a later time, click [No].  You can launch the ControlPoint Configuration Wizard from the Start menu or a Desktop shortcut.

7Click [Finish].

Next Steps

It is strongly recommended that you perform a pre-installation validation check before Configuring the ControlPoint Application and Deploying SharePoint Solutions.

 

Performing a Pre-Installation Validation Check

After installing ControlPoint files, but before configuring ControlPoint for the first time, it is strongly recommended that you run the ControlPoint Install Check, which is located in the following folder: C:\Program Files\Metalogix\ControlPoint\Support\PreinstallValidation. When you run this utility (by double-clicking ControlPointInstallCheck.exe), you are prompted to enter the following information:

·ControlPoint Service Account name and password

·SharePoint Content Database Server name

·ControlPoint Service Database Server name.

NOTE:  If UAC is enabled, it may be necessary to Run as Administrator.

Installer PREREQUISITE CHECK FORM

When you click [Perform Install Validation], the utility verifies that key system requirements are met. At the conclusion of the verification check, a summary of results displays.

Preinstall validation RESULTS

If any errors are reported in the Validation Summary, you can correct them before attempting to configure ControlPoint.

Configuring the ControlPoint Application and Deploying SharePoint Solutions

After ControlPoint file are installed the application must be configured.  

Summary of ControlPoint Configuration Process

The ControlPoint Configuration Wizard carries out the following tasks:

A.Validates License:  Checks the validity of the license key you enter as well as the terms of the license.

B.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.)

C.Creates ControlPoint Web application (if applicable):  If you choose to have the installer create a new Web application to host the ControlPoint Configuration site collection, installs the ControlPoint Web application within SharePoint, which includes the creation of a content database for the Web application.

EXCEPTION:  For SharePont 2007, the Web application is called Axceler.

D.Creates ControlPoint Site Collection:  Creates the ControlPoint Configuration Site Collection within the ControlPoint Web application or an existing Web application (depending on the option you choose), and assigns an initial Site Collection Administrator.

NOTE:  If you changed the host name in a SharePoint 2013 or 2016 environment, the Configuration Wizard also creates the bindings in IIS, creates alternate access mappings in Central Administration, and updates the ControlPoint Setting 'Inbound ControlPoint Url' to use the host header.

E.Deploys ControlPoint WSPs to your SharePoint farm:  Installs the ControlPoint application features, which includes:

§installation of ControlPoint menus and the ControlPoint Settings list into the ControlPoint Configuration Site, and

§creation of the IIS Virtual Directory on the Web front-end server.

NOTE:  As is the case with other SharePoint Solution deployments, upon completion all running application pools will be recycled.

F. Activates License: Activates your ControlPoint license.

G. Windows Service Configuration (optional):  If you elect to use server-side Windows Services as an alternative to the default jobs performed in SharePoint Central Administration, installs and configures the service(s) you selected.

To configure the ControlPoint application:

1Use the information in the following table to determine the appropriate action to take.

If ...

Then ...

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 Configuration desktop icon.

The installer checks your environment for the presence of installed components.

NOTE:  For a first time installation, once the compononents check is complete only the Fetching ControlPoint Configuration Data box should be checked (Installer Checkmark).  All other options will appear with a right-facing arrow.  (Installer Arrow)

Installer Checking for Components

2Click [Continue].

3Enter the license key provided by Quest.

Installer License Validation

4.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...

Then ...

online

accept the default option (Activate Online).

offline

a)Select Activate Offline.

Installer License Validation 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.

5Click [Validate].

If the license is validated successfully a License Validation pop-up displays the terms and current status of the license.

6Dismiss the pop-up and click [Next].

The System Prerequisite check begins. Any item that  fails the check is identified by a red X.

Installer System Check FAIL

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.

7When all system prerequisites checks have completed successfully, click [Next] to display the Create the ControlPoint Service (xcAdmin) Database dialog.

8Specify the Database Server where you want to place the ControlPoint Service (xcAdmin) database:

§enter the server name

OR

§click [Browse] to choose a different database server

If you are installing on an additional farm in a multi-farm installation, make sure you specify the server on which the xcAdmin database has been created for the first farm. (If the database you specified has already been created, you will be asked whether you want to use it.)

Installer xcAdmin DATABASE CREATION

NOTE:  If you are using SQL Express for development or evaluation purposes, the Database Server instance name is typically entered as <server_machine_name>\SQLExpress.

9Specify the authentication method you want to use.  (If you select SQL Server authentication, you will be prompted to enter the Account and Password.)

10After the installer has created the new database (or updated an existing database), click [Next].

11.Use the information in the following table to determine the appropriate action to take to Choose where the ControlPoint Configuration Site will be hosted.

Installer CHOOSE WAP

NOTE:  It is recommended that you always Create a new Web Application, unless special circumstances apply.  

If you want to ...

Then ...

create a new Web application to host the ControlPoint Configuration Site Collection

 

a)Select Create a new Web Application.

b)For Host Name, if different from the default (the machine name), enter the host header (alias) that is used used for the server.

NOTE:  If a host header is entered, the installer will create both the alternate access mappings in Central Administration and bindings in IIS.

c)For Port, either

§accept the default value (1818)

OR

§enter a different, unused Port number.  (It is strongly recommended that you not install ControlPoint on Port 80, as you will encounter complications during setup.  If you are using host headers and want to redirect ControlPoint to a port that is currently in use (including Port 80), you can do so after completing the installation.

d)If different than the default (the currently logged in account), specify the Service Account under which you want the ControlPoint Web application to run.

REMINDER: If your databases reside on a different server, then the Service Account must be a domain account.

e)For Content Database Name, either

§accept the default value (WSS_CONTENT_CONTROLPOINT)

OR

§enter a different content database name  

f)Specify a ControlPoint Configuration Site Collection Administrator account and Service Account, and enter the Service Account Password.

g)If the server is configured for SSL and you want it  to be used to access ControlPoint,  for Use SSL? select Yes, then select a Trusted Certificate.

Configure WAP NEW

(For SharePoint 2007 installations, both the Web Application and Application Pool are named Axceler.)

create the ControlPoint Configuration Site Collection in an existing Web application

a)Select Choose an existing Web Application.

b)Select an existing Web application from the list, then click [Proceed].

Configure WAP Existing

The Configure Web Application dialog is populated with the configuration settings for the selected server.  (Note that ControlPoint uses the selected Web application's Application Pool identity acount as the Service Account).

c)Specify a ControlPoint Configuration Site Collection Administrator account.

d)If the server is configured for SSL and you want it  to be used to access ControlPoint,  for Use SSL? select Yes, then select a Trusted Certificate.

Configure WAP New Completed

12Click [Next].

13Click [Start Deployment].

Installer DEPLOY CONTROLPOINT

14When the deployment has completed, click [Finish].-

If you are installing ControlPoint for SharePoint 2010 or later, the Configure Services dialog displays, asking if you want to configure services.

Configure Services dialog

NOTE:  ControlPoint Services functionality is not included in the SharePoint 2007 edition of ControlPoint.

15If you want to configure services immediately, click [Yes] and continue with Configuring ControlPoint Services.

NOTE:  You can also configure services at a later time by launching the Configuration Wizard from the server on which ControlPoint is installed.

Configuring ControlPoint Services

If you are installing ControlPoint for SharePoint 2010 or later, at the conclusion 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) ControlPoint Full Discovery timer job, which runs from SharePoint Central Administration.  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.

AND/OR

·If Sensitive Content Manager is installed in your environment, ControlPoint Sensitive Content Manager (SCM) Services can be used instead of the default ControlPoint Schedule Job Review timer job, which runs from SharePoint Central Administration:

§as a means of checking for:

Content Analysis (CA) jobs ready to be uploaded from ControlPoint to Sensitive Content Manager for scanning.

AND

§Scan results ready to be downloaded from Sensitive Content Manager to ControlPoint for further action.

The use of SCM Services offers the following advantages:

·Unlike the ControlPoint Scheduled Job Review job, which checks for Sensitive Content Manager upload and results jobs on a fixed schedule (by default, every ten minutes), SCM Services carry out these checks continuously.

AND

·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.

Configure Services from Wizard

To configure ControlPoint Services:

1On the Configure Services dialog, select the service(s) you want to configure.

Installer Configure Services

IMPORTANT:  The Service Account must meet all of the requirements of the ControlPoint Service Account, as well as permission to Run as a Service.

2Select the service(s) you want to configure.

3Click [Continue].

4Click [Start Deployment].

The installer deploys the selected Windows service(s).

Installer Services Deployed

5When the services have been successfully deployed, click [Finish].

Additional Configuration 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\ControlPoint\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\ControlPoint\ControlPointFeatures. Use the portion of the string that starts with the words Data Source and ends with Integrated Security = <value>.

CP Discovery Connection String

You can also change a service's default settings from its Setup application.  Refer to the ControlPoint Administration Guide for complete details.

Related Documents