You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/en/docs/deployment/sap-btp/_index.md
+4-252Lines changed: 4 additions & 252 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -272,263 +272,15 @@ You can also transport to the required environment from the **Overview** tab of
272
272
273
273
### Runtime Settings and Environment Variables
274
274
275
-
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**.
275
+
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**.
276
276
277
277
### Starting the Application
278
278
279
279
1. On the **Start Application** tab, you can see the application details. Click **Start application** to start the application on SAP BTP.
280
280
281
281
{{% alert color="info" %}}This binds any services which are in the status **Services To Be Bound**.{{% /alert %}}
282
282
283
-
2. When the application has been started, you are taken to the **Environment Details** page for the selected environment. See [Environment Details](#EnvironmentDetails).
284
-
285
-
## Environment Details {#EnvironmentDetails}
286
-
287
-
The environment details page contains the following tabs:
288
-
289
-
* [General](#general-tab) – how the application is deployed on SAP BTP
290
-
* [Model Options](#model-options-tab) – application constants and scheduled events
291
-
* [Services](#binding-services) – Cloud Foundry service management
292
-
* [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
293
-
294
-
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.
{{% 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**.
299
-
300
-
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 %}}
301
-
302
-
### General Tab {#general-tab}
303
-
304
-
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.
305
-
306
-
#### Start and Stop Application
307
-
308
-
If the application is running, click **Stop Application** and confirm when asked to stop the application.
309
-
310
-
The button will change to **Start Application** which you can click to start or restart the application.
311
-
312
-
{{% alert color="info" %}}
313
-
You may need to use this option to stop and start your app after changing one of the settings on this page.
314
-
{{% /alert %}}
315
-
316
-
If you receive an error trying to start the app, refer to the [App Does Not Start](#appnotstart) section below.
317
-
318
-
#### Change Admin Password
319
-
320
-
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.
321
-
322
-
{{% alert color="warning" %}}
323
-
The new password will not come into effect until you stop and start your environment.
324
-
{{% /alert %}}
325
-
326
-
#### View Recent Log
327
-
328
-
Click three-dots ({{% icon name="three-dots-menu-horizontal" %}}) icon and select **View Recent Log** to see recent events written to the log.
329
-
330
-
#### Delete Environment
331
-
332
-
**Delete Environment** enables you to delete the environment and, optionally, all its resources, including the app.
333
-
334
-
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.
335
-
336
-
{{% alert color="info" %}}
337
-
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.
338
-
{{% /alert %}}
339
-
340
-
#### Change Development Mode
341
-
342
-
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.
343
-
344
-
#### Change App URL
345
-
346
-
Click **Change** to change the **App URL** for this environment.
347
-
348
-
#### Change Redirect URLs
349
-
350
-
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.
351
-
352
-
#### Scaling
353
-
354
-
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.
355
-
356
-
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.
357
-
358
-
Use the **Memory per instance** slider to change the amount of memory allocated to each instance of the app.
359
-
360
-
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.
361
-
362
-
Click **Cancel** to return the values to what they were before the sliders were moved.
363
-
364
-
{{% alert color="info" %}}
365
-
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/).
366
-
{{% /alert %}}
367
-
368
-
#### Change License Subscription ID
369
-
370
-
Click **Change** to change the **Subscription Secret** which is the code which registers your production Mendix license to this environment.
371
-
372
-
### Model Options Tab {#model-options-tab}
373
-
374
-
This tab displays the application constants and allows you to edit them. It also lets you enable or disable scheduled events.
375
-
376
-
{{% alert color="info" %}}
377
-
You need to restart your app if you change any of these options.
378
-
{{% /alert %}}
379
-
380
-
#### Scheduled Events {#schedules-events}
381
-
382
-
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.
383
-
384
-
To change the state of a scheduled event, select it and click **Enable** or **Disable** from **Actions** to change the **Enabled** flag.
385
-
386
-
#### Constants
387
-
388
-
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.
389
-
390
-
To change a value, select the constant you want to change and click the edit ({{% icon name="pencil" %}}) icon.
391
-
392
-
### Services Tab {#binding-services}
393
-
394
-
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.
395
-
396
-
{{% alert color="warning" %}}
397
-
There are a number of services which your Mendix app requires. If you unbind any of these services, your app probably stops working:
398
-
399
-
* Destination
400
-
* Xsuaa
401
-
* Database (PostgreSQL, Hyperscaler Option, or SAP HANA schema)
402
-
* Connectivity
403
-
404
-
Select, bind, and unbind services through the **Services** page. Changes made in the SAP BTP cockpit are not reflected in the Mendix Portal.
405
-
{{% /alert %}}
406
-
407
-
{{% alert color="info" %}}
408
-
Changes to **Bound Services** do not take place immediately. Stop and start your application to activate the changes.
409
-
410
-
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.
411
-
{{% /alert %}}
412
-
413
-
#### Connecting Services
414
-
415
-
To connect a service in the **Available Services** section, do the following steps:
416
-
417
-
1. Select one or more services (you can search for them by name).
418
-
2. Select a **Plan** for each service. This must be a plan which is part of your quota for this space.
419
-
3. Select a JSON file to upload if you need to add extra configuration.
420
-
4. Click **Connect Selected Services**. You can also **Review Services** before restarting your app.
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.
425
-
426
-
{{% alert color="info" %}}
427
-
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).
428
-
{{% /alert %}}
429
-
430
-
{{% alert color="info" %}}
431
-
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.
432
-
{{% /alert %}}
433
-
434
-
To upload the JSON **File** for service binding, follow these steps:
435
-
436
-
1. Select the service in the **Service To Be Bound** section.
437
-
2. Click the three-dot ({{% icon name="three-dots-menu-horizontal" %}}) icon next to the service for which you want to upload the file.
438
-
3. Select **Add Binding Configuration**.
439
-
4. Select the JSON **File** to upload and click **Save**.
440
-
441
-
The service bindings are created with the provided configurations when you restart the application.
442
-
443
-
{{% alert color="info" %}}
444
-
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.
445
-
{{% /alert %}}
446
-
447
-
If you receive an error trying to restart the app, refer to the [App Does Not Start](#appnotstart) section below.
448
-
449
-
#### Unbinding and Removing Services
450
-
451
-
If you no longer require a service, you can unbind it or remove it from your app.
452
-
453
-
##### Unbinding a Service
454
-
455
-
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.
456
-
1. Select one of the following:
457
-
* **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.
458
-
* **Delete Service** – unbinds the service instance from the application and deletes the service instance from your environment.
459
-
460
-
1. If you want to **Delete Service**, confirm by clicking the appropriate button:
461
-
462
-
* **Delete & Restart App** – confirms the delete action and restarts the app
463
-
* **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.
464
-
* **Cancel** – does not delete or unbind this service
465
-
466
-
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.
467
-
468
-
##### Removing an Unbound Service {#unbound-services}
469
-
470
-
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.
471
-
1. Select **Remove Service** and confirm by clicking **Remove**.
472
-
473
-
The service is deleted from the app environment and returned to the list of **Available Services**.
474
-
475
-
#### Adding Binding Configuration
476
-
477
-
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.
478
-
479
-
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.
480
-
481
-
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.
482
-
483
-
2. Select **Add Binding Configuration**.
484
-
485
-
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.
See the documentation for the service you are configuring for more information.
490
-
491
-
#### Service Names
492
-
493
-
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`.
494
-
495
-
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.
496
-
497
-
### Runtime Tab {#runtime-tab}
498
-
499
-
In the **Runtime** tab, you can **Add**, edit ({{% icon name="pencil" %}}), or delete custom runtime settings and environment variables.
500
-
501
-
{{% alert color="info" %}}
502
-
New values are only applied when you restart your app. The value which is currently applied is shown under **Current Value**.
503
-
{{% /alert %}}
504
-
505
-
#### Custom Runtime Settings
506
-
507
-
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.
508
-
509
-
#### Custom Environment Variables
510
-
511
-
##### Supported Environment Variables
512
-
513
-
You can add supported variables by selecting them from a dropdown list.
514
-
515
-
* **DT_PAAS_TOKEN** – the token for integrating your Dynatrace environment with Cloud Foundry
516
-
* **DT_SAAS_URL** – the monitoring endpoint URL of the Dynatrace service
517
-
* **DT_TENANT** – the unique identifier of your Dynatrace environment
518
-
* **DT_IS_MANAGED** – a variable to enable metrics integration for DT Managed
519
-
* **DT_CLUSTER_ID** – tag your cluster, process group, or deployment group
520
-
* **DT_CUSTOM_PROP** – provide metadata for your process group
521
-
* **NON_MENDIX_PUBLIC_CLOUD** – must be set to **true** when using Datadog, Dynatrace, or other similar tools
522
-
523
-
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.
524
-
525
-
##### Unsupported Environment Variables
526
-
527
-
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**.
528
-
529
-
{{% alert color="info" %}}
530
-
Only use unsupported environment variables if you know exactly what you are doing. Incorrect values can prevent the Mendix Runtime from starting.
531
-
{{% /alert %}}
283
+
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).
532
284
533
285
## Databases in SAP BTP {#databases}
534
286
@@ -610,7 +362,7 @@ If your SAP HANA database has performance issues, you can improve it by performi
610
362
* Password
611
363
* User
612
364
613
-
1. Go to the [Runtime tab](#runtime-tab) of your app environment.
365
+
1. Go to the [Runtime tab](/developerportal/deploy/sap-cloud-platform/environments/#runtime-tab) of your app environment.
614
366
1. Enter the following unsupported environment variables with the associated values, using the values taken from the service binding credentials:
615
367
616
368
| Variable | Value |
@@ -734,7 +486,7 @@ Starting from Mendix 9.7, support for `statsd` is removed.
734
486
735
487
#### Solution
736
488
737
-
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:
489
+
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:
0 commit comments