Use Google to find help fast. For example, search on "xpressdox choosefromlist".

Install XpressDox Server

Install XpressDox Server

This document contains instructions on how to install your XpressDox Server. Before you start, please note:

  • We assume you have the authority and rights to add and configure a website on your network
  • We assume you have experience working with website and database configuration in a Windows environment.

Your XpressDox Server can be opened to the internet to allow remote access, if required.

Hardware Recommendations

Based on our experience we recommend your own hosted server has these, or higher, hardware specifications:

  • Processor: Intel Core i7-4770 Quad Core including Hyper Threading technology
  • RAM: 32 GB DDR3 RAM
  • Hard drives: 2 x 2TB SATA 6 GB/s 7200 rpm (software RAID) Enterprise Class
  • Connection: 1 GBit/s port
  • Bandwidth: 1 GBit/s

Software Requirements

  • Microsoft Windows Server 2012, or higher
  • Microsoft .Net Framework v4.5.2, or higher
  • Internet Information Services (IIS) v7, or higher
  • Microsoft SQL Server [Express] 2012, or higher, if XpressDox WinAuth Server or XpressDox Cloud Server (i.e. not XpressDox API Server) is being installed
  • Optional: Access to your Windows network, only if Windows Active Directory user authentication is required

1. Configure Windows Server

Using Server Manager, configure the roles and features of your Windows Server. In addition to the defaults ensure these values are set:

  • Server Role Web Server Role
  • Web Server (IIS) > Web Server > Security, enable Basic Authentication (WinAuth Only) or Windows Authentication (WinAuth Only)
  • Web Server (IIS) > Web Server > Performance, enable Static and Dynamic Content Compression
  • Features, .NET Framework 4.6 WCF Services -> HTTP Activation

2. Add or Configure Application Pool

Using IIS Manager, add or configure an application pool for your XpressDox Server processes. In particular ensure these values are set:

  • .NET CLR version, set to .NET CLR Version v4.0
  • Managed pipeline mode, set to Integrated
  • Identity, select Custom User Account and supply the details of an existing user, or create a new user if required. (If the templates will be stored on a different server to the software)

The selected or created user must have rights to access the XpressDox Shared Settings and XpressDox-configured Shared folders. (WinAuth Only)

3. Add or Configure Website Application

Using IIS Manager, add or configure a website application to host your XpressDox Server. In particular ensure these values are set:

  • IIS Authentication as required – Anonymous Authentication (All Server Versions) and Forms Authentication (Cloud Server Only) or Basic Authentication (WinAuth Server Only) or Windows Authentication(WinAuth Server Only)
  • Optional: Bindings, add https binding only if you require HTTPS access to your XpressDox Server and have an appropriate SSL certificate.

4. Install XpressDox Server Application Files

Run the installation file called [unzipped directory]\Setup-xpressdox-[winauth OR api]-[Vx.x.x].exe. Ensure these steps are taken:

  • Destination Directory, set to the physical path of your website application configured in IIS
  • When the application installation finishes, the Microsoft Office Access database engine installation launches automatically. Install the database engine. This is required by XpressDox Server to use Microsoft Excel files as data sources.

To install a licence key, create a text file [Installation_Directory]\License\XpressDoxServerLicense.lic and paste the provided key into this file.

5. Add or Configure Application Database

Required for XpressDox WinAuth Server OR XpressDox Cloud Server installations

Using your SQL Server database management tool:

  • Run the script found at [unzipped directory]\XpressDoxData.sql to configure your database

6. Configure XpressDox Server

Open HomeConfiguration\DocumentAssembly.config.xml and edit this setting: (WinAuth Only)

  • SharedSettingsConfigurationFolder, set to the path as configured in XpressDox Desktop Author for the Shared Settings Folder

Open Web.config and ensure your preferences are set for these values:

  • Set the ServerUrl property with your domain base url
  • XpressDoxApplicationDatabase, set to the connection string for your SQL Server application database
  • AdministratorEmail, set the email address of your System Administrator (WinAuth Only)
  • Email server settings, set your email server credentials if you require outbound email support
  • Replace all placeholders indicated by Square Brackets to match your desired configuration. A commented explanation text is included above each property.

7. Run XpressDox Server

Navigate to http[s]://[host name OR ip address]/xpressdox/protected/explorer.aspx to launch your XpressDox Server.

If you are using Windows Active Directory to authenticate users on your XpressDox Server, please note:

  • Users sign in to your XpressDox Server using their Windows domain network username and password
  • Your Windows network file and folder read/write permissions are used by your XpressDox Server to allow or deny a user access to files and folders

For further information on any errors, all detail is logged at [unzipped directory]\logs\XpressDoxApplicationLogging.log


Send support requests to XpressDox Support