DNA-M Installation & Upgrade

Guide for Linux

Document id: DNA-M-InstLinux

Version 36.0, Rev A, 2021-04-26

Copyright
© Copyright 2020 Infinera Corporation. All rights reserved. This Manual is the property of Infinera Corporation and is
confidential. No part of this Manual may be reproduced for any purposes or transmitted in any form to any third party
without the express written consent of Infinera. Infinera makes no warranties or representations, expressed or implied,
of any kind relative to the information or any portion thereof contained in this Manual or its adaptation or use, and
assumes no responsibility or liability of any kind, including, but not limited to, indirect, special, consequential or
incidental damages, even if Infinera, its affiliates, or its suppliers have been advised of the possibility of such damages,
(1) for any errors or inaccuracies contained in the information or (2) arising from the adaptation or use of or the inability
to use the information or any portion thereof including any application of software referenced or utilized in the Manual.
The information in this Manual is subject to change without notice.
Trademarks
Infinera, Infinera Intelligent Transport Networks, I-PIC, IQ NOS, FlexILS, DTN-X, DTN, ATN, FastSMP and logos that
contain Infinera are trademarks or registered trademarks of Infinera Corporation in the United States and other
countries. All other trademarks in this Manual are the property of their respective owners.
Infinera DTN-X, DTN, FlexILS, Cloud Xpress, XT, and ATN Regulatory Compliance
FCC Class A
This device complies with Part 15 of the FCC rules. Operation is subject to the following two conditions: (1) this device
may not cause harmful interference, and (2) this device must accept any interference received, including interference
that may cause undesired operation. Modifying the equipment without Infinera’s written authorization may result in the
equipment no longer complying with FCC requirements for Class A digital devices. In that event, your right to use the
equipment may be limited by FCC regulations, and you may be required to correct any interference to radio or
television communications at your own expense.
DOC Class A
This digital apparatus does not exceed the Class A limits for radio noise emissions from digital apparatus as set out in
the interference-causing equipment standard titled “Digital Apparatus," ICES-003 of the Department of
Communications. Cet appareil numérique respecte les limites de bruits radioélectriques applicables aux appareils
numériques de Classe A prescrites dans la norme sur le matériel brouilleur: "Appareils Numériques," NMB-003 édictée
par le Ministère des Communications.
Class A ITE
This is a Class A product based on the standard of the VCCI Council. If this equipment is used in a domestic
environment, radio interference may occur, in which case, the user may be required to take corrective actions.

Warning
This is a class A product. In a domestic environment this product may cause radio interference in which case the user
may be required to take adequate measures.
FDA
This product complies with the DHHS Rules 21CFR 1040.10 and 1040.11, except for deviations pursuant to Laser
Notice No. 50, dated June 24, 2007.
Contents
1. DNA-M Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.1. Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.1.1. Small . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.1.2. Medium . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.1.3. Large . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.2. Pre-installation checklists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.3. Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.3.1. Upgrading Red Hat or CentOS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.3.2. Installing Java . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.3.3. Installing MariaDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.3.4. Installing RabbitMQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.3.5. Installing DNA-M . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.3.6. Configure RabbitMQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.3.7. Installing DNA-M license . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
1.3.8. Initializing the database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
1.3.9. Configuring the DNA-M server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
1.4. Setting DNA-M up to run as a non-root user (optional) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
1.4.1. Starting DNA-M . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
2. DNA-M Upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
2.1. Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
2.1.1. Small . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
2.1.2. Medium . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
2.1.3. Large . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
2.2. Pre-upgrade checklists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
2.3. Upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
2.3.1. Updating Red Hat or CentOS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
2.3.2. Updating Java . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
2.3.3. Updating MariaDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
2.3.4. Updating RabbitMQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
2.3.5. Upgrading DNA-M . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
2.3.6. Configure RabbitMQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
2.3.7. Updating configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
2.3.8. Starting DNA-M . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
2.4. Rollback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
2.4.1. Stopping DNA-M . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
2.4.2. Restoring database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
2.4.3. Restoring DNA-M . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
2.4.4. Restoring configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
2.4.5. Starting DNA-M . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
3. DNA-M Client Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
3.1. Installing DNA-M Client using RPM files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
DNA-M Installation & Upgrade Guide for Linux Preface

