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
Install HotDocs Core Assembly Service
After installing and configuring the HotDocs Core Assembly Service, see Getting Started with HotDocs Hub for details about launching the Hub UI and logging in.