diff --git a/content/en/docs/control-center/lead-mendix-implementation-your-organization.md b/content/en/docs/control-center/lead-mendix-implementation-your-organization.md index bfcf4dfb7ae..3a7e763c73c 100644 --- a/content/en/docs/control-center/lead-mendix-implementation-your-organization.md +++ b/content/en/docs/control-center/lead-mendix-implementation-your-organization.md @@ -1145,9 +1145,9 @@ If you don’t have a contract, or if your contract doesn’t allow for more lic **Link your application to your licensed node** -If you have a licensed node available, you can link your application to this licensed node. If your application was published as a Free App, you will have to unlink the application from the Free App environment first. This will delete all data on that Free App environment. So, before you unlink your Free App, [back up the data](/developerportal/deploy/licensing-apps/#backing-up) first, if you require it. +If you have a licensed node available, you can link your application to this licensed node. [Back up the data](/developerportal/deploy/licensing-apps/#backing-up) first if you require it. -If you have backed up your data, you can [unlink your application](/developerportal/deploy/licensing-apps/#unlink-free) from the Free App environment. +After that, you can [connect your application](/developerportal/deploy/licensing-apps/#connect-app) to the node. When your app is unlinked from a Free App environment, you can link it to a licensed node. By linking it to a licensed node, you get access to all the features of Mendix Cloud, such as one-click deployment from Studio Pro and our platform, log management, backups management and monitoring tools. diff --git a/content/en/docs/deployment/mendix-cloud-deploy/licensing-apps/_index.md b/content/en/docs/deployment/mendix-cloud-deploy/licensing-apps/_index.md index 0dae4f8b33a..647c7a08e48 100644 --- a/content/en/docs/deployment/mendix-cloud-deploy/licensing-apps/_index.md +++ b/content/en/docs/deployment/mendix-cloud-deploy/licensing-apps/_index.md @@ -27,7 +27,6 @@ Without a licensed node, you can still deploy your app and test it, but it will This page explains how to link your app to a licensed node. It covers the following topics: * [Linking Your App to a Licensed Node](#licensed-node) -* [Unlinking a Free App](#unlink-free) from its environment * [Exchanging Linked Apps Between Nodes](#exchange-apps) {{% alert color="warning" %}} @@ -79,9 +78,8 @@ You also need to have enabled two-factor authentication. For more information, s Consider the following case: You have deployed an app, either as a Free App or to a licensed node. You now want to link it to a licensed node (or move it from one licensed node to another licensed node). To link the app to the node, carry out the following steps: 1. [Back up your data](#backing-up) -2. [Unlink from the current environment](#unlink) -3. [Connect your app to a licensed node](#connect-app) -4. [Restore the backup of your data](#restoring) +2. [Connect your app to a licensed node](#connect-app) +3. [Restore the backup of your data](#restoring) {{% alert color="info" %}} For the specific case of swapping two apps between licensed nodes, see the guidance in the [Exchanging Linked Apps Between Nodes](#exchange-apps) section. @@ -95,35 +93,9 @@ For more details on downloading a backup, see [Download a Backup](/developerport {{% alert color="warning" %}}When you unlink your Free App from its environment, the environment is permanently deleted. You will not be able to recover any data once the Free App is unlinked.

If you unlink an app from a licensed node, that does not delete the node. Data is retained in the node.{{% /alert %}} -### Unlinking From Current Environment{#unlink} +#### Unlinking From Current Environment{#unlink} -Before you can link an app to a new environment, you need to unlink it from its current environment. By default, all apps are created as Free Apps the first time they are deployed. So, in most cases, you must unlink them. - -#### Unlinking a Free App{#unlink-free} - -To unlink a Free App, do the following: - -1. From [Apps](https://sprintr.home.mendix.com), go to the [Environments](/developerportal/deploy/environments/) page of the app you want to unlink. - -1. If the page shows the following message, then your app is not currently linked to a node. In that case, you can go straight to the [Connecting Your App to a Licensed Node](#connect-app) section. - - {{< figure src="/attachments/deployment/mendix-cloud-deploy/licensing-apps/link-node.png" >}} - -1. Click **Unlink your app**. - - {{< figure src="/attachments/deployment/mendix-cloud-deploy/licensing-apps/unlink-free-app.png" >}} - -1. Click **Yes, delete all data and unlink this app** to confirm. - - {{< figure src="/attachments/deployment/mendix-cloud-deploy/licensing-apps/confirm-unlink.png" max-width=70% class="no-border" >}} - -1. If prompted, authenticate yourself with [two-factor authentication](/developerportal/deploy/two-factor-authentication/). - -Your app has now been unlinked from the Free App environment. - -#### Unlinking a Licensed App{#unlink-licensed} - -It is not possible to unlink an app from a licensed node. The only way to do this is to connect another app to the licensed node; this automatically unlinks the existing app. +It is not necessary to unlink an app from its current environment before linking it to a new node. Instead, you can [connect another app to the node](#connect-app); this automatically unlinks the existing app. The [Exchanging Linked Apps Between Nodes](#exchange-apps) section provides an example of how you can use this behavior. @@ -147,19 +119,21 @@ To connect your app to a licensed node, do the following: 1. From [Apps](https://sprintr.home.mendix.com), go to the [Environments](/developerportal/deploy/environments/) page of the app you want to unlink. -1. Click **Select a node**. +1. Click **Select Licensed Node**. {{< figure src="/attachments/deployment/mendix-cloud-deploy/licensing-apps/link-node.png" >}} -1. Click **Use this Node**. +1. If prompted, authenticate yourself with [two-factor authentication](/developerportal/deploy/two-factor-authentication/). - {{< figure src="/attachments/deployment/mendix-cloud-deploy/licensing-apps/choose-node.png" class="no-border" >}} +1. In the list of your cloud nodes, click **Use this Node** by the node that you want to connect to your app. -1. If there is already an app linked to the node, you will be prompted to confirm that you want to replace it. Click **Continue** to confirm. +1. If there is already an app linked to the node, you will be prompted to confirm that you want to replace it. Click **Proceed** to confirm. - {{< figure src="/attachments/deployment/mendix-cloud-deploy/licensing-apps/confirm-replace.png" max-width=70% class="no-border" >}} +{{% alert color="warning" %}} +Unlinking a sandbox app cannot be undone. All data in the app is deleted. Before you proceed, make sure to download a backup of the app that you want to replace. -1. If prompted, authenticate yourself with [two-factor authentication](/developerportal/deploy/two-factor-authentication/). +Linking a new project to a node removes all existing team members and resets node permissions. The technical contact must re-add everyone to the project, and reconfigure any necessary settings. +{{% /alert %}} Your app is now connected to this node. diff --git a/static/attachments/deployment/mendix-cloud-deploy/licensing-apps/choose-node.png b/static/attachments/deployment/mendix-cloud-deploy/licensing-apps/choose-node.png deleted file mode 100644 index 5b104ce6c37..00000000000 Binary files a/static/attachments/deployment/mendix-cloud-deploy/licensing-apps/choose-node.png and /dev/null differ diff --git a/static/attachments/deployment/mendix-cloud-deploy/licensing-apps/confirm-replace.png b/static/attachments/deployment/mendix-cloud-deploy/licensing-apps/confirm-replace.png deleted file mode 100644 index 0fc347e05bc..00000000000 Binary files a/static/attachments/deployment/mendix-cloud-deploy/licensing-apps/confirm-replace.png and /dev/null differ diff --git a/static/attachments/deployment/mendix-cloud-deploy/licensing-apps/confirm-unlink.png b/static/attachments/deployment/mendix-cloud-deploy/licensing-apps/confirm-unlink.png deleted file mode 100644 index b1b1c038f89..00000000000 Binary files a/static/attachments/deployment/mendix-cloud-deploy/licensing-apps/confirm-unlink.png and /dev/null differ diff --git a/static/attachments/deployment/mendix-cloud-deploy/licensing-apps/link-node.png b/static/attachments/deployment/mendix-cloud-deploy/licensing-apps/link-node.png index d5e21861319..fcd38f17b27 100644 Binary files a/static/attachments/deployment/mendix-cloud-deploy/licensing-apps/link-node.png and b/static/attachments/deployment/mendix-cloud-deploy/licensing-apps/link-node.png differ diff --git a/static/attachments/deployment/mendix-cloud-deploy/licensing-apps/unlink-free-app.png b/static/attachments/deployment/mendix-cloud-deploy/licensing-apps/unlink-free-app.png deleted file mode 100644 index bffd95e4b07..00000000000 Binary files a/static/attachments/deployment/mendix-cloud-deploy/licensing-apps/unlink-free-app.png and /dev/null differ