Introduction

To install Manuscript On Premises, you have two options:

  1. Our Professional Services team can install it for you.
    1. Our On Site technician will require temporary remote access to your environment and access to the Manuscript On Premises ISO. Our preferred remote assistance software is GoToMeeting. On the day of your scheduled installation, we’ll make available a GoToMeeting session to connect to your environment. If you have a different remote assistance software you’d like us to use, please let us know ahead of time.
  2. You may install it yourself following the On Premises Installation instructions.

Before your scheduled installation, please complete the Manuscript On Premises Pre-Installation Checklist. The pre-installation checklist helps ensure your environment satisfies prerequisites for installing Manuscript On Premises.

Download details for the Manuscript On Premises ISO will be provided when scheduling your installation. The Manuscript On Premises ISO can be burned to physical media or mounted on your web server where you’ll be installing Manuscript On Premises. Windows Server 2012 R2 includes the ability to mount ISO images.

System Requirements

Please see On Premises System Requirements.

Configuration

To configure your installation, our technician will execute a PowerShell installation script from the Manuscript On Premises ISO. This script accepts a number of parameters, which our technician will work with a technical contact on your end to configure:

  • Installation Directory: The location on disk where Manuscript On Premises will be installed.
  • Service Username: The username for the user under which your Manuscript On Premises application pools will run. This user needs to be a Local Administrator.
  • Service Password: The password for the user under which your Manuscript On Premises application pools will run.
  • SQL Server Instance: The SQL Server instance where your Manuscript On Premises databases will be hosted.
  • SQL Server Username: (Optional) If using SQL authentication, the username for the SQL authentication account which will be used to create and access your Manuscript On Premises databases.
  • SQL Server Password: (Optional) If using SQL authentication, the password for the SQL authentication account which will be used to create and access your Manuscript On Premises databases.
  • Fully Qualified Domain Name (FQDN): The FQDN where you plan to access Manuscript (e.g. manuscript.yourdomain.com).
  • Administrator Email: The email address for the initial site administrator account created during your Manuscript On Premises installation.
  • SMTP Server: (Optional) The host for the SMTP server Manuscript will use to send email.
  • SMTP Port: (Optional) The port over which Manuscript will connect to your SMTP server.
  • SMTP User: (Optional) The SMTP user Manuscript will use to access your SMTP server.
  • SMTP Password: (Optional) The password for the SMTP user.
  • SMTP SSL: (Optional) Whether or not Manuscript should use SSL when connecting to your SMTP server.

Your Manuscript On Premises Fully Qualified Domain Name (FQDN)

Your Manuscript On Premises FQDN consists of a Site Identifier and a Host in the form of:

http://{site identifier}.{host}

This FQDN must be configured on your DNS server to resolve to your Manuscript On Premises web server. Example FQDNs that fit this pattern are:

  • manuscript.yourdomain.com
  • manuscript.yourserver

Additionally:

  • localhost:80 must be bound to your Manuscript On Premises web site in IIS on your Manuscript On Premises web server.

Installing Manuscript On Premises

Once configured, our technician will work with you to run the Manuscript On Premises installation script from a PowerShell prompt Run as Administrator. The Windows account executing the script needs to be a Local Administrator. If using Windows authentication to connect to your Manuscript On Premises databases, a SQL user for the Windows account executing the script must be created in advance and must be granted the dbcreator* role on your target SQL Server instance. If using SQL authentication to connect to your Manuscript On Premises databases, the SQL authentication user must be created in advance and must be granted the dbcreator* role.

* While the dbcreator role is required during your Manuscript On Premises installation, permission for the account used by Manuscript On Premises to access your SQL Server instance can be reduced once the installation is complete. Post-installation, Manuscript On Premises requires db_owner on your Manuscript On Premises databases.

Installation Script Tasks

The Manuscript On Premises installation script will perform a number of tasks to provision your Manuscript On Premises web server and install Manuscript On Premises and its databases. The following is an overview of these tasks:

  • Installs 7-Zip
  • Enables the IIS-ASPNET feature if not already enabled
  • Enables the IIS-ASPNET45 feature if not already enabled (Windows Server 2012 / R2 only)
  • Enables the IIS-ASP feature if not already enabled (Windows Server 2012 / R2 only)
  • Enables the IIS-HttpCompressionDynamic feature if not already enabled (Windows Server 2012 / R2 only)
  • Enables the IIS-StaticContent feature if not already enabled
  • Installs SQL Server tools to provide the Invoke-SqlCmd Powershell cmdlet if not already available
  • Temporarily disables IE Enhanced Security Configuration (this is re-enabled as part of the installation process)
  • Installs the ASP.NET MVC 3 framework
  • Ensures .NET 4.0 is available
  • Installs Puppet to Program Files (x86)Puppet Labs
  • Installs the Java JDK 7.80 to Program FilesJavajdk1.7.0_80
  • Installs Redis Server for Windows to Program FilesRedis
  • Installs Manuscript On Premises to the configured installation directory (default: C:FBOnsite)
  • Creates 3 databases on the configured SQL Server instance:
    • fbhosted
    • FBODExportQueue
    • trial1
  • Disables the Default Web Site in IIS, if it exists
  • Creates and starts 2 IIS websites:
    • FB GEN ALL
    • FB GEN {version number}
  • Creates and starts 3 Windows services:
    • FogBugz ElasticSearch
    • FogBugz Heartbeat Pinger
    • FogBugz Queuing Service

Maintenance and Backups

We are happy to work with you to review the recovery model configured for your Manuscript On Premises databases and to provide general recommendations for configuring maintenance and backup plans. Developing a disaster recovery plan and configuring maintenance and backup plans are beyond the scope of a standard On Premises installation. If you don’t have a DBA on staff or would otherwise like us to assist you in developing a disaster recovery plan and configuring maintenance and backup plans for your Manuscript On Premises data, please contact your account executive to discuss our professional services offerings.