Skip to content

Commit c4d9451

Browse files
Merge pull request #9518 from mendix/olu-proofread-deployed-apps
Proofreading task for apps deployment
2 parents c26893d + fc35ebb commit c4d9451

File tree

1 file changed

+54
-51
lines changed

1 file changed

+54
-51
lines changed

content/en/docs/control-center/apps/deployed-apps.md

Lines changed: 54 additions & 51 deletions
Original file line numberDiff line numberDiff line change
@@ -8,12 +8,17 @@ no_list: true
88

99
## Introduction
1010

11-
The **Deployed Apps Overview** page provides a comprehensive view of all the apps within your company. On this page, you can find detailed information about each app, including its name, ID, Technical Contact, status, number of environments, and the number of [cloud tokens](/control-center/entitlements/#cloud-tokens) used, if applicable. Additionally, this page allows you to provision and offboard environments for apps on Mendix Cloud. Moreover, you can email or download the license keys for your apps directly from this page.
12-
The **Deployed Apps Overview** page has the following tabs: [Mendix Cloud](#mendix-cloud), [Free Apps](#free-apps), and [Apps with License Keys](#apps-license-keys).
11+
The **Deployed Apps Overview** page provides a comprehensive view of all the apps deployed within your company. For each deployed app, you can view details such as its name, ID, Technical Contact, status, number of environments, and, if applicable, the number of [cloud tokens](/control-center/entitlements/#cloud-tokens) used.
12+
13+
Additionally, this page allows you to provision and offboard environments for apps on Mendix Cloud, and email or download the license keys for your apps.
14+
1315
If you click the **...** icon in the upper-right corner, you can access the following pages that allow you to [make requests to Mendix Support](/support/submit-support-request/#submitting):
1416

15-
* [Resize Environment](/support/new-app-node-request-template/#resize) – requests a container size change
16-
* [Offboard Environment](/support/new-app-node-request-template/#offboard) – requests that an app is offboarded
17+
* [Resize App](/support/new-app-node-request-template/#resize) – requests a container size change
18+
* [Offboard App](/support/new-app-node-request-template/#offboard) – requests that an app is offboarded
19+
* [Add new App](/support/new-app-node-request-template/#new-node) – requests a new app addition
20+
21+
The **Deployed Apps Overview** page has the following tabs: [Mendix Cloud](#mendix-cloud), [Free Apps](#free-apps), and [Apps with License Keys](#apps-license-keys).
1722

1823
## Mendix Cloud {#mendix-cloud}
1924

@@ -23,34 +28,31 @@ To activate this capability for your company, contact your Customer Success Mana
2328

2429
The list on this tab shows the following information:
2530

26-
* **App Name** – This is the name of the app. To view the [app environment details](#mendix-cloud-app-environment), click the app name.
27-
* **Technical Contact** – This shows the registered email address for sending license keys to. If the Technical Contact is not correct, you can change it by clicking the edit icon ({{% icon name="pencil" %}}) next to the email address. Every app can only have one Technical Contact. After you change the Technical Contact, both the new and the old contact receive a notification email about the change.
28-
29-
* **Status** – This shows whether app is active or not.
30-
* **Env Count** – This is the number of the environments available for this app.
31-
* **Credits Used** – This shows the number of credits that the app has used.
31+
* **App Name** – The name of the app. To view the [app environment details](#mendix-cloud-app-environment), click the app name.
32+
* **Technical Contact** – The registered email address to which license keys are sent. Each app can only have one Technical Contact. If the Technical Contact is not correct, you can change it by clicking the edit icon ({{% icon name="pencil" %}}) next to the email address and selecting a new Technical Contact from the list. After you update the Technical Contact, both the new and the old contact will receive a notification email.
33+
* **Status** – Indicates whether app is active.
34+
* **Env Count** – The number of the environments available for the app.
35+
* **Credits Used** – The total number of credits the app has used.
3236

3337
### App Environment Details {#mendix-cloud-app-environment}
3438

35-
If you click the name of an app in the list, a page opens and shows the app environment details.
39+
When you click the name of an app in the list, a page opens showing the app's environment details.
3640

3741
{{< figure src="/attachments/control-center/apps/deployed-apps/cloud-provisioning.png" alt="cloud provisioning page for an app" >}}
3842

39-
On the top, you can see the app name, credits used, and the Technical Contact. The labels below show whether the app is licensed or active.
40-
41-
To quickly change the Technical Contact for your app, click **Edit** by the name of the Technical Contact, and then select the new Technical Contact from the list. Every app can only have one Technical Contact. After you change the Technical Contact, both the new and the old contact receive a notification email about the change.
43+
The top of the page includes information about the app name, the number of cloud tokens used, and the Technical Contact. There are also labels which indicate whether the app is licensed or active.
4244

43-
On the right side above the list, you see the **Add Environment** button. You can click it to [add a new environment](#add-environment).
45+
In the upper-right corner, above the list, there is the **Add Environment** button. Click it to [add a new environment](#add-environment).
4446

45-
The list shows the all the environments available for the app, with the following columns:
47+
The list shows all the environments available for the app, with the following columns:
4648

47-
* **Environment**This is the name of the environment.
48-
* **Resource Pack**This is the resource pack selected for the environment.
49-
* **Running State**This shows whether the app is running or not deployed.
50-
* **Production**This shows whether the environment is a production environment.
51-
* **URL** – This shows the URL of the environment.
52-
* **Mendix Version**This shows the Mendix version.
53-
* **Credits Used**This shows the number of the credit that the environment has used.
49+
* **Environment**The name of the environment
50+
* **Resource Pack** The selected resource pack for the environment
51+
* **Running State**Indicates whether the app is running or not deployed
52+
* **Production**Shows whether the environment is a production environment
53+
* **URL** – The public URL of the environment
54+
* **Mendix Version**The Mendix version
55+
* **Credits Used**The number of the credits used by the environment
5456
* **Action**
5557
* **Offboard** – Clicking this button starts [offboarding an environment](#offboard-environment)
5658

@@ -66,7 +68,7 @@ To add a new environment for your app, click the name of an app, and then click
6668

6769
#### Offboarding an Environment {#offboard-environment}
6870

69-
To offboard an environment, click **Offboard**, which is available for stopped environments. After that, confirm that you have made any necessary backups, and type *Offboard* to confirm.
71+
To offboard an environment, click **Offboard**, which is available for stopped environments. After that, confirm that you have made all the necessary backups, and type *Offboard* to confirm.
7072

7173
{{< figure src="/attachments/control-center/apps/deployed-apps/offboarding.png" width= 50% alt="confirming the offboarding" class="no-border" >}}
7274

@@ -80,49 +82,51 @@ The **Free Apps** tab shows all the apps deployed to Mendix Free Cloud.
8082

8183
The list shows the following information:
8284

83-
* **App Name** – This is the name of the app.
84-
* **App ID** – This shows the app/project ID.
85-
* **Technical Contact** – This shows the registered email address for sending license keys to. If the Technical Contact is not correct, you can change it by clicking the edit icon ({{% icon name="pencil" %}}) next to the email address. Every app can only have one Technical Contact. After you change the Technical Contact, both the new and the old contact receive a notification email about the change.
86-
87-
* **Status** – This shows whether app is active or not.
85+
* **App Name** – The name of the app.
86+
* **App ID** – The app/project ID.
87+
* **Technical Contact** – The registered email address to which license keys are sent. Each app can only have one Technical Contact. If the Technical Contact is not correct, you can change it by clicking the edit icon ({{% icon name="pencil" %}}) next to the email address and selecting a new Technical Contact from the list. After you update the Technical Contact, both the new and the old contact will receive a notification email.
88+
* **Status** – Indicates whether app is active or not.
8889

8990
## Apps with License Keys {#apps-license-keys}
9091

91-
The **Apps with License Keys** tab provides an overview of all apps for which license keys have been issued to their respective key contacts. You can find the latest version of license keys for these app environments here. This includes all your apps deployed on Mendix for Private Cloud Standalone, Docker, Cloud Foundry buildpack, and on-premises environments.
92+
The **Apps with License Keys** tab provides an overview of all apps for which license keys have been issued to their respective Technical Contacts. This includes all your apps deployed on Mendix for Private Cloud Standalone, Docker, Cloud Foundry buildpack, and on-premises environments. You can find the latest version of license keys for these app environments here.
93+
94+
License keys are aligned with your Mendix contracts and need to be applied by you to each app. Every app environment (such as test, acceptance, and production) requires its own license key.
9295

93-
License keys here are aligned with your contracts with Mendix and need to be applied by you to each individual app. Each app environment (such as test, acceptance, and production) needs its own license key. Any changes to licenses require the Technical Contacts to reapply license keys to their respective app environments. For example, when contracts are created or renewed, new license keys are automatically generated. Then these new license keys must be applied to the environments of the app for which the contract was changed. For details on how to apply license keys, see the [Activating a Mendix License](/developerportal/deploy/licensing-apps-outside-mxcloud/#activate-mendix-license) section in *Licensing Apps*.
96+
Any changes to licenses require the Technical Contacts to reapply license keys to their respective app environments. For example, when contracts are created or renewed, new license keys are automatically generated. Then these new license keys must be applied to the environments of the app for which the contract was changed. For details on how to apply license keys, see the [Activating a Mendix License](/developerportal/deploy/licensing-apps-outside-mxcloud/#activate-mendix-license) section in *Licensing Apps*.
9497

9598
On the **Apps with License Keys** tab, you can do the following:
9699

97-
* View your apps with issued license keys.
98-
* See active license keys for all environments of an app.
99-
* Delete license keys for environments that are no longer in use.
100-
* Resend licenses to the Technical Contacts of your on-premises deployed apps or download all licenses to your local device.
101-
* Quickly change Technical Contacts for these apps and resend keys as needed.
100+
* View your apps with issued license keys
101+
* See active license keys for all environments of an app
102+
* Delete license keys for environments that are no longer in use
103+
* Resend licenses to the Technical Contacts of your on-premises deployed apps or download all licenses to your local device
104+
* Quickly change Technical Contacts for these apps and resend keys as needed
102105

103106
You can download all the license keys by clicking {{% icon name="download-bottom" %}} **Download all keys** on the right side above the list.
104107

105108
The list shows the following information:
106109

107-
* **App Name**This is the name of the app. To view [app environment details](#apps-license-keys-app-environment), click the app name.
110+
* **App Name**The name of the app. Click the app name to view the [app environment details](#apps-license-keys-app-environment).
108111

109112
{{% alert color="info" %}}The app name shown here is the name that was initially given to the app when the license keys were generated. Your current app name may be different.{{% /alert %}}
110113

111-
* **Technical Contact** – This shows the registered email address to which the license keys are sent. If the Technical Contact is not correct, you can change it by clicking the edit icon ({{% icon name="pencil" %}}) next to the email address. Every app can only have one Technical Contact. After you change the Technical Contact, both the new and the old contact receive a notification email about the change.
114+
* **Account Name** – The name of the account.
115+
* **Technical Contact** – The registered email address to which license keys are sent. Each app can only have one Technical Contact. If the Technical Contact is not correct, you can change it by clicking the edit icon ({{% icon name="pencil" %}}) next to the email address and selecting a new Technical Contact from the list. After you update the Technical Contact, both the new and the old contact will receive a notification email.
112116

113-
* **Created Date**This is the date on which the app was originally created.
117+
* **Created Date**The date the app was originally created.
114118

115-
* **Actions**You can carry out actions with the following icons:
116-
* {{% icon name="email" %}} – Clicking this emails the license keys of the app to the registered Technical Contact.
117-
* {{% icon name="download-bottom" %}} – Clicking this downloads the license keys to your local computer. The license keys can then be applied to the app for which they were created.
119+
* **Actions**Clicking any of these icons performs one of the following actions:
120+
* {{% icon name="email" %}} – Emails the app's license keys to the registered Technical Contact.
121+
* {{% icon name="download-bottom" %}} – Downloads the license keys to your local computer. The license keys can then be applied to the app for which they were created.
118122

119123
### App Environment Details {#apps-license-keys-app-environment}
120124

121-
After clicking an app name in the list, a page opens and shows the environments that belong to that app, together with the license start and end dates. This page allows you to verify the validity of your license keys and download or email them to the Technical Contact of the app.
125+
After clicking an app name in the list, a page opens displaying the environments associated with that app, along with the license start and end dates. On this page, you can verify the validity of your license keys and download or email them to the Technical Contact of the app.
122126

123-
At the upper-left corner the page, you see the name of the app, the email address of the Technical Contact, and the date that will be used as the license end date when new keys are generated.
127+
In the upper-left corner the page, there is the name of the app, the email address of the Technical Contact, and the date that will be used as the license end date when new keys are generated.
124128

125-
To quickly change the Technical Contact for your app, click the edit icon ({{% icon name="pencil" %}}) by the name of the Technical Contact, and then select the new Technical Contact from the list. Every app can only have one Technical Contact. After you change the Technical Contact, both the new and the old contact receive a notification email about the change.
129+
To quickly change the Technical Contact for your app, click the edit icon ({{% icon name="pencil" %}}) by the name of the Technical Contact, and then select the new Technical Contact from the list. After you change the Technical Contact, both the new and the old contact will receive a notification email about the change. Each app can only have one Technical Contact.
126130

127131
On the right side above the list, you can see the following buttons:
128132

@@ -132,20 +136,19 @@ On the right side above the list, you can see the following buttons:
132136

133137
The list below show the details of the environments with the following columns:
134138

135-
* **Environment**This shows the names of the environments that belong to the app that you selected.
136-
* **ServerID**This shows the server IDs that were used to generate the license keys for each environment.
137-
* **LicenseID**This shows the ID of the license that was emailed to the Technical Contact when the license keys were generated. This unique identifier allows you to reference and manage your licenses, ensuring they align with the licenses in your various environments.
139+
* **Environment**The names of the environments that belong to the app that you selected.
140+
* **ServerID**The server IDs used to generate the license keys for each environment.
141+
* **LicenseID**The ID of the license that was emailed to the Technical Contact when the license keys were generated. This unique identifier allows you to reference and manage your licenses, ensuring they align with the licenses in your various environments.
138142
* **Start Date** and **End Date** – Your license keys are valid between these two dates. An app needs an active contract with a future end date to keep working.
139-
* **Actions** – You can carry out an action with the following icon:
140-
* {{% icon name="trash-can" %}} – Clicking this offboards that license from the database. Before the action is completed, a dialog box opens to ask for your confirmation. When the last license of an app is offboarded, the app is automatically offboarded and will no longer show up on the **Apps with License Keys** tab.
143+
* **Actions** – Clicking {{% icon name="trash-can" %}} offboards that license from the database. Before the action is completed, a dialog box opens to ask for your confirmation. When the last license of an app is offboarded, the app is automatically offboarded and will no longer show up on the **Apps with License Keys** tab.
141144

142145
### Frequent Asked Questions {#license-keys-faq}
143146

144147
#### How Do We Know If Our Company Has Apps with Issued License Keys?
145148

146149
The latest version of license keys created for the apps are shown on the **Apps with License Keys** tab on the **Deployed Apps** page in Control Center.
147150

148-
Several deployment options require the Technical Contact to manually apply license keys to the app environments. For details on how to apply license keys, see the [Activating a Mendix License](/developerportal/deploy/licensing-apps-outside-mxcloud/#activate-mendix-license) section in Licensing Apps.
151+
Several deployment options require the Technical Contact to manually apply license keys to the app environments. For details on how to apply license keys, see the [Activating a Mendix License](/developerportal/deploy/licensing-apps-outside-mxcloud/#activate-mendix-license) section in *Licensing Apps*.
149152

150153
In some exceptional cases, the Technical Contact may also receive license keys for other deployment models. As a Mendix Admin, you are aware of these.
151154

0 commit comments

Comments
 (0)