Release notes

These release notes provide product information about the F5 VNF Manager support for version 1.2.1

User documentation

You can find the user documentation on: https://clouddocs.f5.com/cloud/nfv/latest/.

Platform support

F5 VNF Manager version 1.2.1 requires the following supported platforms:

Platform name Platform ID System Requirements
F5 VNF Manager All versions
  • vCPUs: 4 minimum, 8 recommended
  • RAM: 8GB minimum, 16GB recommended
  • Root Disk Storage: 160GB minimum
  • 64-bit host with RHEL/CentOS 7.4
  • Private network dedicated for communicating with other VNFM components, including cluster members
BIG-IP VE Version 13.1.0.5 Virtual Edition BIG-IP 13.1.0.5 Virtual Edition Release Notes
BIG-IQ Version 6.0.1 BIG-IQ 6.0.1 Release Notes
CentOS-7-x86_64-GenericCloud-1503 GenericCloud-1503 Release Notes

F5 VNF Manager and Virtual Infrastructure Manager (VIM) compatibility matrix:

VNF Manager ID VIM Platform ID VIM System Requirements
F5 VNF Manager 1.1.X Red Hat OpenStack Newton Version 10 Environment requirements
F5 VNF Manager 1.2.0 VMware vSphere ESXi Version 6.5 Requirements and patch notices
F5 VNF Manager 1.2.1 VMware vSphere ESXi Version 6.5 and Red Hat OpenStack Newton Version 10 See previous links for requirements information.

Open source components

F5 VNF Manager is built with the following open-source components.

Component Description
Nginx

Nginx is a high-performing Web server. In F5 VNF Manager, it serves two purposes:

  • A proxy for the F5 VNFM REST service and F5 VNFM Console
  • A file server to host F5 VNFM-specific resources, agent packages, and blueprint resources.

File server

The file server served by Nginx, while tied to Nginx by default, is not logically bound to it. Although currently it is accessed directly frequently (via disk rather than via network), we will be working towards having it decoupled from the management environment so that it can be deployed anywhere. The file server served by Nginx, is available at https://{manager_ip}:53333/resources, which is mapped to the /opt/manager/resources/ directory. You must authenticate in order to access the file server. To access subdirectories that include tenant names in their path, you must have privileges on that tenant. These subdirectories include:

  • blueprints
  • uploaded-blueprints
  • deployments
  • tenant-resources

The directories that are stored in snapshots include:

  • blueprints
  • uploaded-blueprints
  • deployments
  • tenant-resources
  • plugins
  • global-resources

Note: The tenant-resources and global-resources directories are not used by F5 VNF Manager; therefore, users can create these directories for storing custom resources.

Gunicorn and Flask Gunicorn is a Web server gateway interface HTTP server. Flask is a Web framework. Together, Gunicorn and Flask provide the F5 VNFM REST service. The REST service is written using Flask, and Gunicorn is the server. Nginx, is the proxy to that server. The F5 VNFM’s REST service is the integrator of all parts of the F5 VNFM environment.
PostgreSQL

PostgreSQL is an object-relational database that can handle workloads ranging from small single-machine applications to large Internet-facing applications. In F5 VNF Manager, PostgreSQL serves two purposes:

  • Provides the main database that stores the application’s model (for example, blueprints, deployments, runtime properties)
  • Provides indexing, and logs’ and events’ storage
Logstash Logstash is a data handler. It can push/pull messages using inputs, and apply filters and output to different outputs. Logstash is used by F5 VNFM to pull log and event messages from RabbitMQ and index them in PostGresSQL.
RabbitMQ

RabbitMQ is a queue-based messaging platform. RabbitMQ is used by F5 VNFM as a message queue for different purposes:

  • Queueing deployment tasks
  • Queueing logs and events
  • Queueing metrics
Pika

Pika is a pure-Python implementation of the AMQP 0-9-1 protocol. The VNF management worker and the host agents are using pika to communicate with RabbitMQ.

Management worker (or agent)

Both the Workflow Executor and the Task Broker that appear in the diagram are part of the F5 VNFM Management Worker.

  • The Workflow Executor receives workflow execution requests, creates the tasks specified by the workflow, submits the tasks for execution by host agents and the Task Broker, and manages workflow state.
  • The Task Broker executes API calls to IaaS providers to create deployment resources, and executes other tasks specified in central_deployment_agent plugins.

Note: All agents (the management worker, and agents deployed on application hosts) are using the same implementation.

Features

Feature Name Description
Install/Uninstall Installs the target deployment, lifecycle operations, and starts all instances. Uninstalls target deployment, frees resources allocated during install, performs uninstall lifecycle operations, stops/deletes deployments and additional blueprints created during install.
Scale out Adds and installs BIG-IP Virtual Editions (VEs) and VNF instances on demand as your network needs resources based on configurable parameters.
Scale in Removes and uninstalls BIG-IP Virtual Editions on demand as your network reduces its need for resources based on configurable parameters.
Heal VEs and layers Creates a new copy of any BIG-IP VEs, layers, and related objects on demand as your network reports dysfunctional instances.
Purge VEs and layers Uninstalls and removes dysfunctional VEs, VNF layer instance(s), and related objects, which you start manually after heal layer workflow runs and problem investigation is complete.
Upgrade Initiates the upgrade process and sets new software reference data. Disables VEs with lower revision numbers. Scaled and healed VEs are installed using the new software reference data.
Update NSD Updates AS3 declaration pushed to the VE as a part of NSD definition.
High Availability (HA) Provides high availability using a cluster of three F5 VNF Managers.
REST API Provides all VNFM functionality using a REST-based API.

