Deploying A10 Lightning ADC (LADC) Cluster

The LADC cluster can either be deployed manually and associated with an LADC cluster or allow the system to launch LADCs automatically. However, it also depends on cloud infrastructure user selects. The configuration page also provides user multiple options to deploy LADC. Deploying LADC depends on the underlying cloud infrastructure. At the very basic it is about setting up a virtual machine with the LADC software.

Deploying LADC Cluster in AWS Cloud

A10 Networks releases pre-built Amazon Machine Image (AMI) of LADC for quick setup. A10 Lightning ADC is capable of launching LADC in users AWS account if the user is comfortable providing permission to the system for the same. Else, a user can launch LADC manually using a Cloud Formation Template (CFT), or from the Amazon marketplace.

Automatic Launch of LADC Cluster by System

To automatically launch LADC cluster, choose the option Automatic cluster type in Create Cluster screen. For the auto launch of LADC cluster, an AWS credentials to be provided in the form of ARN by the user for the system to access various AWS resources of users AWS account.

See also

For more information on different user account authorization, please refer ARN Policy section in Infracredential configuration page.

With the above set of information, the user also needs to provide the exact location regarding AWS region, network and subnets where the LADC should be launched, and the scale up/down policy for the cluster in accordance with higher/lower CPU usage. When the required configuration is saved, the LADC instances are launched and automatically registered with the system into the specified cluster. List of all AWS resources created during the process as well as their status is shown on the cluster page.

Follow the steps below to auto launch LADC cluster by system:

  1. Click + to add a new cluster, provide the cluster name and then select the cloud credentials if already created. By default cluster type would be set to Auto.
_images/image5.1.png
  1. Once the above step is completed, select the Region and then select the Subnet(s) to launch the cluster, set the Min/Max Instances in the cluster. And then save the cluster, wait for the cluster to launch.
_images/image5.2.png
  1. Wait for the status to change to Launch Successful as shown.
_images/image5.3.png

Launching LADC Cluster Manually using CFT

The LADC cluster is launched manually when the user is not comfortable authorising the system to launch the instances and other resources to accesses users AWS account. And, if the user decides to use a Cloud Formation Template (CFT), all the steps are completely automated.

Follow the steps below to auto launch LADC cluster by using CFT:

  1. Click + to add a new cluster, provide the cluster name and then select cluster type as Manual. Save the settings.
_images/image5.4.png
  1. Provide information about placement and scaling, but the system would not save this information.
_images/image5.5.png
  1. Generate a CFT by clicking Export CFT button using the above information, select the AWS platform; and then download the CFT and save it.
_images/image5.47.png
_images/image5.6.png
  1. Upload the CFT to S3 bucket of AWS. Click Services > S3 > Create Bucket > Bucket Name > Region > Create > Double click CFT created > Upload > Add/Upload CFT > Double click CFT Properties > Copy the Link address > Goto Services > Cloud Formation > Launch CloudFormer > Paste the Link address in the field Specify an Amazon S3 template URL> Next > Provide Key and Value > Review > Create.
_images/image5.7.png
_images/image5.8.png
_images/image5.9.png
_images/image5.10.png
_images/image5.11.png
_images/image5.12.png
_images/image5.13.png
_images/image5.14.png
_images/image5.15.png
_images/image5.16.png
_images/image5.17.png
_images/image5.18.png
_images/image5.19.png
_images/image5.20.png

LADC instances launched using a system provided CFT is automatically registered with the system into the specified cluster.

Launching LADC Cluster Manually from AWS Marketplace

To launch the LADC cluster manually from AWS Marketplace, use the LADC AMI available in the AWS Marketplace. Follow the same process to launch LADC cluster in EC2-Classic as well. By manually launching the LADC instance, the user has the liberty to choose the placement of instances, but scaling and security implementation required to be configured manually by the user.

Follow the steps below to launch LADC cluster in AWS Marketplace:

  1. Login to the A10 Lightning ADS and Click + to add a new cluster, provide the cluster name and then select cluster type as Manual. Save the settings as shown.
name
name
  1. Click this link https://aws.amazon.com/marketplace/ to access AWS Marketplace and search for A10 Lightning ADC or LADC and click on A10 Lightning ADC.
name
  1. Click Continue on this screen.
name
  1. Click Manual Launch and select the region to launch A10 Lightning ADC close to your App server.
name
  1. Click Next: Configure details.
name
  1. In this screen, you are configuring the instance details as shown, after providing the basic configuration details click Advanced Details and here click the As text radio button and provide the information such as Cluster ID, Edge IP, and API Server URL as shown in the example below. Copy the below JSON code in the User data field and change only the Cluster ID rest all remains the same.

