## 3.3.1.2.6 Creating an ABAP System
Create a service instance for the ABAP environment from the Service Marketplace.
## Prerequisites
You have increased the quota for the ABAP environment. See Increasing the Quota for the ABAP Environment [page 180].
## Context
<!-- image -->
For more information about creating service instances, see Create Service Instances Using the Cockpit.
## Procedure
1. Log on to the SAP BTP cockpit and navigate to the Cloud Foundry subaccount. See Navigate in the Cockpit .
2. From the navigation area, choose Services Service Marketplace.
You see a list of all services that are available to you.
3. Choose ABAP environment .
4. Choose Create .
A wizard opens that helps you create your instance.
<!-- image -->
5. Select the standard service plan.
6. Choose Cloud Foundry as your runtime environment.
7. Select a space.
8. Enter a CLI-friendly instance name, and choose Next .
The instance name identifies the service instance in the Cloud Foundry environment. Specify an instance name that is unique among all the service instances in a space and only contains alphanumeric characters (A-Z, a-z), periods, underscores, and hyphens.
9. Provide additional instance parameters for the configuration by either using the default form or by uploading a JSON file from your computer or by specifying the parameters in JSON format. Here is a list of all parameters:
| Parameter (technical name in parenthesis)     | Note                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
|-----------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Admin Email Address ( admin_email )           | The admin email address is used to create the initial user for the ABAP sys- tem automatically, including the assignment of the administrator role to this user. You can access the ABAP environment system only with this specified user. By default, the email address is used as subject name identifier.                                                                                                                                                                                                                                                                    |
| Admin Employee ID admin_employee_id           | The admin employee ID is an optional parameter used to provide the em- ployee ID for the initial user. You can either set it directly by using this parameter during instance creation or after instance creation in the Maintain Employees Fiori application of the ABAP environment service instance. Once set, it cannot be changed anymore. The employee ID must only contain uppercase letters, digits, underscores, hyphens and periods, and must not be longer than 60 characters.                                                                                       |
| ABAP System Description ( description )       | The ABAP system description is optional.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| Development System ( is_development_allowed ) | The development system checkbox is checked by default. By using this set- ting, you can control the changeability of development objects in the system. If you want to protect all your customer-related software components and ABAP namespaces against manual changes via ABAP development tools for Eclipse, uncheck the box. This setting is used for test and productive sys- tems, where changes must be imported only. For information about which business catalogs are available in development systems only, see Business Catalogs for Development Tasks [page 2648]. |
| ABAP System ID ( sapsystemname )              | The ABAP system ID must consist of exactly three alphanumeric charac- ters. Only uppercase letters are allowed. The first character must be a letter (not a digit). The ID does not have to be technically unique.                                                                                                                                                                                                                                                                                                                                                              |
| Total ABAP Runtime Size ( size_of_runtime )   | The Total ABAP runtime size refers to the runtime size of the ABAP environment service instance. This is the sum of the runtime size of all ABAP application servers of an ABAP environment service instance. The size is specified in number of ABAP compute units that should be used from the quota plan abap_compute_unit , with one ABAP compute unit representing 16 GB. The supported number of abap_compute_unit is 1, 2, 4, 6, 8, 16, 24, or 32. For more information, see ABAP Compute Units [page 3114].                                                             |
| Parameter (technical name in parenthesis)                            | Note                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
|----------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| ABAP Runtime Size per Application Server ( application_server_size ) | 5 won't work. This is because a total runtime size of 5 ACUs can't be split into three application servers with 2 ACUs each. The ABAP Runtime Size per Application Server refers to the size of a sin- gle ABAP application server in an ABAP environment service instance. It's specified in ABAP compute units (ACUs), with one ACU representing 16 GB. This parameter doesn't consume additional abap_compute_unit quota. Instead, it determines the distribution of the quota defined via the total ABAP runtime size among the application servers. Possible values are 0.5, 2, or 'auto', which is the default. A higher value results in fewer, but larger, application servers. Conversely, a lower number results in more, but smaller, application servers for the                                                                                                                                                                                              |
| Elastic Scaling of the ABAP Applica- tion Server ( elastic )         | servers of the same size each. Therefore, the possible value for the ABAP runtime size per application server depends on the total ABAP runtime size. For instance, application_server_size = 2 can only be set if the size_of_runtime is at least 4 ACUs. On the other hand, application_server_size = 0.5 can only be set if the size_of_runtime isn't higher than 8 ACUs. To decide what value to choose, consider the following: • Servers of size 0.5 ACUs allow more fine-granular scaling and are suita- ble for most use cases. • Larger servers allow slightly more user sessions per ACU. This might be more efficient in systems with very high ACU consumption. They're also a precondition for some exceptional use cases, such as ATC checks for very large ABAP programs. The elastic scaling of the ABAP application server parameter defines whether or not to adapt the number of ABAP application servers dynami- cally, depending on the system load. |
| Parameter (technical name in parenthesis)         | Note                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
|---------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|                                                   | By default, the checkbox is not checked ( elastic = false ), and the service instance will have a fixed number of ABAP application servers with a total ABAP runtime size as defined by the parameter Total ABAP Runtime Size (see above). If you enable elastic scaling by checking the checkbox ( elastic = true ), application servers will be automatically added to the service in- stance when the load increases and removed when the load decreases. More specifically, the number of application servers will scale between the number of ACUs (ABAP compute units) needed for two application servers as a minimum (1 ACU if application_server_size = 0.5 or 4 ACU if applica- tion_server_size = 2), and the number of ACUs configured in the Total ABAP Runtime Size parameter (see above) as a maximum. This feature considerably helps in cost-saving as charges are only levied based on the actually allocated ACUs, and not on the configured maximum. Still, to ensure that defined quotas are not exceeded, the maximum number of ACUs that is set in the Total ABAP Runtime Size parameter is allocated from the available ACU quota for the entire duration that the service in- stance is provisioned. The scaling typically occurs within a couple of minutes. Especially when a service instance is scaled down, there is a grace period of a few minutes to allow the completion of short-lived requests. Before enabling elastic scaling in production, we advise to test your typical workload patterns and monitor the embededed Health Monitoring app to verify the suitability of this cost- saving measure. Maintaining a higher number of statically configured ACUs might be better for handling sudden large spikes in the system load. |
| HANA Cloud Memory Size ( size_of_persistence )    | The HANA Cloud memory size refers to the memory size of theSAPHANA Cloud database used by the ABAP environment service instance. The size is specified in number of HANAcompute units that should be used from the quota plan hana_compute_unit , with one HANAcompute unit representing a block size of 16 GBfor the underlying SAP HANACloud instance. The supported number of hana_compute_unit per HANAinstance is 2, 4, 8, 16, 32, or 64.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| HANA Cloud Disk Size ( size_of_persistence_disk ) | The HANA Cloud disk size refers to the disk size in GBof theSAPHANA Cloud database used by the ABAP environment service instance. If the parameter is set to auto , the SAP HANACloud storage size is set to the minimal value 40 * size_of_persistence + 40 . The maximum allowed value is 120 * size_of_persistence + 40 . If you set a higher value, it will consume 0.002 HANAcompute units (HCU) for anyGB exceeding the minimal default size of the persistence disk. Therefore, the HCUratio of additional storage disk to RAMis 1 : 31.25 perGB(as1HCU=16 GB).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
## Parameter (technical name in
| parenthesis)                        | Note                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
|-------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Admin User Name ( admin_user_name ) | The admin user name is an optional parameter used to provide the user name for the initial user. It must be provided if the login attribute is set to user_name (see below).                                                                                                                                                                                                                                                                                                      |
| Login Attribute ( login_attribute ) | Using an email address as subject name identifier might not be possible if the e-mail address is ambiguous across users, or if the trusted iden- tity provider configured for authentication in the subaccount of the ABAP environment instance is already configured with the subject name identi- fier Login Name . In this case, you can change the login attribute to user_name . In addition, provide the user name for the initial user in the admin user name (see above). |
|                                     |  Caution Currently, it's only possible to change the login attribute when creating a new ABAP system . To change the settings afterwards , please create a service ticket.                                                                                                                                                                                                                                                                                                       |
##  Note
Make sure that you don't choose more compute units than you have assigned to your subaccount for the ABAP environment (see Increasing the Quota for the ABAP Environment [page 180]).
For more information about ABAP system sizing and Native Storage Extension for selected SAP HANA tables, see ABAP System Sizing [page 3102] and Native Storage Extension for the ABAP Environment [page 3106].
##  Caution
Be aware that not all parameters can be changed if you update your ABAP system. For a list of updatable parameters, see Updating an ABAP System [page 188].
10. Choose Next to review and verify your instance details.