Azure
Last updated
Was this helpful?
Last updated
Was this helpful?
This document will guide you through how to set up the Azure infrastructure and deploy the XMPro Platform.
The following deployment diagram shows an example architecture and the necessary resources for the XMPro platform in Microsoft Azure.
In order to proceed with the deployment, you are required to complete the steps in the 1. Preparation guide:
As well as having:
Azure portal administrative access
Access to Subscription and Resource group
This section provides information about installing the XMPro platform from scratch in Azure.
In the search bar type “Deploy” and select “Deploy a custom template”
3. Click "Build your own template in the editor"
4. Download the file from the link provided below:
5. Select "Load File" and then Open the downloaded "mainTemplate_[Version].json"
6. Once loaded, click Save - do not change the template.
7. Complete the form.
Enter the username in the correct format i.e. firstname.lastname@companyname.onxmpro.com
The following special characters are not supported in the passwords: ` ' \ $ @
Take note of the passwords used as this will not be displayed again and they are required later.
8. Verify the information is correct and click Create.
After successful deployment, the following items have been installed:
Subscription Manager
Data Stream Designer
App Designer
Stream Host
This step explains how to restart your app services in the Azure Portal.
Type “Resource groups” in the search bar and select “Resource groups”.
2. Search for the Resource Group created during installation and select it.
3. Select Subscription Manager, Data Stream Designer, and App Designer and restart the applications.
4. The below GIF shows how to restart your app service.
admin@xmpro.onxmpro.com
Super Admin
as entered during setup
firstname.lastname@companyname.onxmpro.com
Admin
as entered during setup
A new company is created as part of the installation process but needs a valid license to work.
This sends a request to XMPro for an App Designer license for this Company.
The Generate a license request link will only work if SMTP was set up during installation.
9. Change the Product to Data Stream Designer from the list and request another license
When you have received a license for each product through an email sent to the email address given during installation, follow the steps below to upload the license for both App Designer and Data Stream Designer.
The installation of the XMPro Platform is now complete but before you can use the platform, some steps are needed to set up the environment. Further instructions about the configuration can be found below:
Download and use the latest "mainTemplate_[Version].json".
Use the same Resource Group and credentials used during the original Install when completing the Custom deployment form.
This section provides information about uninstalling the XMPro platform from Azure.
Open the resource group where XMPro is installed
Click Delete resource group
3. Enter the name of the resource group and click Delete
Set up of Cloud Stream Host, Master Data, , or is optional and is dependent on client requirements. As a result, these resources will be excluded from this deployment.
Select Azure resources that meet the and .
Follow the for an (Recommended).
Log on to the Azure Portal (with Company Administrator access)
Proceed to after they are all deployed.
1. Click Company in the left menu to open the Companies page. 2. Click on the Company. 3. Click on the Subscriptions gauge to open the Subscriptions page. 4. Click on a Subscription. 5. Click the Update License button in the command bar. 6. Click Generate a license request, enter the number of days, and submit. 7. When you have received the license from , upload it. 8. Click Save.
Licenses are given on an individual basis by the .
Before beginning the upgrade, back up databases using guide.
Follow the same steps as a new to upgrade your XMPro platform**.** Make sure to: