Installing HotDocs Hub with User Management

You must run the HotDocs Hub installer to install the core Hub applications in your environment.

In this Topic ShowHide

Prerequisites

• See HotDocs Hub System Requirements for a full list of prerequisites.
• Assigning permissions for the signing certificate

Configure Internet Information Services (IIS) to use HTTPS

The IIS website where Hub is installed must use HTTPS. See https://blogs.msdn.microsoft.com/rakkimk/2007/05/25/iis7-how-to-configure-a-website-for-https/ for more information on configuring HTTPS in IIS.

Installation

To install the HotDocs Hub

1. Unzip the CombinedHub zip file provided to you by HotDocs.
2. Open the Windows Command Prompt as an administrator.
3. Navigate to the extracted CombinedHub directory, containing the HotDocs Hub installation files.
4. Run the HotDocs Hub installer file (e.g. HotDocsHub_Setup.msi).
5. Click Next.
6. Review and accept the License Agreement terms.
7. Click Next.
8. (Optional) Click Browse to change the default installation directory.
9. Click Next.
10. Click Install.
11. Click Finish.

To run additional installation scripts

Note: you may need to change your Powershell execution policy status to run the installation scripts. See Elevated status error when running Invoke.ps1 post-install script for more information.

1. Run Powershell as an administrator.
2. Change the directory to the extracted CombinedHub > Post-Install > Post-install Scripts folder.
3. Edit the Invoke.ps1 script in a text editor to customize the installation parameters; see Post-Installation Script Parameters for more information.
4. Run the Invoke.ps1 script in Powershell, using the following command with your own values replacing the {placeholder} values:
   .\Invoke.ps1 -EnableOAuth2 {enable-oauth2} -SqlServer "{sql-server-name}" -SqlUser {sql-username} -SqlPass {sql-password} -IisWebSite "{website-name}" -IisHostName "{host-name}" -IisAppRoot "{hub-application-root}"
   Where:
• enable-oauth2 – 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 Hub is installed including the domain, e.g. hub.yourorganization.com; this name must match the host name you used when configuring the SSL binding in IIS
• hub-application-root – path to root installation directory containing the HotDocs Hub applications; e.g. C:\inetpub\wwwroot

HotDocs Hub is now installed.

Backup Post-installation Script

Once Hub is installed successfully, you should make a backup copy of the post-installation script and Powershell command used above. This will be useful if you ever need to upgrade your Hub to a later version.

Next Step

Install HotDocs Server and Web Services