Device Registration Through CLI Using Device User

The Device user account is used to register an ACOS device through CLI.

Prerequisites

Before registering a device through CLI using device user, ensure that the following prerequisites are met:

• A device user account must be created in A10 Control, with valid username and password.
• You have CLI access to the vThunder device.
• The device must reach the A10 Control host IP (test.a10control.a10networks.com) over port 443 through the management network.
• The organization name and cluster name to which the device will be registered must be available.

Register an ACOS Device

To register an ACOS device through CLI using a device user account:

1. Log in to an ACOS device using your credentials.

2. Enter enable and then configure to enter configuration mode:

   ACOS>enable

   Password: 

   ACOS#configure

   ACOS(config)#

3. Enter A10 Control profile mode.

   ACOS(config)#controller profile

4. Configure A10 Control host name or IPv4/IPv6 address and the port details.

   ACOS(config-profile)#host test.a10control.a10networks.com port 443

   The hostname is part of A10 Control login URL, which is included in the activation email sent to the first Organization Admin (organization). For example, see the highlighted host name in the login URL, test.a10control.a10networks.com/login/provider-abc-5HJ9.

   If you want to use management interface for communicating with A10 Control instead of data interface, then configure use-mgmt-port.

   ACOS(config-profile)#host test.a10control.a10networks.com port 443 use-mgmt-port

5. Enter the Organization name, included in the email that you received on purchasing the license.

   ACOS(config-profile)# organization organization-abc

6. Enter the Cluster Name.

   vThunder(config-controller-profile)#cluster-name  a10c_cluster

7. Enter the Device User credentials.

   vThunder(config-controller-profile)#user-name a10custer

   vThunder(config-controller-profile)#password  Password@123456

8. (Optional) Specify the country or region and city or zone of the ACOS device.

   ACOS(config-profile)# region United State of America

   ACOS(config-profile)# availability-zone Sacramento

   NOTE:

   The list of supported regions and availability-zones is accessible from the A10 Control GUI, so it is recommended that you update the region and availability-zone fields in the A10 Control GUI. These locations can be mapped to the GEO map.

9. (Optional) Add cluster ID (UUID) and the name of the cluster to which this device must be added.

   If you do not configure the cluster details, the device is added to a single cluster in A10 Control:

   ACOS(config-profile)#cluster-id

   ACOS(config-profile)#cluster-name

   NOTE:

   This information should be available in A10 Control. For more information, see Manage Cluster.

10. Register the ACOS device on A10 Control.

    ACOS(config-profile)# register

    The registration process will begin. While device registration is in progress, do not make other configuration changes.

    The following information is displayed:

    Device registration is in progress. Other config changes are not recommended at this time. Please use the "show controller status" command to monitor the progress.

11. Verify the ACOS device registration status.

    The overall status indicates that the registration is partially completed. You must map the device partitions with Org-Units in A10 Control to complete the registration:

    ACOS(config-profile)#show controller status

    overall-status : Registration with Controller is partially completed. To complete the registration, please go to Infrastructure page of A10 Control Portal and map Device Partitions into Tenants

    heartbeat-status : ACTIVE

    service-registry : ACTIVE

    registration-status : PASS

    registration-status-code : 200

    schema-registry-status : Registration of schemas with SR passed

    broker_info : 129.146.247.182:9093

    kafka-broker-state : Down

    Number-of-tenant-mapped-partitions : 0

    Number-of-tenant-unmapped-partitions : 3

    tunnel-status : ACTIVE

    The partitions must be mapped to the organization in A10 Control. Application services running on the partitions are managed in Org-unit. Additionally, multiple partitions from one or more devices can be mapped to the same Org-unit. Analytics is not generated and displayed until an Org-unit is mapped to the appropriate logical partition.

12. Log in to A10 Control GUI and verify that the registered device appears in A10 Control under the correct cluster and organization and then provision a cluster to the organization. For information, see Provision a Cluster.

13. After mapping the Org-Units in A10 Control, return to the ACOS CLI interface and run the same show command again to check the registration status.

    ACOS(config-profile)#show controller status

    overall-status : Registration with A10 Control completed

    heartbeat-status : ACTIVE

    service-registry : ACTIVE

    registration-status : PASS

    registration-status-code : 200

    schema-registry-status : Registration of schemas with SR passed

    broker_info : 129.146.247.182:9093

    kafka-broker-state : Up

    Number-of-tenant-mapped-partitions : 3

    Number-of-tenant-unmapped-partitions : 0

    tunnel-status : ACTIVE

    The device registration is completed successfully.

If device registration fails or analytics data does not appear in A10 Control GUI after device registration, see Troubleshooting Device Registration.