User data JSON:

{
  "cluster_id": "Cluster-ID_from_UI",
  "edge_ip": ["https://api.a10networks.com/api/v2"],
  "api_svr_url": ["https://api.a10networks.com:8443/api/v2"]
}
name
  1. Click Add Storage provide the storage requirements or leave it default.
name
  1. Click Add Tags provide the Name and Value.

    name
  2. Click Next: Configure Security Group > Select an existing security group > Review and Launch

name
  1. Click Launch
name
  1. Select a Key pair and click Launch Instance.
name
  1. Check the Launch Status.
name
  1. Verify the cluster association with A10 Lightning ADC in the cluster information page.
name

Launching LADC cluster in ASG (Auto Scaling Group) from AWS Marketplace

  1. Follow step 2 to 5 from the “Launching LADC Cluster Manually from AWS Marketplace” before we proceed to next step.

  2. On this screen click Launch into Auto Scaling Group

    name
  3. Click Create Launch Configuration provide the Name, and then click Advanced Details and copy the below JSON code in the User data field and copy the Cluster ID from the cluster creation page as shown in step 6 above, and then click Add Storage.

User data JSON:

{
"cluster_id": "Cluster-ID_from_UI",
"edge_ip": ["https://api.a10networks.com/api/v2"],
"api_svr_url": ["https://api.a10networks.com:8443/api/v2"]
}

name
name
  1. Click Next: Configure Security Group > Select an existing security group > Review > Create Launch Configuration
_images/image5.28.png
_images/image5.29.png
_images/image5.30.png
  1. Choose an existing key pair and click Create Launch Configuration
_images/image5.31.png
  1. Provide the scaling group details, and then click Next: Configure Scaling Policies
_images/image5.33.png
  1. Choose the option Use scaling policies to adjust the capacity of this group provide all the details and then click Next: Configure Notifications
_images/image5.34.png
_images/image5.35.png
_images/image5.36.png
  1. Click Add Notifications
_images/image5.37.png
_images/image5.38.png
  1. Select a notification endpoint from the list if already created. Else, select create topic and follow step 10 to create a new notification endpoint.
_images/image5.39.png
  1. Steps to create a new topic (notification endpoint)
_images/image5.40.png
_images/image5.41.png
_images/image5.42.png
  1. Select the new notification endpoint created, as described in step 9, and then click Next: Configure Tags to reach the below screen. Provide the Key and Value and click Review
_images/image5.43.png
  1. Review the configuration and click Create Auto Scaling group
_images/image5.44.png
_images/image5.45.png
  1. Below message is displayed, on successful creation of Auto Scaling group
_images/image5.46.png
  1. Review the Autoscaling group created.
name
  1. Verify the cluster association with A10 Lightning ADC in the cluster information screen.
name

Upgrading LADC version in AWS Marketplace

The below steps are for the existing A10 Lightning ADC customer’s who already have their LADC instance(s)running in AWS account and want to upgrade it to the new version. For that, the user needs to have the cluster ID of the existing LADC instance(s) running in AWS account and then follow the below steps.

Upgrading LADC Manually in AWS Marketplace

  1. Login to A10 Lightning ADC and look for the LADC Cluster which has the LADC instance already running in AWS account, then copy the Cluster ID as shown below.
name
  1. Go to AWS console click EC2 > Launch Instance > AWS Marketplace > search LADC > Select
name
name
name
name
  1. Click Configure Instance Details
name
  1. Click Advanced Details and copy the JSON code as shown below, and copy the Cluster ID of the existing LADC.

Note

The JSON code format is changed, do not use the old format to input the User data. Use the below one.

User data Snippet:

{
  "cluster_id": "Cluster-ID_from_UI",
  "edge_ip": ["https://api.a10networks.com/api/v2"],
  "api_svr_url": ["https://api.a10networks.com:8443/api/v2"]
}
name
  1. Click Add Storage > Add Tag

    name
  2. Click Next: Configure Security Group > Select an existing security group > Review and Launch

name
  1. Click Launch
name
  1. Select a Key pair and click Launch Instance.
name
  1. Check the Launch Status.
name
  1. Verify the cluster association with A10 Lightning ADC in the cluster Information screen. Delete the old LADC instance once the new LADC instance association is displayed on the screen.

Auto Upgrading LADC in AWS Marketplace

To upgrade the LADC version in Auto Scaling Group(ASG) of AWS account. Follow the steps below.

  1. Login to A10 Lightning ADC and search for the LADC which is already in ASG of AWS.
