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:
-
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.”
-
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.”
-
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.
Field | Steps |
---|---|
Customer ID | Navigate to Account Home, and then click the User icon in the upper-right corner. |
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 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 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 Aruba Central Sites in Bulk
-
In Orchestrator, navigate to Administration > Software > Upgrade > System Information.
-
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.
-
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.
-
Save and close the file.
-
In Aruba Central, navigate to Launch > Network Operations > Organization > Sites.
-
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:
-
On the Aruba Central Site Mapping tab, click Aruba Central Account.
The Aruba Central Account dialog box opens.
-
Configure the following elements as needed:
Field Description Aruba Central Status of the connection. Customer ID Customer ID generated from Aruba Central. Email Email provided by Aruba Central. Password Aruba 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 ID Client ID generated from Aruba Central. Client Secret Client Secret generated from Aruba Central. API Gateway domain API Gateway URL without protocol (for example, internal-apigw.central.arubanetworks.com). -
To test the connection, click Test.
-
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.)
-
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:
-
Click the Edit icon next to an EdgeConnect appliance.
The Edit EdgeConnect to Aruba Central Site Mapping dialog box opens.
-
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 Aruba 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. -
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.