NSP Network Services Platform - Nokia · 2018-03-14 · Note: The platform described in this...

NSPNetwork Services PlatformRelease 17.9

Installer Reference

3HE-12066-AAAD-TQZZA

Issue 1

September 2017

Legal notice

Nokia is a registered trademark of Nokia Corporation. Other products and company names mentioned herein may be trademarks ortradenames of their respective owners.

The information presented is subject to change without notice. No responsibility is assumed for inaccuracies contained herein.

© 2017 Nokia.

NSP


Release 17.9September 2017

2 Issue 1

Contents

About this document............................................................................................................................................4

1 NSP installation overview .............................................................................................................................5

1.1 Introduction .........................................................................................................................................5

1.2 NSP Installer host platform requirements............................................................................................6

1.3 NSP Installer software components and configuration........................................................................8

1.4 Workflow to deploy NSP modules using the NSP Installer .................................................................8

1.5 To install the virtualization OS packages...........................................................................................10

1.6 To provision the NSP Installer host network bridge...........................................................................11

1.7 To install the NSP using the NSP Installer ........................................................................................13

1.8 To enable vCPAA management and operation .................................................................................15

1.9 To enable VSR-NRC management and operation ............................................................................18

1.10 To remove the NSP Installer OS packages and configuration archive..............................................20

NSP

Release 17.9September 2017Issue 1 33HE-12066-AAAD-TQZZA

About this document

Purpose

The Network Services Platform Installer Reference provides information about using the NSPInstaller to deploy Network Services Platform modules.

Document support

Customer documentation and product support URLs:

• Customer Documentation Welcome Page

• Technical support

How to comment

Documentation feedback

NSP



4 Issue 1

https://support.alcatel-lucent.com

https://support.alcatel-lucent.com

mailto:[email protected]

1 NSP installation overview

1.1 Introduction

1.1.1 Description

The NSP Installer orchestrates the deployment of multiple NSP modules as guest VMs on onephysical host. The NSP Installer supports the following deployment types in a live or trialenvironment:

• initial installation of the complete NSP product

• multi-module installation that includes the NSD and NRC modules and one or more of thefollowing:

− Network Functions Manager - Packet, or NFM-P

− Network Functions Manager - Transport, or NFM-T

− Virtual Service Router - Network Resource Controller, or VSR-NRC

Depending on the module and configuration, one or more of the following are also instantiatedduring a module installation:

• virtual Control Plane Assurance Appliance, or vCPAA

• NSP flow collector, or Flow

Functional description

The NSP Installer uses a KVM hypervisor and qcow disk images to instantiate modules in separateVMs according to operator specifications. During a deployment, the installer automatically:

• enables secure communication among the modules using an auto-generated, self-signed SSLcertificate

• applies the appropriate license in an NSP license bundle to each module

• performs the required post-configuration tasks on each module

• initializes each module

Note: In order to obtain an NSP license bundle, you must provide a unique hardware ID foreach NSP module VM that is to be deployed. See 1.4 “Workflow to deploy NSP modulesusing the NSP Installer” (p. 8) for information.

The NSP Installer also performs the configuration actions on a module that is added to an existingNSP system, if the system has been deployed using the NSP Installer.

Note: You cannot use the NSP Installer to add a module to a manually deployed NSP system.

Deployment restrictions

NSP module deployment using the NSP Installer has the following restrictions.

• Each module is deployed as a standalone system; module redundancy is not supported.

NSP NSP installation overview


• The components of a module, for example, an NFM-P main server and database, are collocatedin one VM; distributed deployment is not supported.

• The NSP Installer supports only IPv4 inter-module communication; IPv6 is not supported.

• The NSP Installer performs module installation only, and cannot upgrade a module.

1.2 NSP Installer host platform requirements

1.2.1 Description

The station that hosts the NSP Installer and the module VMs must meet the following platformrequirements.

1.2.2 Hardware requirements

The minimum hardware requirements are the following:

Note: The platform described in this section is listed in the Nokia product catalog, andsatisfies the requirements for a deployment of all supported modules and VMs on one host.The actual number of CPU cores and amount of RAM required depend on which modules areto be installed.

Note: On a ProLiant server, you must ensure that the BIOS Power Profile is set to MaximumPerformance.

• HPE ProLiant DL380 Gen9 2.2GHz 28–core server or equivalent, using E5-2650 v4 CPUs

• 256 Gbytes RAM

• 24 × 300Gbyte 10 000-rpm SAS disks

• 4 × 1Gb/s Ethernet adapters

• HP P440ar disk controller or equivalent with 2Gbyte FBWC

• 12Gb/s SAS expander card

