Search <book_title>...

Cluster Server 7.4.1 Bundled Agents Reference Guide - Linux

Last Published: 2019-06-14

Product(s): InfoScale & Storage Foundation (7.4.1)

Platform: Linux

AzureIP agent

The AzureIP agent manages the following networking resources in an Azure environment:

Private IP - A private IP is a private numerical address that networked devices use to communicate with one another. It is used for communication between an Azure virtual network (VNet) and an on-premises network. To extend an on-premises network to Azure, you use a VPN gateway or an ExpressRoute circuit.
Public IP - A public IP is a numerical address that is used for communication over the internet, including Azure public-facing services.
Overlay IP - An overlay IP provides IP failover functionality for nodes spread across subnets. It allows you to redirect IP address traffic to another cluster node belonging to different subnet within the same VNet. An overlay IP must be defined outside the VNet Classless Inter-Domain Routing (CIDR) block.
Note:
An overlay IP cannot be used to provide failover across Regions if VNet-to-VNet tunneling is used.

The AzureIP agent performs the following activities:

Gets the NIC details, creates the IP configuration, and associates and disassociates the private IP address
Associates and disassociates the Public IP address with the Private IP address
Manages route table entries of Overlay IP for failover across subnets

The AzureIP agent uses Azure Python APIs to associate IP resources with an Azure VM.

An InfoScale deployment in Azure does not support IPv6 because of the following limitations:

Existing virtual machines (VMs) that are configured with IPv4 addresses cannot use IPv6 addresses; you must deploy new VMs and configure them with IPv6 addresses.
Public IPv6 addresses cannot be assigned to a VM.
VMs with IPv6 addresses cannot be members of an Azure cloud service. However, they can communicate with each other over their respective IPv4 addresses.

Prerequisites

Configure the AzureAuth agent.
See AzureAuth agent.
To configure a public IP, create a static public IP resource in the Azure portal.
To configure an overlay IP, create a route table, and associate the subnets where the overlay IP fails over with the route table.
Note:
The subnets can be associated with a single route table.

Dependencies

The AzureIP resources depend on the AzureAuth resources.

Figure: Sample service group dependency

Agent functions

Online	Private IP: Creates the IP configuration with the private IP and associates it with the Network Interface. Public IP: Creates the IP configuration with the private and public IP. Associates the IP configuration with the Network Interface. Overlay IP: Creates a route in the Azure route table given in the RouteTableResourceIds attribute with Address Prefix as the OverlayIP and next hop as the private IP of the primary NIC.
Offline Clean	Private IP: Deletes the IP configuration to disassociate Private IP from the Network Interface. Public IP: Deletes the IP configuration to disassociate the Public IP along with the Private IP from the Network Interface. Overlay IP: Deletes the route from the route table.
Monitor	Private IP: Monitors the associations between IP configuration and Network Interface. Public IP: Monitors the association between IP configuration and Network Interface. Overlay IP: Monitors the routing information and checks whether the route table entry exists for the overlay IP.

State definitions

ONLINE	Private IP: Indicates that the Private IP is assigned to the NIC. Public IP: Indicates that the Private IP is assigned and Public IP is associated with the private IP. Overlay IP: Indicates that Route table entry exists for the overlay IP.
OFFLINE	Private IP: Indicates that the Private IP is not assigned to the NIC. Public IP: Indicates that the Private IP is not assigned or Public IP is not associated with the private IP. Overlay IP: Indicates that Route table entry does not exist for the overlay IP.
UNKNOWN	One of the following could be true: Azure Python SDK is not installed. Required privileges are not present to perform operations on Azure NIC and Virtual Machine. Private IP, Public IP, or Overlay IP is specified in wrong format. Private IP, Public IP, or Overlay IP is already in use. NICDevice attribute value is invalid. In case of Overlay IP, route table id(s) are invalid. IP Configuration has invalid details on NIC. Both or none of the Overlay IP and Private IP are set. Only one should be set.
FAULTED	Indicates that the IP resources could not be brought online or abruptly stopped outside of VCS control.

