Ravnur Media Services – Azure

Marketplace Deployment Instructions

Ravnur Media Services (RMS) is a managed application available in the Azure Marketplace. Deploying
RMS to your Azure tenant is a straightforward process that takes approximately one hour from start to
finish. These instructions describe the process of deploying a Private Plan. Ravnur will create the private
plan for you after you give Ravnur the subscription ID of the Azure subscription where you want to
deploy RMS. After the deployment is complete, you can retrieve the API access credentials from the
application and begin testing the RMS API.

BEFORE YOU BEGIN: Your subscription must have the following resource providers registered for the
deployment to succeed: Microsoft.KeyVault, Microsoft.OperationalInsights, Microsoft.Web,
Microsoft. App, Microsoft.SQL, Microsoft.Container.Service, Microsoft.EventGrid

Encoding uses D8pds_v5 VMs (F8s_v2 VMs for Azure GOV) that have eight cores per VM. You need
to have at least 40 cores in your quota for this type of VM (Standard DPDSv5 Family vCPUs for Azure
Commercial and Standard FSv2 Family vCPUs for Azure Government) for the deployment to succeed.
You can check the quota and increase it in the Azure Portal. In the main search bar, enter Quota and
go from there.

Contents
STEP 1 – CREATE RESOURCE GROUP ............................................................................................................... 2
STEP 2 – ACCESS AZURE M ARKETPLACE FROM RESOURCE G ROUP ..................................................................... 3
STEP 3 – S ELECT THE R AVNUR M EDIA SERVICES P LAN ...................................................................................... 4
STEP 4 – BEGIN THE DEPLOYMENT .................................................................................................................. 5
STEP 5 – ACCEPT THE TERMS AND CONDITIONS ............................................................................................... 6
STEP 6 - DEPLOY THE A PPLICATION ................................................................................................................. 7
STEP 7 – GO TO THE DEPLOYED MANAGED APPLICATION ................................................................................. 7
STEP 8 – ACCESS THE CONSOLE TO GET THE API C REDENTIALS .......................................................................... 8
STEP 9 – COPY THE CONSOLE URL .................................................................................................................. 9
STEP 10 – A UTHENTICATE TO ACCESS THE C ONSOLE ......................................................................................... 9
STEP 11 – ACCEPT REQUIRED PERMISSIONS .................................................................................................. 10
STEP 12 – COPY THE API C REDENTIALS ......................................................................................................... 11

Ravnur, Inc. | www.ravnur.com | 3422 Old Capitol Trail, PMB#2091, Wilmington, DE 19808, USA | Phone +1 239-943-4404
STEP 1 – CREATE RESOURCE GROUP
First, you need to create a resource group in the subscription where you will deploy the managed
application package. This resource group should be in the same region where you want to run the RMS
application.

Ravnur, Inc. | www.ravnur.com | 3422 Old Capitol Trail, PMB#2091, Wilmington, DE 19808, USA | Phone +1 239-943-4404
STEP 2 – ACCESS AZURE MARKETPLACE FROM RESOURCE GROUP
Go to the newly created resource group and click on + Create as indicated on the image below.

This will open the Azure Marketplace. You should see an indication that you have a Private Plan available
for you, and you can access it by clicking on the View private plans link or by clicking on Private Plans
under My Marketplace in the left sidebar menu.

Ravnur, Inc. | www.ravnur.com | 3422 Old Capitol Trail, PMB#2091, Wilmington, DE 19808, USA | Phone +1 239-943-4404
STEP 3 – SELECT THE RAVNUR MEDIA SERVICES PLAN
After clicking on Private Plans, you should see a tile with the Ravnur Media Services – AMS Replacement
title. Click on this tile.

Clicking on the tile for Ravnur Media Services opens the private plan page. Click on Create to begin the
deployment.

Ravnur, Inc. | www.ravnur.com | 3422 Old Capitol Trail, PMB#2091, Wilmington, DE 19808, USA | Phone +1 239-943-4404
STEP 4 – BEGIN THE DEPLOYMENT
Review the values that are loaded when the page appears.

1. Verify that the selected region is the region where you want the service to run. It should be the
same region as the resource group.
2. OPTIONAL: Select all zones for the system and workload pools availability zones. If your region
doesn’t support availability zones, don’t worry, the application will still function.
3. Enter a name for the application, such as mycompanymediaservices. The managed resource
group name is automatically created for you, no need to change that.

Click on Review + create.