1.2.3 Resource allocation

The NSP Installer host, and each NSP module, requires a minimum set of system resources, suchas CPU cores, RAM, and disks.

Table 1, “Required NSP resources” (p. 6) lists the resources required for each NSP VM.

Table 1 Required NSP resources

Module CPU cores RAM (Gbytes) Disks required

NSP Installer host 1 16 2 1

NSD and NRC trial deployment—4

live deployment—8

24 4

NFM-P 4 38 6

NSP Installer host platform requirements NSP



6 Issue 1

Table 1 Required NSP resources (continued)

NFM-T 8 36 8

vCPAA 2 4 2 1

VSR-NRC 2 4 2 1

Flow 8 32 4

Notes:

1. The NSP Installer host, vCPAA, and VSR-NRC share disk resources.

Disk volumes

The following disk allocation scheme is recommended for greatest performance. However, you canuse any allocation scheme, provided that the scheme allows enough space for the requiredmodules, based on the information in Table 1, “Required NSP resources” (p. 6).

Note: You must ensure that write caching is enabled In the system BIOS for all disk volumes.

• volume 1, NSP Installer, VSR-NRC, vCPAA—two disks in a RAID 1 configuration

• the following additional volumes, for NSP modules—each in a RAID 1+0 configuration− volume 2, NSD and NRC —four disks

− volume 3, NFM-P—six disks

− volume 4, NFM-T—eight disks

− volume 5, Flow—four disks

1.2.4 Host OS

The NSP Installer requires that KVM is installed, configured and running on the host OS. After youinstall the host OS using the RHEL OS ISO disk image file in the NSP software file set, you must dothe following:

• Install the additional OS packages required for virtualization.

• Provision the interfaces, addresses, and other elements required for basic network connectivity;see the OS documentation for information.

• Provision a KVM network bridge for NSP inter-module communication.

See 1.4 “Workflow to deploy NSP modules using the NSP Installer” (p. 8) for more information.

OS configuration for VSR-NRC deployment

In order to deploy the VSR-NRC module, the host system must be configured to support 1GBhugetlbfs memory backing. See the Virtual Service Router document Virtualized Service RouterInstallation and Setup Guide for configuration information and the minimum required memory pageallocation.

Note: A hugetlbfs configuration does not persist through a host reboot unless additionalconfiguration is performed, as described in the Virtual Service Router document VirtualizedService Router Installation and Setup Guide.

NSP NSP Installer host platform requirements


Note: The host FTP server must be enabled to provide VSR-NRC access to the license file.

1.3 NSP Installer software components and configuration

1.3.1 Software components

The NSP Installer software components are the following:

• a RHEL OS ISO image file

• a compressed file that contains the NSP Installer software

• the required qcow image files for each required NSP module

• one NSP license bundle file

1.3.2 Configuring an NSP deployment

A file called config.yml contains the NSP module deployment parameters, which include thefollowing:

• modules to install

• qcow image locations

• NSP licence bundle file location

• network settings

An operator must configure a config.yml file using the parameter values for a specific deployment.To facilitate the configuration, each section header in the file includes a definition for eachassociated parameter. The examples directory in the NSP software bundle includes an exampleconfig.yml file that you can use as a template.

1.3.3 Module post-installation configuration

After you install the vCPAA or VSR-NRC module:

• The module VM requires the configuration of additional network interfaces.

• The module requires commissioning to enable the following:− communication with the managed network

− management by other NSP modules

− for the VSR-NRC, which is deployed as a 7750 SR-c12 chassis, a specific card configuration

See 1.8 “To enable vCPAA management and operation” (p. 15) and 1.9 “To enable VSR-NRCmanagement and operation” (p. 18) for configuration information.

1.4 Workflow to deploy NSP modules using the NSP Installer

1.4.1 Stages

1

Set up the NSP Installer host platform according to the specifications in 1.2 “NSP Installer hostplatform requirements” (p. 6).

NSP Installer software components and configuration NSP



8 Issue 1

2

Install the additional OS packages required for virtualization, as described in 1.5 “To install thevirtualization OS packages” (p. 10).

3

Obtain and record the module hardware IDs required for generating the NSP license bundle.

• For each module other than the NFM-T, obtain a unique UUID for each VM from your networkadministrator, or use an online tool to generate a UUID.

The required UUID is a string of hyphen-separated groups of 8, 4, 4, 4, and 12 hexadecimaldigits, as shown in the following example:

35F59783-2258-11E1-BBDA-38B41F432C41

Note: Each alphabetic digit must be an upper-case character.

• For the NFM-T, obtain a unique MAC address for the primary network interface of the NFM-TVM from your network administrator, or use an online tool to generate the MAC address.

