Device Onboarding - FAQs/Troubleshooting

You can use the following list of commands to troubleshoot/resolve device problems based on the Activation Status.

If the AP model does not support the Extended SSID Scale feature and is added to an AP Group with that option enabled, the AP will remain in a “Waiting for First Connect” state.

• The following Stellar AP models support an Extended SSID Scale: AP1201, AP1321, AP 1322, AP1261, AP1361D, AP1362, AP1301H, AP1331, AP1351, AP1451, AP1411, AP1431, AP1201BG.

• Consider creating a separate AP Group with the Extended SSID Scale option disabled (the default) for models that don’t support Extended SSID Scale.

An incorrect configuration can cause the Activation Status field for the AP to indicate “Provisioning Failed”:

• Country Code Conflict.

  • Wireless regulations vary by country, so APs are configured and shipped based on the country's regulations. The Country Code configured for the RF Profile used to manage these APs must match the country code for the APs it is managing. If they do not match, the APs will remain in an unmanageable state until the problem is resolved.

  • The AP Country Code conflicts with the Country Code in the RF Profile.

  • Steps to check the Country Code on AP:

    • Navigate to the Device Catalog List.

    • Select the AP on the Device Catalog List, then click on Actions and choose SSH from the drop-down menu.

    • Input the username and password of AP and click on Start Session.

    • In the AP session, run the command: showsysinfo to check Country Code.

  • Steps to check the Country Code in the OmniVista Cirrus UI:

    • Navigate to the Device Catalog List.

    • Select the AP on the Device Catalog List, then click on the Additional Information icon to check which RF Profile the AP is using.

    • If AP is using a specific RF Profile, navigate to the RF Profiles List, select RF Profile name, and check the Country Code on the details page.

    • If AP is using RF Profile of AP Group, navigate to the Access Point Groups List to which AP belongs, check the provisioning name, then navigate to the Provisioning Configuration List to check RF name for the Provisioning Configuration.

• Auto Group VLAN enabled and OmniVista Cirrus does not find the VLAN that matches the AP.

  • Steps to check VLAN:

    • Navigate to the Provisioning Configuration List.

    • Click the Additional Information icon to check Auto-Group VLANs in the Time section.

• RAP feature is enabled and AP Group does not have enough IP addresses from the IP Range in the Data VPN Server to allocate for the AP.

  • Steps to check IP range:

    • Navigate to the Provisioning Configuration List.

    • Click the Additional Information icon to see data VPNs in the Data VPN settings section.

    • Navigate to Data VPN Settings.

    • Check the IP Range for the data VPNs.

• Some related logs in AP to troubleshoot:

  • /tmp/log/wmaagent.log
    Check some content in the log related to registration flow as below:
    “Main Send to WMA msgtype=registration,message=...”
    “Main Receive from WMA msgtype=registration ,message=…”
    “Main Receive from WMA msgtype=preconfig ,message=…”
    “Main Send to WMA msgtype=preconfig,message=…”

• Logs in OmniVista Cirrus to check:

  • Organization user audit logs.

  • Network device alerts.

  • Network events.

Provide the Alcatel-Lucent Enterprise Technical Support team with the serial number and URL so they can verify their configuration in the cluster and do any clean up as necessary.

If the registered AP is unable to broadcast SSIDs:

Check to see if the SSID was successfully pushed to the AP.

1. Navigate to the Device Catalog List (Configure > Inventory > Device Catalog).

2. Select the AP on the Device Catalog List, then click on Actions and choose the SSH item from the drop-down menu.

3. Input the username and password of the selected AP and click on Start Session.

4. Run this command: cd /tmp/local_config

5. Run this command: cat wlanservice.conf to check the SSID

The SSID is configured as 6Ghz but some countries do not support 6Ghz. To check the SSID band:

1. Navigate to the SSIDs List (Configure > WireLess > SSIDs)

2. Select the SSID that you want to check, then click on Edit icon to open the Customize SSID screen.

3. Check the bands selected for the Allow Band attribute in the Basic Information section.

Some related AP logs and commands to troubleshoot:

• /tmp/log/wmaagent.log

• /tmp/log/wma.log

• sta_list

Logs in OmniVista Cirrus to check:

• Organization user audit logs (Organization > Users > Audit Logs)

• Network device alerts (Monitor > Alerts)

• Network events (Monitor > Diagnostic Tools > Network Events > Events)

If the registered AP is unable to broadcast SSIDs:

Check to see if the SSID was successfully pushed to the AP.

1. Navigate to the Device Catalog List (Configure > Inventory > Device Catalog).

2. Select the AP on the Device Catalog List, then click on Actions and choose the SSH item from the drop-down menu.

3. Input the username and password of the selected AP and click on Start Session.

4. Run this command: cd /tmp/local_config

5. Run this command: cat wlanservice.conf to check the SSID

The SSID is configured as 6Ghz but some countries do not support 6Ghz. To check the SSID band:

1. Navigate to the SSIDs List (Configure > WireLess > SSIDs)

2. Select the SSID that you want to check, then click on Edit icon to open the Customize SSID screen.

3. Check the bands selected for the Allow Band attribute in the Basic Information section.

Some related AP logs and commands to troubleshoot:

• /tmp/log/wmaagent.log

• /tmp/log/wma.log

• sta_list

Logs in OmniVista Cirrus to check:

• Organization user audit logs (Organization > Users > Audit Logs)

• Network device alerts (Monitor > Alerts)

• Network events (Monitor > Diagnostic Tools > Network Events > Events)