Ravnur, Inc. | www.ravnur.com | 3422 Old Capitol Trail, PMB#2091, Wilmington, DE 19808, USA | Phone +1 239-943-4404
STEP 5 – ACCEPT THE TERMS AND CONDITIONS
Select the checkbox to accept the terms and conditions for the offer. The Terms and Conditions and
Privacy Policy can be accessed on this page by clicking on the Terms of use and Privacy policy links
enclosed in the red box in the image below.

Click on Create to start the deployment.

Ravnur, Inc. | www.ravnur.com | 3422 Old Capitol Trail, PMB#2091, Wilmington, DE 19808, USA | Phone +1 239-943-4404
STEP 6 - DEPLOY THE APPLICATION
After clicking on Create, the deployment will begin. This process can take up to 45 minutes.

STEP 7 – GO TO THE DEPLOYED MANAGED APPLICATION

When the deployment is complete, click on Go to resource.

Ravnur, Inc. | www.ravnur.com | 3422 Old Capitol Trail, PMB#2091, Wilmington, DE 19808, USA | Phone +1 239-943-4404
STEP 8 – ACCESS THE CONSOLE TO GET THE API CREDENTIALS
ATTENTION! If you are deploying RMS in an Azure Government tenant, please go to step
13. Azure Government works a bit differently (not in a good way).

Azure Government Deployments – Go to Step 13 to get the API credentials

You’ll land on the managed application page after clicking on the Go to resource button from the
previous step. This page displays the instructions for getting the API credentials from the console
application.

In the left sidebar menu, go to Settings > Parameters and Outputs.

Ravnur, Inc. | www.ravnur.com | 3422 Old Capitol Trail, PMB#2091, Wilmington, DE 19808, USA | Phone +1 239-943-4404
STEP 9 – COPY THE CONSOLE URL
In the main panel copy the value for consoleURL and paste this in another browser tab.

STEP 10 – AUTHENTICATE TO ACCESS THE CONSOLE

You’ll be asked to authenticate. The user should be a member of the tenant where the application has
been deployed.

Ravnur, Inc. | www.ravnur.com | 3422 Old Capitol Trail, PMB#2091, Wilmington, DE 19808, USA | Phone +1 239-943-4404
STEP 11 – ACCEPT REQUIRED PERMISSIONS
The console application requires the user to consent to the displayed permissions.

Ravnur, Inc. | www.ravnur.com | 3422 Old Capitol Trail, PMB#2091, Wilmington, DE 19808, USA | Phone +1 239-943-4404
STEP 12 – COPY THE API CREDENTIALS
The console application is still under development; however, it functions adequately for the purpose of
generating and copying the API credentials. Ignore the Generate token button. You’ll get the token from
the API using the API key. Click on Show to display the API key.

To use the API, you’ll need some information from the console:

1. Subscription ID where RMS is deployed. This is displayed in the console under Subscription ID.
2. RMS resource group name. This is displayed in the console under Resource Group ID. Please
note, this resource group is the managed resource group that holds all the Azure resources, not
the resource group you created in step 1.
3. RMS account name. This is displayed in the console under Name. This is always “default” (until
we make it configurable).
4. RMS instance endpoint. This is the URL of the console app without the path. In Step 9 you
copied this URL. For example, the console app could be
https://rms.jsww38jpbp7x2.ravnur.net/console so in this case the RMS instance endpoint would
be https://rms.jswx52jpbr7x2.ravnur.net.
5. RMS instance API key. This is copied from the console above.

STEP 13 – GET THE API CREDENTIALS FOR AZURE GOVERNMENT

DEPLOYMENTS
1. Go to Azure Front Door in the managed resource group that was created by the deployment and
click on it to access the details
a. In the sidebar menu click on Front Door Manager
b. In the panel that opens copy the URL above Routes as shown in the image below
c. Add “/console” to the end of the URL. This will take you to the console shown in the
documentation where you can get the credentials. For example: fd-ehkayzowfifpq-
bwbda3cyg7cpckdf.z01.azurefd.us/console
2. If you’re using the test application from our GitHub page (https://github.com/Ravnur-Inc/ams-
api-replacement-demo-app/tree/main) make sure you have the latest version because you’ll
need it to pass transforms to RMS.

Ravnur, Inc. | www.ravnur.com | 3422 Old Capitol Trail, PMB#2091, Wilmington, DE 19808, USA | Phone +1 239-943-4404
Ravnur, Inc. | www.ravnur.com | 3422 Old Capitol Trail, PMB#2091, Wilmington, DE 19808, USA | Phone +1 239-943-4404