Installing the HotDocs Hub with User Management and Active Directory

The HotDocs Hub installer installs the core Hub components and user interface.

In this Topic ShowHide

Prerequisites

See HotDocs Hub System Requirements for a full list of prerequisites.

Configure Internet Information Services (IIS) to use HTTPS

The IIS website where Hub is installed must use HTTPS. See https://support.microsoft.com/en-us/kb/324069 for more information on configuring HTTPS in IIS.

Installation

You must complete the following tasks to install and configure HotDocs Hub:

• Install the HotDocs Hub
• Run the additional Hub installation scripts

To install the HotDocs Hub

1. Open the Windows Command Prompt as an administrator.
2. Navigate to the directory containing the HotDocs Hub installation files.
3. Run the HotDocs Hub installer.
4. Click Next.
5. Accept the License Agreement terms.
6. Click Next.
7. (Optional) Click Browse to change the default installation directory to the required location.
8. Click Next.
9. Click Install.
10. Click Finish.

To run additional installation scripts

1. Extract the Post-Installation Files zip file provided with the HotDocs Hub installer.
2. Run Powershell as an administrator.
3. Change the directory to the Scripts folder, in the extracted Post-Installation Files folder.
4. Edit the Invoke.ps1 script in a text editor.
5. Edit the values for the following parameters in the script:
• UseAd – set to true
• ApacheDS – set to the URI of the installed ApacheDS server
• ApachePort – set to the port of the installed ApacheDS server
• ApacheUser – set to the administrative user account used to access the installed ApacheDS server
• ApachePass – the password associated with the administrative user account above; by default, the password is set to secret.
• ApacheDomain – the installation domain controller in ApacheDS server; by default, this is dc=example,dc=com
• ApacheTenancy – set this value to the entryUUID value copied during the Configure ApacheDS for use with Active Directory steps.
• ApacheUseSSL – set to true
6. Run the Invoke.ps1 script in Powershell, using the following command:
   .\Invoke.ps1 -EnableOAuth2 true -SqlServer "sql-server-name" -SqlUser sql-username -SqlPass sql-password -IisWebSite "website-name" -IisHostName "host-name" -IisAppRoot "hub-application-root
   Where:
• enable-oauth2 – enable OAuth2 authentication; must be true.
• sql-server-name – name of the SQL Server where the Hub databases are installed; e.g. .\sqlexpress.
• sql-username – name of user that has read and write permissions to the Hub databases.
• sql-password – password associated with the user above.
• website-name – name of the website under which HotDocs Hub is installed; e.g. Default Web Site.
• host-name – name of the server on which the HotDocs Hub is installed, e.g. exampleserver01.
• hub-application-root – path to root installation directory containing the HotDocs Hub applications; e.g. C:\inetpub\wwwroot.

Next Steps

1. Install HotDocs Server
2. Install HotDocs Web Services
3. Configuring HotDocs Identity Server Application Settings.