Skip to main content

Microsoft Online Service - Deployment

Overview​

This guide walks through the process of deploying the Azure AD Service and Microsoft Online Service into an existing Atria deployment.

Applies to Atria Version​

15.18 onwards

Objective​

This article provides a guide to installing the Microsoft Online (MSOL) service into the Atria Platform.

Deploy Atria Components​

  1. Install Atria Service Schemas:
    • Azure AD Service. (this is the base service for tenant connection and subscription management)
    • Microsoft Online Service (this is the service definition for management of Microsoft Online)
  2. Install Microsoft Online Web Service (this is the core component that interacts with Microsoft)

All of the above components can be installed together on the primary provisioning server. Once installed, these will work for all Atria customers, regardless of whether they are in private or shared Active Directory infrastructure.

Process​

  1. Login to the server hosting the primary provisioning engine.

  2. Start an elevated PowerShell session

  3. Run the following commands to add the service schemas and install the required components:

    Import-AtriaServiceSchema -service azuread,msol

    Install-AtriaMsol

    Once the installation of your Service is completed successfully you can proceed to the next section.

Configure the Azure AD and Microsoft Online (MSOL) service​

Enabling the services​

To continue with the deployment of Azure AD and MSOL, they must be enabled at both top level and location level.

  1. Enable the services (top level):
    1. From the Atria menu bar, choose Configuration > System Manager > Service Deployment.
    2. Locate the AzureAD Service in the Service List, Expand and click Save to enable the service for use within the platform.
    3. Locate the Microsoft Online Service in the Service List, Expand User Plans, add/verify the information and then click Save.
    info

    The top level is where Customer Plans and User Plans can be created and edited.

  2. Enable the services (location level):
    1. Under Service Filter on the left, select Active Directory Location Services and choose a Location
    2. Locate the AzureAD service in the list, Expand and click save to enable the service within the selected location.
    3. Locate the Microsoft Online service in the list, Double-check user plans are enabled and then click Save.
    info

    The location level is where Customer Plans and User Plans are managed and deployed.

Add the MSOL Web Service Credentials​

  1. From the server where the AtriaMsol component was installed (provisioning server by default), using an elevated PowerShell window, query the MSOL credentials from IIS:
C:\Windows\system32\inetsrv\appcmd.exe list apppool /name:"$=Atria MsolWS AppPool" /text:* | findstr "name: userName: password: password"

  1. From the Atria menu bar, choose Configuration > System Manager > Credentials

  2. Select Add

    store the credentials for the service

  3. Input the login credentials retrieved for MSOL web service along with the Domain and click Save

Set Atria MSOL Server Role​

  1. From the Atria menu bar, choose Configuration > System Manager > Server Roles

  2. Expand the server where the MSOL web service was installed.

    select the server roles

  3. Check the "Atria MSOL" server connection component and then click Save

Create a Server Connection​

  1. From the Atria menu bar, choose Configuration > System Manager > Server Connection

  2. Choose New Connection and complete the fields to enable Atria to connect to the web-service.

    add the server connection

    Field nameValue
    Server RoleAtria MSOL
    ServerThis will be automatically selected, based on the server you have associated with the Atria MSOL role.
    CredentialsSelect the Atria MSOL web service credential created earlier
    ProtocolHTTP (default)
    Port8095 (default)
    Timeout200000 (default)

  3. After saving, test the connection by clicking on the Test icon - the icon should spin and then go green when the test has completed.

info

If test connection fails or if you encounter any errors, please review recorded errors and capture event viewer logs or contact support@getatria.com for further assistance.

Now that Service Deployment is complete, you may now proceed with the Connecting Atria to Microsoft Partner Center