Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Install Ubuntu KVM Image for the PON Controller Software

The following are the high-level steps required to complete the installation process:

  • Verify and upgrade NFX250-S2 device software to the recommended release.

  • Factory default (zeroize) the configuration for the NFX250-S2 device.

  • Transfer Ubuntu KVM qcow2 VM image file for the PON Controller software to the NFX250-S2 device.

  • Provision the NFX250-S2 device.

  • Verify the status of the PON Controller VNF.

  • Login to the PON Controller VNF locally.

  • Install the PON Controller software on the VNF.

  • Verify or change the PON Controller configuration.

  • Configure the control plane connections on the ACX router for NFX250-S2 PON Controller VNF connectivity.

  • Verify the PON Controller software operation.

The following steps describe how to install the Ubuntu KVM qcow2 image for the MCMS PON Controller software on the NFX250-S2 device.
Note:

Before proceeding with the installation process, it is a recommended to zeroize the NFX250-S2 device’s configuration. See the Junos OS Software Installation and Upgrade Guide to understand the procedure to zeroize the system.
  1. Configure the NFX250-S2 device to operate in compute mode. Compute mode provides maximum resources for third-party VNFs. The NFX250-S2 device reboots after setting the device in compute mode.
  2. Transfer the Ubuntu KVM qcow2 VM image (nfx250-poncntl.qcow2) for the PON Controller software to the NFX250-S2 device. Use scp command to transfer the Ubuntu KVM qcow2 image file to the NFX250-S2 device’s /var/lshare/public directory. Make sure to use the correct credentials if you want to copy the files to the NFX250-S2 device. For example, root user’s credentials are used here to copy the files to the NFX250-S2 device.
  3. Provision the NFX250-S2 device, including the virtual-network-functions settings, for the PON Controller VNF. Make sure the following appropriate configuration options are set by referring to Example: Configure NFX250-S2 as a Compute Server to Support Virtual Network Functions.

    • system memory hugepages

    • vlans

    • interfaces

    • vmhost vlans

    • virtual-network-functions

    The NFX250-S2 device’s virtual-network-function configuration creates four Ethernet ports for the VNF.

    • The first two ports are the default VNF ports and include the NFX250-S2 to VNF communication network port and a OOB port (disabled later within the Ubuntu VNF).

    • The second two ports are the Ethernet ports designed for use with the PON Controller software.

      • One port for Layer 2 Control Plane communications with the 10G PON OLT devices.

      • One port for Layer 3 IP communications with the PON Manager database.

    Note:

    For more information, see Example: Configure NFX250-S2 as a Compute Server to Support Virtual Network Functions.
  4. Verify the status of the PON Controller VNF in the NFX250-S2 device. From operational mode, enter the show virtual-network-functions vnfname command. You should see the PON Controller VNF State as Running and the Liveliness as alive.
  5. Login to the PON Controller VNF. From operational mode, enter the request virtual-network-functions vnfname ssh user-name user command to create a ssh connection to the PON Controller VNF.
    Note:

    The PON Controller VNF username and password is created during the Ubuntu KVM qcow2 image creation. The steps to create username and passwords are beyond the scope of this document.
  6. Provision the Ethernet interfaces for PON Controller access. Determine the Ethernet interface names in the Ubuntu VNF. From the Ubuntu VNF CLI, enter the ip address command.

    Interfaces 2 and 3 (ens3 and ens4) are the default NFX250-S2 VNF Ethernet ports. The interface names may change based on your installation.

    Interfaces 4 and 5 (ens5 and ens6) are the two Ethernet ports used for the PON Controller VNF. Interface ens5 is the Layer 2 control-plane interface between PON Controller and the ACX5448 router with the 10GbE OLT transceivers installed.

    Interface ens6 is the Layer 3 IP interface for connection between the PON Controller and the PON Manager database server.

  7. Provision the Ethernet ports using Ubuntu netplan and the network manager yaml configuration file.
    1. Create a backup copy of the existing yaml configuration file in the /etc/netplan/ directory. From the Ubuntu VNF CLI, enter the following CLI command:
    2. Use a text editor such as vi or nano and edit the existing netplan configuration yaml file in the /etc/netplan/ directory with the following information and save the configuration:
      Note:

      It is important to follow the indentation format as show below in a .yaml file. Replace the IP addresses with appropriate IP addresses for your installation.
  8. Test the netplan configuration by entering the sudo netplan try command at the Ubuntu VNF CLI.

    You notice that the changes are temporarily applied and that the countdown timer starts.

    When you see the countdown timer starts counting down towards zero, press enter to save the changes.

  9. Verify the changes to the IP address of the Ethernet interfaces to ensure they match your requirements.
  10. Reboot the VNF by entering the sudo reboot -h now command.
  11. After the VNF has restarted, verify that the State and Liveliness information are correct for the VNF by running the show virtual-network functions vnfname command.
  12. Ping the PON Controller Ubuntu VNF interface from a device on the same network to verify the connectivity.

    • Connect a network cable into ge-0/0/1 of the NFX250-S2 device and your network.

    • From a computer that is connected to the network verify if you can ping the IP address of the Layer 3 control plane of the PON Controller VNF (ens6).

  13. To complete the PON Controller software installation, open a ssh session from the computer that is a connected to the network to the PON Controller Ubuntu VNF Layer 3 control plane port (ens6). See the MicroClimate™ Management System [MCMS] Installation Guide to install the MCMS PON Controller software and complete its provisioning.
  14. Configure the Layer 2 control plane connection for the NFX250-S2 PON Controller VNF and the VLAN bridge domain in the ACX router.
    1. On the ACX router, configure the Layer 2 interface and enable VLAN tagging for the connection to the NFX250-S2 device.
    2. On the ACX router, configure VLAN bridge domain.
    Note:

    The Layer 2 control plane connection for the PON Controller VNF communicates to the 10G PON SFP+ OLT transceivers hosted in the ACX router.

    The ACX port configuration for the OLT transceivers would also need the VLAN configuration for VLAN 4090 and they need to be added to the VLAN bridge domain to complete the communications path between the PON Controller VNF and the OLT transceivers.
  15. Verify PON Controller software operation. To validate the PON Controller software operation, see the validation steps in the PON Controller Installation section of the MicroClimate™ Management System [MCMS] Installation Guide.