4

Request the NSP license bundle using the recorded hardware IDs.

5

Provision the network objects that the NSP Installer host requires for basic connectivity, such asinterfaces and IP addresses; see the OS documentation for information.

6

Provision a KVM network bridge for NSP inter-module communication, as described in 1.6 “Toprovision the NSP Installer host network bridge” (p. 11).

7

Use the NSP Installer to deploy the NSP, as described in 1.7 “To install the NSP using the NSPInstaller” (p. 13).

8

If you install a vCPAA, commission the device and add the required network interfaces to themodule VM, as described in 1.8 “To enable vCPAA management and operation” (p. 15).

9

If you install a VSR-NRC, commission the device and add the required network interfaces to themodule VM, as described in 1.9 “To enable VSR-NRC management and operation” (p. 18).

10

Optionally, as a system cleanup function, remove the NSP Installer rpm packages, which arenot required by the installed modules; see 1.10 “To remove the NSP Installer OS packages andconfiguration archive” (p. 20).

NSP Workflow to deploy NSP modules using the NSP Installer


1.5 To install the virtualization OS packages

1.5.1 Description

Perform the following steps on the NSP Installer host station after you install the host OS using theRHEL OS ISO image.

1.5.2 Steps

1

Log in to the NSP Installer host station as the root user.

2

Download the following rpm packages from the default RHEL 7.3 package repository to anempty local directory:

• bridge-utils

• libvirt

• libvirt-client

• libvirt-python

• qemu-img

• qemu-kvm

• virt-install

• virt-manager

• virt-viewer

3

Open a console window.

4

Navigate to the directory that contains the downloaded files.

5

Enter the following to install the packages:

Note: Ensure that the directory contains only the downloaded files.

# yum -y install * ↵

The yum utility resolves any package dependencies, and installs each package.

END OF STEPS

To install the virtualization OS packages NSP



10 Issue 1

1.6 To provision the NSP Installer host network bridge

1.6.1 Description

Perform the following steps to create and configure the network bridge required by the NSPInstaller.

Note: It is strongly recommended that you perform the procedure using the local console orthe ILO interface. Using a local session connection ensures that the connection continues tofunction in the event that a misconfiguration isolates the NSP Installer host from the network.

Note: You require root user privileges on the NSP Installer host station.

Note: Command lines use the # symbol to represent the RHEL CLI prompt for the root user.Do not type the leading # symbol when you enter a command.

1.6.2 Steps

1


2


3

Enter the following commands in sequence to stop and disable the NetworkManager, and toenable and start the network service:

# chkconfig NetworkManager off ↵

# chkconfig network on ↵

# systemctl stop NetworkManager ↵

# systemctl start network ↵

4

Ensure that the RHEL Firewalld, iptables, and netfilter configurations allow traffic to and fromthe network bridge; see the OS documentation for information.

5

Open the following file using a plain-text editor such as vi:

/etc/sysconfig/network-scripts/ifcfg-interface

where interface is the network interface that the host is to use for connectivity as a bridgemember, for example, eth0

NSP To provision the NSP Installer host network bridge


6

Locate the following line and assign a network bridge name by setting the bridge_nameparameter:

BRIDGE=bridge_name

7

Record the bridge_name value that you specify; the name is required for subsequentconfiguration activities.

8

Create the following file using a plain-text editor such as vi:

/etc/sysconfig/network-scripts/ifcfg-bridge_name

where bridge_name is the network bridge name specified in Step 6

9

Enter the following as the file content:

TYPE="Bridge"

BOOTPROTO=static

DEFROUTE="yes"

DEVICE="bridge_name"

ONBOOT="yes"

IPADDR=n.n.n.n

PREFIX=mm

GATEWAY=g.g.g.g

DNS1=d.d.d.d

DOMAIN=domain

NM_CONTROLLED=no

where

bridge_name is the network bridge name specified in Step 6

n.n.n.n is the IP address of interface specified in Step 5

mm is the interface subnet mask

g.g.g.g is the gateway IP address

d.d.d.d is a DNS server IP address

domain is the DNS server FQDN

10

Save and close the ifcfg-bridge_name file.

To provision the NSP Installer host network bridge NSP



12 Issue 1

11

Enter the following to instantiate the network bridge:

# brctl addbr bridge_name ↵

where bridge_name is the network bridge name

12

Enter the following to restart the network service:

# systemctl restart network ↵

13

Close the console window.

END OF STEPS

1.7 To install the NSP using the NSP Installer

1.7.1 Description

The following steps describe how to use the NSP Installer to deploy NSP modules.

