# Adding a BTP Global Account

To monitor an SAP BTP Global Account in Avantra, it is necessary only to set up API access to one Cloud Management Service (central plan) with a service binding inside a single subaccount. Avantra will subsequently discover the associated global account, all directories and other subaccounts, the activated environments, applications and services. For more information on Cloud Management Service (central plan), see SAP Documentation - SAP Cloud Management Service for SAP BTP.

| Avantra will create the service instances and service bindings required to monitor all discovered subaccounts.

## Configuring a BTP Global Account in Avantra

### Prerequisites

You require the following:

- A Global Account in Feature Set B.

- A user with the role Global Account Administrator

### Set up in the BTP Cockpit

Before you can configure a Global Account in Avantra, you need to set up the account in the BTP Cockpit.

1. Log into the BTP Cockpit and access your Global Account. For additional information see SAP Documentation - Log On to Your Global Account.

2. A Subaccount is required to enable monitoring. Either select an existing one, where a user is a member with the role Subaccount Administrator, or create a Subaccount. For information on how to create a Subaccount, see SAP Documentation - Create a Subaccount.

3. Create a new server instance of the Cloud Management Service. For information, see SAP Documentation - Creating Instances in Other Environments.

   1. Specify Service as Cloud Management Service.

   2. Specify Plan as Central.

   3. Specify Runtime Environment as Other.

   4. Instance Name can be named as per requirements.

4. Click Next.

   1. Specify the parameter Authorization Type as Client Credentials.

5. Click Create.

6. Create a Service Binding in the Service Instance. For information, see SAP Documentation - Creating Service Binding in Other Environments

   1. Specify a Binding Name.

   2. There is no requirement to upload a JSON file.

7. Open the Service Binding and make a note of the following values, as they are required for the remaining setup. The most efficient way is to copy the JSON file:

   1. `endpoints`

      1. `accounts_service_url`

   2. `uaa`

      1. `clientid`

      2. `clientsecret`

      3. `url`

### Set up in Avantra

In Avantra:

1. Navigate to Systems > SAP BTP Global Accounts.

2. Click New SAP BTP Global Account.

3. Define the account with a Name.

4. Select a Customer.

5. Select a System Role.

6. Click New.

7. In the Credentials tab, add the OAuth credentials. Using the values noted from the Service Binding:

   1. Add a Name for the credentials.

   2. Add the `clientid`, from the Service Binding, into the Client ID field.

   3. Add the `clientsecret`, from the Service Binding, into the Client Secret field.

   4. Add the `url`, from the Service Binding, into the Access Token URI field, and add `/oauth/token` to the end.

8. In the Properties tab:

   1. Define the `accounts_service_url` in the Accounts Service URL of Cloud Management Service, central plan field.

   2. Check the Self deployment checkbox.

9. Click Apply.

The Global Account monitoring can now be enabled. To do so, click Monitoring Switch. The Edit Monitoring Switch dialog will display the Global Account and all associated Subaccounts.