Link Search Menu Expand Document

Aruba Central Site Mapping

Orchestrator > HPE Integration Services > Aruba Central Site Mapping

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

NOTE: Single Sign-On (SSO) to HPE Aruba Networking 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 HPE Aruba Networking Central Site Mapping integration.

Prerequisites

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

  1. Create an HPE Aruba Networking Central account. For more information on creating an HPE Aruba Networking Central account, see HPE Aruba Networking Central Online Help and search for “Unity EdgeConnect Integration.”

  2. Generate an API token for Orchestrator in HPE Aruba Networking Central. For more information on generating an API token for Orchestrator, see HPE Aruba Networking Central Online Help and search for “Unity EdgeConnect Integration.”

  3. Have existing HPE Aruba Networking Central sites to map EdgeConnect appliances to. If you do not have any existing HPE Aruba Networking Central sites, you can export the location details for EdgeConnect appliances and create HPE Aruba Networking Central sites in bulk from that exported list. For more information on creating HPE Aruba Networking Central sites in bulk, see Create HPE Aruba Networking Central Sites in Bulk.

You need the following details from your HPE Aruba Networking Central account.

Field Steps
Customer ID Navigate to Account Home, and then click the User icon in the upper-right corner.
Email Navigate to Account Home > API Gateway > System Apps & Tokens. The email is listed in the Name column.
Password Navigate to Account Home > API Gateway > System Apps & Tokens, and then click View Tokens.

NOTE: If the HPE Aruba Networking 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 HPE Aruba Networking Central. For more information on resetting your HPE Aruba Networking Central password, see Aruba Central Online Help.
Client ID Navigate to Accounts Home > API Gateway > APIs > System Apps & Tokens.
Client Secret Navigate to Accounts Home > API Gateway > APIs > System Apps & Tokens.
API Gateway domain Navigate 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 HPE Aruba Networking 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 HPE Aruba Networking 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 HPE Aruba Networking Central for proper formatting. To view the sample import file, in HPE Aruba Networking 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 HPE Aruba Networking 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 HPE Aruba Networking Central Account in Orchestrator

To create an HPE Aruba Networking 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:

    Field Description
    Aruba Central Status of the connection.
    Customer ID Customer ID generated from HPE Aruba Networking Central.
    Email Email provided by HPE Aruba Networking Central.
    Password HPE Aruba Networking Central password.

    NOTE: If the HPE Aruba Networking 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 HPE Aruba Networking Central password from HPE Aruba Networking Central. For more information on resetting your Aruba Central password, see HPE Aruba Networking Central Online Help.
    Client ID Client ID generated from HPE Aruba Networking Central.
    Client Secret Client Secret generated from HPE Aruba Networking Central.
    API Gateway domain API 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 HPE Aruba Networking 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 HPE Aruba Networking 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 HPE Aruba Networking Central site. For more information on mapping an EdgeConnect appliance to an HPE Aruba Networking Central site, see Edit EdgeConnect to HPE Aruba Networking Central Site Mapping.

    • Add an HPE Aruba Networking 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 HPE Aruba Networking Central Site Mapping

Orchestrator maps EdgeConnect appliances to HPE Aruba Networking Central sites based on geolocation. Orchestrator maps EdgeConnect appliances to HPE Aruba Networking 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 HPE Aruba Networking Central site. You can also edit an EdgeConnect appliance to map it to an HPE Aruba Networking Central site if Orchestrator did not locate an HPE Aruba Networking Central site within range of the EdgeConnect appliance.

To map an EdgeConnect appliance to an HPE Aruba Networking 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:

    Field Description
    EdgeConnect Appliance Selected EdgeConnect appliance.
    Aruba Central Site Available sites to map the EdgeConnect appliance to.
    Geolocation Suggested Site HPE Aruba Networking 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 HPE Aruba Networking Central site you selected.

Check for Site List Updates

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

If new HPE Aruba Networking 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 HPE Aruba Networking Central sites.


Back to top

© Copyright 2024 Hewlett Packard Enterprise Development LP.

For third-party trademark acknowledgements, go to Trademark Acknowledgements. All third-party marks are property of their respective owners.

To view the end-user software agreement, go to HPE Aruba Networking EULA.

Open Source Code:

This product includes code licensed under certain open source licenses which require source compliance. The corresponding source for these components is available upon request. This offer is valid to anyone in receipt of this information and shall expire three years following the date of the final distribution of this product version by Hewlett Packard Enterprise Company. To obtain such source code, please check if the code is available in the HPE Software Center at https://myenterpriselicense.hpe.com/cwp-ui/software but, if not, send a written request for specific software version and product for which you want the open source code. Along with the request, please send a check or money order in the amount of US $10.00 to:

Hewlett Packard Enterprise Company
Attn: General Counsel
WW Corporate Headquarters
1701 E Mossy Oaks Rd Spring, TX 77389
United States of America