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
Contrail Networking Release 1912.L1
3.1.11 - AppFormix
1.0.6 - AppFormix Flows
Contrail Networking Release 1912
3.1.11 - AppFormix
1.0.6 - AppFormix Flows
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 includes:
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)
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:
- Download AppFormix from
See Table 1 for Contrail, AppFormix, and AppFormix Flows version mapping.
appformix-<version>.tar.gz appformix-platform-images-<version>.tar.gz appformix-dependencies-images-<version>.tar.gz appformix-network_device-images-<version>.tar.gz appformix-openstack-images-<version>.tar.gz appformix-flows-<version>.tar.gz appformix-flows-ansible-<version>.tar.gz
Download the AppFormix Flows images by selecting 1.0 from the drop-down list:
Copy the AppFormix
tar.gzfiles to the
/opt/software/appformix/directory on the Contrail Command server.
Copy your AppFormix license to the
Copy the two
appformix-flowsfiles to the
- Verify the
command_servers.ymlfile was added before installing Contrail Command as specified in Installing Contrail Command. This makes
Add the following statements to the
command_servers.ymlfile. 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.
--- user_command_volumes: - /opt/software/appformix:/opt/software/appformix - /opt/software/xflow:/opt/software/xflow command_servers: server1: ip: 192.168.100.129
- From Setup, select AppFormix Nodes.
- From AppFormix Nodes, the
appformix_platformrole is selected by default.
appformix_network_agentsroles as needed.
- Starting with Contrail
networking release 1910, AppFormix Flows is integrated in the Contrail
Command UI. For the AppFormix node, keep the
Enter the following values:
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.
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
(Optional) Max Retention Bytes—Maximum size of the data to be collected. Default is
0which indicates unlimited size.
- Click Next to continue to Summary.
- Verify the summary of your configuration and click Provision.
- Use the following commands to check and track deployment
vim /var/tmp/contrail_cluster/<cluster-id>/instances.yml tail -f /var/log/contrail/deploy.log
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.
- In the AppFormix Dashboard, select the menu in the upper-right corner, then select Settings.
- Select Network Devices > Add Device.
- 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.
- In the Resource field, select the Resource from the list, then click Add.
- Click Submit to complete.