diff --git a/content/en/docs/deployment/sap-btp/_index.md b/content/en/docs/deployment/sap-btp/_index.md index ce223fb7e07..3814644b579 100644 --- a/content/en/docs/deployment/sap-btp/_index.md +++ b/content/en/docs/deployment/sap-btp/_index.md @@ -100,7 +100,7 @@ Provide the final details for the SAP BTP development environment. Choose a **Domain**, **Organization**, and **Space** which is configured for you in this region. -If you do not choose a **Custom database**, you can still choose from a range of different databases, such as PostgreSQL, Hyperscaler Option, and SAP HANA. Ensure that the database you choose is supported by your quota plan for this region and organization. See [Databases in SAP BTP](#databases) for important information on selecting the correct database for your app. +If you do not choose a **Custom database**, you can still choose from a range of different databases, such as PostgreSQL, Hyperscaler Option, and SAP HANA. Ensure that the database you choose is supported by your quota plan for this region and organization. See [Databases in SAP BTP](/developerportal/deploy/sap-cloud-platform/databases/) for important information on selecting the correct database for your app. If you select **Yes** for **Custom database**, provide the details for the **Name** and the **Plan**. @@ -150,7 +150,7 @@ To create a new environment, perform the following steps: 7. Set **Development Mode** to *Yes* if you want the application to run with the Mendix security level of Prototype/demo, or *No* for no security. This is not recommended for acceptance or production environments. -8. Select the database you would like to use. Be aware that even if a specific database is part of the Marketplace, it could still be unavailable because of limitations imposed by the quota of your organization. See [Databases in SAP BTP](#databases) below for information on selecting the correct database for your app. +8. Select the database you would like to use. Be aware that even if a specific database is part of the Marketplace, it could still be unavailable because of limitations imposed by the quota of your organization. See [Databases in SAP BTP](/developerportal/deploy/sap-cloud-platform/databases/) for information on selecting the correct database for your app. If you choose **Custom Database**, enter a **Name** for the database and the **Plan**. @@ -253,15 +253,15 @@ You can also transport to the required environment from the **Overview** tab of {{< figure src="/attachments/deployment/sap-btp/sap-cloud-platform/edit-constants.png" class="no-border" >}} -3. In the **Scheduled Events** section, select the scheduled event you want to *Enable* or *Disable* and click **Next**. For more information, refer to [Scheduled Events](#schedules-events). +3. In the **Scheduled Events** section, select the scheduled event you want to *Enable* or *Disable* and click **Next**. For more information, refer to [Scheduled Events](/developerportal/deploy/sap-cloud-platform/environments/#schedules-events). ### Unbinding and Deleting Service Instances -1. In the **Services** tab, select any additional services you need for your app. For more information, see the [Services tab](#binding-services). +1. In the **Services** tab, select any additional services you need for your app. For more information, see the [Services tab](/developerportal/deploy/sap-cloud-platform/environments/#binding-services). -{{% alert color="warning" %}}In your initial deployment, do not remove any of the services with the status **Bound Services**. For a new app, these services are required for the correct deployment of the app.{{% /alert %}} + {{% alert color="warning" %}}In your initial deployment, do not remove any of the services with the status **Bound Services**. For a new app, these services are required for the correct deployment of the app.{{% /alert %}} -1. If you want to remove a service instance from your environment, click the three-dot ({{% icon name="three-dots-menu-horizontal" %}}) menu for the service and select **Unbind Service** or **Delete Service**. +2. If you want to remove a service instance from your environment, click the three-dot ({{% icon name="three-dots-menu-horizontal" %}}) menu for the service and select **Unbind Service** or **Delete Service**. The options do the following: @@ -272,370 +272,15 @@ You can also transport to the required environment from the **Overview** tab of ### Runtime Settings and Environment Variables -Click **Next** to continue to the **Runtime** tab. Here, you can **Add**, edit ({{% icon name="pencil" %}}), or delete ({{% icon name="trash-can-filled" %}}) custom runtime settings and environment variables. For more information, refer to [Runtime](#runtime-tab). Click **Next**. +Click **Next** to continue to the **Runtime** tab. Here, you can **Add**, edit ({{% icon name="pencil" %}}), or delete ({{% icon name="trash-can-filled" %}}) custom runtime settings and environment variables. For more information, refer to [Runtime](/developerportal/deploy/sap-cloud-platform/environments/#runtime-tab). Click **Next**. ### Starting the Application 1. On the **Start Application** tab, you can see the application details. Click **Start application** to start the application on SAP BTP. -{{% alert color="info" %}}This binds any services which are in the status **Services To Be Bound**.{{% /alert %}} + {{% alert color="info" %}}This binds any services which are in the status **Services To Be Bound**.{{% /alert %}} -1. When the application has been started, you are taken to the **Environment Details** page for the selected environment. See [Environment Details](#EnvironmentDetails). - -## Environment Details {#EnvironmentDetails} - -The environment details page contains the following tabs: - -* [General](#general-tab) – how the application is deployed on SAP BTP -* [Model Options](#model-options-tab) – application constants and scheduled events -* [Services](#binding-services) – Cloud Foundry service management -* [Runtime](#runtime-tab) – custom environment variables which define **User-Provided Variables** in the SAP Cloud Foundry environment — pre-defined variables can be used to control the behavior of the Mendix Runtime - -Open the environment details by clicking the details ({{% icon name="pencil-write-paper" %}}) icon on the **Environments** page of the Development Portal. You will also be taken to this page when you successfully deploy or transport your app. - -{{< figure src="/attachments/deployment/sap-btp/sap-cloud-platform/env-details.png" alt="" >}} - -{{% alert color="info" %}}If you make changes to your app which you want to be applied next time the app is deployed, you must make them in the **Environment Details**. - -Changes made to the app in the SAP BTP cockpit are only temporary and can be overwritten by the values in the Mendix Portal next time the app is deployed.{{% /alert %}} - -### General Tab {#general-tab} - -This tab contains information on how the application is deployed on SAP BTP. Most of this page shows information about the app, but there are several options which allow you to change the app. - -#### Start and Stop Application - -If the application is running, click **Stop Application** and confirm when asked to stop the application. - -The button will change to **Start Application** which you can click to start or restart the application. - -{{% alert color="info" %}} -You may need to use this option to stop and start your app after changing one of the settings on this page. -{{% /alert %}} - -If you receive an error trying to start the app, refer to the [App Does Not Start](#appnotstart) section below. - -#### Change Admin Password - -Find the three-dots ({{% icon name="three-dots-menu-horizontal" %}}) icon and click **Change Admin Password** to change the password for the administrator account (by default, MxAdmin) in your Mendix app. - -{{% alert color="warning" %}} -The new password will not come into effect until you stop and start your environment. -{{% /alert %}} - -#### View Recent Log - -Click three-dots ({{% icon name="three-dots-menu-horizontal" %}}) icon and select **View Recent Log** to see recent events written to the log. - -#### Delete Environment - -**Delete Environment** enables you to delete the environment and, optionally, all its resources, including the app. - -You are asked to confirm that this environment should be removed. You are also asked to confirm that the resources associated with the environment should also be removed. Note that the default is not to remove the resources. - -{{% alert color="info" %}} -If you do not select **Remove resources** in the dialog, the resources are left in SAP BTP. This is useful if you want to remove the environment but a resource cannot be removed. In this case, the resources can only be removed individually from within the SAP BTP cockpit. -{{% /alert %}} - -#### Change Development Mode - -Click **Change** to change the **Development Mode**. Set it to *Yes* if you want the application to run with only prototype security, or completely without security. This is not recommended for acceptance or production environments. - -#### Change App URL - -Click **Change** to change the **App URL** for this environment. - -#### Change Redirect URLs - -Click **Change** to change the **Redirect URLs**. Redirect URLs are custom URLs (for example, `appname.subdomain.domain.com`) where the user will be redirected after signing on using XSUAA, instead of being redirected to the generated URL (for example, `appname.cfapps.eu10.hana.ondemand.com`) of the app. - -#### Scaling - -If the app is started or stopped (that is, the environment has been created successfully and the app has been deployed without errors), options to scale the app are available. - -Use the **Instances** slider to change the number of instances of the app which can run. This allows you to scale the app horizontally to support large numbers of users, or to improve the app's resilience by allowing it to continue to run if there are any issues with one of the instances. - -Use the **Memory per instance** slider to change the amount of memory allocated to each instance of the app. - -Click **Scale Now** to apply the new settings. If the application is running, it is stopped and restarted to apply the settings. If it is stopped, it is not started automatically. The new settings are used the next time the application is started. - -Click **Cancel** to return the values to what they were before the sliders were moved. - -{{% alert color="info" %}} -You can also make use of the **Application Autoscaler** service on SAP BTP. Mendix provides assistance in setting up the parameters needed to configure the application autoscaler. For more information, see [Application Autoscaler for SAP Business Technology Platform](/developerportal/deploy/sap-cloud-platform/sap-autoscaler/). -{{% /alert %}} - -#### Change License Subscription ID - -Click **Change** to change the **Subscription Secret** which is the code which registers your production Mendix license to this environment. - -### Model Options Tab {#model-options-tab} - -This tab displays the application constants and allows you to edit them. It also lets you enable or disable scheduled events. - -{{% alert color="info" %}} -You need to restart your app if you change any of these options. -{{% /alert %}} - -#### Scheduled Events {#schedules-events} - -You can see the status of each scheduled event. **Currently Enabled** shows the status in the running app. **Enabled** shows the status that is applied the next time the app is restarted. - -To change the state of a scheduled event, select it and click **Enable** or **Disable** from **Actions** to change the **Enabled** flag. - -#### Constants - -You can see the value of all the constants used by the app. **Current Value** is the value in the running app. **New Value** is the value which is used the next time the app is restarted. - -To change a value, select the constant you want to change and click the edit ({{% icon name="pencil" %}}) icon. - -### Services Tab {#binding-services} - -This tab displays Cloud Foundry services which are bound to the app, waiting to be bound to the app, or available to be bound to the app. These are the services which are available to you in SAP BTP and are the same services that you can see in the SAP BTP marketplace. - -{{% alert color="warning" %}} -There are a number of services which your Mendix app requires. If you unbind any of these services, your app probably stops working: - -* Destination -* Xsuaa -* Database (PostgreSQL, Hyperscaler Option, or SAP HANA schema) -* Connectivity - -Select, bind, and unbind services through the **Services** page. Changes made in the SAP BTP cockpit are not reflected in the Mendix Portal. -{{% /alert %}} - -{{% alert color="info" %}} -Changes to **Bound Services** do not take place immediately. Stop and start your application to activate the changes. - -Services which are bound when the application is stopped and restarted are listed in the category **Services To Be Bound**. You also see an information message in this case. The button **Review Services** lists the services which are not currently bound. -{{% /alert %}} - -#### Connecting Services - -To connect a service in the **Available Services** section, do the following steps: - -1. Select one or more services (you can search for them by name). -2. Select a **Plan** for each service. This must be a plan which is part of your quota for this space. -3. Select a JSON file to upload if you need to add extra configuration. -4. Click **Connect Selected Services**. You can also **Review Services** before restarting your app. - - {{< figure src="/attachments/deployment/sap-btp/sap-cloud-platform/connect-service.png" alt="" >}} - - The services you have selected will be added as **Services To Be Bound**. Now, you can upload a JSON file with a configuration that will be applied to the service binding. - -{{% alert color="info" %}} -If you use the **PostgreSQL, Hyperscaler Option** service on SAP BTP, Mendix can create a JSON file for you. See [Running Mendix on PostgreSQL, Hyperscaler Option](#sap-hyperscaler). -{{% /alert %}} - -{{% alert color="info" %}} -If you use the **Application Autoscaler** service on SAP BTP, Mendix can create a JSON file for you. See [Application Autoscaler for SAP Business Technology Platform](/developerportal/deploy/sap-cloud-platform/sap-autoscaler/) for more information. -{{% /alert %}} - -To upload the JSON **File** for service binding, follow these steps: - -1. Select the service in the **Service To Be Bound** section. -2. Click the three-dot ({{% icon name="three-dots-menu-horizontal" %}}) icon next to the service for which you want to upload the file. -3. Select **Add Binding Configuration**. -4. Select the JSON **File** to upload and click **Save**. - -The service bindings are created with the provided configurations when you restart the application. - -{{% alert color="info" %}} -If you receive an error and the service fails to bind, check all aspects of your SAP account. The error message may not provide full information about, for example, which plans you are allowed to choose for a particular service. -{{% /alert %}} - -If you receive an error trying to restart the app, refer to the [App Does Not Start](#appnotstart) section below. - -#### Unbinding and Removing Services - -If you no longer require a service, you can unbind it or remove it from your app. - -##### Unbinding a Service - -1. Click the three-dot ({{% icon name="three-dots-menu-horizontal" %}}) icon next to the service you want to unbind in the **Bound Services** section. -1. Select one of the following: - * **Unbind Service** – unbinds the service instance and moves it to the **Services To Be Bound** section. The service is bound again next time your app is restarted. - * **Delete Service** – unbinds the service instance from the application and deletes the service instance from your environment. - -1. If you want to **Delete Service**, confirm by clicking the appropriate button: - - * **Delete & Restart App** – confirms the delete action and restarts the app - * **Delete** – if you want to unbind more services or do not want the change to happen immediately, you can choose **Delete**. However, this may leave the app in an unstable state as the service is deleted from the environment. - * **Cancel** – does not delete or unbind this service - - Once the service is deleted, it is deleted from the app environment and returned to the list of **Available Services**. If the service is unbound but not deleted, it is returned to the list of **Services To Be Bound** and is rebound next time the app is restarted. - -##### Removing an Unbound Service {#unbound-services} - -1. Click the three-dots ({{% icon name="three-dots-menu-horizontal" %}}) icon next to the service you want to remove in the **Services To Be Bound** section. -1. Select **Remove Service** and confirm by clicking **Remove**. - - The service is deleted from the app environment and returned to the list of **Available Services**. - -#### Adding Binding Configuration - -When a service is in the **Services To Be Bound** section, you can add a new binding configuration if this is supported by the service and the Mendix Portal. - -If you want to change the configuration of a service which is already bound, unbind the service first, as described in the [Removing an Unbound Service](#unbound-services) section. - -1. Click the three-dot ({{% icon name="three-dots-menu-horizontal" %}}) icon next to the service you want to (re)configure in the **Services To Be Bound** section. - -2. Select **Add Binding Configuration**. - -3. You can either use the Configurator to create your configuration by clicking **Open Editor**, or click **Browse** to upload an existing file as the configuration. - - {{< figure src="/attachments/deployment/sap-btp/sap-cloud-platform/add-binding-config.png" alt="" >}} - - See the documentation for the service you are configuring for more information. - -#### Service Names - -The services which are created by the Mendix Portal are named automatically. You can see these names in the SAP BTP cockpit. Normally, the name of the service is **App name** + **_** + **Environment Name** + **_** + **a random six-character suffix**. All spaces are removed from the app and environment names. For example, `MyApp_Development_c7sd9q`. - -However, the maximum length for the service name is 50 characters. If this limit would be exceeded by the name created above, an alternative service name is used. The format of this is **Environment Name** + **_** + **a random six-character suffix**. If the Environment name is longer than 43 characters, only the first 43 characters are used. - -### Runtime Tab {#runtime-tab} - -In the **Runtime** tab, you can **Add**, edit ({{% icon name="pencil" %}}), or delete custom runtime settings and environment variables. - -{{% alert color="info" %}} -New values are only applied when you restart your app. The value which is currently applied is shown under **Current Value**. -{{% /alert %}} - -#### Custom Runtime Settings - -You can add custom server settings which configure Mendix Runtime beyond the standard SAP deployment. See [Runtime Customization](/refguide/custom-settings/) and the [Mendix Cloud Foundry Buildpack GitHub repository](https://github.com/mendix/cf-mendix-buildpack#mendix-runtime-configuration) for information about the settings which are available. - -#### Custom Environment Variables - -##### Supported Environment Variables - -You can add supported variables by selecting them from a dropdown list. - -* **DT_PAAS_TOKEN** – the token for integrating your Dynatrace environment with Cloud Foundry -* **DT_SAAS_URL** – the monitoring endpoint URL of the Dynatrace service -* **DT_TENANT** – the unique identifier of your Dynatrace environment -* **DT_IS_MANAGED** – a variable to enable metrics integration for DT Managed -* **DT_CLUSTER_ID** – tag your cluster, process group, or deployment group -* **DT_CUSTOM_PROP** – provide metadata for your process group -* **NON_MENDIX_PUBLIC_CLOUD** – must be set to **true** when using Datadog, Dynatrace, or other similar tools - -The variables beginning with **DT_** set up Dynatrace. Setting these variables means that the Dynatrace OneAgent is loaded into your environment. You receive all Java-related metrics from your app. See [Dynatrace OneAgent](https://www.dynatrace.com/support/help/setup-and-configuration/dynatrace-oneagent/) for more information. - -##### Unsupported Environment Variables - -You can also enter other environment variables which can be used to support Mendix features which are in beta. In this case, click **No** for **Supported?**, and enter the **Name** of the variable and **New Value**. - -{{% alert color="info" %}} -Only use unsupported environment variables if you know exactly what you are doing. Incorrect values can prevent the Mendix Runtime from starting. -{{% /alert %}} - -## Databases in SAP BTP {#databases} - -Mendix needs access to a relational database back end and can run using different types of database. For deployment to SAP BTP, you have the choice of PostgreSQL, Hyperscaler Option, or SAP HANA. - -### Running Mendix on PostgreSQL, Hyperscaler Option {#sap-hyperscaler} - -{{% alert color="info" %}} -SAP has removed some of the PostgreSQL databases available in their marketplace. If you need a PostgreSQL database, you will have to use PostgreSQL, Hyperscaler Option as your database. This requires some extra configuration which is described below. Alternatively, you can use [SAP HANA](#sap-hana). -{{% /alert %}} - -Select the **postgresql-db** (PostgreSQL, Hyperscaler Option) database service from the **Available Services**. - -{{< figure src="/attachments/deployment/sap-btp/sap-cloud-platform/postgresql-service.png" alt="" >}} - -Upload a file which contains the configuration for this database. Click **Browse** to select your configuration file. You can use the [SAP Hyperscaler PostgreSQL Configurator](#postgresql-configurator) to help you create the configuration file. For more information, refer to the [Parameters](https://help.sap.com/viewer/b3fe3621fa4a4ed28d7bbe3d6d88f036/Cloud/en-US/0630e03aa45d479eaf806c564dc2447a.html) section of *PostgreSQL on SAP Business Technology Platform, Hyperscaler Option*. - -During the creation of the environment, the selected PostgreSQL, Hyperscaler Option service is added to your space. When you deploy your app, the app is bound to it. - -This database service should not be unbound from your environment. For more information on required services, see the [Services Tab](#binding-services) above. - -#### SAP Hyperscaler PostgreSQL Configurator {#postgresql-configurator} - -To get help to create the configuration file, click **Configurator**. - -You can set the required values for your **SAP Hyperscaler PostgreSQL** database. Tooltips describe the values which you need to provide. - -{{< figure src="/attachments/deployment/sap-btp/sap-cloud-platform/postgresql-configurator.png" alt="" >}} - -{{% alert color="warning" %}} -There is no validation on the value of the **Source Instance ID** or **Restore Time** you enter for Standard or Premium plans. If you have issues, check that you entered the correct value here. -{{% /alert %}} - -Click **Upload Configuration To Service** to automatically apply the generated configuration to the PostgreSQL, Hyperscaler Option database service. Alternatively, click **Download Configuration File** to create the file which you can then use on the **Services** tab to configure your PostgreSQL, Hyperscaler Option database. - -### Running Mendix on SAP HANA {#sap-hana} - -{{% alert color="info" %}} -You can only use SAP HANA as the Mendix database for Mendix V7.23.3 and above. - -There are also some differences in the way that Mendix can be used with SAP HANA compared to a PostgreSQL, Hyperscaler Option database. For more information, see [SAP HANA – Known Issues](/refguide/saphana/). -{{% /alert %}} - -#### SAP HANA Configuration for Full Accounts - -To run a Mendix application on SAP BTP using SAP HANA as the database, there are two options. Both options need to be set up in the SAP BTP cockpit. You can choose one of the following options: - -* Provision the SAP HANA DB Service and make it available in your application space. -* Provision SAP HANA Cloud and make this service available to your application space. - -Once one of these services is available, you can use the SAP Cloud deployment functions of the Mendix Portal to deploy your app and use the **HANA_SCHEMA** service to bind your application to the provisioned service. The HANA_SCHEMA creates a separate schema on the SAP HANA Database which isolates your application's data from other applications. In this way, the SAP HANA DB/Cloud Service is shared across applications. - -{{% alert color="warning" %}} - -* Do not attempt to add the SAP HANA *service* to your app. It is the SAP HANA *schema* which needs to be bound to your app. - -* Do not use the **Services** tab or the SAP BTP Marketplace to add both a PostgreSQL, Hyperscaler Option database and an SAP HANA schema to your app. If you do this, it is not possible to predict which database your Mendix app will choose to bind. -{{% /alert %}} - -If you have issues with your app running on SAP HANA, use the SAP BTP cockpit to investigate. The Mendix Portal does not have information on the status or configuration of the SAP HANA service. - -#### SAP HANA Configuration for Trial Accounts - -For new trial accounts, you can bind your Mendix app to a trial SAP HANA database. Choose **hanatrial-securestore** from the drop-down of supported databases. - -{{< figure src="/attachments/deployment/sap-btp/sap-cloud-platform/hanatrial.png" alt="" >}} - -Some older trial accounts do not include `hanatrial-securestore`. In this case, you can get an error when you try to deploy your Mendix app saying that *provisioning has failed because service hanatrial with plan securestore is not found*. - -#### SAP HANA Performance Tuning - -If your SAP HANA database has performance issues, you can improve it by performing the following tuning: - -1. Obtain the following service binding credentials from the **Environment Variables** of SAP BTP cockpit, or via the CLI: - - * Host - * Url - * Schema - * Password - * User - -1. Go to the [Runtime tab](#runtime-tab) of your app environment. -1. Enter the following unsupported environment variables with the associated values, using the values taken from the service binding credentials: - - | Variable | Value | - | --- | --- | - | MXRUNTIME_DatabaseHost | {host} | - | MXRUNTIME_DatabaseJdbcUrl | {url} + `&nonBlockingIO=false&timeZonePerObject=false&packetSize=130000&closeHandlesByCleaner=false&transactionalLobs=false&maxLazyDroppedStatements=100&statementCacheSize=500&deferredPrepared=true` | - | MXRUNTIME_DatabaseName | {schema} | - | MXRUNTIME_DatabasePassword | {password} | - | MXRUNTIME_DatabaseUserName | {user} | - | MXRUNTIME_DatabaseType | `SAPHANA` | - -1. Go to the [General tab](#general-tab) and restart your app to apply the changes. - -The additional parameters that you added to the URL in the `MXRUNTIME_DatabaseJdbcUrl` set the following tuning parameters: - -| Parameter | Value | -| --- | --- | -| closeHandlesByCleaner | false | -| deferredPrepare | true | -| maxLazyDroppedStatements | 100 | -| nonBlockingIO | false | -| packetSize | 130000 | -| statementCacheSize | 500 | -| timeZonePerObject | false | -| transactionalLobs | false | +2. When the application has been started, you are taken to the **Environment Details** page for the selected environment. See [Environment Details](/developerportal/deploy/sap-cloud-platform/environments/). ## Deleting an App @@ -664,7 +309,7 @@ Since SAP Application Logging will soon be deprecated, migrate your logging serv 1. Select the appropriate **Plan** and upload a file if required. 1. Click **Connect Selected Services** and restart your application to bind the new SAP Cloud logging service. 1. At this point, both the **application-logs** and **cloud-logging** services are active for your application. -1. Retain the **application-logs** service until its log retention period ends to ensure access to existing log entries. Then, delete it following the instructions provided in the [Unbinding and Removing Services](#unbinding-and-removing-services) section. After this, only the new SAP Cloud Logging service remains active. +1. Retain the **application-logs** service until its log retention period ends to ensure access to existing log entries. Then, delete it following the instructions provided in the [Unbinding and Removing Services](/developerportal/deploy/sap-cloud-platform/environments/#unbinding-and-removing-services) section. After this, only the new SAP Cloud Logging service remains active. 1. When using the **cloud-logging** service, upgrade **SapApplicationLogs** to the latest version. If you are using an older version, update the **Default Value** of the **ApplicationLoggingService** constant to *cloud-logging* in the [SAP Logging Connector](https://marketplace.mendix.com/link/component/110219). For more information, refer to the [Using the Connector](/appstore/modules/sap/sap-logger/#using-the-connector) section of *SAP Logging Connector*. 1. You can view the logs of an environment using SAP Cloud Logging in your application's logs. For more details, see the [Viewing the Logs](/developerportal/deploy/sap-cloud-platform/sap-monitoring/#viewing-the-logs) section of *Monitoring Environments in Mendix Apps on SAP BTP*. @@ -672,7 +317,7 @@ Since SAP Application Logging will soon be deprecated, migrate your logging serv If you encounter any issues with your apps on SAP BTP, use the following troubleshooting tips to help you solve them. -### Environment is not Created +### Environment Is Not Created If you add an environment and it fails to be created, it will be shown with a red symbol next to it on the Environments page: @@ -714,7 +359,7 @@ If an app is deployed to SAP using the Studio Pro **Run** or **Publish** button #### Cause -The deployment fails because the marketplace services have not been bound. +The deployment fails because the Marketplace services have not been bound. #### Solution @@ -734,7 +379,7 @@ Starting from Mendix 9.7, support for `statsd` is removed. #### Solution -1. In the [Runtime tab](/developerportal/deploy/sap-cloud-platform/#runtime-tab), in the **Custom Environment Variables** section, add a new variable with the following settings: +1. In the [Runtime tab](/developerportal/deploy/sap-cloud-platform/environments/#runtime-tab), in the **Custom Environment Variables** section, add a new variable with the following settings: * **Supported** – select **Yes** * **Name** – select **NON_MENDIX_PUBLIC_CLOUD** diff --git a/content/en/docs/deployment/sap-btp/sap-autoscaler.md b/content/en/docs/deployment/sap-btp/sap-autoscaler.md index 50fd752cfcd..e2f8f98663a 100644 --- a/content/en/docs/deployment/sap-btp/sap-autoscaler.md +++ b/content/en/docs/deployment/sap-btp/sap-autoscaler.md @@ -2,7 +2,7 @@ title: "Application Autoscaler for SAP Business Technology Platform" linktitle: "Application Autoscaler for SAP BTP" url: /developerportal/deploy/sap-cloud-platform/sap-autoscaler/ -weight: 47 +weight: 70 description: "How to set up the SAP Autoscaler" aliases: - /partners/sap/sap-autoscaler/ @@ -16,7 +16,7 @@ For more information on the application autoscaler, see [Application Autoscaler ## Binding the Application Autoscaler{#binding} -The **autoscaler** service can be found on the [Services Tab](/developerportal/deploy/sap-cloud-platform/#binding-services) of the environment details page of your app's environment. +The **autoscaler** service can be found on the [Services Tab](/developerportal/deploy/sap-cloud-platform/environments/#binding-services) of the environment details page of your app's environment. Selecting the **autoscaler** service expands the entry to allow you to enter more details about the service you wish to bind, namely the **Plan** and the file which contains the configuration. diff --git a/content/en/docs/deployment/sap-btp/sap-cloud-connector.md b/content/en/docs/deployment/sap-btp/sap-cloud-connector.md index 2a1770709f7..49cac6019f8 100644 --- a/content/en/docs/deployment/sap-btp/sap-cloud-connector.md +++ b/content/en/docs/deployment/sap-btp/sap-cloud-connector.md @@ -1,7 +1,7 @@ --- title: "SAP Cloud Connector" url: /developerportal/deploy/sap-cloud-platform/sap-cloud-connector/ -weight: 28 +weight: 60 description: "Presents reference information on the SAP Cloud Connector." aliases: - /partners/sap/sap-cloud-connector/ diff --git a/content/en/docs/deployment/sap-btp/sap-databases.md b/content/en/docs/deployment/sap-btp/sap-databases.md new file mode 100644 index 00000000000..6e9ad3c8326 --- /dev/null +++ b/content/en/docs/deployment/sap-btp/sap-databases.md @@ -0,0 +1,116 @@ +--- +title: "Databases in SAP BTP" +linktitle: "Databases in SAP BTP" +url: /developerportal/deploy/sap-cloud-platform/databases +weight: 20 +description: "Describes different types of databases for SAP Business Technology Platform." +#To update these screenshots, you can log in with credentials detailed in How to Update Screenshots Using Team Apps. +#If moving or renaming this doc file, implement a temporary redirect and let the respective team know they should update the URL in the product. See Mapping to Products for more details. +--- + +## Introduction + +Mendix needs access to a relational database back end and can run using different types of database. For deployment to SAP BTP, you have the choice of PostgreSQL, Hyperscaler Option, or SAP HANA. + +### Running Mendix on PostgreSQL, Hyperscaler Option {#sap-hyperscaler} + +{{% alert color="info" %}} +SAP has removed some of the PostgreSQL databases available in their Marketplace. If you need a PostgreSQL database, you will have to use PostgreSQL, Hyperscaler Option as your database. This requires some extra configuration which is described below. Alternatively, you can use [SAP HANA](#sap-hana). +{{% /alert %}} + +Select the **postgresql-db** (PostgreSQL, Hyperscaler Option) database service from the **Available Services**. + +{{< figure src="/attachments/deployment/sap-btp/sap-cloud-platform/postgresql-service.png" alt="" >}} + +Upload a file which contains the configuration for this database. Click **Browse** to select your configuration file. You can use the [SAP Hyperscaler PostgreSQL Configurator](#postgresql-configurator) to help you create the configuration file. For more information, refer to the [Parameters](https://help.sap.com/viewer/b3fe3621fa4a4ed28d7bbe3d6d88f036/Cloud/en-US/0630e03aa45d479eaf806c564dc2447a.html) section of *PostgreSQL on SAP Business Technology Platform, Hyperscaler Option*. + +During the creation of the environment, the selected PostgreSQL, Hyperscaler Option service is added to your space. When you deploy your app, the app is bound to it. + +This database service should not be unbound from your environment. For more information on required services, see the [Services Tab](/developerportal/deploy/sap-cloud-platform/environments/#binding-services). + +#### SAP Hyperscaler PostgreSQL Configurator {#postgresql-configurator} + +To get help to create the configuration file, click **Configurator**. + +You can set the required values for your **SAP Hyperscaler PostgreSQL** database. Tooltips describe the values which you need to provide. + +{{< figure src="/attachments/deployment/sap-btp/sap-cloud-platform/postgresql-configurator.png" alt="" >}} + +{{% alert color="warning" %}} +There is no validation on the value of the **Source Instance ID** or **Restore Time** you enter for Standard or Premium plans. If you have issues, check that you entered the correct value here. +{{% /alert %}} + +Click **Upload Configuration To Service** to automatically apply the generated configuration to the PostgreSQL, Hyperscaler Option database service. Alternatively, click **Download Configuration File** to create the file which you can then use on the **Services** tab to configure your PostgreSQL, Hyperscaler Option database. + +### Running Mendix on SAP HANA {#sap-hana} + +{{% alert color="info" %}} +You can only use SAP HANA as the Mendix database for Mendix V7.23.3 and above. + +There are also some differences in the way that Mendix can be used with SAP HANA compared to a PostgreSQL, Hyperscaler Option database. For more information, see [SAP HANA – Known Issues](/refguide/saphana/). +{{% /alert %}} + +#### SAP HANA Configuration for Full Accounts + +To run a Mendix application on SAP BTP using SAP HANA as the database, there are two options. Both options need to be set up in the SAP BTP cockpit. You can choose one of the following options: + +* Provision the SAP HANA DB Service and make it available in your application space. +* Provision SAP HANA Cloud and make this service available to your application space. + +Once one of these services is available, you can use the SAP Cloud deployment functions of the Mendix Portal to deploy your app and use the **HANA_SCHEMA** service to bind your application to the provisioned service. The HANA_SCHEMA creates a separate schema on the SAP HANA Database which isolates your application's data from other applications. In this way, the SAP HANA DB/Cloud Service is shared across applications. + +{{% alert color="warning" %}} + +* Do not attempt to add the SAP HANA *service* to your app. It is the SAP HANA *schema* which needs to be bound to your app. + +* Do not use the **Services** tab or the SAP BTP Marketplace to add both a PostgreSQL, Hyperscaler Option database and an SAP HANA schema to your app. If you do this, it is not possible to predict which database your Mendix app will choose to bind. +{{% /alert %}} + +If you have issues with your app running on SAP HANA, use the SAP BTP cockpit to investigate. The Mendix Portal does not have information on the status or configuration of the SAP HANA service. + +#### SAP HANA Configuration for Trial Accounts + +For new trial accounts, you can bind your Mendix app to a trial SAP HANA database. Choose **hanatrial-securestore** from the drop-down of supported databases. + +{{< figure src="/attachments/deployment/sap-btp/sap-cloud-platform/hanatrial.png" alt="" >}} + +Some older trial accounts do not include `hanatrial-securestore`. In this case, you can get an error when you try to deploy your Mendix app saying that *provisioning has failed because service hanatrial with plan securestore is not found*. + +#### SAP HANA Performance Tuning + +If your SAP HANA database has performance issues, you can improve it by performing the following tuning: + +1. Obtain the following service binding credentials from the **Environment Variables** of SAP BTP cockpit, or via the CLI: + + * Host + * Url + * Schema + * Password + * User + +1. Go to the [Runtime tab](/developerportal/deploy/sap-cloud-platform/environments/#runtime-tab) of your app environment. +1. Enter the following unsupported environment variables with the associated values, using the values taken from the service binding credentials: + + | Variable | Value | + | --- | --- | + | MXRUNTIME_DatabaseHost | {host} | + | MXRUNTIME_DatabaseJdbcUrl | {url} + `&nonBlockingIO=false&timeZonePerObject=false&packetSize=130000&closeHandlesByCleaner=false&transactionalLobs=false&maxLazyDroppedStatements=100&statementCacheSize=500&deferredPrepared=true` | + | MXRUNTIME_DatabaseName | {schema} | + | MXRUNTIME_DatabasePassword | {password} | + | MXRUNTIME_DatabaseUserName | {user} | + | MXRUNTIME_DatabaseType | `SAPHANA` | + +1. Go to the [General tab](/developerportal/deploy/sap-cloud-platform/environments/#general-tab) and restart your app to apply the changes. + +The additional parameters that you added to the URL in the `MXRUNTIME_DatabaseJdbcUrl` set the following tuning parameters: + +| Parameter | Value | +| --- | --- | +| closeHandlesByCleaner | false | +| deferredPrepare | true | +| maxLazyDroppedStatements | 100 | +| nonBlockingIO | false | +| packetSize | 130000 | +| statementCacheSize | 500 | +| timeZonePerObject | false | +| transactionalLobs | false | diff --git a/content/en/docs/deployment/sap-btp/sap-destination-service.md b/content/en/docs/deployment/sap-btp/sap-destination-service.md index 8c62edd23b9..6ceddd854fc 100644 --- a/content/en/docs/deployment/sap-btp/sap-destination-service.md +++ b/content/en/docs/deployment/sap-btp/sap-destination-service.md @@ -1,7 +1,7 @@ --- title: "SAP Destination Service" url: /developerportal/deploy/sap-cloud-platform/sap-destination-service/ -weight: 20 +weight: 40 description: "Reference for using SAP Destination Services within the OData Connector for SAP solutions." aliases: - /partners/sap/sap-destination-service/ diff --git a/content/en/docs/deployment/sap-btp/sap-destination-with-rest.md b/content/en/docs/deployment/sap-btp/sap-destination-with-rest.md index e5a50acfb38..df8ff33abae 100644 --- a/content/en/docs/deployment/sap-btp/sap-destination-with-rest.md +++ b/content/en/docs/deployment/sap-btp/sap-destination-with-rest.md @@ -2,7 +2,7 @@ title: "Use SAP Connectivity Service with REST and SOAP" linktitle: "Use SAP Connectivity Service with REST and SOAP" url: /developerportal/deploy/sap-cloud-platform/sap-destination-with-rest/ -weight: 25 +weight: 50 description: "How to configure Mendix native REST and SOAP calls to use the SAP Destination Service and the SAP Connectivity Service to reach on-premises services." aliases: - /partners/sap/sap-destination-with-rest/ diff --git a/content/en/docs/deployment/sap-btp/sap-environments.md b/content/en/docs/deployment/sap-btp/sap-environments.md new file mode 100644 index 00000000000..d942036cd69 --- /dev/null +++ b/content/en/docs/deployment/sap-btp/sap-environments.md @@ -0,0 +1,265 @@ +--- +title: "Environment Details on SAP BTP" +linktitle: "Environment Details on SAP BTP" +url: /developerportal/deploy/sap-cloud-platform/environments +weight: 10 +description: "Describes SAP Business Technology Platform Environment Details." +#To update these screenshots, you can log in with credentials detailed in How to Update Screenshots Using Team Apps. +#If moving or renaming this doc file, implement a temporary redirect and let the respective team know they should update the URL in the product. See Mapping to Products for more details. +--- + +## Introduction + +The **Environment Details** page is the central location for configuring and managing your Mendix app environments on SAP BTP. This page provides access to deployment settings, service bindings, runtime configuration, and operational controls for each environment. + +Use the **Environment Details** page to configure how your app runs, manage Cloud Foundry services, set environment variables, and monitor your app's status. Changes made here persist across deployments and override any temporary changes made directly in the SAP BTP cockpit. + +{{% alert color="info" %}} +To access the Environment Details page, go to **Environments** in [Apps](https://sprintr.home.mendix.com/) and click the details ({{% icon name="pencil-write-paper" %}}) icon next to your environment. You will also be taken to this page when you successfully deploy or transport your app. +{{% /alert %}} + +## Environment Details {#EnvironmentDetails} + +The environment details page contains the following tabs: + +* [General](#general-tab) – how the application is deployed on SAP BTP +* [Model Options](#model-options-tab) – application constants and scheduled events +* [Services](#binding-services) – Cloud Foundry service management +* [Runtime](#runtime-tab) – custom environment variables which define **User-Provided Variables** in the SAP Cloud Foundry environment — pre-defined variables can be used to control the behavior of the Mendix Runtime + +{{< figure src="/attachments/deployment/sap-btp/sap-env-details/env-details.png" alt="" >}} + +{{% alert color="info" %}}If you make changes to your app which you want to be applied next time the app is deployed, you must make them in the **Environment Details**. + +Changes made to the app in the SAP BTP cockpit are only temporary and can be overwritten by the values in the Mendix Portal next time the app is deployed.{{% /alert %}} + +### General Tab {#general-tab} + +This tab contains information on how the application is deployed on SAP BTP. Most of this page shows information about the app, but there are several options which allow you to change the app. + +#### Start and Stop Application + +If the application is running, click **Stop Application** and confirm when asked to stop the application. + +The button will change to **Start Application** which you can click to start or restart the application. + +{{% alert color="info" %}} +You may need to use this option to stop and start your app after changing one of the settings on this page. +{{% /alert %}} + +If you receive an error trying to start the app, refer to the [App Does Not Start](/developerportal/deploy/sap-cloud-platform/#appnotstart) section below. + +#### Change Admin Password + +Find the three-dots ({{% icon name="three-dots-menu-horizontal" %}}) icon and click **Change Admin Password** to change the password for the administrator account (by default, MxAdmin) in your Mendix app. + +{{% alert color="warning" %}} +The new password will not come into effect until you stop and start your environment. +{{% /alert %}} + +#### View Recent Log + +Click the three-dots ({{% icon name="three-dots-menu-horizontal" %}}) icon and select **View Recent Log** to see recent events written to the log. + +#### Delete Environment + +**Delete Environment** enables you to delete the environment and, optionally, all its resources, including the app. + +You are asked to confirm that this environment should be removed. You are also asked to confirm that the resources associated with the environment should also be removed. Note that the default is not to remove the resources. + +{{% alert color="info" %}} +If you do not select **Remove resources** in the dialog, the resources are left in SAP BTP. This is useful if you want to remove the environment but a resource cannot be removed. In this case, the resources can only be removed individually from within the SAP BTP cockpit. +{{% /alert %}} + +#### Change Development Mode + +Click **Change** to change the **Development Mode**. Set it to *Yes* if you want the application to run with only prototype security, or completely without security. This is not recommended for acceptance or production environments. + +#### Change App URL + +Click **Change** to change the **App URL** for this environment. + +#### Change Redirect URLs + +Click **Change** to change the **Redirect URLs**. Redirect URLs are custom URLs (for example, `appname.subdomain.domain.com`) where the user will be redirected after signing on using XSUAA, instead of being redirected to the generated URL (for example, `appname.cfapps.eu10.hana.ondemand.com`) of the app. + +#### Scaling + +If the app is started or stopped (that is, the environment has been created successfully and the app has been deployed without errors), options to scale the app are available. + +Use the **Instances** slider to change the number of instances of the app which can run. This allows you to scale the app horizontally to support large numbers of users, or to improve the app's resilience by allowing it to continue to run if there are any issues with one of the instances. + +Use the **Memory per instance** slider to change the amount of memory allocated to each instance of the app. + +Click **Scale Now** to apply the new settings. If the application is running, it is stopped and restarted to apply the settings. If it is stopped, it is not started automatically. The new settings are used the next time the application is started. + +Click **Cancel** to return the values to what they were before the sliders were moved. + +{{% alert color="info" %}} +You can also make use of the **Application Autoscaler** service on SAP BTP. Mendix provides assistance in setting up the parameters needed to configure the application autoscaler. For more information, see [Application Autoscaler for SAP Business Technology Platform](/developerportal/deploy/sap-cloud-platform/sap-autoscaler/). +{{% /alert %}} + +#### Change License Subscription ID + +Click **Change** to change the **Subscription Secret** which is the code which registers your production Mendix license to this environment. + +### Model Options Tab {#model-options-tab} + +This tab displays the application constants and allows you to edit them. It also lets you enable or disable scheduled events. + +{{% alert color="info" %}} +You need to restart your app if you change any of these options. +{{% /alert %}} + +#### Scheduled Events {#schedules-events} + +You can see the status of each scheduled event. **Currently Enabled** shows the status in the running app. **Enabled** shows the status that is applied the next time the app is restarted. + +To change the state of a scheduled event, select it and click **Enable** or **Disable** from **Actions** to change the **Enabled** flag. + +#### Constants + +You can see the value of all the constants used by the app. **Current Value** is the value in the running app. **New Value** is the value which is used the next time the app is restarted. + +To change a value, select the constant you want to change and click the edit ({{% icon name="pencil" %}}) icon. + +### Services Tab {#binding-services} + +This tab displays Cloud Foundry services which are bound to the app, waiting to be bound to the app, or available to be bound to the app. These are the services which are available to you in SAP BTP and are the same services that you can see in the SAP BTP Marketplace. + +{{% alert color="warning" %}} +There are a number of services which your Mendix app requires. If you unbind any of these services, your app probably stops working: + +* Destination +* Xsuaa +* Database (PostgreSQL, Hyperscaler Option, or SAP HANA schema) +* Connectivity + +Select, bind, and unbind services through the **Services** page. Changes made in the SAP BTP cockpit are not reflected in the Mendix Portal. +{{% /alert %}} + +{{% alert color="info" %}} +Changes to **Bound Services** do not take place immediately. Stop and start your application to activate the changes. + +Services which are bound when the application is stopped and restarted are listed in the category **Services To Be Bound**. You also see an information message in this case. The button **Review Services** lists the services which are not currently bound. +{{% /alert %}} + +#### Connecting Services + +To connect a service in the **Available Services** section, do the following steps: + +1. Select one or more services (you can search for them by name). +2. Select a **Plan** for each service. This must be a plan which is part of your quota for this space. +3. Select a JSON file to upload if you need to add extra configuration. +4. Click **Connect Selected Services**. You can also **Review Services** before restarting your app. + + {{< figure src="/attachments/deployment/sap-btp/sap-env-details/autoscaler-service.png" alt="" >}} + + The services you have selected will be added as **Services To Be Bound**. Now, you can upload a JSON file with a configuration that will be applied to the service binding. + +{{% alert color="info" %}} +If you use the **PostgreSQL, Hyperscaler Option** service on SAP BTP, Mendix can create a JSON file for you. See [Running Mendix on PostgreSQL, Hyperscaler Option](/developerportal/deploy/sap-cloud-platform/databases/#sap-hyperscaler). +{{% /alert %}} + +{{% alert color="info" %}} +If you use the **Application Autoscaler** service on SAP BTP, Mendix can create a JSON file for you. See [Application Autoscaler for SAP Business Technology Platform](/developerportal/deploy/sap-cloud-platform/sap-autoscaler/) for more information. +{{% /alert %}} + +To upload the JSON **File** for service binding, follow these steps: + +1. Select the service in the **Service To Be Bound** section. +2. Click the three-dot ({{% icon name="three-dots-menu-horizontal" %}}) icon next to the service for which you want to upload the file. +3. Select **Add Binding Configuration**. +4. Select the JSON **File** to upload and click **Save**. + +The service bindings are created with the provided configurations when you restart the application. + +{{% alert color="info" %}} +If you receive an error and the service fails to bind, check all aspects of your SAP account. The error message may not provide full information about, for example, which plans you are allowed to choose for a particular service. +{{% /alert %}} + +If you receive an error trying to restart the app, refer to the [App Does Not Start](/developerportal/deploy/sap-cloud-platform/#appnotstart) section below. + +#### Unbinding and Removing Services + +If you no longer require a service, you can unbind it or remove it from your app. + +##### Unbinding a Service + +1. Click the three-dot ({{% icon name="three-dots-menu-horizontal" %}}) icon next to the service you want to unbind in the **Bound Services** section. +1. Select one of the following: + * **Unbind Service** – unbinds the service instance and moves it to the **Services To Be Bound** section. The service is bound again next time your app is restarted. + * **Delete Service** – unbinds the service instance from the application and deletes the service instance from your environment. + +1. If you want to **Delete Service**, confirm by clicking the appropriate button: + + * **Delete & Restart App** – confirms the delete action and restarts the app + * **Delete** – if you want to unbind more services or do not want the change to happen immediately, you can choose **Delete**. However, this may leave the app in an unstable state as the service is deleted from the environment. + * **Cancel** – does not delete or unbind this service + + Once the service is deleted, it is deleted from the app environment and returned to the list of **Available Services**. If the service is unbound but not deleted, it is returned to the list of **Services To Be Bound** and is rebound next time the app is restarted. + +##### Removing an Unbound Service {#unbound-services} + +1. Click the three-dots ({{% icon name="three-dots-menu-horizontal" %}}) icon next to the service you want to remove in the **Services To Be Bound** section. +1. Select **Remove Service** and confirm by clicking **Remove**. + +The service is deleted from the app environment and returned to the list of **Available Services**. + +#### Adding Binding Configuration + +When a service is in the **Services To Be Bound** section, you can add a new binding configuration if this is supported by the service and the Mendix Portal. + +If you want to change the configuration of a service which is already bound, unbind the service first, as described in the [Removing an Unbound Service](#unbound-services) section. + +1. Click the three-dot ({{% icon name="three-dots-menu-horizontal" %}}) icon next to the service you want to (re)configure in the **Services To Be Bound** section. + +2. Select **Add Binding Configuration**. + +3. You can either use the Configurator to create your configuration by clicking **Open Editor**, or click **Browse** to upload an existing file as the configuration. + + {{< figure src="/attachments/deployment/sap-btp/sap-env-details/add-binding-config.png" alt="" >}} + + See the documentation for the service you are configuring for more information. + +#### Service Names + +The services which are created by the Mendix Portal are named automatically. You can see these names in the SAP BTP cockpit. Normally, the name of the service is **App name** + **_** + **Environment Name** + **_** + **a random six-character suffix**. All spaces are removed from the app and environment names. For example, `MyApp_Development_c7sd9q`. + +However, the maximum length for the service name is 50 characters. If this limit would be exceeded by the name created above, an alternative service name is used. The format of this is **Environment Name** + **_** + **a random six-character suffix**. If the Environment name is longer than 43 characters, only the first 43 characters are used. + +### Runtime Tab {#runtime-tab} + +In the **Runtime** tab, you can **Add**, edit ({{% icon name="pencil" %}}), or delete custom runtime settings and environment variables. + +{{% alert color="info" %}} +New values are only applied when you restart your app. The value which is currently applied is shown under **Current Value**. +{{% /alert %}} + +#### Custom Runtime Settings + +You can add custom server settings which configure Mendix Runtime beyond the standard SAP deployment. See [Runtime Customization](/refguide/custom-settings/) and the [Mendix Cloud Foundry Buildpack GitHub repository](https://github.com/mendix/cf-mendix-buildpack#mendix-runtime-configuration) for information about the settings which are available. + +#### Custom Environment Variables + +##### Supported Environment Variables + +You can add supported variables by selecting them from a dropdown list. + +* **DT_PAAS_TOKEN** – the token for integrating your Dynatrace environment with Cloud Foundry +* **DT_SAAS_URL** – the monitoring endpoint URL of the Dynatrace service +* **DT_TENANT** – the unique identifier of your Dynatrace environment +* **DT_IS_MANAGED** – a variable to enable metrics integration for DT Managed +* **DT_CLUSTER_ID** – tag your cluster, process group, or deployment group +* **DT_CUSTOM_PROP** – provide metadata for your process group +* **NON_MENDIX_PUBLIC_CLOUD** – must be set to **true** when using Datadog, Dynatrace, or other similar tools + +The variables beginning with **DT_** set up Dynatrace. Setting these variables means that the Dynatrace OneAgent is loaded into your environment. You receive all Java-related metrics from your app. See [Dynatrace OneAgent](https://www.dynatrace.com/support/help/setup-and-configuration/dynatrace-oneagent/) for more information. + +##### Unsupported Environment Variables + +You can also enter other environment variables which can be used to support Mendix features which are in beta. In this case, click **No** for **Supported?**, and enter the **Name** of the variable and **New Value**. + +{{% alert color="info" %}} +Only use unsupported environment variables if you know exactly what you are doing. Incorrect values can prevent the Mendix Runtime from starting. +{{% /alert %}} diff --git a/content/en/docs/deployment/sap-btp/sap-monitoring.md b/content/en/docs/deployment/sap-btp/sap-monitoring.md index 1746bb75434..a6923101ebc 100644 --- a/content/en/docs/deployment/sap-btp/sap-monitoring.md +++ b/content/en/docs/deployment/sap-btp/sap-monitoring.md @@ -1,7 +1,7 @@ --- title: "Monitoring Environments in Mendix Apps on SAP BTP" url: /developerportal/deploy/sap-cloud-platform/sap-monitoring/ -weight: 19 +weight: 30 description: "Presents reference information on logging and monitoring for Mendix apps running on SAP BTO." --- diff --git a/content/en/docs/deployment/sap-btp/sap-single-sign-on.md b/content/en/docs/deployment/sap-btp/sap-single-sign-on.md index ffb8d880497..1d7451f3696 100644 --- a/content/en/docs/deployment/sap-btp/sap-single-sign-on.md +++ b/content/en/docs/deployment/sap-btp/sap-single-sign-on.md @@ -1,7 +1,7 @@ --- title: "SAP Single Sign-On" url: /developerportal/deploy/sap-cloud-platform/sap-single-sign-on/ -weight: 50 +weight: 80 description: "Reference information on SAP Single Sign-On" aliases: - /partners/sap/sap-single-sign-on/ diff --git a/content/en/docs/developerportal/deployment.md b/content/en/docs/developerportal/deployment.md index a4e7fab24dc..7b3a4392ec1 100644 --- a/content/en/docs/developerportal/deployment.md +++ b/content/en/docs/developerportal/deployment.md @@ -23,7 +23,7 @@ For details on the **Environments** pages for Mendix Cloud, Mendix on Kubernetes * Mendix Cloud deployments – [Environments](/developerportal/deploy/environments/) * Mendix on Kubernetes deployments – [Deploying a Mendix App to a Mendix on Kubernetes Cluster](/developerportal/deploy/private-cloud-deploy/#environment-details) -* SAP deployments – [SAP Business Technology Platform](/developerportal/deploy/sap-cloud-platform/#EnvironmentDetails) +* SAP deployments – [SAP Business Technology Platform](/developerportal/deploy/sap-cloud-platform/environments/) Other platforms are not currently supported on the **Environments** page; instead, you must go to the relevant platform portal to monitor and configure your environments. diff --git a/content/en/docs/howto9/monitoring-troubleshooting/manage-app-performance/_index.md b/content/en/docs/howto9/monitoring-troubleshooting/manage-app-performance/_index.md index 8c2051ce6cf..4e411260cff 100644 --- a/content/en/docs/howto9/monitoring-troubleshooting/manage-app-performance/_index.md +++ b/content/en/docs/howto9/monitoring-troubleshooting/manage-app-performance/_index.md @@ -25,5 +25,5 @@ Outside Mendix Cloud, you can use the following monitoring tools: * Datadog * New Relic – see [Manage App Performance with New Relic](/howto9/monitoring-troubleshooting/manage-app-performance-with-new-relic/) -* Dynatrace – for example on [SAP Business Technology Platform](/developerportal/deploy/sap-cloud-platform/#runtime-tab) +* Dynatrace – for example on [SAP Business Technology Platform](/developerportal/deploy/sap-cloud-platform/environments/#runtime-tab) * Other tools – you can see these under [Telemetry Configuration](https://github.com/mendix/cf-mendix-buildpack#telemetry-configuration) in the Mendix *Cloud Foundry Buildpack*. diff --git a/content/en/docs/marketplace/platform-supported-content/modules/sap/sap-event-mesh-connector.md b/content/en/docs/marketplace/platform-supported-content/modules/sap/sap-event-mesh-connector.md index 7dbc725f929..3723ca3fcb5 100644 --- a/content/en/docs/marketplace/platform-supported-content/modules/sap/sap-event-mesh-connector.md +++ b/content/en/docs/marketplace/platform-supported-content/modules/sap/sap-event-mesh-connector.md @@ -48,7 +48,7 @@ The SAP Enterprise Messaging service (Event Mesh) instance must be created with The **Event Mesh Configurator** provides a user friendly interface to create the JSON required to configure the required Enterprise Messaging service instance with the desired configuration. To bind and configure the service, perform the following steps: -1. Ensure that the **enterprise-messaging** service is in the status **Available Services** in Mendix Portal. See the [Services Tab](/developerportal/deploy/sap-cloud-platform/#binding-services) section of *SAP Business Technology Platform* for more information. +1. Ensure that the **enterprise-messaging** service is in the status **Available Services** in Mendix Portal. See the [Services Tab](/developerportal/deploy/sap-cloud-platform/environments/#binding-services) section of *SAP Business Technology Platform* for more information. 2. Click **Available Services** > **⚙️ Configurator** to open the configurator. 3. Provide the required information. For more information about the parameter syntax, see [Syntax for Service Descriptor](https://help.sap.com/docs/event-mesh/event-mesh/syntax-for-service-descriptor?locale=en-US). * **EM Name** - Enter a display name for the service. diff --git a/content/en/docs/marketplace/platform-supported-content/modules/sap/sap-xsuaa-connector.md b/content/en/docs/marketplace/platform-supported-content/modules/sap/sap-xsuaa-connector.md index a2e53b8bedf..c23939298bc 100644 --- a/content/en/docs/marketplace/platform-supported-content/modules/sap/sap-xsuaa-connector.md +++ b/content/en/docs/marketplace/platform-supported-content/modules/sap/sap-xsuaa-connector.md @@ -55,7 +55,7 @@ After you install the connector, you can find it in the **App** > **Marketplace You need to provide your own [xs-security.json](https://help.sap.com/viewer/4505d0bdaf4948449b7f7379d24d0f0d/2.0.04/en-US/6d3ed64092f748cbac691abc5fe52985.html) file to add custom configuration to your XSUAA connector. -1. Ensure that the **xsuaa** service is in the status **Services To Be Bound**. See the [Services Tab](/developerportal/deploy/sap-cloud-platform/#binding-services) section of *SAP Business Technology Platform* for more information. +1. Ensure that the **xsuaa** service is in the status **Services To Be Bound**. For more information, see the [Services Tab](/developerportal/deploy/sap-cloud-platform/environments/#binding-services) section of *Environment Details on SAP BTP*. 2. Click the three dots **…** next to the **xsuaa** service and select **Add Binding Configuration**. diff --git a/content/en/docs/refguide/runtime/custom-settings/_index.md b/content/en/docs/refguide/runtime/custom-settings/_index.md index 485f5711f96..a93ead762b9 100644 --- a/content/en/docs/refguide/runtime/custom-settings/_index.md +++ b/content/en/docs/refguide/runtime/custom-settings/_index.md @@ -23,7 +23,7 @@ Each custom setting consists of a name and a value. For example, to set the hash If you are running your app on Mendix Cloud or SAP Business Technology Platform, you can access these settings by opening your app in [Apps](https://sprintr.home.mendix.com/) and choosing **Environments** > **Environment Details** > **Runtime** > **Custom Runtime Settings**. For more information see: * the [Runtime Tab](/developerportal/deploy/environments-details/#runtime-tab) section of *Environment Details* for information about Mendix Cloud -* the [Runtime tab](/developerportal/deploy/sap-cloud-platform/#runtime-tab) section of *SAP Business Technology Platform* for information about the SAP BTP +* the [Runtime tab](/developerportal/deploy/sap-cloud-platform/environments/#runtime-tab) section of *Environment Details on SAP BTP* for information about the SAP BTP When you are running your app locally, you can set these values in a [Configuration](/refguide/configurations-tab/#custom). diff --git a/content/en/docs/refguide10/runtime/custom-settings/_index.md b/content/en/docs/refguide10/runtime/custom-settings/_index.md index f13f3079364..6959a10f467 100644 --- a/content/en/docs/refguide10/runtime/custom-settings/_index.md +++ b/content/en/docs/refguide10/runtime/custom-settings/_index.md @@ -19,7 +19,7 @@ Each custom setting consists of a name and a value. For example, to set the hash If you are running your app on Mendix Cloud or SAP Business Technology Platform, you can access these settings by opening your app in [Apps](https://sprintr.home.mendix.com/) and choosing **Environments** > **Environment Details** > **Runtime** > **Custom Runtime Settings**. For more information see: * the [Runtime Tab](/developerportal/deploy/environments-details/#runtime-tab) section of *Environment Details* for information about Mendix Cloud -* the [Runtime tab](/developerportal/deploy/sap-cloud-platform/#runtime-tab) section of *SAP Business Technology Platform* for information about the SAP BTP +* the [Runtime tab](/developerportal/deploy/sap-cloud-platform/environments/#runtime-tab) section of *Environment Details on SAP BTP* for information about the SAP BTP When you are running your app locally, you can set these values in a [Configuration](/refguide10/configuration/#custom). diff --git a/content/en/docs/refguide9/runtime/custom-settings/_index.md b/content/en/docs/refguide9/runtime/custom-settings/_index.md index e5bda04b59c..4bf34eb2d6e 100644 --- a/content/en/docs/refguide9/runtime/custom-settings/_index.md +++ b/content/en/docs/refguide9/runtime/custom-settings/_index.md @@ -19,7 +19,7 @@ Each custom setting consists of a name and a value. For example, to set the hash If you are running your app on Mendix Cloud or SAP Business Technology Platform, you can access these settings in [Apps](https://sprintr.home.mendix.com/) via **Environments** > **Environment Details** > **Runtime** > **Custom Runtime Settings**. For more information see: * the [Runtime Tab](/developerportal/deploy/environments-details/#runtime-tab) section of *Environment Details* for information about Mendix Cloud -* the [Runtime tab](/developerportal/deploy/sap-cloud-platform/#runtime-tab) section of *SAP Business Technology Platform* for information about the SAP BTP +* the [Runtime tab](/developerportal/deploy/sap-cloud-platform/environments/#runtime-tab) section of *Environment Details on SAP BTP* for information about the SAP BTP When you are running your app locally, you can set these values in a [Configuration](/refguide9/configuration/#custom). diff --git a/content/en/docs/releasenotes/deployment/sap-cloud-platform.md b/content/en/docs/releasenotes/deployment/sap-cloud-platform.md index ceb5d5cb8bc..1cb3f19e361 100644 --- a/content/en/docs/releasenotes/deployment/sap-cloud-platform.md +++ b/content/en/docs/releasenotes/deployment/sap-cloud-platform.md @@ -134,7 +134,7 @@ For information on the current status of deployment to SAP BTP and any planned r #### Improvements -* You can now add custom Mendix Runtime settings under the [Runtime tab](/developerportal/deploy/sap-cloud-platform/#runtime-tab). +* You can now add custom Mendix Runtime settings under the [Runtime tab](/developerportal/deploy/sap-cloud-platform/environments/#runtime-tab). * this replaces the previous method of adding custom settings using User-Provided Variables. ### June 20, 2022 @@ -161,7 +161,7 @@ For information on the current status of deployment to SAP BTP and any planned r #### Improvements -* We added the ability to provide a custom *xs-security.json* file to configure an XSUAA service. This allows you to apply the configuration every time your app is deployed. You can add your configuration by unbinding and rebinding the XSUAA service in the [Services](/developerportal/deploy/sap-cloud-platform/#binding-services) tab. +* We added the ability to provide a custom *xs-security.json* file to configure an XSUAA service. This allows you to apply the configuration every time your app is deployed. You can add your configuration by unbinding and rebinding the XSUAA service in the [Services](/developerportal/deploy/sap-cloud-platform/environments/#binding-services) tab. ### August 30, 2021 @@ -244,7 +244,7 @@ For more information see [SAP Business Technology Platform - deploy](/developerp * We have added support for PostgreSQL on SAP Cloud Platform, Hyperscaler Option for Mendix apps deployed to SAP Cloud Platform. * this comes with a configurator to help you create the correct configuration. - * see [Running Mendix on PostgreSQL on SAP Cloud Platform](/developerportal/deploy/sap-cloud-platform/#sap-hyperscaler) for more information. + * see [Running Mendix on PostgreSQL on SAP Cloud Platform](/developerportal/deploy/sap-cloud-platform/databases/#sap-hyperscaler) for more information. * As part of a Developer Portal clean up, we removed the *Model* option from the *DEVELOP* section of the Developer Portal menu when you are looking at environments on SAP Cloud Platform. The functions of this page are still available via the **Edit in Studio Pro** button on the environments page. ### October 21, 2020 @@ -274,7 +274,7 @@ For more information see [SAP Business Technology Platform - deploy](/developerp #### Improvements -* We added support for using the HANA trial database available in new SAP Cloud Platform trial accounts. See the [Running Mendix on SAP HANA](/developerportal/deploy/sap-cloud-platform/#sap-hana) section of the *SAP Cloud Platform* deployment document for more details. +* We added support for using the HANA trial database available in new SAP Cloud Platform trial accounts. See the [Running Mendix on SAP HANA](/developerportal/deploy/sap-cloud-platform/databases/#sap-hana) section of the *SAP Cloud Platform* deployment document for more details. ## 2019 diff --git a/static/attachments/deployment/sap-btp/sap-cloud-platform/connect-service.png b/static/attachments/deployment/sap-btp/sap-cloud-platform/connect-service.png deleted file mode 100644 index 8fd3d905913..00000000000 Binary files a/static/attachments/deployment/sap-btp/sap-cloud-platform/connect-service.png and /dev/null differ diff --git a/static/attachments/deployment/sap-btp/sap-cloud-platform/add-binding-config.png b/static/attachments/deployment/sap-btp/sap-env-details/add-binding-config.png similarity index 100% rename from static/attachments/deployment/sap-btp/sap-cloud-platform/add-binding-config.png rename to static/attachments/deployment/sap-btp/sap-env-details/add-binding-config.png diff --git a/static/attachments/deployment/sap-btp/sap-env-details/autoscaler-service.png b/static/attachments/deployment/sap-btp/sap-env-details/autoscaler-service.png new file mode 100644 index 00000000000..b0a326c468f Binary files /dev/null and b/static/attachments/deployment/sap-btp/sap-env-details/autoscaler-service.png differ diff --git a/static/attachments/deployment/sap-btp/sap-cloud-platform/env-details.png b/static/attachments/deployment/sap-btp/sap-env-details/env-details.png similarity index 100% rename from static/attachments/deployment/sap-btp/sap-cloud-platform/env-details.png rename to static/attachments/deployment/sap-btp/sap-env-details/env-details.png