orkungedik/SAP-basis-dataset huggingface dataset:
## 6.2.4.6.2 Assign Space Quotas to Spaces
You can use the SAP BTP cockpit to assign space quotas to spaces.
## Prerequisites
- You have the Org Manager role for the org in which you want to create and assign a space quota.
- You have at least one space quota. For more information, see Create Space Quotas [page 2528].
## Procedure
1. Navigate to the subaccount that contains the spaces to which you want to assign space quotas.
2. In the navigation menu, choose Cloud Foundry Space Quotas .
3. Open the Quota Assignments tab.
4. Select one of the existing quota assignments and choose  (Edit) to make changes.
5. Select either a specific Space Quota from the drop-down or the Org Quota . If you select Org Quota , the space will use the consumption limits defined in the org quota.
6. To assign the selected space or org quota to the space, choose Save .
## Related Information
Entitlements and Quotas [page 117]
Create Space Quotas Using the Cockpit [page 2528]
Assign Quota Plans to Spaces Using the Cloud Foundry Command Line Interface [page 2576]
## 6.2.4.6.3 Edit Space Quotas
Edit space quotas in the Cloud Foundry environment using the SAP BTP cockpit.
## Prerequisites
You have the Org Manager role for the org in which you want to edit space quotas.
## Procedure
1. Choose the subaccount that contains the spaces for which you'd like to edit the space quota.
2. In the navigation menu, choose Cloud Foundry Space Quotas .
3. Choose  (Edit) for an existing space quota.
4. Adjust the values in the text fields as needed.
For more information about the different values, see https:/ /docs.cloudfoundry.org/adminguide/quotaplans.html#space .
5. Choose Save .
## Related Information
Change Space Quota Plans Using the Command Line Interface [page 2576]
Create Space Quotas [page 2528]
Assign Space Quotas to Spaces [page 2530]
Configure Entitlements and Quotas for Subaccounts [page 2269]
Entitlements and Quotas [page 117]
## 6.2.4.7 Using Space Events
The Space Events page at space level in the SAP BTP cockpit shows the order in which actions are performed in a space.
## When Are Space Events Created?
A space event is created when you perform an action in the space.
For example, if you trigger the creation of a new route, the audit.route.create space event is logged. The route is the target resource of this action. In this example, you are the Actor , while the route is the Target .
## How Are Space Events Most Commonly Used?
You can use space events to:
- Troubleshoot a failed action
- Keep track of the history of certain resources
- For auditing and compliance purposes
## What Are the Types of Space Events?
Depending on the resource that is the target of the action, a space event can be specific to an application, service, route, organization, among others.
To get the full list of all space event types, see https:/ /docs.cloudfoundry.org/running/managing-cf/auditevents.html#types .
## Searching for a Specific Space Event
You can search for a specific space event by actor or target.
##  Note
Not all search results are loaded immediately. To add more results to your search, choose Load More . Each Load More action adds up to 200 space events to your search results.
## 6.2.5  Org Administration Using the Cloud Foundry CLI
Use the Cloud Foundry command line interface (CF CLI) for managing subaccounts in the Cloud Foundry environment, such as creating orgs and spaces, or managing quota.
- Download and Install the Cloud Foundry Command Line Interface [page 2533]
- CF CLI: Plug-ins [page 2535]
- Create Spaces Using the Cloud Foundry Command Line Interface [page 2572]
- Add Organization Members Using the Cloud Foundry Command Line Interface [page 2571]
- Add Space Members Using the Cloud Foundry Command Line Interface [page 2573]
- Create Space Quota Plans Using the Cloud Foundry Command Line Interface [page 2575]
- Assign Quota Plans to Spaces Using the Cloud Foundry Command Line Interface [page 2576]
- Change Space Quota Plans Using the Command Line Interface [page 2576]
##  Note
If you work with the Cloud Foundry CLI (cf CLI), be aware that you are responsible for all actions performed using the CLI. Also, you won't always be able to mirror the same data in the SAP BTP cockpit.
You must delete an org using only the cockpit or the SAP BTP command line interface (btp CLI).
## 6.2.5.1 Working with the Cloud Foundry Command Line Interface
Find out how to get and use the Cloud Foundry command line interface.
## Related Information
Download and Install the Cloud Foundry Command Line Interface [page 2533] Log On to the Cloud Foundry Environment Using the Cloud Foundry Command Line Interface [page 2534] CF CLI: Plug-ins [page 2535]
## 6.2.5.1.1 Download and Install the Cloud Foundry Command Line Interface
Download and set up the Cloud Foundry Command Line Interface (cf CLI) to start working with the Cloud Foundry environment.
## Procedure
1. Download the latest version of cf CLI from GitHub at the following URL: https:/ /github.com/cloudfoundry/ cli#downloads
- For Microsoft Windows, download the Windows 64-bit installer.
- For Mac OS, download the PKG file. You can use the Homebrew open source package management software to download the latest available version of the cf CLI.
2. Install the cf CLI:
- For Microsoft Windows, unpack the ZIP file.
- For Mac OS, proceed as follows:
1. Open the PGK file.
2. In the installation wizard, choose Continue , and then select the destination folder for the cf CLI installation.
3. Choose Continue , and when prompted, choose Install .
For more information, see http:/ /docs.cloudfoundry.org/devguide/installcf/install-go-cli.html .
3. (Optional) If you have an HTTP proxy server, configure the proxy settings. For more information, see http:/ / docs.cloudfoundry.org/cf-cli/http-proxy.html .
## 6.2.5.1.2 Log On to the Cloud Foundry Environment Using the Cloud Foundry Command Line Interface
Use the Cloud Foundry Command Line Interface (cf CLI) to log on to the Cloud Foundry space.
## Prerequisites
- The Cloud Foundry environment is enabled. You can enable it in the Cloud Platform Cockpit. For more information, see Create a Subaccount [page 2249].
- (Enterprise accounts only) You have created at least one subaccount and enabled the Cloud Foundry environment in this subaccount. For more information, see Create a Subaccount [page 2249].
##  Note
In a Cloud Foundry trial account, the Cloud Foundry environment has been activated for you automatically and a first space "dev" has been created for you.
- Download and install the cf CLI and log on to Cloud Foundry. For more information, see Download and Install the Cloud Foundry Command Line Interface [page 2533].
## Procedure
1. Open a command line.
2. Set the target API endpoint to the cloud controller.
##  Note
There is no specific endpoint for trial accounts. Both enterprise and trial accounts use the same API endpoints.
cf api https://api.cf.eu10.hana.ondemand.com
For more information, see Regions and API Endpoints Available for the Cloud Foundry Environment [page 19].
3. Log on to the Cloud Foundry environment:
cf login
##  Note
- To log on with SAP Universal ID, use the option . Y ou need a browser in the logon process.
- --sso For more information, see Log On Manually With a Custom Identity Provider [page 2330]. Otherwise log on with the password associated with your account (S-user or P-user) in the default identity provider, SAP ID service. If you have multiple user accounts with the same email address, log on with your user ID (S-user or P-user) instead of your email address. If you've forgotten this password and this user is associated with your SAP Universal ID user, reset your password. For more information, see SAP Note 3085908 .
- To log on with a specific identity provider, use the option --origin . For more information, see Log On as a Technical User With a Custom Identity Provider [page 2331].
4. When prompted, enter your user credentials (email and password).
5. To view the help for the CLI, execute cf help , which lists the most common CLI commands with a short description, or cf help -a , which lists all commands. To get help for a specific command, execute cf help &lt;command&gt; .
## 6.2.5.1.3 CF CLI: Plug-ins
A list of additional commands that have been implemented as plug-ins to extend the base CF CLI client.
- Autoscaler Plugin for Cloud Foundry CLI [page 2535]
- Custom Domain Plugin for the Cloud Foundry Environment [page 2542]
- Java Plugin for Cloud Foundry Command Line Interface [page 2551]
- Multitarget Application Commands for the Cloud Foundry Environment [page 2554]
- Service Fabrik Plugin in Cloud Foundry [page 2567]
## 6.2.5.1.3.1  Autoscaler Plugin for Cloud Foundry CLI
The Autoscaler service offers a CLI plugin for the Cloud Foundry Command Line Interface (CLI).
The plugin enables users to:
- attach or detach scaling policies to apps
- view attached scaling policies and view the scaling histories
- view the metrics sent by apps
This is useful:
- to get some insights into how current scaling policies work and if changes are reasonable.
- for debugging, especially when introducing custom-metrics to scale an app. It lets you check if the sent metrics are correctly handled by the Application Autoscaler, and it helps you understand why your app is scaling out or in or why this does not happen.
This documentation explains how to use the plugin on Cloud Foundry in BTP. For details not related to BTP, see https:/ /github.com/cloudfoundry/app-autoscaler-cli-plugin/blob/main/README.md .
## Command List
Cloud Foundry Commands of Application Autoscaler [page 2537]
## Related Information
Initial Setup Cloud Foundry Commands of Application Autoscaler [page 2537]
## 6.2.5.1.3.2  Custom Domain Plugin for the Cloud Foundry Environment
The Custom Domain CLI plugin provides functions for creating private keys and certificate signing requests, as well as additional commands for managing your custom domains.
To use the functionality of the Custom Domain plugin, use the extended Cloud Foundry commands in the command-line interface.
##  Note
However, we recommend using the UI over the CLI because the Custom Domain Manager supports TLS configurations and extension landscapes. For more information, see Custom Domain Manager.
## Related Information
Install the Custom Domain Plugin [page 2542]
Extended Cloud Foundry Commands of Custom Domains [page 2544] Configuring Custom Domains
## 6.2.5.1.3.2.1  Install the Custom Domain Plugin
Use the Custom Domain CLI plugin to configure and manage your custom domains.
## Prerequisites
Install the Cloud Foundry command-line interface (CLI) for the plugin to work. You can find the installation instructions here: Download and Install the Cloud Foundry Command Line Interface [page 2533].
## Procedure
1. Download the latest version of the plugin that is compatible with your operating system. On the Web page, you'll find the plugin under the SAP BTP Cloud Foundry CLI plugins section with the name Custom Domain.
2. Untar or unzip the downloaded archive.
3. Open the command-line interface or terminal.
4. To install the plugin, enter the following command:
- Mac and Linux:
cf install-plugin &lt;path to the downloaded folder&gt;/custom-domain-cli
- Windows:
cf install-plugin &lt;path to the downloaded folder&gt;\custom-domain-cli.exe
##  Note
If you are reinstalling the plugin, first uninstall the previous version using: cf uninstall-plugin "Custom Domain"
5. Verify that the plugin has been installed successfully by entering:
cf plugins
You see a list of plugins that now includes Custom Domain. The output also displays commands that are specific to the Custom Domain plugin.
## Results
You have installed the Custom Domain plugin for the Cloud Foundry CLI and can now use the extended commands that are available from the Custom Domain service.
## Related Information
Download and Install the Cloud Foundry Command Line Interface [page 2533] Configuring Custom Domains
## 6.2.5.1.3.3  Java Plugin for Cloud Foundry Command Line Interface
Use the Java plugin for the Cloud Foundry command line interface to get heap dumps, thread dumps and profiling data (JFR or async-profiler).
Before using the extended commands, you first need to install the Java plugin in the Cloud Foundry environment.
See: Install the Java CLI Plugin in the Cloud Foundry Environment [page 2551]
## 6.2.5.1.3.3.1  Install the Java CLI Plugin in the Cloud Foundry Environment
The Java plugin provides convenience utilities to work with Java applications deployed on Cloud Foundry.
## Prerequisites
You have installed the Cloud Foundry command line interface (cf CLI). See: Download and Install the cf CLI
## Procedure
1. Open the command line interface or terminal.
2. Check if you already have the Java plugin installed. Run:
cf plugins
If the java plugin is installed, you have to uninstall it first. Run:
cf uninstall-plugin java
3. Before installing the latest available version of the plugin, make sure you have the Cloud Foundry community repository in your cf CLI.
If it is not available there, you need to add it. Run:
cf add-plugin-repo CF-Community https://plugins.cloudfoundry.org
4. Install the latest Java plugin version. Run:
cf install-plugin -r CF\_Community java
<!-- image -->
In case the latest version is not available in the Cloud Foundry community repository, you can perform a manual installation:
1. Download the binary file for your target operating system from the latest release .
2. If you've already installed the plugin and you're now updating it, run: cf uninstall-plugin java
3. Now install the plugin. Run: cf install-plugin [cf-cli-java-plugin] Note: Replace [cf-cli-java-plugin] with the actual binary name you'll use, which depends on your operating system.
5. Verify that the plugin has been installed successfully. Run:
cf plugins
## Results
You see a list of cf CLI plugins that now includes the java one. The output also displays commands that are specific to this plugin.
## 6.2.5.1.3.4  Multitarget Application Plugin for Cloud Foundry Command Line Interface
Use the Multitarget application plugin for the Cloud Foundry command line interface to deploy, remove, and view MTAs, among other possible operations.
Before using the extended commands, you first need to install the MTA plugin in the Cloud Foundry environment.
See: Install the MultiApps CLI Plugin in the Cloud Foundry Environment [page 2553]
## Related Information
Multitarget Applications in the Cloud Foundry Environment [page 598]
## 6.2.5.1.3.4.1  Install the MultiApps CLI Plugin in the Cloud Foundry Environment
The MultiApps command line interface plugin (formerly known as the MTA plugin) for the Cloud Foundry command line interface lets you deploy, remove, and view MTAs, among other possible operations, by extending Cloud Foundry commands.
## Prerequisites
You have installed the Cloud Foundry command line interface version 6.40 or higher. See Download and Install the Cloud Foundry Command Line Interface [page 2533].
## Procedure
1. Open the command line interface or terminal.
2. Check if a previous version is installed by using the command cf plugins . If the MtaPlugin is already installed, you have to uninstall it using the command cf uninstall-plugin MtaPlugin .
If you do not uninstall the previous version of the plugin and try to install a new one, you receive the following error:
## 
```
Output Code Plugin multiapps v<version> could not be installed as it contains commands
```
with names and aliases that are already used: bg-deploy, deploy, download-mta-op-logs, mta, mta-ops, mtas, purge-mtaconfig, undeploy, dmol
3. To install the latest available version of the plugin, proceed as follows:
1. Make sure that you have the Cloud Foundry community repository in your Cloud Foundry command line interface. If it is not available there, add it by executing the following command:
2. To install the plugin, enter the following command:
```
cf add-plugin-repo CF-Community https://plugins.cloudfoundry.org
```
```
cf install-plugin multiapps -f
```
##  Note
Alternatively, if you want to install a specific version of the plugin, proceed as follows:
1. Download the preferred version of the plugin that is compatible with your operating system.
2. Extract the downloaded archive if required.
3. To install the plugin, enter the following command:
- Mac and Linux: cf install-plugin&lt;path to the downloaded plugin&gt; -f
- Windows: cf install-plugin&lt;path to the downloaded plugin&gt; -f
4. Verify that the plugin has been installed successfully by entering cf plugins .
You see a list of plugins that now includes the MultiApps CLI Plugin for the Cloud Foundry command line interface. The output also displays commands that are specific to this plugin.
## Related Information
SAP BTP, Cloud Foundry CLI Plugins
<!-- image -->
Download and Install the Cloud Foundry Command Line Interface [page 2533] MultiApps CLI Plugin
## 6.2.5.1.3.4.2.1  Application Versions and Deployment Consistency
The SAP Cloud Deployment service follows the rules specified in the Semantic Versioning Specification (Semver) when comparing the versions of a deployed multitarget application (MTA) with the version that is to be deployed. If an MTA that is submitted for deployment has a version that is lower than or equal to an already deployed version of the same MTA, the deployment might fail if their is a conflict with the version rule specified in the deployment operation. The version rule is a parameter of the deployment process, which specifies which relationships to consider between the existing and the new version of an MTA before proceeding with the operation. The version rules supported by the deploy service are as follows:
- HIGHER - Only MTAs with versions that are bigger than the version of the currently deployed MTA, are accepted for deployment.
- SAME\_HIGHER - Only MTAs with versions that are higher than (or the same as) the version of the currently deployed MTA are accepted for deployment. This is the default setting for the version rule.
- ALL - All versions are accepted for deployment.
## 6.2.5.1.3.5  Service Fabrik Plugin in Cloud Foundry
Service Fabrik CF CLI plugin is used for performing various backup and restore operations on service-instances in Cloud Foundry, such as starting/aborting a backup, listing all backups, removing backups, starting/aborting a restore, etc.
This CF CLI plugin is only available for ServiceFabrik broker, so it can only be used with CF installations in which this service broker is available. Y ou can also list all available commands and their usage with 'cf backup'. You can now manage your backups of service instance and restore them using the backup and restore functionality.
To use the functionality, use the SAP BTP cockpit or the extended Cloud Foundry commands in the command line interface.
## 6.2.5.1.3.5.1  Install the Service Fabrik Plugin
The Service Fabrik plugin lets you manage backups of a service instance by extending Cloud Foundry commands.
## Prerequisites
You need to have Cloud Foundry Command Line Interface (CF CLI) installed for the plugin to work since it is built on CF CLI. The installation instructions for CF CLI can be found here . The minimum version of CF CLI, on which the plugin has been tested successfully is v6.20.
## Procedure
1. Download the latest version of the plugin that is compatible with your operating system. On the Web page, you will find the plugin under the SAP Cloud Platform Cloud Foundry CLI Plugins section with the name Service Fabrik based B&amp;R .
2. Untar or unzip the downloaded archive.
3. Open the command line interface or terminal.
4. To install the plugin, enter the following command:
- Mac and Linux: cf install-plugin &lt;path to the downloaded folder&gt;&lt;/service-fabrikcli-plugin [Linux/Mac]&gt;
- Windows : cf install-plugin&lt;path to the downloaded folder&gt;&lt;\service-fabrik-cliplugin.exe [Windows]&gt;
##  Note
If you are reinstalling the plugin, first uninstall the previous version using: cf uninstall-plugin ServiceFabrikPlugin
5. Verify that the plugin has been installed successfully by entering cf plugins .
You see a list of plugins that now includes Service Fabrik. The output also displays commands that are specific to the Service Fabrik plugin.
## Related Information
https:/ /tools.hana.ondemand.com/#cloud Download and Install the Cloud Foundry Command Line Interface [page 2533]
## 6.2.5.2 Add Organization Members Using the Cloud Foundry Command Line Interface
You can use the Cloud Foundry Command Line Interface (cf CLI) to add organization members and assign roles to them.
## Prerequisites
- The Cloud Foundry environment is enabled. Enable it in the SAP BTP cockpit. For more information, see Create a Subaccount [page 2249].
- The Org Manager role for the org in question.
##  Note
You automatically have the Org Manager role in an org that you created.
- The user exists in the UAA. All users are stored in identity providers, either in the default or in a custom identity provider. Cloud
Foundry needs a copy of the user, sometimes called a shadow user. To create the shadow user, choose one of the following options:
- The user has been added from the cockpit. For more information, see Add Org Members [page 2516].
- The user has already logged on to the Cloud Foundry environment. For example: cf login -a https://api.cf.eu20.hana.ondemand.com
##  Note
The landscape the user logs on to must be the same as the landscape where the subaccount is located. See the overview page of your subaccount for the API endpoint.
- You have the e-mail addresses of the members that you want to add. The user must already exist in the connected identity provider. For more information, see Trust and Federation with Identity Providers [page 2280].
- Download and install the cf CLI and log on to Cloud Foundry. For more information, see Download and Install the Cloud Foundry Command Line Interface [page 2533] and Log On to the Cloud Foundry Environment Using the Cloud Foundry Command Line Interface [page 2534].
## Context
This task is meant for the OrgManager and OrgAuditor roles. T o add members with the OrgUser role, follow the procedure described in Add Space Members Using the Cloud Foundry Command Line Interface [page 2573].
## Procedure
Enter the following command, specifying the user name, the name of the organization, and the role:
```
cf set-org-role <USERNAME> <ORG> <ROLE> cf set-org-role julie.armstrong@example.com account_subaccount-47v2w8dj OrgAuditor
```
## Next Steps
To remove an org role from a user, enter the following string, specifying the user name, the name of the organization, and the role:
```
cf unset-org-role <USERNAME> <ORG> <ROLE>
```
## Related Information
Supported Tools and Services When Using Custom Identity Providers for Platform Users [page 2326] About Roles in the Cloud Foundry Environment [page 2510] Managing Org Members Using the Cockpit [page 2515]
## 6.2.5.3 Create Spaces Using the Cloud Foundry Command Line Interface
Use the cf create-space command to create spaces in your Cloud Foundry organization using the Cloud Foundry Command Line Interface (cf CLI).
## Prerequisites
- (Enterprise accounts only) Create at least one subaccount and enable the Cloud Foundry environment in this subaccount. For more information, see Create a Subaccount [page 2249] and Create Orgs [page 2514].
##  Note
In a trial account, the Cloud Foundry environment is automatically activated, and a first space named dev is created.
- You have the Org Manager role in the organization in which you want to create a space. For more information about roles and permissions, see https:/ /docs.cloudfoundry.org/concepts/roles.html .
- Download and install the cf CLI and log on to Cloud Foundry. For more information, see Download and Install the Cloud Foundry Command Line Interface [page 2533] and Log On to the Cloud Foundry Environment Using the Cloud Foundry Command Line Interface [page 2534].
## Procedure
1. Make sure that you are in the Cloud Foundry organization you want to add a space to.
```
cf target -o ORG
```
To get a list of your organizations, call cf orgs .
2. Enter the following string, specifying a name for the new space, the name of the organization, and the quota you'd like to assign to it:
3. (Optional) Set this space as target by executing: cf target -o ORG -s SPACE
```
cf create-space SPACE [-o ORG] [-q SPACE_QUOTA]
```
##  Note
If you are assigned to only one Cloud Foundry organization and space, the system automatically targets you to the relevant Cloud Foundry organization and space when you log on.
## Related Information
Delete Spaces Using the Cloud Foundry Command Line Interface [page 2577] Create Spaces Using the Cockpit [page 2520]
## 6.2.5.4 Add Space Members Using the Cloud Foundry Command Line Interface
You can use the Cloud Foundry Command Line Interface (cf CLI) to add space members and assign roles to them.
## Prerequisites
- The Space Manager role for the space.
· The users exist in a trusted platform identity provider. All users of Cloud Foundry UAA are stored in identity providers, either in the default or in a custom identity provider. UAA needs a copy of the user, sometimes called a shadow user. You assign the shadow user authorizations to access resources in UAA. When a user authenticates, UAA forwards the request to the identity provider. To specify which identity provider hosts the user, use the --origin option. For more information about finding the origin key, see the trust configuration documentation. For more information, see Trust and Federation with Identity Providers [page 2280].
- Download and install the cf CLI and log on to Cloud Foundry. For more information, see Download and Install the Cloud Foundry Command Line Interface [page 2533] and Log On to the Cloud Foundry Environment Using the Cloud Foundry Command Line Interface [page 2534].
## Context
Space members are organization members who have specific roles in a space.
Org members can only be added by an Org Manager. This means that if you only have the Space Manager role, you can't add space members that aren't known to the org. To do that, you must first ask your Org Manager to add the users as org members with no roles. Once this is done, you can add them as space members following the steps below.
If you're the Org Manager, you don't need to first add the users as org members with no roles. Since you have the permissions necessary to add users to the org, when you add a new user as a space member, that user automatically becomes part of the org as well.
## Procedure
Enter the following string, specifying the user name, the name of the organization, the name of the space, and the role:
cf set-space-role USERNAME ORG SPACE ROLE
## Next Steps
To remove a space role from a user, enter the following string, specifying the user name, the name of the organization, the name of the space, and the role:
```
cf unset-space-role USERNAME ORG SPACE ROLE
```
## Related Information
Supported Tools and Services When Using Custom Identity Providers for Platform Users [page 2326] Add Space Members Using the Cockpit [page 2523]
## 6.2.5.5 Create Space Quota Plans Using the Cloud Foundry Command Line Interface
You can use the Cloud Foundry Command Line Interface to create space quota plans.
## Prerequisites
- The Org Manager role for the org that contains the spaces to which you want to assign quotas.
- Download and install the cf CLI and log on to Cloud Foundry. For more information, see Download and Install the Cloud Foundry Command Line Interface [page 2533] and Log On to the Cloud Foundry Environment Using the Cloud Foundry Command Line Interface [page 2534].
## Procedure
Open a command line and enter the following string, replacing QUOTA with the name for your space quota plan:
cf create-space-quota QUOTA [-i INSTANCE\_MEMORY] [-m MEMORY] [-r ROUTES] [-s SERVICE\_INSTANCES] [--allow-paid-service-plan | --disallow-paid-service-plans]
Specify the following parameters:
- -i : Maximum amount of memory an application instance can have ( -1 represents an unlimited amount)
- -m : T otal amount of memory a space can have
- -r : T otal number of routes
- -s : T otal number of service instances
- --allow-paid-service-plans : Can provision instances of paid service plans
- --disallow-paid-service-plans : Can not provision instances of paid service plans
## Related Information
Create Space Quotas [page 2528]
## 6.2.5.6 Assign Quota Plans to Spaces Using the Cloud Foundry Command Line Interface
You use the Cloud Foundry Command Line Interface to assign the quotas available in your global account to your subaccounts.
## Prerequisites
- The Org Manager role for the org that contains the spaces to which you want to assign quotas.
- Download and install the cf CLI and log on to Cloud Foundry. For more information, see Download and Install the Cloud Foundry Command Line Interface [page 2533] and Log On to the Cloud Foundry Environment Using the Cloud Foundry Command Line Interface [page 2534].
- A space quota plan. For more information, see Create Space Quota Plans Using the Cloud Foundry Command Line Interface [page 2575].
## Procedure
Open a command line and enter the following string:
cf set-space-quota SPACE\_NAME SPACE\_QUOTA\_NAME
## 6.2.5.7 Change Space Quota Plans Using the Command Line Interface
Change space quota plans in the Cloud Foundry environment using the Cloud Foundry command line interface (cf CLI).
## Prerequisites
- You have the Org Manager role in the organization in which you'd like to change space quota plans. For more information about roles and permissions, see https:/ /docs.cloudfoundry.org/concepts/roles.html .
- Download and install the cf CLI and log on to your Cloud Foundry instance. For more information, see Download and Install Cloud Foundry Command Line Interface and Log On to the Cloud Foundry Environment Using the Cloud Foundry Command Line Interface [page 2534].
## Procedure
1. (Optional) Enter the following string to identify the names of all space quota plans available in your org:
2. To modify a quota plan, enter the following string:
```
cf space-quotas
```
```
cf update-space-quota SPACE-QUOTA-NAME [-i MAX-INSTANCE-MEMORY] [-m MEMORY] [-n NEW_NAME] [-r ROUTES] [-s SERVICES] [--allow-paid-service-plans | -disallow-paid-service-plans]
```
##  Note
For more information about managing space quota plans, see https:/ /docs.cloudfoundry.org/ adminguide/quota-plans.html#space .
## Related Information
Edit Space Quotas [page 2531]
Configure Entitlements and Quotas for Subaccounts [page 2269] Managing Entitlements and Quotas Using the Cockpit [page 2261]
## 6.2.5.8 Delete Spaces Using the Cloud Foundry Command Line Interface
Use the cf delete-space command to delete spaces in your Cloud Foundry organization using the Cloud Foundry Command Line Interface (cf CLI).
## Prerequisites
- You have the Org Manager role in the organization from which you want to delete a space. For more information about roles and permissions, see https:/ /docs.cloudfoundry.org/concepts/roles.html .
- Download and install the cf CLI and log on to Cloud Foundry. For more information, see Download and Install the Cloud Foundry Command Line Interface [page 2533] and Log On to the Cloud Foundry Environment Using the Cloud Foundry Command Line Interface [page 2534].
## Procedure
1. Make sure that you are in the Cloud Foundry organization you want to delete a space in.
```
cf target -o ORG
```
To get a list of your organizations, call cf orgs .
2. Enter the following string, specifying a name for the space, and the name of the organization:
```
cf delete-space SPACE [-o ORG] [-f]
```
To get the list of your spaces, call cf spaces .
## Related Information
Create Spaces Using the Cloud Foundry Command Line Interface [page 2572] Delete Spaces Using the Cockpit [page 2522]
## 6.2.6  Application Operations in the Cloud Foundry Environment
Learn more about the different application operations that you can perform in the Cloud Foundry environment.
- Manage Environment Variables [page 2579]
- Deploy an Application [page 2580]
- Start, Stop, and Restart Applications [page 2582]
- Manage Application Instances [page 2583]
- Troubleshoot Applications [page 2586]
- Using Application Events [page 2586]
- Using Application Logs [page 2587]
- Configuring Application URLs in the Cloud Foundry CLI [page 2588]
- About Routes in the Cockpit [page 2589]
- Create Routes [page 2590]
- Map Routes to Applications [page 2591]
- Bind Routes to Service Instances [page 2592]
- Security Groups [page 2594]
- Using Custom Domains [page 2595]
## 6.2.6.1 Manage Environment Variables
You can use the SAP BTP cockpit to view system-provided and create user-provided variables. The Cloud Foundry environment uses these variables to communicate with the applications deployed in it.
## Environment Variables
In the Cloud Foundry environment, there are two types of environment variables:
- System-provided
The system-provided variables are provided by the Cloud Foundry environment.
They are split into VCAP\_APPLICATION and VCAP\_SERVICES :
- VCAP\_APPLICATION contain the attributes of your deployed application.
- VCAP\_SERVICES contain information about the service instances bound to your application, if any.
- User-provided You can create your own custom environment variables as key-value pairs. For more information, see
Create User-Provided Variables [page 2580].
## Environment Variable Groups
There are two types of environment variable groups:
- Running
All variables available to your application at runtime.
- Staging All variables available to your application at the time of staging.
## View System-Provided Variables and Environment Variable Groups
## Prerequisites
- You must have at least one application deployed in your Cloud Foundry space.
- You have the Space Developer or Space Supporter role.
## Procedure
1. In the SAP BTP cockpit, navigate to the Applications page in your Cloud Foundry space.
2. Choose the application whose environment variables you want to view.
3. Choose Environment Variables .
## Create User-Provided Variables
## Prerequisites
- You must have at least one application deployed in your Cloud Foundry space.
- You have the Space Developer or Space Supporter role.
## Procedure
1. In the SAP BTP cockpit, navigate to the Applications page in your Cloud Foundry space.
2. Choose the application for which you want to create a user-provided variable.
3. Choose User-Provided Variables .
4. Choose Create Variable .
5. Provide a Key and a Value . These values are case-sensitive.
6. Choose Create .
## Related Information
https:/ /docs.cloudfoundry.org/devguide/deploy-apps/environment-variable.html
## 6.2.6.2 Deploy an Application
You can use the SAP BTP cockpit to deploy a new application in the Cloud Foundry environment.
## Prerequisites
- You have the Space Developer role. For more information, see About Roles in the Cloud Foundry Environment [page 2510].
- You have enough space quota, or enough org quota if no space quota is assigned to the space. For more information, see Managing Space Quotas [page 2526].
## Procedure
1. In your Cloud Foundry subaccount, navigate to the space where you would like to deploy your application.
2. On the Applications page, choose Deploy Application .
3. Choose the location of the file which contains your application.
4. (Optional) If you would like to use a manifest, choose the location of your manifest.yml file.
##  Note
To avoid any unexpected behavior, specify the attributes of your choice and their respective values in the manifest.yml file. For reference, see https:/ /docs.cloudfoundry.org/devguide/deploy-apps/ manifest-attributes.html .
5. (Optional) If you don't want to use a manifest, select the Custom Settings radio button and enter the application details.
- a. Enter a name for your application.
- b. (Optional) Edit the amount of memory and disk space available to each instance of your application, as well as the number of instances.
The amount of memory per instance that you assign, in this step or in the manifest.yml file during deployment, is the value that is metered when using the Cloud Foundry runtime service. For more information, see the examples in Monitoring and Troubleshooting.
##  Note
By default, each instance of a new application is assigned 1024 MB of memory and 512 MB of disk space, and each application starts with 1 instance. If you require more or less resources, edit the prefilled fields in the form to suit your needs.
- c. (Optional) If you don't need a route for your application, switch off Create Route .
- d. (Optional) If you would like to create a route for your application, leave Create Route switched on and choose a Host name (if different from your application name) and a Domain for your application.
##  Note
When you enter an application name, the Host field is automatically filled with the same name. You can make changes to it or leave it as is. After deciding on a host and domain, you can see a preview of your final Application Route at the bottom of the form.
6. Choose Deploy .
## Results
The file containing your new application is uploaded and your application is deployed.
##  Note
If an application is displayed as Started according to the Requested State column, it doesn't automatically mean that the application is started. This is the desired state, but there might be an issue with an application instance. For any warning alerts, check the Instances column.
To get more detailed information about the current state of your application instances, navigate to the Overview page of the application.
## Related Information
Deploying to the Cloud Foundry Environment [page 597]
About Routes in the Cockpit [page 2589] Create Routes [page 2590]
## 6.2.6.4 Manage Application Instances
To increase the availability of your Cloud Foundry application, you can run multiple instances of it. In the SAP BTP cockpit, you can add or remove application instances, or change the size of their memory and disk.
## Prerequisites
- You must have one application deployed in your Cloud Foundry space.
- You have the Space Developer or Space Supporter role.
## Procedure
1. In the SAP BTP cockpit, navigate to the Applications page in your Cloud Foundry space.
2. Choose the application whose instances you want to manage.
3. In the Overview page of your application choose:
-  Instance to start an additional instance of your application.
-  Instance to remove one of the running instances of your application.
- Change Instance Details to update the memory size and the disk size of all instances of your application.
##  Note
Each instance of the application receives the size in megabytes you have specified. You can allocate instance memory up to the available space memory limit.
## Related Information
Deploy an Application [page 2580]
## 6.2.6.6 Troubleshoot Applications
You can use application events and logs to troubleshoot your application in the SAP BTP cockpit.
## Procedure
1. In the SAP BTP cockpit, navigate to the Applications page in your Cloud Foundry space.
2. Choose the application whose events or logs you want to manage.
3. Navigate to the Events or the Logs page.
For more information, see:
- Using Application Events [page 2586]
- Using Application Logs [page 2587]
## 6.2.6.6.1 Using Application Events
The Application Events page at application level in the SAP BTP cockpit shows the order in which actions are performed on an application. You can use these events to debug your application and analyze its state.
## UI Reference
| UI Component   | Role                                                                                                                                                                                                     |
|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Time           | Shows the timestamp at which an event is created and log- ged.                                                                                                                                           |
| Event          | Shows the type of the event. The application events use the audit.app.* naming pattern. For more information, see https:/ /docs.cloudfoundry.org/running/managing-cf/au- dit-events.html#app-lifecycle . |
| UI Component   | Role                                                                       |
|----------------|----------------------------------------------------------------------------|
| Actor          | Shows who triggered the event. It can be either you or Cloud Foundry.      |
| Target         | Shows where the event was triggered. Provides the name of the application. |
| Description    | Provides technical details about the event.                                |
## Related Information
Troubleshoot Applications [page 2586] Using Application Logs [page 2587]
## 6.2.6.6.2 Using Application Logs
The Logs page at application level in the SAP BTP cockpit shows the application logs and logs generated by various Cloud Foundry components that relate to the application. You can use these logs to identify and troubleshoot application-specific problems.
## UI Reference
| UI Component   | Role                                                                                                                                              |
|----------------|---------------------------------------------------------------------------------------------------------------------------------------------------|
| Time           | Shows the timestamp at which the log is generated.                                                                                                |
| Log Type       | Shows the type of the log according to Cloud Foundry. It can be either STDOUT or STDERR .                                                         |
| Source         | Shows the Cloud Foundry component code and the instance number. For example, [APP/1] indicates that application instance 1 has generated the log. |
| Message        | Allows you to view the log message in a message box. To open the message box, choose More Details .                                               |
## Related Information
https:/ /docs.cloudfoundry.org/devguide/deploy-apps/streaming-logs.html Troubleshoot Applications [page 2586] Using Application Events [page 2586]
## 6.2.6.7 Configuring Application URLs in the Cloud Foundry CLI
By default, all applications running on SAP BTP are accessed on the default landscape domain. According to your needs, you can change the default application URL by configuring additional application domains.
The URL for an application deployed on SAP BTP in the Cloud Foundry environment is https:// &lt;application&gt;.cfapps.&lt;region&gt;.hana.ondemand.com . The domain depends on your location, in the European region, for example, the domain is cfapps.eu10.hana.ondemand.com . So, if you're deploying an application with the name "myapp", the default application URL is https:// myapp.cfapps.eu10.hana.ondemand.com .
Running on the China (Shanghai) region:
There's no default URL available in China, therefore you can't deploy an application without configuring a custom domain first. Please refer to the related information link on how to use custom domains.
##  Note
To check what domains are available in your Cloud Foundry organization, use the command cf domains .
## Custom Domains
Use custom domains to reach your applications on your own domain instead of the default domain, for example, https://myapp.mydomain.com instead of https:// myapp.cfapps.eu10.hana.ondemand.com . When you use a custom domain, both the domain name and the TLS/SSL certificate of the server are owned by the customer.
You can configure custom domains using the Cloud Foundry command-line interface with the plugin for custom domains.
For more information, read the Custom Domain service user guide.
## Application Routes
If you want to make your application reachable on another route, you can add additional routes using the Cloud Foundry CLI. If your application is available under the route
https://myapp.cfapps.eu10.hana.ondemand.com , you could add a route that reads https:// expenses.cfapps.eu10.hana.ondemand.com that leads to the same application.
## Related Information
Using Custom Domains [page 2595]
About Routes in the Cockpit [page 2589] Configuring Application URLs (Neo environment)
## 6.2.6.8 About Routes in the Cockpit
To enable your end users to reach your application, create a route and map it to the application in the SAP BTP cockpit.
## What Is a Route?
A route is the URL that enables your end users to reach your application. Routes belong to a space, and therefore are managed at space level.
The Router component in Cloud Foundry is responsible for routing routes. It maintains a list of mapped applications and compares each request with the list to find the best match. Based on this comparison, it then routes requests to the appropriate application instance.
Currently, you can create, map, and delete HTTP routes. An HTTP route includes a domain, a host name (or subdomain), and an optional path.
## Creating Routes
The number of routes you can create in a space depends on your subaccount entitlements and quotas, or on the space quota assigned to that space.
For more information, see Create Routes [page 2590].
## Mapping Routes to Applications
You can only map a route to an application that belongs to the same space.
It is possible to map a single route to multiple applications, as well as multiple routes to a single application.
For more information, see Map Routes to Applications [page 2591].
## Binding Routes to Service Instances
To bind a route to a service instance in the SAP BTP cockpit, see Bind Routes to Service Instances [page 2592].