Atria Platform v15+ Update Guide

Atria Platform v15+ Update Guide


This article outlines the upgrade process for the Atria Platform.

Applies To

  1. Atria 12.6+ 
  2. Atria 12.11+
  3. Atria 12.14+
If environment is still on CPSM, kindly coordinate this with Atria Support

System Requirements

In order to install Atria v15 you MUST complete the prerequisite components noted in the following article: Atria v15 System Requirements

Atria v15+ Upgrade Check List

Here is a check list summary to ensure the environment is ready for install:

Item Description
Atria version is listed on the supported versions
This applies to all Atria components as per latest release
Install Erlang and RabbitMQ
Messaging can have its own server. In this article Provisioning server is used as messaging server. For more information please refer to System Requirements
Configure RabbitMQ and add messaging DNS entry
Please refer to System Requirements for a step by step configuration.
Atria network ports are open and accessible
To get more information please refer to System Requirements

Atria Upgrade Summary at a glance

The following table summarises the steps in the install process
Item Description
Upgrade Check list

Connect to the Atria-Beta Release Repository Feed
15.0 packages are on an Atria-Beta release repository feed
Upgrade Components
- Refer to Config Service in v15 to get more information about Config Service Component

- Conversion and Update from the old ConfigService to the new one is to be done (An extra command than usual)

- Atria Agent Component is responsible to do the updates required services to communicate between environments
Import the Atria Service Schemas
Atria Service Schema update

Remote Environment Configuration
Remote Environment Configuration and Update of Remote Components
Web Services
Updating each Atria Web Services
Update Completed
Summary of the Atria Platform v15+ Update

Connect to the Atria-Beta Release Repository Feed

Currently, the 15.0 packages are on an Atria-Beta release repository feed. Please contact Atria Support for an access token for this feed.
  1. Connect-AtriaFeed -UserName '<any username>' -PersonalAccessToken '<access token provided by Atria Support>' -FeedUrl ''

Update Guide

Once done with the above steps, you can run the following commands in PowerShell to start upgrading Atria components.

Update the Atria.Tools Module

12.6 details will be added on it is available
If Atria is on 12.11.x to 12.13.13, the AtriaTools module should be updated once (this will upgrade directly from 12.11.x to 15.x)
If Atria is on 12.13.14, the AtriaTools module should be updated twice due to some changes on the modules (this will upgrade from 12.13.14 > 12.13.16 > 15.x.x)
If Atria is on 12.14, the AtriaTools module should be updated once (12.14.x to 15.x)
  1. Update-AtriaToolsModule
Restart PowerShell Session after the update
This will update the Atria modules: Atria.Tools and Atria.Platform

Repeat these steps to each server that where Atria Components were installed.

Convert and Update the ConfigService Component (Provisioning Server) 

The Below applies only to upgraded from a version prior to V15. If you have already upgraded to 15.x, please continue to the next step.

Below example uses -UseSQLStore parameter, to get detailed information about Config Service please refer to:

By default, if using -UseSQLStore - the AtriaConfigService database will use the current Atria DB ConnectionStrings and will create where OLM and OLMReports are deployment (default is on AtriaSQL DB server)

Storage Type-UseSQLStore / -UseFileSystemStore  / -UseKeyVaultStore
MessagingUrl : RabbitMQ Messaging Alias
MessagingUsername : RabbitMQ Admin Account Username
Messaging Password RabbitMQ Admin Account Password
  1. All Values must be in single quotes 
  2. Please remove the '<>' from each value once inputted, so it will just be a UserName or Password.
  3. For the Messaging URL, Please input the FQDN (Fully Qualified Domain Name) instead of "Atria Messaging", but with AMQPS infront of the FQDN. 
    for example, a completed parameter will be -MessagingURL 'amqps://'
    1. A good test is to confirm that the FQDN is able to be pinged to confirm it's responding and able to be talked to by the provisioning server.
Messaging Username is case sensitive - This means that if your Username contains uppercase values, this additionally needs to be present between the single quotes.
  1. ConvertTo-Atria15PlusConfigService -UseSqlStore -MessagingUrl '<amqps://atriamessaging>' -MessagingUsername '<rabbitmq account name>' -MessagingPassword '<rabbitmq account password>'

