Azure Client Stack Deployment

CAM Azure Stack utilizes Microsoft Azure services and resources to provide the ability to move documents and content and sync metadata between multiple Document Management Systems (DMS). CAM Content Mover and Data Sync (Content Sync) use Azure storage blobs as an intermediary place while moving content between the supported Document Management Systems.

To deploy the CAM Azure Stack, you need to deploy the Azure template into your Azure environment. The template deploys a complete solution that contains multiple resources such as function apps, MySQL instances, Blob Storages, and others. These resources are provided and hosted by Microsoft Azure in your Azure account to provide more control over moving content.

Azure & CAM Integration Notes

As of January 30, 2021, Azure is not allowing custom token expiry settings. The conditional access policies determine how the token expires are configured. This requires at least a P1 license in Azure. See the Microsoft link here.

 

CAM Azure Stack Architecture

  • Content Mover in CAM uses REST APIs to work with 7 functions, 4 queues, and two triggers to move content.

  • Data Sync (Content Sync) uses REST APIs to work with 3 functions, 1 queue, and one trigger to sync content.

Prerequisites to the CAM Azure Stack Deployment

Requirements

 

 

Deploying and Configuring the CAM Azure Stack

 

Create a Resource Group

  1. From the Azure services section, on the Azure portal home page, click on Resource groups to open the resource groups page.

2. Click Create from the Resource groups toolbar.

3. Enter the following resource group details on the Create a Resource group page:

Fields

Description

Fields

Description

Subscription

Select the appropriate Azure subscription from the dropdown list.  A P1 license and Azue Standard must be set as minimal.

Resource groups

Enter a unique name for your resource group in the Resource group field.

Note: Resource group names must have only alphanumeric characters, periods, underscores, hyphens, and parentheses and must not have a full stop (.) at the end.

Region

Select the region where you want to create your resource group from the Region drop-down list.

4. Click Review + Create to validate and create new resource groups.

5. Click Next: Tags > to navigate to the next screen. Please skip entering any tags as they aren’t required.

6. Click Review + Create to validate and create new Resource groups successfully. The Validation passed message is displayed if validation passes successfully.

7. Click Previous, to go back to the previous screen.

8. Click Next: Review + Create> to navigate to the next screen.

9. When validation passes successfully, click Create to add new Resource groups.

Deploying CAM Azure Stack to the Azure Subscription

  1. Using a browser, navigate to the CAM Azure Stack GitHub repository using the URL https://github.com/Prosperoware/cam-azure-deployment -

  2. Navigate to the repository home page and click on the Deploy to Azure button as the image shows in this section.

  3. The link redirects you to the MS Azure Portal and displays the CAM Azure Stack deployment form.

  4. Click Deploy to Azure. Log into the Azure user portal. The Custom Deployment screen is displayed.



5. Enter the following project details for your Azure deployment:

Fields

Description

Fields

Description

Project Details

Subscription

Selects the subscription from the dropdown list. Selects the same subscription used to create the resource group.

Resource groups

You can either select an existing resource group from the resource groups drop-down or create a new resource group.

Click here to see the process for creating a new resource group or click on the Create new link that you can find next to the resource group drop-down.

Tip: Litera recommends you to select the Create New link.

Instance Details (Template Parameters) - Includes the following parameters

Region

Displays the region automatically on your created Resource group selection.

Litera Tenant Id

Enter the Tenant id from the received mail.

Litera Encrypted Key

Enter Litera Encrypted Key from the received mail.

Litera Secret Key

Enter Litera Secret Key from the received mail.

Features

You can select one of the features while deploying the Azure Stack:

ETL: Deploys Azure Stack for only Content Mover. You can use this feature when you want to move content across DMS systems permanently.
Content Sync: Deploys Azure Stack for only Content Sync. You can use this feature when you want to move content to the Azure blob storage temporarily.
Both: Deploys both Content Mover and Content Sync operations or features with the Azure Stack.

Is Production

Selects the Boolean value from the dropdown list.

Environment Stage

Enter the environment stage name. In continuation with the above mentioned example:

The Environment Stage would be like: yourenvironment.prosperowaredev.com

Instance Unique Name

Enter an unique instance name. In continuation with above mentioned example:

The Instance Unique Name would be like: yourenvironment.prosperowaredev.com

 

Top Level Domain

Enter the Top Level Domain.

The Top Level Domain would be like: yourenvironment.prosperowaredev.com