name
  1. Look for the launch configuration information in the Cluster information screen.
name
  1. Click Launch Configuration in the AWS screen and search for the launch configuration which you found in Cluster screen.
name
  1. Select the LADC and click Actions > Copy launch configuration
name
  1. From the Copy launch configuration screen click Edit AMI and then click AWS Marketplace search LADC and select the radio button Yes, I want to continue with this AMI.
name
name
  1. Click Next: Configure details
name
  1. In the Configure details screen click next.
name
name
  1. Select the existing security group for the LADC instance running and click Review.
name
  1. Click Create launch configuration
name
  1. Select the existing key pair or create a new key pair.
name
  1. Check for status.
name
  1. Click Auto Scaling Group choose the existing LADC instance and in the Details increase the desired instance (for example, if it is “1” change it to “2”) and wait for it to launch the new instance.
name
name
name
  1. Now we have two LADC instances, the old and the updated in the cluster page.
name
  1. Check for CPU stats for the new LADC instance, for analytics.
name
name
  1. In the AWS we have both the old and the updated LADC instances running.
name
  1. Hence, to make the updated LADC instance(s) active delete the old instance(s) by reduce the desired instance (for example, if it is “2” change it to “1”) in “Auto Scaling Group” screen and the old instance is automatically deleted by AWS.
name
  1. The old instance is terminated as shown.
name
  1. The cluster screen now shows only the updated LADC instance.
name

Deploying LADC Cluster in Google Cloud Platform (GCP)

Automatic Launch of LADC Cluster by System in GCP

To automatically launch LADC cluster, choose the option Auto(Launched by System) in the Add New Cluster page. For the Auto lauch of LADC cluster, an GCP credentials has to be provided for the system to access various GCP launch resources of users GCP account. User is also required to select the appropriate Project to associate the cluster.

See also

For more information on creating GCP Credentials, refer Onboarding an Application section in the document.

With the above set of information, the user also needs to provide the exact location regarding GCP region, network and subnets where the LADC should be launched, and the scale up/down policy for the cluster in accordance with higher/lower CPU usage. When the required configuration is saved, the LADC instances are launched and automatically registered with the system into the specified cluster. List of all GCP resources created during the process as well as their status is shown on the cluster page.

Note

Please ensure that TCP port 5666 is open on your LADC node. As a part of LADC image creation, we install NRPE (Nagios Remote Plugin Executor) plugin which allows cloud team to monitor LADC’s remotely. Services using NRPE daemon binds to port 5666 by default. This will allow us to alert your team in occurrence of any events. If you have monitoring in place, you can decide NOT to open TCP port 5666. This holds good for both manual and auto launch of LADC.

Follow the steps below to auto launch LADC cluster by the system:

  1. Click + to add a new cluster, provide the cluster name and then attach the cloud credential, and select the appropriate Project as shown. By default cluster type would be set to Auto.
_images/image5.53.png
_images/image5.67.png
  1. Once the above step is completed, select the Region and then select the Subnet(s) to launch the cluster, set the Min/Max Instances in the cluster. And then save the cluster, wait for the cluster to launch.
_images/image4.18.png
_images/image4.19.png
  1. Wait for the status to change to Launch Successful as shown.
_images/image4.20.png
_images/image4.21.png

Launching LADC Cluster Manually in GCP

The LADC cluster is launched manually when the user is not comfortable authorising the system to launch the instances and other resources to accesses users GCP account.

Follow the steps below to launch LADC cluster manually in GCP:

  1. Click + to add a new cluster, provide the cluster name and then select cluster type as Manual. Save the settings.
_images/image5.54.png
  1. The View/Edit Cluster screen provides the user the metadata information like Cluster ID and API server URL which is used to associate the cluster with GCP.
_images/image5.55.png
  1. Login to the GCP using the Google account credentials.
_images/image5.56.png
  1. Click Product and Services on the left top corner, and from the dropdown select Compute Engine > Instance templates > CREATE INSTANCE TEMPLATE.
_images/image5.57.png
  1. Input the instance name and keep other fields as default, expand [Management, disk, networking, SSH keys] and then provide the metadata information(cluster ID and API server URL or Edge IP) exactly as shown in the figure below.
name
name
name
name
  1. Create an Instance group and associate the Instance template with the Instance group as shown. Keep all the fields set as default. Select an existing instance or select an instance template. And then, click Create.
name
name
name
name
  1. View the status of the LADC cluster instance.
name

Deploying A10 Lightning ADC Cluster in Azure Infrastructure

