Installing the HotDocs Hub with Active Directory
The HotDocs Hub installer installs the core Hub components and user interface.
In this Topic Hide
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
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
- Unzip the CombinedHub zip file provided to you by HotDocs.
- Open the Windows Command Prompt as an administrator.
- Navigate to the extracted CombinedHub directory, containing the HotDocs Hub installation files.
- Run the HotDocs Hub installer file (e.g. HotDocsHub_Setup.msi).
- Click Next.
- Review and accept the License Agreement terms.
- Click Next.
- (Optional) Click Browse to change the default installation directory to the required location.
- Click Next.
- Click Install.
- Click Finish.
To run additional installation scripts
You may need to change your Powershell execution policy status to run the installation scripts. See Elevated status error when running ConfigureHub.ps1 post-install script for more information.
- Run Powershell as an administrator.
- Change the directory to the CombinedHub > Post-Install > Post-install Scripts folder.
- Edit the DefaultConfig.psd1 settings file in a text editor.
- Customize the installation configuration settings in DefaultConfig.psd1.
- Run the ConfigureHub.ps1
script in Powershell, using the following command:
.\ConfigureHub.ps1 -ConfigFile configurationFile -SqlUser username -SqlPass password
Where: - ConfigurationFile – by default, this should be DefaultConfig.psd1; you can specify a different configuration file (e.g. the configuration file for an existing installation of Hub) if necessary.
- Username – the username of a user account with permissions to connect to SQL Server; only required if you are not using integrated security.
- Password – the password for the above user
- Check the Powershell console output to see if you receive the message "Active Directory user SID not found" when altering HotDocsIdentityServer application settings; if you do receive this message, see Active Directory user SID not found when running ConfigureHub script for manual configuration steps.
Backup Post-installation Script
Once Hub is installed successfully, you should make a backup copy of the DefaultConfig.psd1 script above. This will be useful if you ever need to upgrade your Hub to a later version.
Next Step
Configuring HotDocs Web Services