Administrator Login

Enter a new username for Azure CAM Stack MySQL Database admin user.

Administrator Login Password

Provide a password for Azure CAM Stack MySQL Database admin user.

6. Click Review + Create - Validates and create the template if the validation passes as displayed in the following screen.

7. If the form is valid, then the message Validation passed will be displayed. Now, click the Create button to start the deployment process.

 

  1. Click Previous to navigate to the previous screen.

2. The deployment process takes a few minutes to complete. The resources are created one after the other.

 

Fields

Description

Fields

Description

Resource

Displays the name of the created resources.

Type

Displays the type of the resources.

Status

Displays the status of resource creation.

Operation details

You can view the details against created resources.

3. Once the deployment is completed successfully, you can see the following screen.

 

Options

Description

Options

Description

Delete

Click Delete to remove the deployment.

Cancel

Click Cancel to cancel the deployment.

Redeploy

Click Redeploy to redeploy the template, if the deployment isn’t successfully completed.

Refresh

Click Refresh to re-load all the resources.

Initialize CAM Azure Stack Configuration

  1. After the deployment is completed successfully, CAM Azure Stack needs to be initialized. The initialization URL is in the template deployment output.

2. Click Outputs, from the template deployment page left panel.

3. The following screen is displayed. Copy the initializeFunctionUrl and paste it into your Internet browser’s URL address bar.

 

4. The initialization function process URL will respond with the initialization status in JSON format. A successful response looks like the following:

5. Display the bucketname.

6. Display the apiEndPointBaseUrl.

Configure CAM Content Mover to Utilize your Azure Stack

  1. The below steps can be done for Content Mover or Data Sync (Content Sync).

2. Navigate to your CAM instance, click Administration > click Content Mover. The following screen appears:

3. Navigate to the Configuration tab, the following screen appears:

Fields

Description

Fields

Description

Choose Cloud Provider

Selects “Azure“ from the list.

Choose Storage

Displays automatically based on cloud provider value.

Choose Storage Type

Selects the Private Encrypted Storage as storage type.

Bucket Name

Enter the Bucket name.

API Endpoint Base Url

Enter the API Endpoint Base Url.

API Secret Key

Enter the API Secret key which is received in your email.

Validate

Click “Validate” to validate the form data. If the form data is correct, then the message “Validated successfully” will be displayed.

4. Click Save to save the configuration.

5. Click Cancel to close the configuration screen without saving any changes to the fields.

6. If using Data Sync, repeat the above steps but after clicking Administration- Data Sync

Storage Bucket Retention Rules and Deletions

Azure Pricing and Cost Calculator

CAM Azure Stack Security

 

SSL for the MySQL Database

To Setup SSL on the MYSQL database, set the following on the appconfig.yml in Content Mover:

  • useSSL = True

  • requireSSL = True

 

Creating a Personal Access Token:

  1. Log into Azure DevOps at the https://dev.azure.com/

  2. In the right-hand corner select User Settings and then Personal access tokens

 

 

  1. Create the PAT for the deployment - This token will be used only for the setup and the Expiration can be set for only 1 day.

a.       Select the New Token option.

b.       Select a Name for the token, and organization where you will deploy, and expiration. For the expiration select one day using the Custom Defined option.

 

c.       In the scope section select:

Agent Pools

Read & manage

Build

Read & execute

Code

Read & write

Connected Server

Connected Server

Deployment Groups

Read & manage

Environment

Read & manage

Project & Team

Read, write & manage

Release

Read, write, execute & manage

Secure Files

Read, create & manage

Service Connections

Read, query & manage

Variable Groups

Read, create & manage

 

Create PAT for push code (Service account)

a.       Select New Token”option.

b.       Select a Name for the token, organization where you will deploy, and expiration. For the expiration, select at least 12 months. This token will have to be rotated when it is close to the expiration date.

 

c.       In the scope section select:

Code

Read & write

 

 

Additional Info

https://pdocs.atlassian.net/wiki/spaces/CCAM/pages/25067592

| Configuring Data Sync

 

Let's Connect📌

☎ +1 630.598.1100
☎ ‪+44 20 3880 1550‬
📧 support@litera.com
💻 https://www.litera.com/support/

📝 Support is available:
4 am - 8 pm US Eastern
(9 am - 1 am GMT/BST
7 pm - 11 am AET) on normal business days (excluding holidays)

© 2024 Litera