Link Search Menu Expand Document

Aruba Central Site Mapping

Orchestrator > Aruba Central > Aruba Central Site Mapping

Use this tab to create an Aruba Central account in Orchestrator. After you create an Aruba Central account, Orchestrator maps EdgeConnect appliances to Aruba Central sites. When mapped, EdgeConnect appliances display in the Network Health tab in Aruba Central and provide real-time site health updates.

NOTE: Single Sign-On (SSO) to Aruba Central from Orchestrator is not supported. If your account is SSO-enabled, or if two-factor user verification is enabled, you will not be able to use the account for Central Site Mapping integration.

Prerequisites

Before you can integrate Unity EdgeConnect devices with Aruba Central, you must do the following:

  1. Create an Aruba Central account. For more information on creating an Aruba Central account, see Aruba Central Online Help and search for “Unity EdgeConnect Integration.”
  2. Generate an API token for Orchestrator in Aruba Central. For more information on generating an API token for Orchestrator, see Aruba Central Online Help and search for “Unity EdgeConnect Integration.”
  3. Have existing Aruba Central sites to map EdgeConnect appliances to. If you do not have any existing Aruba Central sites, you can export the location details for EdgeConnect appliances and create Aruba Central sites in bulk from that exported list. For more information on creating Aruba Central sites in bulk, see Create Aruba Central Sites in Bulk.

You need the following details from your Aruba Central account.

FieldSteps
Customer IDNavigate to Account Home, and then click the User icon in the upper-right corner.
EmailNavigate to Account Home > API Gateway > System Apps & Tokens. The email is listed in the Name column.
PasswordNavigate to Account Home > API Gateway > System Apps & Tokens, and then click View Tokens.

NOTE: If the Aruba Central password changes, you must update this password whether authentication is configured as a system user or as a federated user.

NOTE: If you do not remember the password, you must reset it from Aruba Central. For more information on resetting your Aruba Central password, see Aruba Central Online Help.
Client IDNavigate to Accounts Home > API Gateway > APIs > System Apps & Tokens.
Client SecretNavigate to Accounts Home > API Gateway > APIs > System Apps & Tokens.
API Gateway URLNavigate to Account Home > API Gateway. The URL is listed in the Documentation column.

NOTE: Copy the URL without the protocol (for example, internal-apigw.central.arubanetworks.com).

Create Aruba Central Sites in Bulk

  1. In Orchestrator, navigate to Administration > Software > Upgrade > System Information.

  2. In the appliance tree, select the appliances you want to create Aruba Central sites for, and then click Export.

    Orchestrator creates and downloads a .csv file.

  3. Open the .csv file, and then delete the three header rows.

    TIP: Refer to the sample import file provided by Aruba Central for proper formatting. To view the sample import file, in Aruba Central, navigate to Launch > Network Operations > Organization > Sites > Bulk Upload, and then click Download a sample file on the Bulk Import dialog.

  4. Save and close the file.

  5. In Aruba Central, navigate to Launch > Network Operations > Organization > Sites.

  6. Scroll to the bottom of the page, click Bulk Upload, and then follow the prompts.

Create an Aruba Central Account in Orchestrator

To create an Aruba Central account in Orchestrator:

  1. On the Aruba Central Site Mapping tab, click Aruba Central Account.

    The Aruba Central Account dialog box opens.

  2. Configure the following elements as needed:

    FieldDescription
    Aruba CentralStatus of the connection.
    Customer IDCustomer ID generated from Aruba Central.
    EmailEmail provided by Aruba Central.
    PasswordAruba Central password.

    NOTE: If the Aruba Central password changes, you must update this password whether authentication is configured as a system user or as a federated user.

    NOTE: If you do not remember the password you must reset the Aruba Central password from Aruba Central. For more information on resetting your Aruba Central password, see Aruba Central Online Help.
    Client IDClient ID generated from Aruba Central.
    Client SecretClient Secret generated from Aruba Central.
    API Gateway URLAPI Gateway URL without protocol (for example, internal-apigw.central.arubanetworks.com).
  3. To test the connection, click Test.

  4. If the connection is successful, click Save.

    Orchestrator maps EdgeConnect appliances to Aruba Central sites based on geolocation. (Addresses assigned to EdgeConnect appliances are converted to geolocations.)

  5. If “None” displays in the Aruba Central Site column of an appliance, Orchestrator did not locate an Aruba Central site within range of the appliance (within 0.2 degrees of the latitudeDelta and the longitudeDelta combined). Do one of the following:

    • Edit the appliance and manually map it to any Aruba Central site. For more information on mapping an EdgeConnect appliance to an Aruba Central site, see Edit EdgeConnect to Aruba Central Site Mapping.
    • Add an Aruba Central Site within range of the EdgeConnect appliance, and then check for site list updates. For more information on checking for site list updates, see Check for Site List Updates.

Edit EdgeConnect to Aruba Central Site Mapping

Orchestrator maps EdgeConnect appliances to Aruba Central sites based on geolocation. Orchestrator maps EdgeConnect appliances to Aruba Central sites that are within 0.2 degrees of the latitudeDelta and the longitudeDelta combined.

You can edit an EdgeConnect appliance to map it to a different Aruba Central site. You can also edit an EdgeConnect appliance to map it to an Aruba Central site if Orchestrator did not locate an Aruba Central site within range of the EdgeConnect appliance.

To map an EdgeConnect appliance to an Aruba Central site:

  1. Click the Edit icon next to an EdgeConnect appliance.

    The Edit EdgeConnect to Aruba Central Site Mapping dialog box opens.

  2. Configure the following elements as needed:

    FieldDescription
    EdgeConnect ApplianceSelected EdgeConnect appliance.
    Aruba Central SiteAvailable sites to map the EdgeConnect appliance to.
    Geolocation Suggested SiteAruba Central site that Orchestrator mapped by geolocation to the EdgeConnect appliance.

    NOTE: If you map the EdgeConnect appliance to any other site, the site that Orchestrator suggests based on geolocation will display next to that site in parentheses.
  3. Click Save.

    Orchestrator maps the appliance to the Aruba Central site you selected.

Check for Site List Updates

To refresh the Aruba Central site list in Orchestrator to check for Aruba Central site list updates, click Check for Site List Updates.

If new Aruba Central sites are detected within range of unmapped EdgeConnect appliances (within 0.2 degrees of the latitudeDelta and the longitudeDelta combined), Orchestrator maps the EdgeConnect appliances to the new Aruba Central sites.


Back to top

© Copyright 2022 Hewlett Packard Enterprise Development LP. The information contained herein is subject to change without notice. The only warranties for Hewlett Packard Enterprise products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. Hewlett Packard Enterprise shall not be liable for technical or editorial errors or omissions contained herein. Aruba Networks and the Aruba logo are registered trademarks of Aruba Networks, Inc. Third-party trademarks mentioned are the property of their respective owners. To view the end-user software agreement, go to Aruba EULA.