Deployment Quick Start Guide

Thanks for choosing OrchestrateIT for Revenue Collection at your school. We use an automated deployment wizard to streamline the initial installation and patching process. This article walks you through the deployment process using this wizard. Intermediate technical knowledge is required to follow this guide and the intended audience is for your school’s ICT administrator (or equivalent).

Deploying a new instance

Please follow the steps below to set-up OrchestrateIT for Revenue Collection at your school using the deployment wizard:

  1. Install SQL Server 2012 (or newer) on a server, if you do not already have a suitable SQL Server ready to use. This can be on the same server as the web application or a different server (i.e. a dedicated database server). Ensure you enable ‘SQL-based authentication’ and use a default instance.
  2. Download the latest version of the Deployment Wizard from the Download Portal using the credentials shared with you.
  3. Run the Deployment Wizard (as an administrator) on an application server. Refer to this article for system requirements.
  4. If prompted, enter your HTTP proxy server credentials. These credentials are used to download dependencies that are required for the installation process and they are not stored or used for any other purpose. The Deployment Wizard will automatically launch once the prerequisite packages have finished downloading.
  5. After reviewing and accepting the license agreement, select your preferred installation method. The recommended option is ‘Full Installation’, which allows you to deploy the application and database at the same time. Note: This does not mean that the database needs to be installed on the same server. 
  6. Enter the license credentials on your invoice, ensuring the details you enter are an exact match. Both fields are case sensitive. If the server is located behind a proxy server, select the ‘validate license via a Proxy Server’ option and enter proxy server credentials. These credentials are only used for license validation purposes.
  7. Enter your database server details and the credentials that the application should use for connecting to the application.
  8. Enter the credentials for an OrchestrateIT ‘System Administrator’ user account. You can add other user accounts (including multiple System Administrators) after the installation process. If you are part of a Queensland Department of Education school, you can also opt to install a default configuration library which streamlines your initial setup process for data import profiles and message templates (recommended).
  9. Click ‘INSTALL’ to start the installation process. Depending on your environment, this process can take up to 20 minutes.

 

Common Issue 1: I see a server error page with an ‘access denied’ message when I navigate to the OrchestrateIT web URL from within the application server
Depending on local server security policies, you may need to manually assign security permissions to the following directories for the ‘IIS AppPool\OrchestrateIT’ application pool identity.

  • C:\Program Files (x86)\OrchestrateIT\OrchestrateIT for Revenue Collection\App (Read, Execute, Write)
  • C:\Program Files (x86)\dotnet (Read, Execute)
  • C:\Program Files\dotnet (Read, Execute)

 

Common Issue 2: I see a “HTTP Error 502.5 – Process Failure” message when I navigate to the OrchestrateIT web URL from within the application server
On some occasions, it is necessary to repair the Dotnet Core Hosting Bundle after the deployment wizard has completed. You can do this through ‘Programs and Features’. This has been observed in scenarios where the ‘Web Server (IIS)’ role (and associated features) were not enabled on the server prior to running the Deployment Wizard. The Deployment Wizard will enable these features automatically however this happens after the Dotnet Core Hosting Bundle is installed which means that a required IIS module is not installed properly for some schools.

 

Patching an existing instance

Please follow the steps below to update an existing installation of OrchestrateIT for Revenue Collection:

  1. Download the latest version of the Deployment Wizard from the Download Portal using the credentials shared with you.
  2. Run the Deployment Wizard (as an administrator) on an application server. Refer to this article for system requirements.
  3. If prompted, enter your HTTP proxy server credentials. These credentials are used to download dependencies that are required for the installation process and they are not stored or used for any other purpose. The Deployment Wizard will automatically launch once the prerequisite packages have finished downloading.
  4. After reviewing and accepting the license agreement, click ‘Update an existing instance’ to commence the upgrade process. This process can take up to 15 minutes depending on your environment.
  5. Navigate to the OrchestrateIT for Revenue Collection web URL and confirm that the application launches successfully.

It is important that you notify the OrchestrateIT team Ii any issues are encountered during the upgrade process.

Common Issue 1: The version number on the sign-in page does not change or I am experiencing unexpected issues using OrchestrateIT
Some of the changes we make can conflict with local cache that is automatically stored on your workstation by your web browser. Try pressing Ctrl-F5 on the OrchestrateIT log-on page to force refresh the latest version of OrchestrateIT from your school servers.