Note: Before you attempt to perform the procedure, you must configure the host OS asdescribed in 1.6 “To provision the NSP Installer host network bridge” (p. 11).



1.7.2 Steps

1

Download the following files for the current release to the NSP Installer host station:

• NSP Installer software file

• KVM qcow2 image files for each required NSP module

• NSP license bundle file

2


3

Open a console window on the NSP Installer host.

NSP To install the NSP using the NSP Installer


4

Navigate to the directory that contains the downloaded NSP files.

5

Enter the following:

# tar xvf NSP-Installer-R.r.tar.gz ↵

where R.r is the release identifier, in the form MAJOR.minor

6


# cd NSP-Installer-R.r ↵

where R.r is the release identifier, in the form MAJOR.minor

7


# cp examples/config.yml . ↵

The NSP Installer example configuration file is copied to the current directory. After youconfigure the parameters in the file, the NSP Installer uses the parameter settings to deploy thespecified modules.

8

Open the new config.yml file using a plain-text editor such as vi.

Note: As you edit the file in subsequent steps, you must ensure that you do not alter thelead spacing of elements in the file. The NSP Installer cannot use a config.yml file inwhich the lead spacing is altered.

Note: A file location that you specify in the config.yml file is an absolute file path on thelocal file system.

9

A section name is a left-justified line in lower-case characters, for example, nfmp. A sectionheader lists and describes the associated parameters.

Locate the section that begins with the following line.

nsp

10

Set the nsp_license_file parameter to the location of the NSP license bundle file.

11

Set the rootca_store_password parameter to the password that you want to apply to theSSL artifacts that the installer generates and distributes to the modules.

To install the NSP using the NSP Installer NSP



14 Issue 1

12

Configure the parameters in the nspos section.

13

Configure the parameters in the individual module sections, as required.

The following are the mappings of section names to modules:

• sdn—NSD and NRC

• nfmp—NFM-P

• nfmt—NFM-T

• vsr—VSR-NRC

• cpaa—vCPAA

• nfc—NSP flow collector

Note: The qcow2_image_source value in the sdn section must match theqcow2_image_source value in the nspos section.

14

Configure the parameters in the network section using the network information specified in1.6 “To provision the NSP Installer host network bridge” (p. 11).

15

Review and verify the configuration.

16

Save and close the config.yml file.

17


# ./install.bash ↵

The modules specified in the configuration file are installed.

18


END OF STEPS

1.8 To enable vCPAA management and operation

1.8.1 Description

Perform the following steps after you install the vCPAA module using the NSP Installer tocommission the device for management and configure the connection to the managed network.

NSP To enable vCPAA management and operation




1.8.2 Steps

1

Log in as the root user on the NSP Installer host station.

2


3

Open a CLI session on the vCPAA device.

1. Enter the following.

# telnet device_IP port ↵

where

device_IP is the nsp_installer_host_ip value in the cpaa section of config.yml

port is the telnet_port value in the cpaa section of config.yml

2. Enter the following user credentials when prompted:• user—admin

• password—admin

4

Enter the following to configure one or more static routes, if required:

bof address management_IP/mm ↵

where

management_IP is the vCPAA management IP address to assign

mm is the subnet mask to assign

5

Enter the following to configure a static route, if required:

bof static-route network_IP/mm next-hop next_hop_IP ↵

where

network_IP is the destination network IP address

mm is the subnet mask

next_hop_IP is the IP address of the next hop in the static route

6

Enter the following in sequence to complete the BOF configuration:

To enable vCPAA management and operation NSP



16 Issue 1

bof persist on ↵

bof save ↵

7


configure router interface system address system_interface_IP/mm ↵

where

system_interface_IP is the vCPAA system interface IP address

mm is the system interface subnet mask

8

Enter the following in sequence to complete the device commissioning:

configure system snmp no shutdown ↵

configure system snmp packet-size 9216 ↵

configure system security snmp community private rwa version both ↵

admin save ↵

admin reboot now ↵

The vCPAA reboots. After the reboot, the NFM-P can discover the vCPAA

.

9


10

For managed network connectivity, and to establish peering sessions, the vCPAA VM requiresvirtual network interfaces, or vNICs. The first vNIC, which the NSP Installer creates, is mappedto the CFM-A management port.

Depending on your network architecture, you may need to provision additional vNICs, create anadditional network bridge, and bind the vNICs to the bridge.

Note: The second provisioned VSR-NRC interface is reserved for CFM-B. AdditionalvNICs that you create are sequentially assigned as network ports 1/1/1, 1/1/2, and so on.

If required, perform the following to create additional vNICs; see the RHEL OS documentationfor more information.

