2. Server Installation

This chapter walks through installing the TOA server on a Linux host. The server is a single Spring Boot fat jar shipped together with a sample configuration file; installation is a matter of unpacking the release zip, adjusting config/toa-server.yml for the target environment, and running the jar as a service.

The chapter assumes a customer-managed Linux host and a reverse proxy in front of the server that terminates TLS and forwards both the Outlook add-in task pane and the /api/ calls to this server on the same origin (see Hosting the task pane). Windows Server deployments are technically supported via the same jar but are not covered in detail here; they will be added in a later revision of the documentation.

Publishing the Outlook add-in to end users is covered separately in Publishing the Add-in.

• 2.1. Prerequisites
  • 2.1.1. Operating system
  • 2.1.2. Java runtime
  • 2.1.3. Disk space
  • 2.1.4. Network
  • 2.1.5. Service account
  • 2.1.6. Artifactory access
• 2.2. Installing TOA server
  • 2.2.1. Obtaining the release
  • 2.2.2. Unpacking
  • 2.2.3. Service account and data root
  • 2.2.4. Configuration
  • 2.2.5. systemd unit
  • 2.2.6. Reverse proxy
  • 2.2.7. Windows Server deployments
• 2.3. Verifying the install
  • 2.3.1. Service state
  • 2.3.2. Smoke test - listing domains
  • 2.3.3. Smoke test - through the reverse proxy
  • 2.3.4. Data root
• 2.4. Upgrading an existing installation
  • 2.4.1. Release notes