Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 

Installing AppFormix and AppFormix Flows using Contrail Command

 

AppFormix Release to Use with Contrail Release

Table 1 specifies which AppFormix release to use with the Contrail release. For previous releases, check the Supported Platforms in the Contrail Release Notes for the applicable Contrail release.

Table 1: AppFormix Release

Contrail Networking Release

AppFormix Release

Operating System

Contrail Networking Release 1912.L1

3.1.11 - AppFormix

1.0.6 - AppFormix Flows

CentOS 7.7

Contrail Networking Release 1912

3.1.11 - AppFormix

1.0.6 - AppFormix Flows

CentOS 7.7

Note

Install AppFormix and AppFormix Flows during the initial installation along with the Contrail and OpenStack installation. AppFormix and AppFormix Flows cannot be installed after the Contrail and OpenStack cluster is already deployed and imported into Contrail Command.

4-Node Setup

4-Node setup includes:

Node 1Contrail Command
Node 2OpenStack and Contrail
Node 3AppFormix
Node 4AppFormix Flows

Hardware Requirements

The Contrail Command server, on which AppFormix Platform is installed has the following minimum requirements.

  • CPU: 16 cores (virtual or physical)

  • Memory: 64 GB

  • Storage: 2 TB (recommended)

Requirements

  • Install Centos 7.7 on all nodes.

  • Have your AppFormix license from Juniper available. This will need to be added on the Contrail Command server in the same folder together with Appformix.

Server requirements and supported platforms are listed in the installation guide and release notes.

Download and Install AppFormix and AppFormix Flows on the Contrail-Command Node

To install AppFormix using Contrail Command:

  1. Download AppFormix from

    https://support.juniper.net/support/downloads/.

    Note

    See Table 1 for Contrail, AppFormix, and AppFormix Flows version mapping.

    Download the AppFormix Flows images by selecting 1.0 from the drop-down list:

    Figure 1: Download AppFormix Flows Images
    Download AppFormix Flows Images
    • Copy the AppFormix tar.gz files to the /opt/software/appformix/ directory on the Contrail Command server.

    • Copy your AppFormix license to the /opt/software/appformix/ directory.

    • Copy the two appformix-flows files to the /opt/software/xflow directory.

  2. Verify the command_servers.yml file was added before installing Contrail Command as specified in Installing Contrail Command. This makes /opt/software/appformix available in contrail-command Docker.

    Add the following statements to the command_servers.yml file. They must be placed after the "---" at the very top of the file or as the last two lines at the very bottom of the file.

  3. From Setup, select AppFormix Nodes.
    Figure 2: AppFormix Nodes Setup
    AppFormix Nodes Setup
  4. From AppFormix Nodes, the appformix_platform role is selected by default.

    Optionally, select appformix_bare_host and appformix_network_agents roles as needed.

  5. Starting with Contrail networking release 1910, AppFormix Flows is integrated in the Contrail Command UI. For the AppFormix node, keep the appformix_platform role default.
    Figure 3: Installing AppFormix Flows
    Installing AppFormix Flows

    Enter the following values:

    Out-of-Band Provisioning:

    • Virtual IP Address—This is the IP address of the load balancer node for AppFormix Flow collectors.

    • Available Servers—Select the server on which AppFormix Flows node is to be installed.

    In-Band Provisioning:

    • CIDR—Enter the underlay telemetry infrastructure subnet. In-band interface on the AppFormix Flows node is assigned an IP address from this subnet.

    • VLAN-ID—Enter the VLAN ID used for the telemetry infrastructure network.

    • Management Virtual IP Address—Enter an unused IP address which will be used as the management IP Address. Contrail Command uses this IP address to connect to the AppFormix Flows node.

    • Virtual IP Address—The IP address is populated by default and is usually the third IP Address from the CIDR range (telemetry subnet). However, you can change the IP address if needed. This IP address is used as the collector destination IP address for the sFlow target on TOR switches.

    • (Optional) Retention Period—Time duration in seconds that you want to keep the collected data. Default is 7200 s.

    • (Optional) Max Retention Bytes—Maximum size of the data to be collected. Default is 0 which indicates unlimited size.

  6. Click Next to continue to Summary.
  7. Verify the summary of your configuration and click Provision.
  8. Use the following commands to check and track deployment progress:
Note

After the AppFormix installation, you can view monitoring by selecting Monitoring > External Apps > AppFormix.

Enable LLDP and Analytics To Collect

In the AppFormix software, enable LLDP for each device and any analytics that you want to collect.

  1. In the AppFormix Dashboard, select the menu in the upper-right corner, then select Settings.
  2. Select Network Devices > Add Device.
  3. In the LLDP field, complete the following:
    • Select Contrail in Device Info for LLDP. The default is Contrail.

    • Add the Management IP address, then click Next.

    • Select SNMP > + in Device Sources to input the SNMP community string. The default community string for each Junos device provisioned is public.

    Figure 4: Enable LLDP and Add Management IP for Network Device
    Enable LLDP and Add Management IP for Network Device
  4. In the Resource field, select the Resource from the list, then click Add.
    Figure 5: Add Selected Resource for Network Device MIB Configurations
    Add Selected Resource for Network Device MIB Configurations
  5. Click Submit to complete.
Release History Table
Release
Description
Starting with Contrail networking release 1910, AppFormix Flows is integrated in the Contrail Command UI.