Note: You must choose “virtio” as the Device model for each interface.

1. Open the RHEL Virtual Machine Manager, or virt-manager, tool.

2. Use the tool to add virtual network interfaces, as required.

3. When the creation of all interfaces is complete, restart the vCPAA VM.

After the VM restarts, the provisioned interfaces are shown in the vCPAA configuration as ports.

NSP To enable vCPAA management and operation


11


END OF STEPS

1.9 To enable VSR-NRC management and operation

1.9.1 Description

Perform the following steps after you install the VSR-NRC module using the NSP Installer tocommission the device for management and configure the connection to the managed network.

Note: The NSP Installer deploys the VSR-NRC as a 7750 SR-c12 chassis.



1.9.2 Steps

1


2


3

Open a CLI session on the VSR-NRC device using one of the following methods.

a. Use a Telnet connection.

1. Enter the following.

# telnet device_IP port ↵

where

device_IP is the nsp_installer_host_ip value in the vsr section of config.yml

port is the telnet_port value in the vsr section of config.yml

2. Enter the following user credentials when prompted:• user—admin

• password—admin

b. Use an SSH connection.

1. # ssh -l admin device_IP ↵

where device_IP is the primary_management_ip value in the vsr section of config.yml

2. Enter admin when prompted for the user password.

To enable VSR-NRC management and operation NSP



18 Issue 1

4

Enter the following to configure a static route, if required:

bof static-route network_IP/mm next-hop next_hop_IP ↵

where

network_IP is the destination network IP address

mm is the subnet mask

next_hop_IP is the IP address of the next hop in the static route

5

Enter the following in sequence to complete the BOF configuration:

bof persist on ↵

bof save ↵

6

Enter the following to configure the VSR-NRC system address:

configure router interface system address system_interface_IP/mm ↵

where

system_interface_IP is the VSR-NRC system interface IP address

mm is the system interface subnet mask

7

Enter the following in sequence to complete the device commissioning:

configure system snmp no shutdown ↵

configure system snmp packet-size 9216 ↵

configure system security snmp community private rwa version both ↵

configure card 1 card-type iom-xp-b ↵

configure card 1 mcm 1 mcm-type mcm-xp ↵

configure card 1 mda 1 mda-type m60-10/100eth-tx ↵

admin save ↵

admin reboot now ↵

The VSR-NRC reboots. After the reboot, the NFM-P can discover the VSR-NRC.

8


9

For managed network connectivity, and to establish peering sessions, the VSR-NRC VMrequires network interfaces, or vNICs. The first vNIC, which the NSP Installer creates, ismapped to the CFM-A management port.

NSP To enable VSR-NRC management and operation


Depending on your network architecture, you may need to provision additional vNICs, create anadditional network bridge, and bind the vNICs to the bridge.

Note: The second provisioned VSR-NRC interface is reserved for CFM-B. AdditionalvNICs that you create are sequentially assigned as network ports 1/1/1, 1/1/2, and so on.

If required, perform the following to create additional vNICs; see the RHEL OS documentationfor more information.

Note: You must choose “virtio” as the Device model of each interface.

1. Open the RHEL Virtual Machine Manager, or virt-manager, tool.

2. Use the tool to add virtual network interfaces, as required.

3. When the creation of all interfaces is complete, restart the VSR-NRC VM.

After the VM restarts, the interfaces are shown as ports in the VSR-NRC configuration.

10


END OF STEPS

1.10 To remove the NSP Installer OS packages and configurationarchive

1.10.1 Description

The NSP installer installs RHEL OS packages on the host station that are required only for an NSPdeployment, and saves an archive copy of the deployment configuration.

As a cleanup measure after a successful NSP deployment, you can use a script to uninstall thepackages and delete the deployment configuration, as described in the following steps.

Note: Performing the procedure does not remove or otherwise affect any installed NSPmodule.


Note: A leading # symbol in a command line represents the RHEL CLI prompt for the rootuser. Do not type the leading # symbol when you enter a command.

1.10.2 Steps

1


2


To remove the NSP Installer OS packages and configuration archive NSP



20 Issue 1

3

Navigate to the directory that contains the NSP Installer files.

4


# ./uninstall.bash ↵

The script removes the NSP Installer OS packages and configuration archive.

5

When the script execution is complete, close the console window.

END OF STEPS

NSP To remove the NSP Installer OS packages and configuration archive


To remove the NSP Installer OS packages and configuration archive NSP



22 Issue 1

Date post:	09-Apr-2020
Category:	Documents
Upload:	others
View:	6 times
Download:	0 times

NSP Network Services Platform - Nokia · 2018-03-14 · Note: The platform described in this...

Documents