To launch the A10 Lightning ADC cluster in Azure account, use the Azure machine image provided by A10 Networks in Azure Marketplace. By manually launching the Lightning ADC instance the user has the liberty to choose the placement of instances. But, scaling and security implementation required to be configured manually by the user.

Steps to launch A10 Lightning ADC Cluster manually in Azure Marketplace

  1. Click + to add a new cluster, provide the cluster name and then select cluster type as Manual. Save the settings.
name
  1. Login to Azure Marketplace and search for LADC, from the search results select A10 Lightning ADC-BYOL to launch VM as shown.
name
  1. After the successful launch of LADC, SSH to LADC instance with username and password.

  2. Run the below command to gain required privileges:

    sudo su
    

5.Run register-cli command to register LADC to cluster as shown, and then follow the steps in the example below to launch LADC successfully:

register-cli

Example:

Welcome to A10 LADC Shell
It is advised to change the default password
Do you want to change password([Y]es/No) : No
Password not changed.Continuing with registration
--------------------------------------------------
Do you want to register LADC([Y]es/No) : Yes
Register your A10 Lightning ADC with the Controller using
Cluster ID and API Server URL. You can get them by logging into
A10 Lightning ADS and selecting the cluster name from the left
pane.
-------------------------------------------------------------
Input the API server URL and Cluster ID that is obtained from
the A10 Lightning ADS UI
Please enter API server URL :    https://api.a10networks.com/api/v2
Please enter the cluster id : ofvrgvdj6i
API Server URL : https://api.a10networks.com/api/v2
Cluster ID     : ofvrgvdj6i
Is this information correct([Y]es/No) : Yes
Applying changes
Waiting for the proxy to get registered.
Trying to connect to API server
Starting registration
Updated cluster id
Updated API Server
Restarting services
Services restarted
Congratulations!
LADC activation is completed successfully.!
  1. After successful registration of Lightning ADC in Azure Marketplace, go back to the A10 Lightning ADS Cluster page and refresh the page to view the association of LADC with A10 Lightning Controller.
name

Upgrading A10 Lightning ADC Cluster in Azure Infrastructure

This section of the document provides the steps to upgrade the LADC version in the Azure Infrastructure.

  1. Copy the cluster ID from the running LADC cluster and keep it ready.
name
  1. Login to Azure Marketplace and search for LADC, from the search results select A10 Lightning ADC-BYOL to launch VM as shown.
name
  1. After the successful launch of LADC, SSH to LADC instance with username and password.

  2. Run the below command to gain required privileges:

    sudo su
    

5.Run register-cli command to register LADC to cluster as shown:

register-cli

When the above command is executed it prompts for the cluster ID, the user can provide the cluster ID of the running LADC.

name
  1. After successful registration of Lightning ADC in Azure Marketplace, go back to the A10 Lightning ADS Cluster page and refresh the page to view the association of LADC with A10 Lightning Controller.
name
  1. Once the upgraded LADC associates with the A10 Lightning Controller, the user can delete the old LADC.
name
name
  1. On successful deletion of the old LADC cluster, the cluster page displays only the upgraded LADC cluster.
name

Deploying A10 Lightning ADC Cluster in Docker Environment

Docker containers are based on open standards, enabling containers to run on all major Linux distributions and on Microsoft Windows and on top of any infrastructure.

A10 Lightning ADC user can deploy A10 Lightning ADC instances in Docker container. This makes the deployment independent of underlying infrastructure and Lightning ADC can be deployed near to application servers where ever servers are deployed.

The user is expected to have the Docker engine installed, before starting the A10 Lightning ADC deployment. Also, the user should have the Lightning ADC cluster configured in A10 Lightning ADC to obtain a cluster ID and API server URL.

Steps to configure a new cluster in A10 Lightning ADC to obtain clusterID and API server URL:

  1. Login to A10 Lightning ADC and click Add New Cluster provide the cluster name and select cluster type as Manual and then click Save.
_images/image5.51.png
  1. Copy the cluster ID and API server URL from this page.
_images/image5.52.png

Command to launch Lightning ADC in Docker

Syntax

Command:

docker run -tdi -e
ladc_api_svr_url=?https://api.a10networks.com/api/v2? -e
ladc_cluster_id=?<cluster_id>? --restart=always --net=host
a10networks/ladc

This docker command automatically restarts the container on a reboot. Note, this will make sure the container is restarted automatically if it is stopped. This applies on a reboot or in some circumstance the container exited for whatever reason.

Below is the example output of docker run command.

name
name
name