doc title Help Center
You are here: Home > Managing Access Points > Configuring Access Points > Setting Country Code

Setting Country Code

The initial Wi-FiWi-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 AP requires you to specify the country code for the country in which the Instant AP operates. This configuration sets the regulatory domain for the radio frequencies that the Instant AP uses. The available 20 MHzMegahertz, 40 MHz, or 80 MHz channels are dependent on the specified country code.

Country Code Configuration in Aruba Central from UI

If you provision a new Instant AP without the country code, Aruba Central exhibits the following behavior:

Table 1: Instant AP Provisioned To Aruba Central

Country Code Configured at Instant AP

Country Code Configured in Group

Behavior

No

Yes

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

No

No

Aruba 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 Instant AP.

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.

If an Instant AP has a country code and joins Aruba Central using ZTPZero 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 Instant AP is retained. In this case, Aruba Central will not push the group country code.

Setting Country Code at Group Level

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

1. In the Network Operations app, set the filter to a group that contains at least one AP.

The dashboard context for the group is displayed.

2. Under Manage, click Devices > Access Points.

A list of access points is displayed in the List view.

3. Click the Config icon.

The tabs to configure the access points are displayed.

4. Click Show Advanced, and click the System tab.

The System details page is displayed.

5. Click General.

6. In the Set Country code for group drop-down list, select the country code for Instant AP.

7. Click Save Settings.

8. Reboot Instant AP for changes to take effect.

By default, the value corresponding to the Set Country code for group field is empty. This indicates that any Instant AP 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 Instant AP also will be updated.

Setting Country Code at Device Level

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

1. In the Network Operations app, set the filter to a group that contains at least one AP.

The dashboard context for the group is displayed.

2. Under Manage, click Devices > Access Points.

A list of access points is displayed in the List view.

3. Click the Config icon.

The tabs to configure the access points are displayed.

4. Click Show Advanced, and click the System tab.

The System details page is displayed.

5. Click General.

6. In the Virtual Controller pane, select an Instant AP, and then click the edit icon.

7. Select the new country code from the Country Code drop-down list.

8. Click OK.

9. Reboot Instant AP for changes to take effect.

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 Instant AP will always be the most recently set country code at the group level or device level.

Aruba Central now constantly displays the default tabs under the Show Advanced and Hide Advanced option in the Devices > Access Points page, When you click the Show Advanced or Hide Advanced option and navigate out of the page, the respective default tabs under Show Advanced or Hide Advanced option are still displayed when you visit the page next time.

The auto If there is a discrepancy in country code configuration, Aruba Central displays it as an override in the Configuration Audit page.

Country Code Configuration at Group Level from API

Aruba Central provides an option to set and get the country code at group level through the APIsApplication 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 Account Home page, click API Gateway.

The API Gateway page is displayed.

2. Click the Authorized Apps & Tokens tab and generate a token key.

3. Download and copy the generated token.

4. In the All Published APIs window, click the urlUniform 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.

5. On the left navigation pane, select Configuration from the URL drop-down list.

6. Paste the token key in the Token field and press enter.

7. 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. Aruba Central currently allows country codes of up to 50 Instant AP 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 Instant AP group. To get the country code information of the Instant AP 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 Instant AP 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

For further details on APIs, see https://app1-apigw.central.arubanetworks.com/swagger/central.

/*]]>*/