What’s new

The following table describes new functionality added in VNF Manager version 1.2.1:

Item Description
F5-VNF-BIG-IQ blueprint

A new blueprint automating the configuration of the BIG-IQ license manager utility. This blueprint automatically returns all the required license names and BIG-IQ address information required by the other main, blueprint solutions (Gi LAN, Gi Firewall, and Base). Consult the F5 VNFM inputs repository on GitHub.

Tip: Upon purchasing the BIG-IQ blueprint, you will receive license keys for a BIG-IQ HA pair. If you uninstall and delete the BIG-IQ blueprint from your VNFM and want to redeploy the blueprint, you must contact F5 Support to release the previously configured devices from the BIG-IQ, before you can redeploy the BIG-IQ HA pair using the same license keys.

New internal_ca_cert secret For OpenStack users, you will find a new internal_ca_cert secret. This secret was introduced to fix a security issue. The secret value is auto-generated by VNFM; therefore, you do NOT need to edit/supply this secret, manually.
Red Hat OpenStack Newton Version 10 enhancements The bigip_os_ssh_key input has changed to bigip_ssh_key, requiring you to define and upload new solution inputs files. Consult the F5 VNFM inputs repository on GitHub.
F5 AS3 Declaration version 3.13.0 (non-LTS) New version of F5 AS3 Declaration released.

Known issues

The following table lists known issues in the designated version release:

Platform name Description
F5 VNF Manager Version 1.2.1
  • If deploying the F5-VNF-BIG-IQ blueprint from a VMware vSphere ESXi VIM, you must NOT use 192.168.1.200 and 192.168.1.245 IP addresses on the same network the F5 VNF Manager is connected, until AFTER you deploy the BIG-IQ blueprint and the BIG-IQ HA pair is online. Once the BIG-IQ HA pair is online, those IP addresses become available.
  • The VNFM image for VMware vSPhere ESXi displays several extraneous workflows (Clear inactive deployment ips, Clear subnets, Update, and Configuration Update) for the main Gi-LAN and Firewall deployments. These workflows are internal and part of the blueprint automation. You are NOT meant to execute these workflows manually. F5 will hide these workflows in the UI, in a future next release.
  • In VMware vSphere ESXi, when using the VNFM REST API, you must set up your networks to use unique port group names, regardless of the directories in which they reside.
  • Intermittently, an incorrect BIG-IP hostname is sent to the BIG-IQ license manager, causing a mismatched BIG-IP instance with their VE representation in VNFM. This issue affects only how the reporting plugin displays BIG-IP VE usage data within a layer, but does not affect any billing information.
  • OpenStack v10 (Newton) has an issue with privileges and connecting devices residing outside the OpenStack environment with those residing inside the OpenStack environment, including F5 VNF Managers. To work around this issue, you must add the VNF Manager to the admin project.
  • Nagios continuously triggers, and then cancels the Heal workflow on DAG instances unnecessarily. However, these actions do not prevent the system from operating.
BIG-IP 13.1.0.5 Virtual Edition Issues list
BIG-IQ 6.0.1 Issues list
CentOS-7-GenericCloud-1503 Issues list
Red Hat OpenStack Newton Version 10 Issues list
VMware vSphere ESXi 6.5 Issues list

Fixed issues

The following table lists issues that were fixed in the designated version release:

Platform name Fixed in version Description
F5 VNF Manager 1.2.1
  • Implemented several network stabilization fixes, including stabilizing the traffic flow during a failover. Tip: F5 recommends upgrading to VNFM version 1.2.1, for these stabilization fixes.
  • Fixed licensing timing issues on the OpenStack VIM.
  • When running the Scaling workflow on a layer, the Heal workflow no longer executes immediately after the new slave is created.
  • Fixed the race condition that prevented more than one slave from joining the cluster, simultaneously.
  • Corrected hostname in BIGIQ license pool.
  • Removed the ric_throughput parameter in all gilan and firewall solution inputs files, as it was a duplicate of the vnf_group_throughput parameter.
  • Purge workflow no longer fails on DAG Instance, due to the removal of the ric_throughput parameter.
  • Improved the polling capabilities during blueprint deployments and workflow executions.
  • Fixed Nagios monitor, so that the auto-heal workflow triggers successfully.
BIG-IP Virtual Edition 13.1.0.5 Issues list
BIG-IQ 6.0.1 Issues list
CentOS-7-x86_64 GenericCloud-1503 Issues list
Red Hat OpenStack Newton Version 10.0 Issues list
VMware vSphere ESXi 6.5 Issues list

Installation overview

To install F5 VNF Manager, use the link provided in the email, and use the key provided in the email as customer identification, when obtaining customer support. Additionally, you will need the following F5 product license keys:

Platform name Product license
BIG-IQ 6.0.1 F5-BIQ-VE-LIC-MGR-LIC
BIG-IP 13.1.0.5 Virtual Edition F5-BIG-MSP-LOADV12-LIC
CentOS-7-x86_64-GenericCloud-1503 NA

Upgrade overview

You can upgrade HA clusters two ways:

  • Upgrade on new hosts (recommended method).

  • In-place upgrade (prevents ability to rollback).

    Important

    This method works only if you leave the IP, AMQP credentials and certificates unchanged.

What’s Next?

Set up VNFM