Hub Installation Checklist

HotDocs Hub installation requires several installation files, scripts, and other prerequisites. Before you start installing the Hub, use the table below to check that you have all of the installation files and prerequisites available.

Hub with User Management Installation Checklist

The following table lists all prerequisites and installation files required to install HotDocs Hub with user management. You should check this list before beginning a new installation, to verify that you have all the software and installation files necessary to complete the install process.

Item Name	Type	Description	Notes
Internet connection	Prerequisite	Required to download installation files and verify HotDocs Server installation.
SMTP server	Prerequisite	Required for user provisioning e-mails.	You should have a note of SMTP settings for use during deployment. See Post-Installation Script Parameters: Email Settings for more information.
Windows Server 2008 R2 SP1 or later	Prerequisite	Server operating system.	See Windows and IIS Configuration Checklist below for specific configuration settings.
Internet Information Service (IIS) 7 or later	Prerequisite	Web server for Windows Server.	See Windows and IIS Configuration Checklist below for specific configuration settings.
URL Rewrite module for IIS	Prerequisite	An extension for IIS that enables administrators to rewrite URLs and create custom response messages.	See URL Rewrite module for IIS for more information.
SQL Server 2012 or later	Prerequisite	Database server.	See SQL Server Configuration Checklist below.
Microsoft .Net Framework 4.6.2 or later	Prerequisite	.Net software framework.
Powershell 3.0 or later	Prerequisite	Used to run Hub post-installation configuration scripts.
SSL certificate	Prerequisite	Used to configure HTTPS for the Hub. The .pfx file for the certificate is required for the deployment.	See Notes on SSL Certificates and Signing Certificates below.
Signing certificate	Prerequisite	Used to sign API requests between HotDocs Hub applications. The .pfx file for the certificate is required for the deployment.	See Notes on SSL Certificates and Signing Certificates below.
HotDocs Hub installer	Installation files	Installer for HotDocs Hub. Provided with the Hub installation package.	HubInstaller.msi
Hub configuration scripts	Installation files	Powershell scripts used for post-installation configuration of Hub. Provided with the Hub installation package.	The files you will use are: DefaultConfig.psd1 – configuration settings file ConfigureHub.ps1 – runs configuration tasks
Hub common Files	Installation files	Additional common files required by the post-installation configuration files. Provided with the Hub installation package.	Common folder
HotDocs Server	Installation files	Provides core HotDocs document assembly and interview generation functionality. Provided with the Hub installation package.
HotDocs Web Service API	Installation files	Web services used by HotDocs Hub to access core HotDocs Server functionality. Provided with the Hub installation package.
Upload Plugin for HotDocs Developer	Installation files	Plugin for HotDocs Developer required to upload templates to Hub. Provided with the Hub installation package.

Windows and IIS Configuration Checklist

Windows and IIS features that you must enable before installing HotDocs Hub.

Item Name	Type	Description	Notes
ASP.Net 4.6	Windows Server feature	Web application framework.
Basic authentication	Windows Server feature	Required to authenticate users login.
HTTP redirection	Windows Server feature	Required by the HotDocs Hub UI.
HTTPS binding	IIS setting	HTTPS must be enabled on the web site where Hub is installed.	See Notes on SSL Certificates and Signing Certificates below.
Signing certificate permissions	Security setting	The user under which the Hub's application pool runs must have read permissions to the private key of your signing certificate.	See assigning permissions for the signing certificate for more information.

SQL Server Configuration Checklist

Hub must be able to connect to SQL Server, to create new databases, read data, and write data.

Item Name	Type	Description	Notes
User account	SQL user	The account used by HotDocs Hub to access SQL Server. This can be: Local account – e.g. Network Service Service account – e.g. a specific domain user SQL login user – e.g. a specific SQL user account with appropriate permissions	You can also configure Hub to connect to the database using integrated security. See Installation Configuration Settings for more information.
dbcreator	SQL Server role	The user must be able to create new databases for the installed Hub applications.
db_datareader	Master Database role	The user must be able to read data from the Hub databases.	Typically not required when user has dbcreator role.
db_datawriter	Master Database role	The user must be able to write data to the Hub databases.	Typically not required when user has dbcreator role.

Notes on SSL Certificates and Signing Certificates

PFX Files

If you have not already set up the certificates, you must have .PFX files for both certificates ready for Hub deployment.

TLS/SSL

You must enable a TLS/SSL connection in IIS when installing HotDocs Hub.

2048 bit public key.
Must be exportable.
Must be imported to the local machine Personal store.
Must be imported to the local machine Trusted People store (if using a self-signed certificate).
You should provide permissions to the MachineKeys directory for the application pool under which Hub runs in IIS

Signing Certificate

Hub requires a certificate for signing access tokens, used for authenticating requests to Hub APIs. The certificate has the following configuration requirements:

May be a self-signed certificate, if necessary.
2048 bit public key.
Must be exportable.
Must be imported to the local machine Personal store.
The identity for the application pool under which the HotDocs Hub applications run must have permissions to the private key of the certificate. You configure these permissions after you install Hub.

You must also add the certificate's thumbprint to the HotDocs Identity Server application settings SigningCertificateThumbprint key during the installation process.

HotDocs recommends that you use a separate security certificate as the signing certificate for Hub. However, you can use the SSL certificate as the signing certificate if necessary.