Installation and upgrade Guide for the Digital Network Administrator Metro (DNA-
M), version 36.0.0
The document is divided into two parts:

• DNA-M Installation
Read this part if you intend to install the DNA-M Server for the first time.
• DNA-M Upgrade
Read this part of the guide if you intend to upgrade an already installed DNA-M Server.

DNA-M-InstLinux | 2021-04-26 1 (16) © Infinera Corporation 2021

DNA-M Installation & Upgrade Guide for Linux 1. DNA-M Installation

1. DNA-M Installation
This chapter will take you through the prerequisites and necessary steps to install a DNA-M server
for the first time. Prerequisites needed for installing the DNA-M Server as well as useful checklists
before starting the installation can be found below.

1.1. Prerequisites
The host machine onto which you intend to install the DNA-M Server must meet the following
requirements:

1.1.1. Small
Hardware Requirements Comment OK?

CPU 12 cores

RAM 32 GB

Storage 100 GB Dedicated drive/array for the database is recommended

1.1.2. Medium
Hardware Requirements Comment OK?

CPU 18 cores

RAM 64 GB

Storage 150 GB Dedicated drive/array for the database is recommended

1.1.3. Large
Hardware Requirements Comment OK?

CPU 24 cores

RAM 128 GB

Storage 150 + 300 GB 300GB for database, dedicated drive/array for the
database is recommended

Software Requirements Comment OK?