Update the Config Service (Provisioning Server) 

This step only applies to Atria environments already running 15.x. If you have just completed the previous step (Convert Config service) please skip this step.
  1. Update-AtriaConfigService

Update the Database Component (Provisioning Server)

Update of the Database Component can be executed from the Provisioning Server.
OLM and OLMReports will be backup during update process. If OLM and OLMReports Database were backup prior to this step, then -SkipDBBackup parameter can be added on the command below.
  1. Update-AtriaDatabase
If the below error is encountered, just hit 'Continue (c)'

After it completes, re-run the Update-AtriaDatabase and it should be completing it without any errors

Install or Update the Agent Component (Provisioning Server)

Validate if Agent component has been installed before. Do a Get-Service AtriaAgent
If it the service is not present, run the install
  1. Install-AtriaAgent
If the service is present, run the update
  1. Update-AtriaAgent

Update the PlatformAPI Component (Provisioning Server)

  1. Update-AtriaPlatformApi

Update the Provisioning and ProvisioningManager Component (Provisioning Server)

  1. Update-AtriaProvisioning
  2. Update-AtriaProvisioningManager

Update the Directory Component (Provisioning Server)

  1. Update-AtriaDirectory

Update the WebComponents (Front-End Web Server)

This will update the 4 Web Components (WebForms, Atria, AtriaProxy, ExternalApi)
  1. Update-AtriaWebComponents

Import the Atria Service Schemas (Provisioning Server)

  1. Import-AtriaServiceSchema -Installed

Remote Environment Configuration

Remote environments feature in Atria v15 enables customers to be managed in both shared and private Active Directory networks.  This article gives you more information on different environment types and associated features:  Remote Environment Configuration.

After the Remote Environment Configuration has been completed, we can now update your existing Private or Shared environment with the following steps:
1. Update the AtriaToolsModule to 15.x using the command Update-AtriaToolsModule (Restart powershell afterwards)
2. In Atria, Navigate to Configuration > Environment
3. Click on the Environment Name to be upgraded
4. Scroll down to the Tokens and click on Add Token
5. Copy the script from the Token generated, run this script on the Private/Shared environment using PowerShell (Admin mode)

The script from the token should do all the components for a private or shared environment

Web Services

For each Atria Web Service (i.e. Exchange, MSOL, HostedAppsAndDesktops), update each web service with the following steps:
1. Make sure to apply the Atria Root CA on each of the server where the Atria Web Service using the article - Extracting and using the Atria Root CA
2. Update the AtriaToolsModule to 15.x using the command Update-AtriaToolsModule (Restart powershell afterwards)
3. Run the update for the Atria Web Service 

To find out if any of these have been updated, run the command "Get-AtriaComponent -ListOutOfDate". This will show the current web services and other packages that are out of date.

Below is the list of web services and their relevant commands to upgrade.
Atria Web Service
PowerShell Command
Microsoft ADFS

    • Related Articles

    • Atria API User Guide (CortexAPI)

      Overview The application programming interface (API) is a powerful interface that allows you to interact directly with Atria without using the ATRIA Web User Interface (UI).  The API grants a user, with some development knowledge, the ability to ...
    • Atria v12.11+ System Requirements

      Overview  The following article provides the prerequisites necessary for the deployment of Atria v12.11+ into your environment.  System Requirements   Environment  Core servers for the platform should be domain joined. Before you can deploy Atria ...
    • Atria Billing Setup User Guide

      Objective This article describes how to configure Atria to utilize the latest billing features. This document outlines the billing setup attributes that should be configured.    Applies to Introduced in Atria version 12.0.0 Billing Setup Overview To ...
    • Atria v12.11+ Deployment Guide

      Overview  This article outlines the deployment procedure of Atria v12.11+.  This article will also refer to other articles that may assist with your installation or upgrade. Alert:  In-place migration from any version of CloudPortal Services Manager ...
    • Billing Rules Engine User Guide

      Objective This article describes how to use the Atria billing rules engine to identify specific Atria entities as non-billable.   Applies to Introduced in Atria version 12.0.0 Billing Rule Feature Overview Many entities - customers, services, users, ...