Setting Country Code

The initial Wi-Fi Wi-Fi is a technology that allows electronic devices to connect to a WLAN network, mainly using the 2.4 GHz and 5 GHz radio bands. Wi-Fi can apply to products that use any 802.11 standard. setup of an Instant Access Point (IAP) requires you to specify the country code for the country in which the IAP operates. This configuration sets the regulatory domain for the radio frequencies that the IAP uses. The available 20 MHz Megahertz, 40 MHz, or 80 MHz channels are dependent on the specified country code.

Country Code Configuration in HPE Aruba Networking Central from UI

If you provision a new IAP without the country code, HPE Aruba Networking Central exhibits the following behavior:

Table 1: IAP Provisioned to HPE Aruba Networking Central

Country Code Configured at IAP

Country Code Configured in Group

 Behavior

No

Yes

The country code of the group is pushed to the newly added IAP.

No

No

HPE Aruba Networking Central displays the Country Code not set. Config not updated message in Audit Trail. A notification is also displayed at the bottom of the main window to set the country code of the new IAP.

To set the country code, perform the following actions:

1. Click Set Country Code now link on the notifications pane. The Set Country Code pop up is displayed.

2. In the Device(s) without country code table, click the edit icon.

3. Specify a country code from the Country Code drop-down list.

4. Click Save.
Setting Cory Code At Group Level

If an IAP has a country code and joins HPE Aruba Networking Central using ZTP Zero Touch Provisioning. ZTP is a device provisioning mechanism that allows automatic and quick provisioning of devices with a minimal or at times no manual intervention. configuration, then the country code of the IAP is retained. In this case, HPE Aruba Networking Central will not push the group country code.

Setting Country Code at a Group Level

To set the country code of the IAP at the group level, complete the following steps:

  1. In the WebUI, set the filter to a group containing at least one AP.

    The dashboard context for the group is displayed.

  2. Under Manage, click Devices > Access Points.

    A list of APs is displayed in the List view.

  3. Click the Config icon.

    The default tabs to configure the virtual controller are displayed.

  4. Click Show Advanced to view advanced configuration options.
  5. Click the System tab.

    The System details page is displayed.

  6. Expand the General accordion.
  7. In the Set Country code for group drop-down list, select the country code for the IAP.
  8. Click Save Settings and then reboot the IAP.
  • By default, the value corresponding to the Set Country code for group field is empty. This indicates that any IAP with different country codes can be a part of the group.
  • When the Set Country code for group field is set, the field cannot revert to the default value. When the country code of the group is changed, the country code of the already connected IAP also will be updated.

Setting Country Code at a Device Level

To set the country code of the IAP at the device level, complete the following steps:

  1. In the WebUI, set the filter to a group containing at least one AP.

    The dashboard context for the group is displayed.

  2. Under Manage, click Devices > Access Points.

    A list of APs is displayed in the List view.

  3. In the Virtual Controller column, click the virtual controller link to navigate to the Access Points > List view of the virtual controller.

    When you click the virtual controller link in the Virtual Controller column, the dashboard context for the virtual controller is dispalyed.

  4. Click the Config icon.

    The default tabs to configure the virtual controller are displayed.

  5. Click Show Advanced to view advanced configuration options.
  6. Click the System tab.

    The System details page is displayed.

  7. Expand the General accordion.
  8. In the Virtual Controller table, select a virtual controller and then click the edit icon.
  9. In the Edit IP Address window, select the country code from the Country Code drop-down list.
  10. Click Ok.
  11. Click Save Settings and then reboot the IAP.
  • By default, the value corresponding to the Country code is the country code set at the group level which can be then modified at the device level from the drop-down list. The country code of the IAP will always be the most recently set country code at the group level or device level.
  • If there is a discrepancy in the country code configuration, HPE Aruba Networking Central displays it as an override in the Configuration Audit page.

Country Code Configuration at Group Level from API

HPE Aruba Networking Central provides an option to set and get the country code at group level through the APIs Application Programming Interface. Refers to a set of functions, procedures, protocols, and tools that enable users to build application software. in API Gateway.

To set or get the country code at group level through API, complete the following steps:

  1. In the Aruba Central app, set the filter to Global.

  2. Under Maintain, click Organization > Platform Integration.
  3. Under the API Gateway tile, click Rest API.

    4. The API Gateway page is displayed.

  4. Click the My Apps & Tokens tab and generate a token key.

    The token key is valid only for 2 hours from the time it was generated.

  5. Download and copy the generated token.
  6. Click APIs tab.
  7. In the All Published APIs window, click the url Uniform Resource Locator. URL is a global address used for locating web resources on the Internet. link listed under the Documentation column.

    The Central Network Management APIs page is displayed.

  8. On the left navigation pane, select Configuration from the Category drop-down list.
  9. Paste the token key in the Token field and press enter.
  10. Click NB UI Group Configuration.

     The following options are displayed:

    • Set country code at group level ([PUT]/configuration/v1/country)—This API allows to set country code for multiple groups at once. HPE Aruba Networking Central currently allows country codes of up to 50 IAP device groups to be configured simultaneously. To set the country codes of multiple groups, enter the group names and country code as inputs corresponding to the groups and country labels respectively in the script { "groups": [ "string" ], "country": "string" } within the set_ group_config_ country_ code text box.
    • Get country code set for group ([GET]/configuration/v1/{group}/country)—This API allows to retrieve the country code set for a specific IAP group. To get the country code information of the IAP group, enter the name of the group for which the country code is being queried corresponding to the country label in the script { "country": "string"} within the group text box.

The APIs for setting and retrieving country code information are not available for the IAP devices deployed in template groups.

The following are the response messages displayed in the Set country code at group level and Get country code set for group sections:

Table 2: Response Messages

Set country code at group level

Get country code set for group

  • 201 - Successful operation
  • 400 - Bad Request
  • 401 - Unauthorized access, authentication required
  • 403 - Forbidden, do not have write access for group
  • 413 - Request-size limit exceeded
  • 417 - Request-size limit exceeded
  • 429 - API Rate limit exceeded
  • 500 - Internal Server Error
  • 503 - Service unavailable, configuration update in progress
  • 400 - Bad Request
  • 401 - Unauthorized access authentication required
  • 403 - Forbidden, do not have read access for group
  • 413 - Request-size limit exceeded
  • 417 - Request-size limit exceeded
  • 429 - API Rate limit exceeded
  • 500 - Internal Server Error
  • 503 - Service unavailable, configuration update in progress

Swagger documentation displays more information on APIs. To access the Swagger documentation, see API Gateway.