Linux Red Hat Enterprise Linux 7.7 How to check: cat /etc/*-release
CentOS 7

Java Open JDK 8, Java Runtime How to check: java -version

Environment (JRE) 8 update 242 or
latest available update recommended

Database MariaDB 10.4.x (latest stable release) How to check: mysql --version

Messaging broker RabbitMQ 3.7 (latest stable release) How to check: rabbitmqctl status

1.2. Pre-installation checklists

Filling out the following checklists before starting the installation will help you verify that all

DNA-M-InstLinux | 2021-04-26 2 (16) © Infinera Corporation 2021

DNA-M Installation & Upgrade Guide for Linux 1. DNA-M Installation

requirements are met.

Item Comment OK?

Location of DNA-M installation media

Location of DNA-M license file

([Link])
Access to Linux software repository for Red Hat: [Link]
your OS version [Link] (requires Red Hat subscription)
CentOS: [Link]
Packages/

Server Comment OK?

DNS name

IP address

Root access Root access required for installation

1.3. Installation
Follow the steps in this section if you are performing a new installation on a server with no previous
version of DNA-M.

1.3.1. Upgrading Red Hat or CentOS

Before starting the DNA-M installation, ensure that the latest version of the OS is installed.
Upgrading the CentOS or a properly subscribed Red Hat system is done by running the following
command:

yum update

A Red Hat subscription is acquired through Red Hat.

If the server does not have Internet access, the upgrade can be performed using the latest
installation media, downloaded from CentOS or Red Hat.

1.3.2. Installing Java

If the server has Internet access an appropriate version of Java will be installed automatically during
the DNA-M installation. If this is not the case, a suitable version must be installed manually. The
easiest way to do this is to go to the software repository for your Linux version and search for java-
1.8.0-openjdk. Download the latest x86_64 rpm file and transfer it to the DNA-M server. Then install
it by issuing the following command in the directory with the file:

yum install java-1.8.0-openjdk*.rpm

In order to set the correct version of Java as the system JVM run the following command and select
the Java 8 entry:

DNA-M-InstLinux | 2021-04-26 3 (16) © Infinera Corporation 2021

DNA-M Installation & Upgrade Guide for Linux 1. DNA-M Installation

alternatives --config java

1.3.3. Installing MariaDB

The DNA-M Server requires a MariaDB server to run and instructions on how to install the latest
stable version can be found at [Link]

1.3.4. Installing RabbitMQ

RabbitMQ is a messaging broker (based on Erlang) - an intermediary for messaging, used for
sending messages about events internally in DNA-M.
Below are two ways of installing the RabbitMQ depending on whether the host machine has access
to the Internet or not.

[Link]. Installing RabbitMQ using YUM repository

 This alternative provides easy setup and access to updates but can only be used if
the host machine has access to the Internet.

1. Add Erlang repository

curl -s [Link] | sudo bash

2. Add RabbitMQ repository

curl -s [Link] | sudo bash

3. Install RabbitMQ
a. Red Hat Enterprise Linux 7 and Centos 7

yum install rabbitmq-server

b. Red Hat Enterprise Linux 6

yum install epel-release

yum install rabbitmq-server

[Link]. Installing RabbitMQ using RPM files

1. Download Erlang RPM from [Link] version 21.0 or later
2. Install Erlang

DNA-M-InstLinux | 2021-04-26 4 (16) © Infinera Corporation 2021

DNA-M Installation & Upgrade Guide for Linux 1. DNA-M Installation

yum install erlang*.rpm

3. Download RabbitMQ RPM from [Link] version 3.7 or

later
4. Install RabbitMQ

yum install rabbitmq-server-*.rpm

Please refer [Link] for details about the

 compatibility between the RabbitMQ and Erlang RPMs and ensure the compatible
RPMs are installed

1.3.5. Installing DNA-M

 Port 5672 must be opened in firewall between DNA-M Server and DNA-M Client

Below are the way of installing the DNA-M Server.

[Link]. Installing DNA-M using RPM files

Download the DNA-M installation archive in tgz format from [Link]

Move the installation archive to the server, extract it:

tar zxvf tnm-*-[Link]

Install the DNA-M server with:

yum install tnm-*.rpm

1.3.6. Configure RabbitMQ

RabbitMQ must be configured for use with DNA-M. Configure with following command

/opt/transmode/tnm/mainserver/scripts/setup_rabbitmq.sh

[Link]. Enable auto-start of RabbitMQ

Enable auto-start of RabbitMQ upon startup of the host machine

chkconfig rabbitmq-server on

DNA-M-InstLinux | 2021-04-26 5 (16) © Infinera Corporation 2021

DNA-M Installation & Upgrade Guide for Linux 1. DNA-M Installation

1.3.7. Installing DNA-M license

Place the license file [Link] in the directory /etc/tnm

1.3.8. Initializing the database

The database must be initialized for use by DNA-M with the following command:

mysql -uroot -p < /opt/transmode/tnm/mainserver/scripts/[Link]

The [Link] script creates a database and database user dedicated to DNA-M.

1.3.9. Configuring the DNA-M server

A default installation of DNA-M does not require any manual configuration. Optional adjustments
such as server name or memory usage are configured in the following files:

Configuration files Comment

/etc/tnm/[Link] DNA-M application settings (e.g. server name, node trap address, …)

/etc/sysconfig/tnmserver Java runtime settings (e.g. memory usage)

/etc/tnm/[Link] Logging settings (e.g. debug logging)

Please refer to the DNA-M Server Admin Guide for available settings.

[Link]. Enable starting DNA-M via ServerGUI in Red Hat Enterprise Linux 6
(optional)
In order to be able to start DNA-M server via ServerGUI in Red Hat Enterprise Linux 6, follow below
instructions.

1. Remove # from the line #[Link]: service tnmserver in /etc/tnm/[Link]

 After this change, to start DNA-M server via ServerGUI in Red Hat Enterprise
Linux 6, the ServerGUI must be ran as root

1.4. Setting DNA-M up to run as a non-root user (optional)

DNA-M can be set up to run as a non-root user. For this configuration, the sudo and iptables
packages must be installed on the server where DNA-M is running. All ports in
/etc/tnm/[Link] must also be set to available non-privileged ports above 1023.

In order to configure this simply run the script setup_user.sh, found in

/opt/transmode/tnm/mainserver/scripts/, with the desired user as an argument:

/opt/transmode/tnm/mainserver/scripts/setup_user.sh username

The script will check for all needed packages and settings and inform if anything needs to be

DNA-M-InstLinux | 2021-04-26 6 (16) © Infinera Corporation 2021

DNA-M Installation & Upgrade Guide for Linux 1. DNA-M Installation

corrected.

After setup is completed the chosen user will be able to perform all DNA-M server admin operations,
have access to the DNA-M directories, and can start and stop DNA-M using sudo, e.g.

sudo service tnmserver start

1.4.1. Starting DNA-M

service tnmserver start

Once the DNA-M server is started, the DNA-M client GUI can be downloaded, installed and started
from the DNA-M webstart page:

[Link] server ip-address>:9000

To access the DNA-M server GUI, please read the DNA-M Server Administration Guide.

DNA-M-InstLinux | 2021-04-26 7 (16) © Infinera Corporation 2021

DNA-M Installation & Upgrade Guide for Linux 2. DNA-M Upgrade

2. DNA-M Upgrade
This chapter will take you through the prerequisites and necessary steps to upgrade from a prior
version of the DNA-M server. Prerequisites needed for upgrading the DNA-M Server as well as
useful checklists before starting the installation can be found below.

2.1. Prerequisites
The host machine onto which you intend to upgrade the DNA-M Server must meet the following
requirements:

2.1.1. Small
Hardware Requirements Comment OK?

CPU 12 cores

RAM 32 GB

Storage 100 GB Dedicated drive/array for the database is recommended

2.1.2. Medium
Hardware Requirements Comment OK?

CPU 18 cores

RAM 64 GB

Storage 150 GB Dedicated drive/array for the database is recommended

2.1.3. Large
Hardware Requirements Comment OK?

CPU 24 cores

RAM 128 GB

Storage 150 + 300 GB 300GB for database, dedicated drive/array for the
database is recommended

Software Requirements Comment OK?

Linux Red Hat Enterprise Linux 7.7 How to check: cat /etc/*-release
CentOS 7

Java Open JDK 8, Java Runtime How to check: java -version

Environment (JRE) 8 update 242 or
latest available update recommended

Database MariaDB 10.4.x (latest stable release) How to check: mysql --version

Messaging broker RabbitMQ 3.7 (latest stable release) How to check: rabbitmqctl status

2.2. Pre-upgrade checklists

Filling out the following checklists before starting the upgrade procedure will help you verify that all

DNA-M-InstLinux | 2021-04-26 8 (16) © Infinera Corporation 2021

DNA-M Installation & Upgrade Guide for Linux 2. DNA-M Upgrade

requirements are met.

Files Comment OK?

Location of current DNA-M installation media

Location of new DNA-M installation media

Access to Linux software repository for your Red Hat: [Link]

OS version [Link] (requires Red Hat subscription)
CentOS: [Link]
Packages/

Location of DNA-M license file ([Link])

Server Comment OK?

DNS name

IP address

Root access Root access required for installation

DNA-M status Comment OK?

Server name Default: Tnm Server

Server IP used by DNA-M Client

Server IP used by network elements to send

SNMP traps to DNA-M

Nodes Number and status

Services Number and status

Discovery calculation Duration and status

2.3. Upgrade
Once all the prerequisites are met and all checklists crossed off the actual upgrade can begin.

2.3.1. Updating Red Hat or CentOS

Before starting the DNA-M upgrade, ensure that the latest version of the OS is installed. Upgrading
the CentOS or a properly subscribed Red Hat system is a simple matter of running the following
command:

yum update

A Red Hat subscription is acquired through Red Hat.

If the server does not have Internet access, the upgrade can be performed using the latest
installation media, downloaded from CentOS or Red Hat.

2.3.2. Updating Java

If the server has Internet access an appropriate version of Java will be installed automatically during
the DNA-M installation. If this is not the case, a suitable version must be installed manually. The

DNA-M-InstLinux | 2021-04-26 9 (16) © Infinera Corporation 2021

DNA-M Installation & Upgrade Guide for Linux 2. DNA-M Upgrade

easiest way to do this is to go to the software repository for your Linux version and search for java-
1.8.0-openjdk. Download the latest x86_64 rpm file and transfer it to the DNA-M server. Then install
it by issuing the following command in the directory with the file:

yum install java-1.8.0-openjdk*.rpm

In order to set the correct version of Java as the system JVM run the following command and select
the Java 8 entry:

alternatives --config java

2.3.3. Updating MariaDB

 Backup your current DNA-M database before upgrading MariaDB or DNA-M.

Starting DNA-M initiates an automatic upgrade of the DNA-M database tables.

mysqldump -uroot -p --single-transaction --quick --databases tnmdb -r /BACKUP_LOCATION/BACKUP_NAME.sql

BACKUP_LOCATION and BACKUP_NAME are to be replaced with the actual folder and filename
respectively.

The DNA-M Server requires a MariaDB server to run. Instructions on how to install the latest stable
version can be found at [Link]

If Database replication using MariaDb Galera Cluster is used and MariaDb is upgraded to version
10.4 and greater, then compatible Galera RPM should be installed. For example: For MariaDb
version 10.4, galera-4 should be installed.

2.3.4. Updating RabbitMQ

RabbitMQ is a messaging broker (based on Erlang) - an intermediary for messaging, used for
sending messages about events internally in DNA-M.
Below are two ways of installing the RabbitMQ depending on whether the host machine has access
to the Internet or not. For details, please refer [Link]

 Port 5672 must be opened in firewall between DNA-M Server and Client

[Link]. Installing using the YUM repository

 This alternative provides easy setup and access to updates but can only be used if
the host machine has access to the Internet.

1. Add Erlang repository

curl -s [Link] | sudo bash

2. Add RabbitMQ repository

DNA-M-InstLinux | 2021-04-26 10 (16) © Infinera Corporation 2021

DNA-M Installation & Upgrade Guide for Linux 2. DNA-M Upgrade

curl -s [Link] | sudo bash

3. Install RabbitMQ
a. Red Hat Enterprise Linux 7 and Centos 7

yum install rabbitmq-server

b. Red Hat Enterprise Linux 6

yum install epel-release

yum install rabbitmq-server

[Link]. Installing using RPM files

1. Download Erlang RPM from [Link] version 21.0 or later
2. Install Erlang

yum install erlang*.rpm

3. Download RabbitMQ RPM from [Link] version 3.7 or

later
4. Install RabbitMQ

yum install rabbitmq-server-*.rpm

Please refer [Link] for details about the

 compatibility between the RabbitMQ and Erlang RPMs and ensure the compatible
RPMs are installed

2.3.5. Upgrading DNA-M

First stop the running instance of the DNA-M Server.

service tnmserver stop

If you are using database replication, then the replication should be halted now. Refer to the DNA-M
Database Replication Guide for complete details on restarting replication. In short the replication can
be stopped as follows. From the database commandline:

DNA-M-InstLinux | 2021-04-26 11 (16) © Infinera Corporation 2021

DNA-M Installation & Upgrade Guide for Linux 2. DNA-M Upgrade

mysql -uroot -p -e "stop slave;"

mysql -uroot -p -e "reset slave;"

[Link]. Upgrade DNA-M using RPM files

Before starting the upgrade, it is necessary to take a backup of the following configuration files:

Configuration files

/etc/tnm/[Link] General DNA-M settings

/etc/sysconfig/tnmserver Java settings

/etc/tnm/[Link] Logging settings

Download the installation archive in tgz format from [Link]

After moving the installation archive to the server, extract it:

tar zxvf tnm-*-[Link]

Upgrade DNA-M by running the following command:

yum install tnm-*.rpm

 If PM Aggregation is planned to be enabled after upgrade, please refer to DNA-M

Server Admin Guide. PM Aggregation section contains these details.

2.3.6. Configure RabbitMQ

RabbitMQ must be configured for use with DNA-M. Configure with following command

/opt/transmode/tnm/mainserver/scripts/setup_rabbitmq.sh

[Link]. Enable auto-start of RabbitMQ

Enable auto-start of RabbitMQ upon startup of the host machine

chkconfig rabbitmq-server on

2.3.7. Updating configuration

Run the config_migration script:

/opt/transmode/tnm/config_migration/bin/config_migration

This script restore configurations in /etc/tnm/[Link] and in /etc/sysconfig/tnmserver from backup

DNA-M-InstLinux | 2021-04-26 12 (16) © Infinera Corporation 2021

DNA-M Installation & Upgrade Guide for Linux 2. DNA-M Upgrade

file /etc/sysconfig/[Link].

Restore the configuration files by manually comparing the backup files with the newly copied files
and update configuration files as necessary:

Configuration files

/etc/tnm/[Link] General DNA-M settings

/etc/sysconfig/tnmserver Java settings

/etc/tnm/[Link] Logging settings

Please refer to the DNA-M Server Admin Guide for available settings.

[Link]. Enable starting DNA-M via ServerGUI in Red Hat Enterprise Linux 6
(optional)
In order to be able to start DNA-M server via ServerGUI in Red Hat Enterprise Linux 6, follow below
instructions.

1. Remove # from the line #[Link]: service tnmserver in /etc/tnm/[Link]

 After this change, to start DNA-M server via ServerGUI in Red Hat Enterprise
Linux 6, the ServerGUI must be ran as root

2.3.8. Starting DNA-M

1. Red Hat Enterprise Linux 7 and Centos 7

systemctl daemon-reload

service tnmserver start

2. Red Hat Enterprise Linux 6

service tnmserver start

Once the DNA-M server is started, the DNA-M client GUI can be downloaded, installed and started
from the DNA-M webstart page:

[Link] server ip-address>:9000

To access the DNA-M server GUI, please read the DNA-M Server Administration Guide.

Verify the DNA-M installation against the checklist created before the upgrade. All behavior should
be the same, or changed according to the DNA-M release notes.

If you are using database replication, turn it on now by executing the following command on the

DNA-M-InstLinux | 2021-04-26 13 (16) © Infinera Corporation 2021

DNA-M Installation & Upgrade Guide for Linux 2. DNA-M Upgrade

slave server. Refer to the DNA-M Database Replication Guide for Linux for details.

mysql -uroot -p -e "start slave;"

2.4. Rollback
If, for any reason, the upgrade has to be rolled back, go through the following steps.

Make sure that you have the previous version of DNA-M available. If you are installing using rpm
files you need to download the installation archive from the TAC website.

2.4.1. Stopping DNA-M

Stop the DNA-M server if it is still running:

service tnmserver stop

If you are using database replication, stop it now by running the following commands on the slave
server. Refer to the DNA-M Database Replication Guide for Linux for details.

mysql -uroot -p -e "stop slave;"

mysql -uroot -p -e "reset slave all;"

2.4.2. Restoring database

Make sure that your database backup is available and drop the upgraded database and source the
backup:

mysql -uroot -p -e "drop database tnmdb;"

mysql -uroot -p -e "source /BACKUP_LOCATION/BACKUP_NAME.sql"

2.4.3. Restoring DNA-M

Uninstall the current DNA-M installation:

yum erase tnm*

Copy the previous release to the server

Install the previous version:

[Link]. Installation using RPM files

yum clean all

yum install 'tnm*.rpm'

DNA-M-InstLinux | 2021-04-26 14 (16) © Infinera Corporation 2021

DNA-M Installation & Upgrade Guide for Linux 2. DNA-M Upgrade

2.4.4. Restoring configuration

Check and update configuration files /etc/tnm/[Link] and /etc/sysconfig/tnmserver as
mentioned in section Updating configuration.

2.4.5. Starting DNA-M

Start the DNA-M server again:

service tnmserver start

If you are using database replication, turn it on now by executing the following command on the
slave server.

mysql -uroot -p -e "start slave;"

Refer to the Database Replication Guide for DNA-M for details.

DNA-M-InstLinux | 2021-04-26 15 (16) © Infinera Corporation 2021

DNA-M Installation & Upgrade Guide for Linux 3. DNA-M Client Installation

3. DNA-M Client Installation

Before starting the installation, ensure that the latest version of the OS is installed. (refer Upgrading
Red Hat or CentOS) Also ensure that Java is installed. (refer Installing Java)

 Port 5672 must be opened in firewall between DNA-M Server and DNA-M Client

3.1. Installing DNA-M Client using RPM files

Download the DNA-M Client installation archive in tgz format from [Link]

Move the installation archive to the client machine, and extract it:

tar zxvf tnm-*-[Link]

Install the DNA-M client with:

yum install tnm-*.rpm

Once its installed, the client can be launched from /opt/transmode/tnm/clientgui/bin using the
command

./clientgui

DNA-M-InstLinux | 2021-04-26 16 (16) © Infinera Corporation 2021