Attributes

Table: Required attributes

Attribute	Description
PrivateIP	Secondary private IP address of the Azure VM. This value is mandatory if OverlayIP is not provided. Type and dimension: string-scalar
NICDevice	Name of the network device. Enter ip addr to list all network adapters. Example: eth0 In above example, eth0 is specified to assign the private IP address to the next available alias of eth0. Type and dimension: string-scalar
OverlayIP	Overlay IP provides IP failover functionality for nodes spread across subnets. Overlay IP must be outside of the VNet CIDR block in which the nodes are present. This value is mandatory if PrivateIP is not provided. Type and dimension: string-scalar
RouteTableResourceIds	Describes all route tables. You can add one or more route table IDs separated by a space. Type and dimension: string-vector
AzureAuthResName	Name of the authentication agent resource that handles Azure related authentication. Type and dimension: string-scalar

Table: Optional attributes

Attribute	Description
PublicIP	Static public IP created from the Azure Portal. This IP is used in IP configuration to map the Public IP address to a secondary private IP address. Type and dimension: string-scalar
AzureVMName	Name of the VM in Azure on which agent is running. Type and dimension: string-scalar
VMResourceGroup	Azure resource group where the Azure VM resides. Type and dimension: string-scalar

Attribute

Description

PublicIP

Static public IP created from the Azure Portal.

This IP is used in IP configuration to map the Public IP address to a secondary private IP address.

Type and dimension: string-scalar

AzureVMName

Name of the VM in Azure on which agent is running.

Type and dimension: string-scalar

VMResourceGroup

Azure resource group where the Azure VM resides.

Type and dimension: string-scalar

Resource type definition

type AzureIP (
    static str ArgList[] = { tempVMName, PrivateIP, NICDevice, 
      PublicIP, tempPublicIPResourceId, AzureVMName, VMResourceGroup, 
      OverlayIP, RouteTableResourceIds, "AzureAuthResName:SubscriptionId", 
    		AzureAuthResName:ClientId", "AzureAuthResName:SecretKey", 
    		AzureAuthResName:TenantId", tempVMResourceGroupName }
    str PrivateIP
    str NICDevice
    str PublicIP
    temp str tempPublicIPResourceId
    str AzureVMName
    str VMResourceGroup
    str OverlayIP
    str RouteTableResourceIds[]
    str AzureAuthResName
    temp str tempVMName
    temp str tempVMResourceGroupName
)

Sample configurations

Sample configuration with Private IP:

AzureIP azure-ip-res (
    PrivateIP = "10.1.5.42"
    NICDevice @ CLOUDVM1 = "eth0"
    NICDevice @ CLOUDVM2 = "eth0"
    AzureAuthResName = Auth_Res
)

Sample configuration with Public IP:

AzureIP azure-ip-res (
    PrivateIP = "10.1.5.52"
    NICDevice @ CLOUDVM1 = "eth0"
    NICDevice @ CLOUDVM2 = "eth0"
    PublicIP = "52.173.243.126"
    AzureAuthResName = Auth_Res
)

Sample configuration with Overlay IP:

AzureIP overlay-ip-res (
    NICDevice @ CLOUDVM1 = "eth0"
    NICDevice @ CLOUDVM2 = "eth0"
    OverlayIP = "192.168.3.88"
    RouteTableResourceIds = {
      "/subscriptions/6940a326-abc6-40dd-b616-d3f9bbdf1d63/
      resourceGroups/azureRG/providers/Microsoft.Network/
      routeTables/azureroute1",
      "/subscriptions/6940a326-abc6-40dd-b616-d3f9bbdf1d63/
      resourceGroups/azureRG/providers/Microsoft.Network/
      routeTables/azureroute2"}
    AzureAuthResName = Auth_Res
)

Debug log levels

The AzureIP agent uses the DBG_1 and the DBG_2 debug log levels.