Skip to content

Reinstate Mendix Basic Package documentation #9576

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 3 commits into
base: development
Choose a base branch
from
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion content/en/docs/deployment/mendix-cloud-deploy/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -149,7 +149,7 @@ For more information, see [Pricing](https://www.mendix.com/pricing/).

### Cloud Resource Packs {#resource-pack}

Mendix environments are sized by reference to cloud resource packs. These resources are used for application runtime as well as anything else required to run your application, such as agents for any third-party integrations that you have added. The table below shows the current cloud resource packs for Standard, Premium, and Premium Plus plans.
Mendix environments are sized by reference to cloud resource packs. These resources are used for application runtime as well as anything else required to run your application, such as agents for any third-party integrations that you have added. The table below shows the current cloud resource packs for Standard, Premium, and Premium Plus plans. Resources for the Basic plan are fixed as described in [Mendix Basic Package](/developerportal/deploy/basic-package/).

If you have a Standard, Premium, or Premium Plus plan, you can redeem virtual credits known as cloud tokens to purchase cloud resource packs on the Mendix Platform. For more information about how this works, see [Entitlements](/control-center/entitlements/).

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -57,6 +57,8 @@ In a licensed node, you have everything you need to stage and deploy your app. Y

To license an app, you must have a licensed cloud node available:

If you want to license a single app for between five and one hundred users, you can order the Mendix Basic package online. For more information, see [Mendix Basic Package](/developerportal/deploy/basic-package/).

If you have an existing contract that allows for more licensed nodes, use the [Request New App Node](https://newnode.mendix.com) app to request a new node from Mendix Support. For more information, see [Licensing Apps](/developerportal/deploy/licensing-apps-outside-mxcloud/).

{{% alert color="info" %}}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,96 @@ description: "Obtaining a Mendix Basic Package Node"
#To update these screenshots, you can log in with credentials detailed in How to Update Screenshots Using Team Apps.
---

{{% alert color="warning" %}}
New licenses for Mendix Basic Package are not currently available.
## Introduction

If you currently have a Mendix Basic Package, it can still be renewed by contacting your CSM or [Mendix Support](https://support.mendix.com/)
You can only run a Mendix app in production on Mendix Cloud if the app is linked to a licensed node. If you have an app that you want to license, you can do this simply and cost-effectively by ordering the [Mendix Basic](https://www.mendix.com/pricing/basic-package/) package.

{{% alert color="info" %}}
After you submit your order, it will be sent to our Order Desk Team and they will contact you in around five working days.
{{% /alert %}}

{{% alert color="info" %}}
Without a license, you can still deploy and test your app, but the functionality is limited compared to the Basic Package. For more information, see [Mendix Cloud](/developerportal/deploy/mendix-cloud-deploy/).
{{% /alert %}}

## Features of the Basic Package

The Basic Package has the following features:

* Runs in Mendix Cloud
* Supports 5-100 users
* Can be paid for via invoice only
* Has a limited amount of resources and a single cloud environment on Mendix Cloud, together with the ability to preview and test in Studio Pro. The cloud environment has the following features:
* 1 GiB App RAM
* 0.25 vCPU
* 1 GiB database schema as a part of a shared database — your schema is private to your app, and some database monitoring graphs are not available (see [Metrics](/developerportal/operate/metrics/) for more information)
* 1 GiB file storage for `FileDocument` and `Image` entities
* The regular Mendix [Service Level Agreement](https://www.mendix.com/wp-content/uploads/Mx_ServiceLevelAgreement_v2018-01.pdf) applies, but note the following:
* You cannot get telephone support; you can only access support via the [Mendix Support](https://support.mendix.com) website.
* Support is only available for general platform issues; Mendix Support cannot help solve problems with individual apps.

## Purchasing a Basic Package

From [Apps](https://sprintr.home.mendix.com), go to the **Environments** page of the Free App you want to license.

When you view your Free App environment, you will see a banner showing that you are using a Free App.

{{< figure src="/attachments/deployment/mendix-cloud-deploy/licensing-apps/basic-package/free-app-message.png" alt="Free App banner" class="no-border" >}}

To order your Mendix Basic package, do the following:

1. Click **Learn More**.

2. Review the features of Mendix Basic and click **Upgrade Now**.

3. Configure the Basic Package by choosing the following:

* **App Name** – This defaults to the current Free App, but you can choose another one of your Free Apps using the drop-down list.
* **App URL** – Choose your preferred subdomain of `.mendixcloud.com`. This is where users can find your app.
* **Deployment Region** – Choose your preferred region. Mendix recommends selecting the region where you expect to receive the most visitors. The available regions correspond to AWS regions.
* **Number of Users** – The cost of your Basic package depends on the number of users.

{{< figure src="/attachments/deployment/mendix-cloud-deploy/licensing-apps/basic-package/configure-basic-package.png" alt="Configuration screen" class="no-border" >}}

You can see a summary of your Basic package on the right side of the screen.

4. Click **Continue**.

5. Enter your account and billing details.

{{% alert color="info" %}}Enter an email address that you monitor. Mendix uses this email address to send important information about your Mendix Basic package.{{% /alert %}}

6. Click **Continue**.

7. Review your order and make any changes needed. Review and accept the **Terms & Conditions**.

{{% alert color="info" %}}The license may take 48 hours to provision. You will receive your invoice about 14 days after you submit your order.{{% /alert %}}

8. Depending on your payment method, you will be asked to enter your credit card details or to continue with the payment on your account.

9. Click **Purchase** to complete your order.

10. Read the confirmation details and click **Done** to return to the Mendix Portal. You will also receive a confirmation email at the email address entered in your order.

## Linking Your App to your Mendix Basic Node

After 48 hours, your Mendix Basic package will be provisioned as a new licensed node. You will receive an email at the address entered in your order; this email notifies you that your node is ready and directs you to documentation on how to use the node.

To link your app to your licensed node, follow the same process as for any other sort of license. For details on how to link your app, see the following documents:

* For brief instructions, see [How To Migrate a Free App to Mendix Basic](/developerportal/deploy/migrate-free-app-to-basic/)
* For full details, see [Linking Your App to a Licensed Node](/developerportal/deploy/licensing-apps/#licensed-node) in *Licensing Mendix Cloud Apps*

## Invoicing for your Basic Package

It takes about 14 days to prepare your invoice. The invoice is sent to the **Invoice Email** that you provide.

For automatic orders, payment occurs when the package is ordered. For manual orders, payment is due within 30 days.

## Renewing Your Payment Method

Your plan automatically renews 12 months from the date of provision. You can opt out of auto-renewal via the [MyCommerce](https://account.mycommerce.com/) site up to 60 days before the period ends.

Before renewing the licenses for your company, Mendix checks if your company's payment method is still valid. If it is expired, you will receive an email that asks you to update your company's payment method.

You can update your payment details on the **Account Information** page of the [MyCommerce](https://account.mycommerce.com/) site.
Original file line number Diff line number Diff line change
Expand Up @@ -7,8 +7,98 @@ description: "Moving an existing Mendix app deployed as a Free App to a Basic Pa
#To update these screenshots, you can log in with credentials detailed in How to Update Screenshots Using Team Apps.
---

{{% alert color="warning" %}}
New licenses for Mendix Basic Package are not currently available.
## Introduction

If you currently have a Mendix Basic Package, it can still be renewed by contacting your CSM or [Mendix Support](https://support.mendix.com/)
{{% /alert %}}
This how-to explains how to migrate your app and its database from a Free App environment to a paid Mendix Basic node. For more information on the Mendix Basic Package, see [Mendix Basic Package](/developerportal/deploy/basic-package/).

You can also see these steps by watching this video:

{{< vidyard "UkYqZGMiP3k1AZGk7PPrjP" >}}

For more information on setting up any environment details as described in the video, see [Environment Details](/developerportal/deploy/environments-details/).

## Prerequisites

Before starting this how-to, make sure that the following prerequisites are met:

* You have received confirmation that your Basic node is ready
* You are the [Technical Contact](/developerportal/general/app-roles/#technical-contact) of the app

## Migrating to Mendix Basic

To migrate your Free App and its database to your Mendix Basic environment, follow the steps in the sections below.

### Open your Free App

1. Go to [Apps](https://sprintr.home.mendix.com). Sign in if prompted.
1. Click the app that you want to migrate to a Basic Node.

### Download a Backup{#download-backup}

1. In the [navigation pane](/developerportal/#navigation-pane), click **Backups**.
1. On the backup that you want to download, click **More Options** ({{% icon name="three-dots-menu-horizontal" %}}) > **Download**.
1. Make sure **Full Snapshot** is selected, then click **Start** to prepare the download.
1. Once the backup is ready, click **Download**.

{{< figure src="/attachments/deployment/mendix-cloud-deploy/licensing-apps/migrate-free-app-to-basic/download-backup.png" alt="" width=75% class="no-border" >}}

1. Close the **Download Backup** dialog box.

### Unlink Your App From Its Node

1. In the navigation pane, click **Environments**.

1. Click **Unlink your app**.

{{< figure src="/attachments/deployment/mendix-cloud-deploy/licensing-apps/migrate-free-app-to-basic/unlink-free-app.png" class="no-border" >}}

If you see the following message, your app has already been unlinked. In that case, you can skip ahead to [Link Your App to the New Node](#link-app-to-node).

{{< figure src="/attachments/deployment/mendix-cloud-deploy/licensing-apps/migrate-free-app-to-basic/link-node.png" class="no-border" >}}

1. In the **Confirmation** pop-up, click **Yes, delete all data and unlink this app**.

{{< figure src="/attachments/deployment/mendix-cloud-deploy/licensing-apps/migrate-free-app-to-basic/confirm-unlink.png" alt="" width=75% class="no-border" >}}

{{% alert color="info" %}}Before your environment is deleted, you may be prompted to authenticate with [two-factor authentication](/developerportal/deploy/two-factor-authentication/).{{% /alert %}}

### Link Your App to the New Node{#link-app-to-node}

1. In the banner at the top of the **Environments** page, click **Select a node**.

{{< figure src="/attachments/deployment/mendix-cloud-deploy/licensing-apps/migrate-free-app-to-basic/link-node.png" class="no-border" >}}

2. Click **Use this node** for the node you just licensed. You may have to confirm and authenticate this with two-factor authentication again.

### Configure Your Environment

Before your app can be deployed, you may need to configure your environment details. This is only required if you have some special configurations or you have to specify settings in order for your functionality to work. For example, if your app uses scheduled events or application constants, you can configure them at this stage. For more information about configuring your environment, see [Environment Details](/developerportal/deploy/environments-details/).

### Deploy Your App

Now you need to deploy and start your app!

1. Create a deployment package as described in the [Creating a Deployment Package](/developerportal/deploy/mendix-cloud-deploy/deploying-an-app/#package-from-team-server).
1. On the deployment package you just created, click **Deploy** ({{% icon name="deploy" %}}) and follow the steps in the resulting wizard, as described in [Deploying the App to an Environment](/developerportal/deploy/mendix-cloud-deploy/deploying-an-app/#deploy-the-app-to-an-environment). This publishes your app to the production environment and then starts it.

### Upload and Restore the Backup

The final step is restoring your data. You must do this after you've deployed your app because this ensures that a database has been provisioned and is ready to accept your data.

1. Go to the **Backups** page.

1. Click **Upload Backup**.

1. Select the backup file you downloaded earlier in [Download a Backup](#download-backup), then click **Upload Archive**. The file will be uploaded. Once the upload completes, a backup file is uploaded to your app using the data from your old Free App environment.

1. On the backup you just uploaded, click **More Options** ({{% icon name="three-dots-menu-horizontal" %}}) > **Restore**.

1. Confirm the restore by clicking **Restore Backup**.

{{% alert color="info" %}}If your app is running, you will be prompted to stop the application before continuing the restoration process. If prompted, stop your application by clicking **Stop application**. Then click **Restore Backup** again.{{% /alert %}}

{{< figure src="/attachments/deployment/mendix-cloud-deploy/licensing-apps/migrate-free-app-to-basic/restore-backup.png" alt="" width=75% class="no-border" >}}

1. You will see a dialog stating that your backup restore has been scheduled and will be completed shortly. Click **Okay**.

1. Go to the **Environments** page, click **Environment Details** ({{% icon name="notes-paper-edit" %}}) on the production environment, and start your application. Now it is ready for use.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.