Merge pull request mendix#9139 from mendix/kk-azure-sme

Kk azure sme

Author: katarzyna-koltun-mx

content/en/docs/deployment/_index.md

@@ -82,6 +82,12 @@ The Docker buildpack is available at [Mendix Docker Buildpack](https://github.co
 
 Deploying to Azure is possible from the [Azure Marketplace](https://azuremarketplace.microsoft.com/en-us/marketplace/apps/mendix.mendix-pro).
 
+### Mendix on Azure
+
+Mendix on Azure is a deployment option that makes use of some of the features of Mendix for Private Cloud in an opinionated way. For more information, see [Mendix on Azure](/developerportal/deploy/mendix-on-azure/).
+
+{{% alert color="info" %}} This feature is currently available to participating customers. For more information, contact your Customer Success Manager. {{% /alert %}}
+
 ## On-Premises
 
 To learn how to deploy your Mendix application on premises, see [How to Deploy Mendix on Microsoft Windows](/developerportal/deploy/deploy-mendix-on-microsoft-windows/) and [Unix-Like Deployment](/developerportal/deploy/unix-like/).

content/en/docs/deployment/mx-azure/mx-azure-installation.md

@@ -17,6 +17,10 @@ Before starting the installation and implementation process, make sure that you
 
 * Obtain and configure a Microsoft Azure account. For more information, refer to the the Microsoft Azure documentation.
 * Purchase the Mendix on Azure offering in the [Azure Marketplace](https://azuremarketplace.microsoft.com/).
+* Enable co-access permissions for the offering.
+
+{{< figure src="/attachments/deployment/mx-azure/coadmin-permission.png" class="no-border" >}}
+
 * Familiarize yourself with the [Private Cloud](https://docs.mendix.com/developerportal/deploy/private-cloud/) concepts.
 * Ensure that your Mendix Studio Pro is in version 10.10 or newer.
 * As an optional best practice, add multiple cluster manager to your clusters.
@@ -26,9 +30,9 @@ Before starting the installation and implementation process, make sure that you
 To create a cluster for your Mendix on Azure app, perform the following steps:
 
 1. In the Mendix Portal, in Private Cloud Cluster Manager, click **Mendix on Azure**.
-2. Connect to your Azure account by clicking **Connect and Initialize**, and then logging in with the same account that you used to purchase the Mendix on Azure offering.
+2. Connect to your Azure account by clicking **Connect Azure Account**, and then logging in with the same account that you used to purchase the Mendix on Azure offering. If required, you can also purchase an Azure offering after you log in.
 
-    After you successfully connect the accounts, the Mendix Portal shows a list of available clusters (that is, any Azure clusters that you have already linked with Mendix) and initializable clusters (that is, any clusters that you have not yet linked with Mendix). For initialized clusters, means that the all the required resources are provisioned on the cluster. For uninitialized clusters, no resources are provisioned yet.
+    After you successfully connect the accounts, the Mendix Portal shows a list of available clusters (that is, any Azure clusters that you have already linked with Mendix), initializable clusters (that is, any clusters that you have not yet linked with Mendix), and clusters that failed to initialize for any reason. For initialized clusters, means that the all the required resources are provisioned on the cluster. For uninitialized clusters, no resources are provisioned yet.
 
     {{< figure src="/attachments/deployment/mx-azure/available-clusters.png" class="no-border" >}}
 
@@ -46,21 +50,35 @@ To create a cluster for your Mendix on Azure app, perform the following steps:
 
     The managed app that you created is now visible as a new initializable cluster.
 
-    {{< figure src="/attachments/deployment/mx-azure/initializable-clusters.png" class="no-border" >}}   
+    {{< figure src="/attachments/deployment/mx-azure/initializable-clusters.png" class="no-border" >}}
 
-7. Click **Initialize**. 
+7. In the **Actions** column, click the icon, and then select **Initialize**. 
 
     The preflight check launches to verify that the required resources can be registered in the cluster. Mendix apps are hosted with virtual images, so the preflight check determines whether the cluster contains the required type of virtual image. To view a list of the required resource providers, hover your cursor over the **Information** icon. If required, you can register any missing providers in the **Resource providers** section of the Microsoft Azure portal.
 
+    {{< figure src="/attachments/deployment/mx-azure/preflight-check.png" class="no-border" >}}
+
 8. After the preflight check completes, click **Next**.
 
-9. Select the **AKS Service Tier**.
+9. In the **Provision** screen, review the information in the **Advanced Settings** section, and adjust any settings as needed. Note that selecting higher service tiers will incur higher costs. The **Postgress Compute SKU** and **Postgress Storage Performance Tier for IOPS** cannot currently be adjusted.
+
+    {{% alert color="info" %}}If you plan to use [virtual network peering](#network-peering), you must set the **Load Balancer Type** to **Private (Internal)**.{{% /alert %}}
+
+10. In the **Review & Initialize** screen, review the information and click **Initialize**.
+
+    The initialization process takes approximately 15 minutes. It creates a resource group in the managed app that you created in step 3 above. Once the cluster is initialized successfully, a corresponding cluster is created in the the Private Cloud portal. The namespace is also created and configured automatically, as described in [Standard Operator: Running the Tool](https://docs.mendix.com/developerportal/deploy/standard-operator/#running-the-tool). You cannot create additional namespaces for a Mendix on Azure cluster. You also cannot use APIs to create or modify the cluster.
+    
+    The cluster cannot be deleted from the Private Cloud portal or the Mendix on Azure portal. If you want to remove it, you must delete it in the Microsoft Azure portal.
+
+## Rerunning Failed Clusters
+
+If a cluster fails for any reason, its status in the Mendix Portal changes to **Failed**. To view more information about the issue, click the icon in the **Actions** column, and then select **Details**.
 
-    You can choose any tier that suits your requirements. Higher tiers will incur higher costs.
+{{< figure src="/attachments/deployment/mx-azure/failed-cluster.png" class="no-border" >}}
 
-10. Click **Initialize**.
+To fix the issue, you can click **Rerun** to manually re-run the cluster. If a cluster still fails after a manual rerun, a support ticket is automatically opened with Mendix Support. For more information, see [Support Policy for Mendix on Azure: Automatic Support Tickets](/developerportal/deploy/mendix-on-azure/support/#tickets-automatic).
 
-    The initialization process takes approximately 15 minutes. It creates a resource group in the managed app that you created in step 3 above. Once the cluster is initialized successfully, a corresponding cluster and namespace are created in the the Private Cloud portal. The namespace is also configured automatically, as described in [Standard Operator: Running the Tool](https://docs.mendix.com/developerportal/deploy/standard-operator/#running-the-tool). The cluster cannot be deleted from the Private Cloud portal or the Mendix on Azure portal. If you want to remove it, you must delete it in the Microsoft Azure portal.
+{{% alert color="warning" %}}Do not initialize a cluster while it is in a Failed status.{{% /alert %}}
 
 ## Editing the Cluster in the Mendix on Azure Portal
 
@@ -84,7 +102,7 @@ The following diagram shows two managed resource groups. One of them contains th
 
 {{< figure src="/attachments/deployment/mx-azure/separate-access-groups.png" class="no-border" >}}
 
-#### Potential Solution 1: Virtual Network Peering
+#### Potential Solution 1: Virtual Network Peering {#network-peering}
 
 The following diagram shows one potential solution to the access issue. Bi-directional [virtual network peering](https://learn.microsoft.com/en-us/azure/virtual-network/virtual-network-peering-overview) has been configured between the two resource groups.
 

content/en/docs/deployment/mx-azure/mx-azure-support.md

@@ -11,7 +11,9 @@ weight: 30
 
 This document describes the technical support policies and limitations for Mendix on Azure, based on the shared responsibility model underlying the offering.
 
-## Shared Responsibility Model
+{{% alert color="info" %}}Before you begin, familiarize yourself with the general Mendix support policies, as outlined in [Mendix Support](/support/).{{% /alert %}}
+
+## Shared Responsibility Model for Mendix on Azure
 
 Under the shared responsibility model for Mendix on Azure deployments, Mendix, Microsoft, and customer organizations all have their own responsibilities in the deployment process and business-as-usual operations. Familiarize yourself with the responsibilities listed below:
 
@@ -97,7 +99,11 @@ Your tickets can have the following statuses:
 
 The status is updated based on the current status of the ticket in the Zendesk. To see the latest status of the ticket, click the **Refresh** button.
 
-### Automatic Support Tickets
+{{% alert color="info" %}}  
+If you delete a cluster, all support tickets opened for that cluster are also deleted.
+{{% /alert %}}
+
+### Automatic Support Tickets {#tickets-automatic}
 
 Mendix on Azure can also automatically create support tickets for you. If a cluster fails to initialize and rerunning it manually does not resolve the issue, a support request is automatically created in the Support Center. Mendix Support is notified about the issue through Zendesk. You can follow the link from the support ticket to Zendesk to view its status or add additional comments.
 
@@ -149,3 +155,5 @@ The solution is being benchmarked against SOC2 Azure Policy Compliance controls.
 
 * Mendix on Azure only supports hosting apps on Mendix versions 10.10 or later. Any app on an earlier version will fail to deploy successfully.
 * Due to the managed nature of this product, not all Private Cloud APIs are available to the customer. Refer to the Build and Deploy API documentation to find out which API calls are out of scope for Mendix on Azure.
+* Currently, even after a cluster manager is deleted from the Private Cloud portal for a specific cluster, users can still access the cluster in the Mendix on Azure portal.
+* Because Mendix on Azure is directly dependent on Mendix for Private Cloud, issues that affect the Private Cloud may also affect Mendix on Azure deployments. For example, if the Private Cloud is down, it is not possible to create new Mendix on Azure clusters.

content/en/docs/support/_index.md

@@ -185,6 +185,10 @@ Mendix Support does not have access to app health, logs, graphs and monitoring.
 
 {{< figure src="/attachments/support/private-cloud.png"   width="75%"  class="no-border" >}}
 
+### Mendix on Azure
+
+[Mendix on Azure](/developerportal/deploy/mendix-on-azure/) is a deployment option that makes use of some of the features of Mendix for Private Cloud in an opinionated way. For detailed information about the support policy in place for Mendix on Azure, see [Support Policy for Mendix on Azure](/developerportal/deploy/mendix-on-azure/support/).
+
 ### Private Mendix Platform
 
 Private Mendix Platform provides a platform experience in on-premises or (virtual) private cloud environments. It is dependent on Mendix for Private Cloud and Kubernetes, and integrates with tooling in the customer's landscape. Please refer to [Private Mendix Platform](/private-mendix-platform/) documentation for [prerequisites](/private-mendix-platform-prerequisites/) to install the platform and set up [configurations](/private-mendix-platform-configuration/), as well as [Mendix for Private Cloud](/developerportal/deploy/private-cloud/) documentation for [supported environments](/developerportal/deploy/private-cloud-supported-environments/).