avepoint meetings pro for sharepoint on-premises installation and

Click here to load reader

Upload: nguyenkhanh

Post on 30-Dec-2016

229 views

Category:

Documents


0 download

TRANSCRIPT

  • Issued January 2018

    AvePoint Meetings Pro 4.3 for

    SharePoint On-Premises

    Installation and Configuration Guide

  • 2

    AvePoint Meetings Pro for SharePoint On-Premises

    Table of Contents

    Whats New in this Guide ............................................................................................................................. 5

    About AvePoint Meetings Pro for SharePoint .............................................................................................. 6

    AvePoint Meetings Pro for SharePoint On-Premises System Requirements ............................................... 7

    System Requirements for AvePoint Meetings Pro for SharePoint On-Premises Installation: Hardware

    Requirements ............................................................................................................................................ 7

    System Requirements for AvePoint Meetings Pro App Package Installation ....................................... 7

    System Requirements for AvePoint Meetings Pro Website Installation .............................................. 7

    Software Requirements ............................................................................................................................ 8

    Supported SharePoint Versions ............................................................................................................ 8

    Permissions ........................................................................................................................................... 9

    Processors ........................................................................................................................................... 10

    Supported Browsers ............................................................................................................................ 10

    Server Communication ....................................................................................................................... 10

    AvePoint Meetings Pro Outlook Plug-In Requirements .......................................................................... 10

    AvePoint Meetings Pro for SharePoint On-Premises Pre-Installation Checklist ......................................... 11

    Preparing the Environment to Host AvePoint Meetings Pro for SharePoint On-Premises ........................ 12

    Starting SharePoint Service Applications and Instances ......................................................................... 13

    Setting up an App Catalog ....................................................................................................................... 16

    Verifying App Domain and App Prefix Configuration ............................................................................. 18

    Configuring ADFS Authentication for AvePoint Meetings Pro for SharePoint On-Premises ...................... 19

    Preparing the ADFS Environment for AvePoint Meetings Pro for SharePoint ....................................... 19

    Configuring ADFS Authentication for AvePoint Meetings Pro for SharePoint ....................................... 19

    Configuring User Profile Synchronization ........................................................................................... 19

    Configuring an ADFS Relying Party Trust ............................................................................................ 26

    Adding the Token-signing Certificate as a Trusted Certificate................................................................ 32

    Exporting the Token-signing Certificate from ADFS Server ................................................................ 32

    Adding the Exported Certificate as a Trusted Certificate ................................................................... 35

    Installing AvePoint Meetings Pro for SharePoint On-Premises .................................................................. 38

    Running the AvePoint Meetings Pro App Package Installation Wizard .................................................. 38

    Running the AvePoint Meetings Pro Website Installation Wizard ......................................................... 45

  • 3

    AvePoint Meetings Pro for SharePoint On-Premises

    Adding AvePoint Meetings Pro for SharePoint On-Premises to a SharePoint Site ................................. 59

    Installing AvePoint Meetings Pro for SharePoint On-Premises in a Network Load Balanced Cluster ........ 61

    Adding a Host in DNS for AvePoint Meetings Pro for SharePoint On-Premises ..................................... 61

    Configuring AvePoint Meetings Pro Website Load Balance ....................................................................... 63

    Pre-requirements .................................................................................................................................... 63

    Configuring the Settings of AvePoint Meetings Pro for SharePoint On-Premises in Web.config File ........ 64

    Enabling the Creating a New Meeting Feature ....................................................................................... 64

    Enabling the Sending E-mail Notification to All Attendees Feature ....................................................... 65

    Enabling the Breaking the Sync Relationship Feature ............................................................................ 65

    Enabling Users to Only View Attachment for Their Meetings in SharePoint Libraries ........................... 65

    Enabling Deleting Searched Out Meetings Feature ................................................................................ 66

    Configuring the Exchange Service URL ................................................................................................... 67

    Configuring the Maximum Attachment Size ........................................................................................... 67

    Configuring My Site Host Location .......................................................................................................... 67

    Hiding the Dashboard in the Global View ............................................................................................... 68

    Hiding the AvePoints Options in AvePoint Meetings Pro for iOS .......................................................... 68

    Customizing the Support and About Meetings Options ......................................................................... 69

    Customizing the Interval of Generating Event Logs ................................................................................ 69

    Customizing the Interval of Task Synchronization .................................................................................. 70

    Customizing the Value of Back to Site Button ........................................................................................ 70

    Customizing the Body of E-mail Notifications......................................................................................... 70

    Updating AvePoint Meetings Pro for SharePoint On-Premises .................................................................. 73

    Updating AvePoint Meetings Pro App Package ...................................................................................... 73

    Updating AvePoint Meetings Pro Website ............................................................................................. 74

    Updating the AvePoint Meetings Pro Certificate ........................................................................................ 79

    Updating Certificate for App Package ..................................................................................................... 79

    Updating Certificate for Website ............................................................................................................ 81

    Installing the AvePoint Meetings Pro Outlook Plug-In ............................................................................... 83

    Activating the Installed AvePoint Meetings Pro Outlook Plug-In ........................................................... 85

    Using AvePoint Meetings Pro for SharePoint On-Premises ........................................................................ 88

    Applying and Managing the AvePoint Meetings Pro for SharePoint On-Premises License........................ 89

    Uninstalling AvePoint Meetings Pro for SharePoint On-Premises.............................................................. 93

  • 4

    AvePoint Meetings Pro for SharePoint On-Premises

    Uninstalling the AvePoint Meetings Pro Outlook Plug-In ........................................................................... 95

    Configuring SCOM to Monitor the Usage of AvePoint Meetings Pro for SharePoint On-Premises ........... 96

    Notices and Copyright Information ............................................................................................................ 99

  • 5

    AvePoint Meetings Pro for SharePoint On-Premises

    Whats New in this Guide

    Updated the System Requirements for AvePoint Meetings Pro Website Installation section.

    Updated the Software Requirements section.

    Added the Enabling Users to Only View Attachment for Their Meetings in SharePoint Libraries section.

    Added the Enabling Deleting Searched Out Meetings Feature section.

    Added the Configuring My Site Host Location section.

    Added the Customizing the Intervals for Task Synchronization section.

    Added the Customizing the Value of Back to Site Button section.

    Added the Customizing the Body of E-mail Notifications section.

    Added the Updating the AvePoint Meetings Pro Certificate section.

  • 6

    AvePoint Meetings Pro for SharePoint On-Premises

    About AvePoint Meetings Pro for SharePoint

    AvePoint Meetings Pro for SharePoint, an app for SharePoint 2013 and SharePoint 2016, brings order

    and efficiency to activities such as meeting organization, note-taking, and task assignments.

    Use AvePoint Meetings Pro for SharePoint to collaborate with others in real-time before, during, and

    after meetings by:

    Creating single or recurring meetings

    Allowing meeting attendees to adjust and update meeting agendas as well as discussion topics

    Capturing meeting information and notes with multi-user support

    Tracking meeting minutes with full auditing, allowing for historical search capabilities

    Uploading, deleting, and downloading attachments

    Searching by meetings, agendas, actions, notes, decisions, attachments, and links

    Support for Advanced Search

    Tracking the roll call for meeting attendance

    Printing the meeting minutes

    Sharing meetings with others

    Exporting meeting minutes to a PDF file

    Managing the metadata

    Using Agenda Timer for timing

    Configuring meeting privacy

  • 7

    AvePoint Meetings Pro for SharePoint On-Premises

    AvePoint Meetings Pro for SharePoint On-Premises

    System Requirements

    Refer to the sections below for AvePoint Meetings Pro for SharePoint on-premises hardware and

    software requirements.

    System Requirements for AvePoint Meetings Pro for SharePoint

    On-Premises Installation: Hardware Requirements

    Refer to the following tables for the system requirements for each of the AvePoint Meetings Pro for

    SharePoint on-premises components:

    System Requirements for AvePoint Meetings Pro App Package Installation

    The following table identifies the system requirements for the AvePoint Meetings Pro app package.

    Elements Requirements

    Operating System Windows Server 2008 R2 SP1, Windows Server 2012, Windows Server 2012 R2, Windows Server 2016

    Number of CPU Cores Minimum: 2 cores

    Available Physical Memory Minimum: 512 MB Recommended: 2 GB

    Available Disk Space for Generated Temporary Files

    Required: 32 MB

    Available Disk Space for Installation Package

    Required: 32 MB

    .Net Framework Version .NET Framework 4.5 or above

    .Net Framework Features The following Windows features must be active and installed on the system: WCF Activation, HTTP Activation, and Non-HTTP Activation.

    PowerShell Version PowerShell 2.0 or above

    System Requirements for AvePoint Meetings Pro Website Installation

    The following table identifies the system requirements for AvePoint Meetings Pro website.

    Elements Requirements

    Operating System Windows Server 2008 R2 SP1, Windows Server 2012, Windows Server 2012 R2, Windows Server 2016

    Number of CPU Cores Minimum: 2 cores

    Available Physical Memory Minimum: 512 MB Recommended: 2 GB

  • 8

    AvePoint Meetings Pro for SharePoint On-Premises

    Elements Requirements

    Available Disk Space for Generated Temporary Files

    Required: 128 MB

    Available Disk Space for Installation Package

    Required: 128 MB

    Available Disk Space for Generated Physical Files

    Required: 128 MB

    .Net Framework Version .NET Framework 4.5 or above

    .Net Framework Features The following Windows features must be active and installed on the system: WCF Activation, HTTP Activation, and Non-HTTP Activation.

    Windows Process Activation Service

    Windows Process Activation Service is started.

    World Wide Web Publishing Service

    World Wide Web Publishing Service is started.

    Web Server(IIS) Role Windows features installed:

    Management Tools (IIS Management Console, IIS 6 Management

    Compatibility and IIS 6 Metabase Compatibility)

    World Wide Web Publishing Service and its following components

    The WebSocket Protocol role in Server Manager

    IIS Service Version IIS Service Version 7.0 or above

    PowerShell Version PowerShell 2.0 or above

    SQL Server Version SQL Server 2008 R2 Service Pack 1, SQL Server 2012, SQL Server 2014, SQL Server 2016

    *Note: AvePoint Meetings Pro for SharePoint on-premises can be added to an environment where

    DocAve is currently deployed without any restrictions.

    Software Requirements

    Refer to the sections below for the software requirements for AvePoint Meetings Pro for SharePoint on-

    premises:

    Supported SharePoint Versions

    AvePoint Meetings Pro for SharePoint on-premises supports the following SharePoint versions:

    SharePoint 2013 on-premises

    SharePoint 2013 SP1 on-premises

    SharePoint 2016 on-premises

    *Note: AvePoint Meetings Pro for SharePoint on-premises does not support SharePoint Foundation

    2013.

  • 9

    AvePoint Meetings Pro for SharePoint On-Premises

    Permissions

    To install and use AvePoint Meetings Pro for SharePoint on-premises properly, ensure that the following

    permission requirements are in place:

    *Note: Only the SharePoint users mentioned below can run the AvePoint Meetings Pro for SharePoint

    on-premises installation wizard or add AvePoint Meetings Pro for SharePoint on-premises to a

    SharePoint site.

    AvePoint Meetings Pro App Package Installation Wizard

    The user running the AvePoint Meetings Pro App Package Installation Wizard must have the following

    permissions:

    A member of the local Administrators group.

    A member of the Farm Administrators group.

    db_owner database role in SharePoint Configuration database.

    db_owner database role in the content database of the Web application to which AvePoint Meetings Pro for SharePoint on-premises will be added.

    At least Design permission to the app catalog site to which AvePoint Meetings Pro for SharePoint on-premises will be uploaded.

    AvePoint Meetings Pro Website Installation Wizard

    To run the AvePoint Meetings Pro Website Installation Wizard, the following requirements must be met:

    The user running the AvePoint Meetings Pro Website Installation Wizard must be a member of the local Administrators group.

    If the database used to store the AvePoint Meetings Pro for SharePoint data is accessed through Windows authentication, the application pool account of the AvePoint Meetings Pro website must have the db_owner database role in this database.

    Adding AvePoint Meetings Pro for SharePoint On-Premises to a SharePoint Site

    The user adding AvePoint Meetings Pro for SharePoint on-premises to a SharePoint site must have the

    following permissions:

    *Note: System accounts cannot add AvePoint Meetings Pro for SharePoint on-premises to a SharePoint

    site.

    A member of Farm Administrators group, Site Collection Administrators group, and local Administrators group.

    At least Read permission to the site app catalog site.

  • 10

    AvePoint Meetings Pro for SharePoint On-Premises

    Processors

    AvePoint Meetings Pro for SharePoint on-premises must be installed on a server with a dual-core

    processor (at a minimum).

    Supported Browsers

    AvePoint Meetings Pro for SharePoint on-premises supports the following browsers and versions:

    Internet Explorer 11

    Google Chrome 63.0.3239.108

    Server Communication

    Make sure the following servers can communicate with one another:

    If you are installing the AvePoint Meetings Pro app package and AvePoint Meetings Pro website on different servers, make sure that all of the servers can communicate with one another.

    Communication is available between the SharePoint farm and the AvePoint Meetings Pro website.

    AvePoint Meetings Pro Outlook Plug-In Requirements

    The AvePoint Meetings Pro Outlook Plug-In is an optional add-in for Microsoft Outlook that synchronizes

    meetings created in Microsoft Outlook to AvePoint Meetings Pro for SharePoint. For installation

    instructions, refer to Installing the AvePoint Meetings Pro Outlook Plug-In.

    Every end-user computer using the AvePoint Meetings Pro Outlook Plug-In must meet the following

    requirements:

    Microsoft Outlook 2010, Microsoft Outlook 2013, or Microsoft Outlook 2016 is installed on the computer.

    .Net Framework Version 4.5 or above is installed on the computer that will host this add-in.

    The AvePoint.Meetings.PRO.Outlook.PlugIn.Setup_VersionNumber.msi file has been downloaded to every end-user computer that will use this add-in.

  • 11

    AvePoint Meetings Pro for SharePoint On-Premises

    AvePoint Meetings Pro for SharePoint On-Premises Pre-

    Installation Checklist

    Ensure that the following items are in place before installing AvePoint Meetings Pro for SharePoint on-

    premises:

    SharePoint 2013 or SharePoint 2016 on-premises is installed on the server that will contain this app.

    The SharePoint site that will host AvePoint Meetings Pro for SharePoint is created.

    A User Profile Service Application is created. For more information, refer to the instructions provided here: http://technet.microsoft.com/en-us/library/ff382639.aspx.

    The following .zip files have been downloaded and extracted to the servers where you want to deploy AvePoint Meetings Pro for SharePoint:

    o AvePoint_Meetings_App_VersionNumber_SerialNumber.zip

    Download and extract this file to any SharePoint Web front-end server.

    o AvePoint_Meetings_Website_VersionNumber_SerialNumber.zip Download and extract this file to an IIS server that is in the same Active Directory domain as the SharePoint Web front-end server in the first bullet above.

    *Note: The AvePoint Meetings Pro app package must be installed in the same Active

    Directory domain as the AvePoint Meetings Pro website.

    To configure ADFS authentication for AvePoint Meetings Pro for SharePoint on-premises, ensure that the following are in place before installing AvePoint Meetings Pro for SharePoint in addition to the items above:

    o ADFS authentication is configured in your SharePoint 2013 or SharePoint 2016 environment and on the ADFS server.

    o Both Windows authentication and the configured ADFS authentication (Trusted Identity provider) are used by the Web application where you are about to add AvePoint Meetings Pro for SharePoint.

    http://technet.microsoft.com/en-us/library/ff382639.aspx

  • 12

    AvePoint Meetings Pro for SharePoint On-Premises

    Preparing the Environment to Host AvePoint Meetings

    Pro for SharePoint On-Premises

    Before installing AvePoint Meetings Pro for SharePoint on-premises, the environment should be

    configured to host AvePoint Meetings Pro for SharePoint. Refer to the instructions in the following

    sections on how to prepare your environment to host AvePoint Meetings Pro for SharePoint.

    If your environment is already configured to host apps, skip directly to Verifying App Domain and App

    Prefix Configuration.

    *Note: If you have already installed SharePoint apps, these settings may already be configured.

    1. Starting SharePoint Service Applications and Instances

    2. Setting up an App Catalog

    3. Verifying App Domain and App Prefix Configuration

  • 13

    AvePoint Meetings Pro for SharePoint On-Premises

    Starting SharePoint Service Applications and Instances

    If you have already used apps in your SharePoint 2013 or SharePoint 2016 on-premises environment,

    you can skip this section.

    *Note: The user who will be performing these steps must be an Active Directory domain user, a member

    of the local Administrators group, a member of the SharePoint Farm Administrators group, with Full

    Control permission to the SharePoint Web front-end server, and access to the site collection where you

    are deploying the app.

    First, taking SharePoint 2013 on-premises environment as an example, perform the following steps to

    verify that the appropriate services are running:

    1. Navigate to Start > All Programs > Microsoft SharePoint 2013 Products > SharePoint 2013 Central Administration.

    2. Click Manage service applications under the Application Management heading.

    Figure 1: Clicking Manage service applications.

    3. In the Manage Service Applications page, verify that the following three service applications are created.

    App Management Service Application

    Subscription Settings Service Application

    User Profile Service Application

    4. Click System Settings on the left pane.

    5. Click Manage services on server under the Servers heading.

    6. In the Services on Server interface, verify that the following three service instances are Started. If they are not, click Start.

  • 14

    AvePoint Meetings Pro for SharePoint On-Premises

    App Management Service

    Microsoft SharePoint Foundation Subscription Settings Service

    User Profile Service Application

    If these three service applications do not exist, refer to the following steps to create them through

    Windows PowerShell.

    1. Locate the ConfigServices.ps1 file in the ConfigurationScripts folder under the extracted AvePoint Meetings Pro app package directory.

    2. Open this file using Notepad.

    3. Configure the SPManagedAccount nodes. Replace AccountName in $account = Get-SPManagedAccount "" with the username of the SharePoint Managed Account.

    Figure 2: Locate the $account = Get-SPManagedAccount "" node.

    *Note: You can find the SharePoint Managed Account name by navigating to SharePoint 2013 Central Administration > Security > Configure managed accounts.

    4. Save and close the modified file.

    5. Navigate to Start > All Programs > Microsoft SharePoint 2013 Products.

  • 15

    AvePoint Meetings Pro for SharePoint On-Premises

    6. Right-click SharePoint 2013 Management Shell, and then select Run as administrator from the drop-down menu. The SharePoint 2013 Management Shell window appears.

    Figure 3: The SharePoint 2013 Management Shell window.

    7. Run & ConfigService.ps1 from the file directory in the SharePoint Management Shell to start the created services.

    For example, if the directory of the ConfigService.ps1 file is

    C:\Users\add\Meetings\AvePoint_Meetings_Pro_App\ConfigurationScripts\ConfigService.ps1,

    enter the following command:

    & C:\Users\add\Meetings\AvePoint_Meetings_Pro_App\ConfigurationScripts\ConfigService.ps1

    And press Enter to run the script.

    For more information on how to configure an environment for apps for SharePoint 2013, refer to the

    instructions provided here: http://technet.microsoft.com/en-us/library/fp161236.aspx; for more

    information on how to configure an environment for apps for SharePoint 2016, refer to the instructions

    provided here: https://technet.microsoft.com/en-us/library/fp161236(v=office.16).aspx.

    http://technet.microsoft.com/en-us/library/fp161236.aspxhttps://technet.microsoft.com/en-us/library/fp161236(v=office.16).aspx

  • 16

    AvePoint Meetings Pro for SharePoint On-Premises

    Setting up an App Catalog

    An app catalog site is used to store apps. These apps can be installed on any site under the Web

    application where the app catalog site resides. Only the members of the Farm Administrators group can

    view and operate the app catalog site collection.

    Follow the steps below, which uses SharePoint 2013 on-premises environment as an example, to

    configure the SharePoint App catalog:

    1. Navigate to Start > All Programs > Microsoft SharePoint 2013 Products > SharePoint 2013 Central Administration.

    2. Click Manage App Catalog under the Apps heading.

    Figure 4: Clicking Manage App Catalog under the Apps heading.

    3. In the Manage App Catalog page, select the Web application where you are about to create the app catalog site.

  • 17

    AvePoint Meetings Pro for SharePoint On-Premises

    4. Select Create a new app catalog site. Then, click OK. The Create App Catalog page appears.

    Figure 5: Selecting Create a new app catalog site.

    5. Configure the necessary settings for creating a new app catalog site.

    a. Enter a title for the app catalog site in the Title text box.

    b. In the Description text box, enter the description for the site.

    c. In the URL text box, enter the URL to use for the site.

    d. In the User name text box of the Primary Site Collection Administrator section, enter

    the user who will manage the catalog.

    *Note: Only one username can be entered. Security groups are not supported.

    e. In the Users/Groups text box of the End Users section, enter the names of the users or

    groups that can browse the catalog.

    *Note: Added users or groups have read access to the app catalog site. You can add

    multiple usernames and security groups. Users must be added as End Users to be able

    to browse the App Catalog from their site collections. However, if users want to add the

    app to their sites, these users must be Farm Administrators by default.

    f. In the Select a quota template drop-down list, select the quota template to use for the

    site.

    g. Click OK to create the app catalog site.

  • 18

    AvePoint Meetings Pro for SharePoint On-Premises

    Verifying App Domain and App Prefix Configuration

    Before installing AvePoint Meetings Pro for SharePoint, the App domain and App prefix must be

    configured (if they are not configured previously). Complete the following steps, which uses SharePoint

    2013 on-premises environment as an example, to verify the App domain and App prefix:

    1. In the SharePoint 2013 server where you are about to install AvePoint Meetings Pro for SharePoint, navigate to Start > All Programs > Microsoft SharePoint 2013 Products > SharePoint 2013 Central Administration.

    2. Click Apps on the left pane.

    3. Click Configure App URLs under the App Management heading. The Configure App URLs interface appears.

    Figure 6: The Configure App URLs interface.

    4. If the App domain and App prefix text boxes have values in them, then the App domain and App prefix are already configured.

    If the text boxes are empty, configure the App domain and App prefix following the instructions

    provided in the Configure the app URLs to use section of Configure an environment for apps

    for SharePoint (SharePoint 2013) in http://technet.microsoft.com/en-

    us/library/fp161236(v=office.15).aspx or Specify the app domain and app prefix section of

    Configure an environment for apps for SharePoint (SharePoint 2016) in

    https://technet.microsoft.com/en-us/library/fp161236(v=office.16).aspx.

    http://technet.microsoft.com/en-us/library/fp161236(v=office.15).aspxhttp://technet.microsoft.com/en-us/library/fp161236(v=office.15).aspxhttps://technet.microsoft.com/en-us/library/fp161236(v=office.16).aspx

  • 19

    AvePoint Meetings Pro for SharePoint On-Premises

    Configuring ADFS Authentication for AvePoint Meetings

    Pro for SharePoint On-Premises

    Active Directory Federation Services (ADFS) authentication simplifies access to systems and applications

    using a claims-based access (CBA) authorization mechanism to maintain application security. ADFS

    authentication supports Web single-sign-on (SSO) technologies that help information technology

    organizations collaborate across organizational boundaries. When installed in the SharePoint 2013 or

    SharePoint 2016 on-premises environment with ADFS authentication configured, AvePoint Meetings Pro

    for SharePoint can be accessed by users in the ADFS server domain (a domain that is separated from

    that of AvePoint Meetings Pro for SharePoint).

    *Note: The E-mail properties of users who want to access AvePoint Meetings Pro for SharePoint must

    be configured in the domain controller (the server where Active Directory Manager is installed).

    Preparing the ADFS Environment for AvePoint Meetings Pro for

    SharePoint

    Before installing AvePoint Meetings Pro for SharePoint on a SharePoint 2013 or SharePoint 2016

    environment that has ADFS authentication configured, the environment should be properly configured.

    For details, refer to Preparing the Environment to Host AvePoint Meetings Pro for SharePoint On-

    Premises and Configuring ADFS Authentication for AvePoint Meetings Pro for SharePoint.

    *Note: If you have already installed SharePoint apps, proceed directly to Configuring ADFS

    Authentication for AvePoint Meetings Pro for SharePoint.

    Configuring ADFS Authentication for AvePoint Meetings Pro for

    SharePoint

    After the SharePoint 2013 or SharePoint 2016 environment is ready for hosting AvePoint Meetings Pro

    for SharePoint, refer to the sections below to configure the ADFS authentication in the environment for

    AvePoint Meetings Pro for SharePoint.

    Configuring User Profile Synchronization

    If the users in the domain where the ADFS server resides want to access AvePoint Meetings Pro for

    SharePoint in another domain, the E-mail properties of these users must be synchronized to the

    SharePoint 2013 or SharePoint 2016 environment that has AvePoint Meetings Pro for SharePoint

    installed.

    *Note: To synchronize the E-mail properties of these users, the E-mail properties for these users must

    be properly configured in the domain controller of the domain where the ADFS server resides.

  • 20

    AvePoint Meetings Pro for SharePoint On-Premises

    Refer to the sections below to synchronize the E-mail properties of the specific users to the SharePoint

    2013 or SharePoint 2016 environment.

    Starting the User Profile Synchronization Service

    Complete the following steps, which uses SharePoint 2013 on-premises environment as an example, to

    start the user profile synchronization service:

    1. Navigate to Start > All Programs > Microsoft SharePoint 2013 Products > SharePoint 2013 Central Administration.

    2. Click Manage services on server under the System Settings heading.

    Figure 7: Clicking Manage services on server under the System Settings heading.

    3. In the Services on Server interface, locate the User Profile Synchronization Service and click Start. The User Profile Synchronization Service interface appears.

    4. Select the user profile service you are about to synchronize data to from the Select the User Profile Service drop-down list.

    5. Enter the password and the confirm password for the loaded service account. Click OK to start the user profile synchronization service.

    *Note: The Forefront Identity Manager Service and Forefront Identity Manager

    Synchronization Service will be automatically started along with the user profile synchronization

    service, which may take at least 10 minutes. Please do not start these two services manually

    during the startup process.

    After starting the user profile synchronization service, execute the IISReset cmdlet to restart the IIS

    service.

    Configuring Synchronization Connections

    Complete the following steps to configure the synchronization connections:

    1. Navigate to Application Management > Manage service application. In the SERVICE APPLICATIONS interface, click the user profile service you selected in the User Profile Synchronization Service interface. The Manage Profile Service interface appears.

  • 21

    AvePoint Meetings Pro for SharePoint On-Premises

    2. Click Configure Synchronization Connections in the Synchronization section. In the pop-up Synchronization Connections interface, click Create New Connection.

    Figure 8: Clicking Create New Connection.

    3. In the Add new synchronization connection interface, configure the following settings:

    Connection Name Enter the connection name in the Connection Name field.

    Type Select Active Directory as the type of the source data to be synchronized.

    Connection Settings Complete the following settings in the Connection Settings field.

    o Forest Name Enter the domain where the ADFS server resides, and then select Specify a domain controller.

    o Domain controller name Enter the full computer name of the server where the domain controller of the entered domain resides.

    *Note: The domain controller must be added as a host in DNS Manager or the

    hosts file and the added host must direct to the server where the domain

    controller resides. For more instructions about how to add a host in DNS, refer

    to Adding a Host in DNS for AvePoint Meetings Pro for SharePoint On-Premises.

    o Authentication Provider type Select Trusted Claims Provider Authentication as the authentication provider type, and then select the employed trusted identity provider of the Web application where you are about to add AvePoint Meetings Pro for SharePoint.

    o Account name Enter the account name.

    *Note: The entered account must be a member of the Domain Admins group in

    the domain where the ADFS server resides.

    o Password Enter the corresponding password for the entered account.

    o Confirm password Enter the password again.

    o Port Keep the default value 389 for this setting.

    Containers Click Populate Containers and the entered domain is loaded in the table. Expand the tree and select the users whose E-mail attribute you are about to synchronize, or the Organization Units these users reside from the tree.

  • 22

    AvePoint Meetings Pro for SharePoint On-Premises

    *Note: Make sure that the E-mail properties of the selected users are properly

    configured in the domain controller of the domain where the ADFS server resides.

    Figure 9: Selecting users or organization units from the domain tree.

    Click OK to create the configured connection.

    Mapping the User Profile Properties

    Complete the following steps to map the user profile properties:

    1. Navigate to Application Management > Manage service application. In the SERVICE APPLICATIONS interface, click the user profile service you selected to synchronize the source data to. The Manage Profile Service interface appears.

    Figure 10: The Manage Profile Service interface appears.

  • 23

    AvePoint Meetings Pro for SharePoint On-Premises

    2. Click Manage User Properties in the People section. The Manage User Properties interface appears.

    Figure 11: The Manage User Properties interface appears.

    3. Select the Claim User Identifier property and click Edit. The Edit User Profile Property interface appears.

    4. In the Add New Mapping field, select the corresponding attribute from the Attribute drop-down list. This attribute must be the one the IdentifierClaim attribute is mapped to when you created the Trusted Identity Provider during your ADFS configuration process.

    5. Click OK to save the configurations and go back to the Manage User Properties interface.

    6. Select the Work email property and click Edit. The Edit User Profile Property interface appears.

    7. In the Property Mapping for Synchronization field, click Remove to delete the existing mapping.

    8. In the Add New Mapping field, select mail from the Attribute drop-down list.

    9. Click OK to save the configurations.

  • 24

    AvePoint Meetings Pro for SharePoint On-Premises

    Starting the Profile Synchronization

    Complete the following steps to start the profile synchronization:

    1. Navigate to Application Management > Manage service application. In the SERVICE APPLICATIONS interface, click the selected user profile service where you are about to synchronize the source data. The Manage Profile Service interface appears.

    Figure 12: The Manage Profile Service interface appears.

    2. Click Start Profile Synchronization in the Synchronization section. The Start Profile Synchronization interface appears.

    3. Click Start Full Synchronization to start a full synchronization.

    4. Click OK to start the synchronization and go back to the Manage User Profiles interface. The synchronization information is displayed in the Manage User Profiles interface. Refresh the page to view the synchronization progress. When the synchronization process finishes, the Profile Synchronization Status will be displayed as Idle.

    Figure 13: The Profile Synchronization Status is displayed as Idle.

  • 25

    AvePoint Meetings Pro for SharePoint On-Premises

    Verifying the Profile Synchronization

    Complete the following steps to verify whether or not the user profiles are successfully synchronized to

    the specific user profile service.

    1. Navigate to Application Management > Manage service application. In the SERVICE APPLICATION interface, click the user profile service where you have synchronized the source data. The Manage Profile Service interface appears.

    Figure 14: The Manage Profile Service interface appears.

    2. Click Manage User Profiles in the People section. The Manage User Profiles interface appears.

    Figure 15: The Manage User Profiles interface appears.

    3. Enter one of the users whose user profiles you synchronized to the specific user profile service in the Find profiles text box and then click Find. Verify whether or not the E-mail address property of the entered user has the corresponding value in the search results.

    *Note: If you are about to synchronize E-mail properties of more users in the domain where the ADFS

    server resides, edit the created synchronization connection, select these users in the loaded domain tree

    and then run the profile synchronization again. For more information, refer to Configuring

    Synchronization Connections and Starting the Profile Synchronization.

  • 26

    AvePoint Meetings Pro for SharePoint On-Premises

    Configuring an ADFS Relying Party Trust

    Refer to the sections below to configure an ADFS relying party trust for AvePoint Meetings Pro for

    SharePoint you are about to install.

    Adding a Relying Party Trust

    Complete the following steps to add a relying party trust:

    1. Navigate to Start > All Programs > Administrative Tools > AD FS 2.0 Management. The AD FS 2.0 window appears.

    Figure 16: The AD FS 2.0 window pops up.

    2. Expand the Trust Relationships node on the left pane and select the Relying Party Trusts node.

    3. In the Actions pane, click Add Relying Party Trust and the Add Relying Party Trust Wizard appears.

    4. In the Welcome interface, click Start to start this wizard. The Select Data Source interface appears. Click Enter data about the relying party manually, and then click Next.

  • 27

    AvePoint Meetings Pro for SharePoint On-Premises

    5. In the Specify Display Name interface, enter the display name for the relying party.

    6. Click Next and the Choose Profile interface appears. Select AD FS 2.0 profile as the configuration file for the relying party.

    Figure 17: Selecting AD FS 2.0 profile as the configuration file for the relying party.

    7. Click Next to proceed to the Configure URL interface.

    8. Click the Enable support for the WS-Federation Passive protocol option. In the Relying Party WS-Federation Passive protocol URL text box, enter the Relying Party WS-Federation Passive protocol URL in the format of https://appredirectURL/Meeting/Home/Index. For example, https://avepointmeetings:20000/Meeting/Home/Index.

    *Note: The app redirect URL contains the hostname and the port for AvePoint Meetings Pro for

    SharePoint you are about to install. For example, if you entered avepointmeetings:20000 as the

    app redirect URL, avepointmeetings will be the hostname and 20000 will be the port for

    AvePoint Meetings Pro for SharePoint. The app redirect URL entered here will be employed

    when installing AvePoint Meetings Pro app package.

    *Note: If the port number you are about to use for AvePoint Meetings Pro for SharePoint is 443,

    which is the default port, you can either omit the port number in the text box and enter the

    Relying Party WS-Federation Passive protocol URL in the format of

    https://hostname/Meeting/Home/Index, or enter the Relying Party WS-Federation Passive

    protocol URL in the format of https://appredirectURL/Meeting/Home/Index without omitting

    the port number.

    9. Click Next to proceed to the next step.

    https://appredirecturl/pages/default.aspx/_trust

  • 28

    AvePoint Meetings Pro for SharePoint On-Premises

    10. In the Configure Identifiers interface, enter the relying party trust identifier in the following format: aaa:bbb:ccc. For example, urn:sharepoint:contoso. Click Add.

    *Note: The relying party trust identifier name you entered here will be employed when

    installing the AvePoint Meetings Pro website.

    11. Click Next. The Choose Issuance Authorization Rules interface appears.

    Figure 18: The Choose Issuance Authorization Rules interface appears.

    12. Click Permit all users to access this relying party.

  • 29

    AvePoint Meetings Pro for SharePoint On-Premises

    13. Click Next to proceed to the Finish interface.

    Figure 19: The Finish interface appears.

    14. Click Close to exit the Add Relying Party Trust Wizard and then the Edit Claim Rules interface pops up. To configure the claim rule, refer to Configuring the Claim Rule.

    Configuring the Claim Rule

    Complete the following steps to configure a claim rule for AvePoint Meetings Pro for SharePoint:

    1. In the Issuance Transform Rules tab, click Add Rule. The Add Transform Claim Rule Wizard appears.

    2. Complete the following settings to add a claim rule:

  • 30

    AvePoint Meetings Pro for SharePoint On-Premises

    In the Select Rule Template interface, select Send LDAP Attributes as Claims from the Claim rule template drop-down list. Click Next.

    Figure 20: Selecting Send LDAP Attributes as Claims.

  • 31

    AvePoint Meetings Pro for SharePoint On-Premises

    In the Configure Rule interface, configure the following settings:

    Figure 21: The Configure Rule interface.

    o Claim rule name Enter the claim rule name in the Claim rule name field.

    o Attribute store Select Active Directory from the Attribute store drop-down list.

    o Mapping of LDAP attributes to outgoing claim types Select E-Mail-Addresses from the LDAP Attribute drop-down list and Outgoing Claim Type drop-down list respectively.

    o Click Finish to exit this wizard and go back to the Edit Claim Rules interface.

    3. Click OK to save the configurations.

  • 32

    AvePoint Meetings Pro for SharePoint On-Premises

    Adding the Token-signing Certificate as a Trusted Certificate

    Before the specified users in the ADFS server domain access AvePoint Meetings Pro for SharePoint in the

    SharePoint site, the token-signing certificate of ADFS server must be added as a trusted certificate to the

    server where the AvePoint Meetings Pro website resides. Refer to the sections below for more

    information:

    1. Exporting the Token-signing Certificate from ADFS Server

    2. Adding the Exported Certificate as a Trusted Certificate

    Exporting the Token-signing Certificate from ADFS Server

    To add the token-signing certificate as a trusted certificate to another server, you must export this

    certificate from the ADFS server first. Complete the following steps to export the token-signing

    certificate:

    1. Log into the server that has ADFS server installed. Navigate to Start > All Programs > Administrative Tools > AD FS 2.0 Management. The AD FS 2.0 window pops up.

    Figure 22: The AD FS 2.0 window pops up.

  • 33

    AvePoint Meetings Pro for SharePoint On-Premises

    2. On the left pane, expand the Service node and select the Certificates node. The Certificates pane appears.

    Figure 23: The Certificates pane appears.

    3. Double-click the token-signing certificate under the Token-signing heading. The Certificate window pops up.

    4. Under the Details tab, click Copy to File. The Certificate Export Wizard appears.

    Figure 24: Clicking Copy to File under the Details tab.

    5. In the Welcome interface, click Next to proceed to the next step.

  • 34

    AvePoint Meetings Pro for SharePoint On-Premises

    6. In the Export File Format interface, select DER encoded binary X.509 (.CER) as the file format of the certificate you are about to export.

    Figure 25: Selecting DER encoded binary X.509 (.CER) as the file format.

    7. Click Next. The File to Export interface appears.

    8. Click Browse to locate a folder to store the exported .CER certificate. In the pop-up Save as window, enter a name for this exported file. Click Save.

    9. Click Next to proceed to the next step.

    10. In the Complete the Certificate Export Wizard interface, click Finish to exit this wizard.

  • 35

    AvePoint Meetings Pro for SharePoint On-Premises

    Adding the Exported Certificate as a Trusted Certificate

    Complete the following steps to add the exported token-signing certificate as a trusted certificate to the

    server where you are about to install the AvePoint Meetings Pro website, or that already has AvePoint

    Meetings Pro website installed:

    1. Log into the server where you are about to install the AvePoint Meetings Pro website or that already has AvePoint Meetings Pro website installed.

    2. Copy the exported token-signing certificate to this server.

    3. Click Start on the desktop and enter mmc as the keyword to search for the mmc.exe file.

    4. Right-click the searched out mmc.exe file and select Run as administrator. The Console Root interface appears.

    Figure 26: The Console Root interface appears.

  • 36

    AvePoint Meetings Pro for SharePoint On-Premises

    5. Click File on the ribbon, and then select Add/Remove Snap-in from the drop-down menu. The Add or Remove Snap-ins interface appears.

    6. Select Certificates from the Available snap-ins table and then click Add. The Certificates snap-in interface appears.

    Figure 27: Selecting Certificates from the Available snap-ins table.

    7. Click Computer account and then click Next.

    8. In the Select Computer interface, keep the default settings and then click Finish to go back to the Add or Remove Snap-ins interface.

    9. Click OK. The Certificates folder node appears on the left pane.

  • 37

    AvePoint Meetings Pro for SharePoint On-Premises

    10. Expand the Certificates folder node to load its child nodes. Expand the Personal folder node. The Certificates folder node appears.

    Figure 28: The Certificates folder node.

    11. Right-click the Certificates folder node that appears and then select All Tasks > Import from the drop-down menu. The Certificate Import Wizard appears.

    12. On the Welcome interface, click Next. The File to Import interface appears.

    13. Click Browse to upload the exported token-signing certificate that is copied to the current server.

    14. Click Next. Keep the default settings to proceed to the Completing the Certificates Import Wizard interface. Click Finish to exit this wizard.

    15. Expand the Trusted Root Certification Authorities folder node and right-click the Certificates folder node that appears. Repeat the steps above to import the exported token-signing certificate into the Certificates folder under the Trusted Root Certification Authorities folder.

  • 38

    AvePoint Meetings Pro for SharePoint On-Premises

    Installing AvePoint Meetings Pro for SharePoint On-

    Premises

    Before you begin with the installation, ensure that you have met all of the prerequisites listed in

    AvePoint Meetings Pro for SharePoint On-Premises System Requirements.

    The AvePoint Meetings Pro app package must be installed in the same Active Directory domain as that

    of the AvePoint Meetings Pro website.

    AvePoint Meetings Pro for SharePoint installation consists of the following steps, which must be

    completed in order.

    1. Running the AvePoint Meetings Pro App Package Installation Wizard

    Run this wizard on any SharePoint Web front-end server.

    2. Running the AvePoint Meetings Pro Website Installation Wizard

    Run this wizard on an IIS server that is in the same Active Directory domain as the SharePoint

    Web front-end server in step 1 above.

    3. Adding AvePoint Meetings Pro for SharePoint On-Premises to a SharePoint Site

    4. Installing the AvePoint Meetings Pro Outlook Plug-In (an optional step)

    Install this add-in on end-user computers.

    After completing the installation, you can configure the settings of AvePoint Meetings Pro for

    SharePoint on-premises by configuring the Web.config file. For details, refer to the Configuring the

    Settings of AvePoint Meetings Pro for SharePoint On-Premises in Web.config File.

    Running the AvePoint Meetings Pro App Package Installation

    Wizard

    This wizard generates a .cer certificate (which establishes trust between a SharePoint site and the

    AvePoint Meetings Pro application website), verifies that all of the prerequisite services and service

    applications have been started, registers the AvePoint Meetings Pro for SharePoint information in

    SharePoint, and uploads the AvePoint Meetings Pro app package to the selected app catalog site.

    To use AvePoint Meetings Pro App Package Installation Wizard, complete the following steps:

    1. Go to the directory where you extracted the AvePoint_Meetings_App_VersionNumber_SerialNumber.zip file.

    2. Right-click the Setup.exe file and then select Run as administrator to run this wizard.

  • 39

    AvePoint Meetings Pro for SharePoint On-Premises

    3. In the Welcome page, select Upload a new AvePoint Meetings Pro app package and click Next to proceed to the next step.

    4. Select the I accept the terms in the license agreement. option, and then click Next.

    5. In the Certificate Configuration interface, you can choose to import an existing .pfx certificate, or create a new certificate.

    *Note: Only the wildcard certificates are supported.

    To import an existing .pfx certificate, select Import an Existing Certificate and then complete the following steps:

    Figure 29: Selecting Import an Existing Certificate in the Certificate Configuration interface.

    i. Click Browse to upload an existing .pfx certificate file.

    ii. In the pop-up window, locate the .pfx certificate file, and then click Open to

    upload it.

    iii. Enter the password of the uploaded certificate file in the Password text box.

  • 40

    AvePoint Meetings Pro for SharePoint On-Premises

    To create a new .pfx certificate, select Create a New Certificate. A pop-up window appears to inform you that AvePoint does not recommend you create a new certificate in the production environment for security reasons. Click OK to create a new certificate anyway. Enter and confirm the password in the corresponding text boxes.

    Figure 30: Selecting Create a New Certificate in the Certificate Configuration interface.

    6. Click Browse to locate a folder to store the exported .cer and .pfx certificate files, and then click OK.

    7. Click Next to proceed to the next step.

    8. In the App Catalog Site Configuration interface, select a Web application from the drop-down list.

  • 41

    AvePoint Meetings Pro for SharePoint On-Premises

    If the app catalog site already exists in the selected Web application, the URL of this site will be displayed in this page.

    Figure 31: The URL of the app catalog site is displayed in the App Catalog Site Configuration interface.

    If the app catalog site does not exist in the selected Web application, click Create a new app catalog site. A pop-up window appears.

  • 42

    AvePoint Meetings Pro for SharePoint On-Premises

    Figure 32: Clicking Create a new app catalog site.

    i. Click the Manage App Catalog link in the pop-up window. The SharePoint

    Manage App Catalog interface appears.

    ii. Create an app catalog site for the selected Web application. For more

    information on how to create an app catalog site, refer to Setting up an App

    Catalog.

    iii. Return to the wizard, click Close to close the pop-up window.

    iv. Click Refresh.

    v. Select the previously selected Web application again. The newly created app

    catalog site is displayed on GUI.

    *Note: The AvePoint Meetings Pro App Package Installation Wizard uploads the AvePoint

    Meetings Pro app package to the app catalog site collection. You must run this wizard again if

    you want to upload the AvePoint Meetings Pro app package to another app catalog site

    collection.

    9. Click Next to proceed to the next step.

    10. The wizard automatically starts checking whether or not the environment has met the prerequisites for installing AvePoint Meetings Pro for SharePoint. For more information on how

  • 43

    AvePoint Meetings Pro for SharePoint On-Premises

    to configure the SharePoint environment for hosting AvePoint Meetings Pro for SharePoint, refer to Preparing the Environment to Host AvePoint Meetings Pro for SharePoint On-Premises.

    Figure 33: Checking rules in the Service Authentication interface.

    11. After the check is finished, click Next to proceed to the next step. If you failed to scan the rules, make sure the environment meets the installation rules first, and then click Rescan to scan again.

    12. In the App Information Configuration interface, configure the hostname and the port for AvePoint Meetings Pro for SharePoint in the App Redirect URL text box following the format of Hostname:Port. For example: avepointmeetings:20000. If the port number you are about to use is 443, do not enter port number in the text box. For example: avepointmeetings.

    *Note: To configure ADFS authentication for AvePoint Meetings Pro for SharePoint, in the App

    Redirect URL text box, enter the app redirect URL you configured for AvePoint Meetings Pro for

    SharePoint when adding the relying party trust. For more information, refer to Adding a Relying

    Party Trust.

    *Note: The host must be added in DNS Manager or the hosts file and direct to the computer where AvePoint Meetings Pro website you are about to install resides. The port configured here will be used as the port of the AvePoint Meetings Pro website. Complete the following steps to add the host in the hosts file:

    a. Click Run from the Start menu.

    b. Enter drivers in the text box and then click OK.

    c. Open the etc folder.

  • 44

    AvePoint Meetings Pro for SharePoint On-Premises

    d. Open the hosts file using Notepad.

    e. Enter the IP address in the left pane, press Tab on the keyboard twice, and then enter

    the hostname in the right pane.

    f. Save the changes and close the hosts file.

    13. Click Next to proceed to the next step.

    14. In the Installation Summary interface, the configuration information is listed for you to make sure if anything you configured is incorrect. Click Next to proceed to the next step.

    Figure 34: The Installation Summary interface.

    15. The wizard automatically starts installing the AvePoint Meetings Pro app package.

    16. During the installation, a pop-up window appears to confirm whether or not you want to restart IIS service. Click Restart Now to restart the IIS service immediately or click Restart Later to manually restart it later.

    17. In the Complete interface, click Copy to copy the Issuer ID. This will be used when installing AvePoint Meetings Pro website. A report containing your app package configuration information will be generated automatically after the installation. Click the link in the Report Location field to navigate to the folder where this report resides.

    18. Click Finish to exit this wizard.

  • 45

    AvePoint Meetings Pro for SharePoint On-Premises

    Running the AvePoint Meetings Pro Website Installation Wizard

    Because AvePoint Meetings Pro for SharePoint is a Provider-Hosted app, this wizard creates a stand-

    alone website during installation. Once the app is installed, a user can click the AvePoint Meetings Pro

    icon in any SharePoint 2013 or SharePoint 2016 site where AvePoint Meetings Pro for SharePoint is

    configured to be redirected to this website.

    Follow the steps below to run this wizard:

    1. Go to the directory where you extracted the AvePoint_Meetings_Website_VersionNumber_SerialNumber.zip file.

    *Note: If you are about to install more websites on the Network load balance cluster for the

    AvePoint Meetings Pro website load balance function, copy and extract the

    AvePoint_Meetings_Website_VersionNumber_SerialNumber.zip file to any IIS server that is in

    the same Active Directory domain as the SharePoint Web front-end server where AvePoint

    Meetings Pro app package resides and does not have AvePoint Meetings Pro website installed.

    2. Right-click the Setup.exe file and then select Run as administrator to run this wizard.

    3. The Welcome page appears.

    If you have not installed the AvePoint Meetings Pro before, click Next to proceed to the next step directly.

    If you have installed the AvePoint Meetings Pro and you only want to reconfigure the settings in Web.config file, select Reconfigure your AvePoint Meetings Pro website settings, and then click Next to proceed to the next step.

    *Note: With Reconfigure your AvePoint Meetings Pro website settings selected, you

    can only configure the settings on the Database Configuration, Administration, and

    Advanced interface. For details, refer to the corresponding introductions below.

    If you have installed the AvePoint Meetings Pro and you want to reinstall the website in exactly the same version, select Reinstall the AvePoint Meetings Pro website with the new Setup.exe file, and update your website settings, and then click Next to proceed to the next step.

  • 46

    AvePoint Meetings Pro for SharePoint On-Premises

    4. Select the I accept the terms in the license agreement. option, and then click Next.

    5. This wizard automatically starts scanning the installation rules.

    Figure 35: Installation Rules Scanning interface.

    6. After the scan is finished, click Next to proceed to the next step. If you failed to scan the rules, make sure the environment meets the installation rules first, and then click Rescan to scan again.

    IIS Service Version IIS 7 or above

    .Net Framework Version 4.5 or above

    7. In the Certificate Configuration interface, click Browse to upload the .pfx certificate file used in the AvePoint Meetings Pro App Package Installation Wizard.

    *Note: Only the wildcard certificates are supported.

  • 47

    AvePoint Meetings Pro for SharePoint On-Premises

    Figure 36: Clicking Browse to upload the .pfx certificate file.

    8. In the pop-up window, locate the .pfx certificate file, and then click Open to upload it.

    9. Enter the password of the uploaded .pfx certificate file, and then click Next.

    10. In the Website Configuration interface, configure the settings for the website you are about to add:

    *Note: If you access the AvePoint Meetings Pro website from the server where the AvePoint

    Meetings Pro website resides, either BackConnectionHostNames or DisableLoopBackCheck

    needs to be configured. To manually configure BackConnectionHostNames or

    DisableLoopBackCheck, refer to Microsoft Support Article.

    https://support.microsoft.com/en-us/help/896861/you-receive-error-401-1-when-you-browse-a-web-site-that-uses-integrat

  • 48

    AvePoint Meetings Pro for SharePoint On-Premises

    Figure 37: Configuring the settings in the Website Configuration interface.

    Website Name Enter a name for your website if you want to use a different name than the one in the Website Name text box.

    Website Host Name This is optional. Select the Website Host Name option to enter the hostname for your website. The hostname must be the same as the hostname configured in the AvePoint Meetings Pro App Package Installation Wizard. For example, if you configure avepointmeetings:20000 in the AvePoint Meetings Pro App Package Installation Wizard, enter avepointmeetings in this text box.

    Physical Path Enter a physical path for your website if you want to use a different path than the one in the Physical Path text box.

    Port Enter a port number for your website. The port must be the same as the port configured in the AvePoint Meetings Pro App Package Installation Wizard. For example, if you configure avepointmeetings:20000 in the AvePoint Meetings Pro App Package Installation Wizard, enter 20000 in this text box.

    Website Application Pool Enter the name for the application pool of your website if you want to use a different name than the one in the Website Application Pool text box.

    Username/Password Enter the username and password for your website.

    *Note: The user configured here must be a member of the local Administrators group

    and have at least the Write permission to the database that will be configured in the

    Database Configuration step.

    11. Click Next to proceed to the next step.

  • 49

    AvePoint Meetings Pro for SharePoint On-Premises

    12. In the Database Configuration interface, complete the following settings to configure the database that will store all data generated by AvePoint Meetings Pro for SharePoint:

    Figure 38: The Database Configuration step.

    SQL Server Name Enter the SQL server where the database resides.

    Database Name Enter the database name if you want to use a different name than the one in the Database Name text box.

    Authentication Select an authentication method to access the database.

    o Windows Authentication Select Windows Authentication to access the database.

    o SQL Server Authentication Select SQL Server Authentication to access the database.

    Username Enter the username used to access the database.

    Password Enter the corresponding password.

    13. Click Next to proceed to the next step.

  • 50

    AvePoint Meetings Pro for SharePoint On-Premises

    14. In the Administration interface, complete the following settings to configure the administration:

    Figure 39: Configuring the settings in the Administration interface.

    Meetings Global Administrator Configure an Active Directory user as the administrator to view the statuses of all of the actions in the Dashboard of Global View.

    o Domain Name Enter the name of the Active Directory domain where the AvePoint Meetings Pro server belongs.

    o Username Enter a username of the domain user.

    *Note: Enter the username excluding the domain name. For example, enter

    Mary instead of avepoint\Mary.

    o Password Enter the corresponding password.

    *Note: The configured user must be a Windows account.

    *Note: If the current server, where AvePoint Meetings Pro website will be installed,

    belongs to a parent domain, you can enter a child domain name in the Domain Name

    text box and then enter a username of that child domain in the Username text box, or

    enter the parent domain name in the Domain Name text box and then enter a

    username of a child domain in the Username text box. If the current server, where

    AvePoint Meetings Pro website resides, belongs to a child domain, you can enter a

    parent domain name or the child domain name in the Domain Name text box and then

    enter a username of the parent domain, or enter the name of another child domain in

  • 51

    AvePoint Meetings Pro for SharePoint On-Premises

    the Domain Name text box and then enter a username of that child domain in the

    Username text box.

    Retrieve User Profile Photos Configure an account to retrieve end user photos from the User Profile Service. This account only needs "Read Access" to the User Profile Service.

    o Domain Name Enter the name of the domain where the AvePoint Meetings Pro server belongs.

    o Username Enter a username of the domain user.

    *Note: Enter the username excluding the domain name. For example, enter

    Mary instead of avepoint\Mary.

    o Password Enter the corresponding password.

    *Note: If the current server, where AvePoint Meetings Pro website will be installed,

    belongs to a parent domain, you can enter a child domain name in the Domain Name

    text box and then enter a username of that child domain in the Username text box, or

    enter the parent domain name in the Domain Name text box and then enter a

    username of a child domain in the Username text box. If the current server, where

    AvePoint Meetings Pro website resides, belongs to a child domain, you can enter a

    parent domain name or the child domain name in the Domain Name text box and then

    enter a username of the parent domain, or enter the name of another child domain in

    the Domain Name text box and then enter a username of that child domain in the

    Username text box.

    Install the optional AvePoint Meetings timer service With this option selected, AvePoint Meetings Pro timer service will be used to track tasks, measure durations in meetings and more. Complete the following information to configure an account to start the service:

    *Note: If you do not select this option, the timer service will not be installed, and the

    Todays meetings view and the Task Synchronization feature will be disabled. Besides,

    the recurring rules information of the recurring meeting will be displayed on the

    meeting tile.

    o Username Enter a username in this text box to configure an account to start the service.

    *Note: If you want to use a Windows Authentication user, the user must have

    the db_owner role to the AvePoint Meetings Pro database.

    o Password Enter the corresponding password.

    15. Click Next to proceed to the next step.

    16. In the Issuer ID interface, enter the Issuer ID in the text box, and then click Next. The Issuer ID must be the same as the one generated in the AvePoint Meetings Pro App Package Installation

  • 52

    AvePoint Meetings Pro for SharePoint On-Premises

    Wizard. For more information, refer to Running the AvePoint Meetings Pro App Package Installation Wizard.

    *Note: If you forget the Issuer ID, go to the AvePoint\AvePoint Meetings Pro\Report directory

    and find the Installation report for Meetings app file. Open this file and find what the Issuer ID

    is.

    *Note: If there are websites installed on other IIS servers that are in the same Active Directory

    domain as the SharePoint Web front-end server where AvePoint Meetings Pro app package

    resides, you can find the Issuer ID in the following ways:

    Go to the AvePoint\AvePoint Meetings Pro\Report directory on the server in the Network load balance cluster with AvePoint Meetings Pro app package installed. Find the Installation report for Meetings app file. Open this file and find what the Issuer ID is.

    Go to the \AvePoint\AvePoint Meetings Pro\AvePoint WebSite directory on any server in the Network load balance cluster with AvePoint Meetings Pro website installed. Find and open the Web.config file, and then locate the node. The value of this node is the issuer ID generated in your AvePoint Meetings Pro App Package Installation Wizard.

    Figure 40: Issuer ID in the Web.config file.

    17. In the Advanced interface, to configure the e-mail server, select the Enable E-mail Server option and then complete the following settings:

    Use Exchange Server Select this option to configure the Exchange Server settings to send e-mails when sharing a meeting, exporting meeting minutes, or inviting an agenda guest.

    *Note: Only Exchange Server 2010 and 2013 can be configured to work with AvePoint Meetings Pro 4.3.

  • 53

    AvePoint Meetings Pro for SharePoint On-Premises

    Figure 41: Selecting Use Exchange Server.

    o Exchange Service URL Enter the Exchange Service URL where the e-mail account configured below will connect.

    o Username Enter the username in the text box, and the e-mail notifications will be sent via the Exchange e-mail address of the entered user when sharing a meeting, exporting meeting minutes, or inviting an agenda guest.

    o Password Enter the corresponding password of the e-mail address.

    Select Same Exchange Server, Custom, or Retrieve Automatically to configure the

    Exchange Service URL used to send an e-mail notification when creating or editing a

    meeting.

    o Same Exchange Server Select this option if you want to use the same Exchange Service URL as the one configured above.

    o Custom Select this option if you want to use a different Exchange Service URL. Enter a different Exchange Service URL in the text box below.

    o Retrieve Automatically Select this option if you do not want to configure the Exchange Service URL in the installation process. With this option selected, the Exchange Service URL will be retrieved automatically after you configure the Exchange e-mail account when creating or editing a meeting.

    Use SMTP Server Select this option to configure the SMTP server settings to send e-mails from AvePoint Meetings Pro for SharePoint to attendees.

  • 54

    AvePoint Meetings Pro for SharePoint On-Premises

    Figure 42: Selecting Use SMTP Server.

    o SMTP Server Enter the SMTP server used to send e-mails.

    o SMTP Port Enter the port of the SMTP server. The default port is 25.

    o Enable SSL Authentication Select this option if SSL authentication is used in the SMTP server.

    o Enable Anonymous Access Select this option to enable anonymous access, or configure the e-mail address and password below without selecting this option. With this option selected, the e-mail notifications will be sent via the e-mail address of the user who logs into AvePoint Meetings Pro for SharePoint. With this option deselected, the e-mail notifications will be sent via the e-mail address configured below.

    *Note: With the Enable Anonymous Access option selected, in order for

    Exchange Server groups to receive e-mail notifications, make sure Senders

    inside and outside of my organization is selected for their delivery

    management settings.

    o E-mail Address Enter the e-mail address in the text box, and then the e-mail address will be used to access the entered SMTP server.

    o Password Enter the corresponding password of the e-mail address.

  • 55

    AvePoint Meetings Pro for SharePoint On-Premises

    To configure the website load balance, select the Enable Website Load Balance option.

    Figure 43: Selecting the Enable Website Load Balance option.

  • 56

    AvePoint Meetings Pro for SharePoint On-Premises

    To configure ADFS authentication for AvePoint Meetings Pro for SharePoint, select the Enable

    ADFS Authentication option to enable this function. Complete the following settings to

    configure ADFS authentication for your AvePoint Meetings Pro website:

    Figure 44: Selecting the Enable ADFS Authentication option.

    Relying Party Trust Identifier Enter the relying party trust identifier configured when adding the relying party trust. For more information, refer to Adding a Relying Party Trust.

    *Note: Enter the relying party trust identifier in the following format: aaa:bbb:ccc. For

    example, urn:sharepoint:contoso.

    Full Computer Name (ADFS Server) Enter the full computer name of the server where the ADFS server resides.

    Trusted Identity Provider Name Enter the trusted identity provider used by the Web application where you are about to add AvePoint Meetings Pro for SharePoint.

  • 57

    AvePoint Meetings Pro for SharePoint On-Premises

    Domain Name Enter the name of the domain where the ADFS server belongs.

    Username (ADFS Server) Enter a username of the ADFS server used to connect to the domain you entered above.

    *Note: Enter the username excluding the domain name. For example, enter Mary

    instead of avepoint\Mary.

    Password Enter the corresponding password.

    Is UPN enabled in your ADFS environment? Select Yes or No to indicate whether or not the ADFS environment enables UPN.

    To configure AD integration to allow AvePoint Meetings Pro for iOS to search and check Active

    Directory domain users information, select the Enable AD Integration option to enable this

    function. Complete the following settings to configure AD integration for your AvePoint

    Meetings Pro website:

    Figure 45: Selecting the Enable AD Integration option.

    Domain Name Enter the name of the Active Directory domain where the AvePoint Meetings Pro server belongs.

    Username (AD) Enter a username of the domain user.

    Password Enter the corresponding password.

    *Note: If the current server, where AvePoint Meetings Pro website will be installed, belongs to a

    parent domain, you can enter a child domain name in the Domain Name text box and then

    enter a username of that child domain in the Username text box, or enter the parent domain

  • 58

    AvePoint Meetings Pro for SharePoint On-Premises

    name in the Domain Name text box and then enter a username of a child domain in the

    Username text box. If the current server, where AvePoint Meetings Pro website resides, belongs

    to a child domain, you can enter a parent domain name or the child domain name in the

    Domain Name text box and then enter a username of the parent domain, or enter the name of

    another child domain in the Domain Name text box and then enter a username of that child

    domain in the Username text box.

    18. Click Next to proceed to the next step.

    19. In the Installation Summary interface, the configuration information is listed for you to view if anything you configured is incorrect. Click Next to proceed to the next step.

    Figure 46: Your configuration information is listed on the Installation Summary interface.

    20. The wizard automatically starts installing the AvePoint Meetings Pro website.

    21. A report containing your website configuration information will be generated automatically after the installation and the report location listed in the Progress interface is where this report resides. Click the link in the Report Location field to navigate to the folder where this report resides.

    22. Click Finish to exit this wizard.

  • 59

    AvePoint Meetings Pro for SharePoint On-Premises

    Adding AvePoint Meetings Pro for SharePoint On-Premises to a

    SharePoint Site

    AvePoint Meetings Pro for SharePoint on-premises will be added from the app catalog site to any

    SharePoint site under the same Web application where the app catalog site resides.

    *Note: System accounts cannot add AvePoint Meetings Pro for SharePoint to SharePoint sites.

    1. Navigate to the SharePoint site where you want to add AvePoint Meetings Pro for SharePoint.

    2. Click the Settings ( ) button on the top right corner of the site, and then click Add an app. Or, navigate to the Site Contents page and click add an app. The Your Apps page appears.

    Figure 47: The Your Apps page.

    3. In the Quick Launch, click From Your Organization to add AvePoint Meetings Pro for SharePoint from App Catalog.

  • 60

    AvePoint Meetings Pro for SharePoint On-Premises

    4. Enter AvePoint Meetings Pro in the Find an app search box, and then press Enter.

    5. Click AvePoint Meetings Pro. To learn more about AvePoint Meetings Pro for SharePoint, click App Details.

    Figure 48: Clicking App Details to learn more about AvePoint Meetings Pro for SharePoint.

    6. Click ADD IT to add AvePoint Meetings Pro on the site.

    Figure 49: Clicking ADD IT to add AvePoint Meetings Pro on the site.

    7. When asked if you want to trust AvePoint Meetings Pro for SharePoint, click Trust It.

    8. AvePoint Meetings Pro for SharePoint will now appear on the Site Contents page. To view the AvePoint Meetings Pro for SharePoint page, click AvePoint Meetings Pro on the Site Contents page.

  • 61

    AvePoint Meetings Pro for SharePoint On-Premises

    Installing AvePoint Meetings Pro for SharePoint On-

    Premises in a Network Load Balanced Cluster

    To install AvePoint Meetings Pro for SharePoint in a network load balanced cluster, make sure that you

    have met the prerequisites provided in AvePoint Meetings Pro for SharePoint On-Premises System

    Requirements.

    To install AvePoint Meetings Pro for SharePoint in a network load balanced cluster, install the AvePoint

    Meetings Pro app package on any network load balanced cluster node, and then install the AvePoint

    Meetings Pro website on each network load balanced cluster node.

    *Note: After installing the AvePoint Meetings Pro app package and website, you will add a host in DNS

    for the AvePoint Meetings Pro for SharePoint direct URL. This is explained in Adding a Host in DNS for

    AvePoint Meetings Pro for SharePoint On-Premises.

    Complete the following steps to install AvePoint Meetings Pro for SharePoint in a network load balanced

    cluster:

    1. Install AvePoint Meetings Pro app package on a SharePoint server in the network load balanced cluster. For more information, refer to Running the AvePoint Meetings Pro App Package Installation Wizard.

    2. Install AvePoint Meetings Pro website on each IIS server in the network load balanced cluster. For more information, refer to Running the AvePoint Meetings Pro Website Installation Wizard.

    3. In DNS Manager, add a host for AvePoint Meetings Pro for SharePoint. The IP is the NLB Cluster IP. For more information, refer to Adding a Host in DNS for AvePoint Meetings Pro for SharePoint On-Premises.

    After completing the installation, you can configure the settings of AvePoint Meetings Pro for

    SharePoint on-premises by configuring the Web.config file. For details, refer to the Configuring the

    Settings of AvePoint Meetings Pro for SharePoint On-Premises in Web.config File.

    *Note: To configure a setting, the Web.config file of each SharePoint server in the network load

    balanced cluster must be configured.

    Adding a Host in DNS for AvePoint Meetings Pro for SharePoint

    On-Premises

    On the domain controller machine, complete the following steps to add a host in DNS for AvePoint

    Meetings Pro for SharePoint:

    1. Navigate to Start > Administrative Tools > DNS. The DNS Manager interface appears.

    2. Expand the Forward Lookup Zones node.

  • 62

    AvePoint Meetings Pro for SharePoint On-Premises

    3. Locate the corresponding domain under the Forward Lookup Zones node. For example, if the app redirect URL is meetings.ContosoApps.com, locate ContosoApps.com under the Forward Lookup Zones node.

    4. Right-click the corresponding domain node, and then select New Host (A or AAAA) from the drop-down menu.

    5. In the New Host pop-up window:

    a. Enter the host in the Name (uses parent domain name if blank) text box. For example,

    if the app redirect URL is meetings.ContosoApps.com, enter meetings in the text box.

    Figure 50: Entering the host in the Name (uses parent domain name if blank) text box.

    b. Enter the NLB cluster IP address in the IP address text box.

    c. Click Add Host.

    6. The newly added host appears in the right pane of the interface.

    If desired, you can also add a wildcard alias for the domain. For more information, refer to the

    instructions provided in the Configure the domain names in DNS (all hosting options) section of this

    article: http://technet.microsoft.com/en-us/library/fp161236(v=office.15).aspx.

    http://technet.microsoft.com/en-us/library/fp161236(v=office.15).aspx

  • 63

    AvePoint Meetings Pro for SharePoint On-Premises

    Configuring AvePoint Meetings Pro Website Load

    Balance

    After the AvePoint Meetings Pro website load balance is properly configured, the followings are

    supported:

    The scalability and availability of AvePoint Meetings Pro for SharePoint on-premises will be largely enhanced by distributing network traffic in each website.

    Multiple attendees accessing a meeting via different websites can successfully receive the synchronous data, including updates during the meeting.

    Pre-requirements

    Before configuring AvePoint Meetings Pro website load balance, make sure that the followings are in

    place:

    AvePoint Meetings Pro for SharePoint on-premises has been properly installed on a Network load balance cluster.

    The AvePoint_Meetings_Website_VersionNumber_SerialNumber.zip file has been downloaded and extracted to the IIS server that is in the same Active Directory domain as the Network load balance cluster where AvePoint Meetings Pro app package resides and have AvePoint Meetings Pro websites installed.

    Navigate to Updating AvePoint Meetings Pro Website to configure the AvePoint Meetings Pro website

    load balance by updating your AvePoint Meetings Pro websites.

    Repeat the steps in Updating AvePoint Meetings Pro Website to update the other websites installed on

    the Network load balance cluster. You must use the same database for the update of each AvePoint

    Meetings Pro website.

    After properly updating all your AvePoint Meetings Pro websites installed on the Network load balance cluster, the AvePoint Meetings Pro website load balance is successfully configured.

    If you want to install more websites on other IIS servers that are in the same Active Directory domain as

    the Network load balance cluster where AvePoint Meetings Pro app package resides for the AvePoint

    Meetings Pro website load balance function, refer to Running the AvePoint Meetings Pro Website

    Installation Wizard. After installing AvePoint Meetings Pro websites on the specific Network load

    balance cluster, apply the AvePoint Meetings Pro license for each installed website when the free 30-

    day trial has expired.

  • 64

    AvePoint Meetings Pro for SharePoint On-Premises

    Configuring the Settings of AvePoint Meetings Pro for

    SharePoint On-Premises in Web.config File

    After the AvePoint Meetings Pro for SharePoint on-premises is installed completely, you can configure

    the following settings:

    Enabling the Creating a New Meeting Feature

    Enabling the Sending E-mail Notification to All Attendees Feature

    Enabling the Breaking the Sync Relationship Feature

    Enabling Users to Only View Attachment for Their Meetings in SharePoint Libraries

    Enabling Deleting Searched Out Meetings Feature

    Configuring the Exchange Service URL

    Configuring the Maximum Attachment Size

    Configuring My Site Host Location

    Hiding the Dashboard in the Global View

    Hiding the AvePoint Options in AvePoint Meetings Pro for iOS

    Customizing the Support and About Meetings Options

    Customizing the Intervals for Generating Event Logs

    Customizing the Intervals for Task Synchronization

    Customizing the Value of Back to Site Button

    Customizing the Body of E-mail Notifications

    Enabling the Creating a New Meeting Feature

    To enable the Creating a New Meeting feature by modifying the Web.config file, complete the following

    steps:

    1. Log into the server where AvePoint Meetings Pro website resides.

    2. Go to the \AvePoint\AvePoint Meetings Pro\AvePoint WebSite directory and find the Web.config file.

    3. Open the Web.config file with Notepad.

    4. Locate the node.

    5. Enter False as the value of this node to enable the feature of creating a new meeting; otherwise, enter True.

    6. Save the file.

  • 65

    AvePoint Meetings Pro for SharePoint On-Premises

    Enabling the Sending E-mail Notification to All Attendees Feature

    To enable the Sending E-mail Notification to All Attendees feature by modifying the Web.config file,

    complete the following steps:

    1. Log into the server where AvePoint Meetings Pro website resides.

    2. Go to the \AvePoint\AvePoint Meetings Pro\AvePoint WebSite directory and find the Web.config file.

    3. Open the Web.config file with Notepad.

    4. Locate the node.

    5. Enter True as the value of this node to enable the feature of sending e-mail not