Professional Documents
Culture Documents
Tj5500-Tj5100 Im Guide
Tj5500-Tj5100 Im Guide
www.tejasnetworks.com
Copyright Notice
Copyright © Tejas Networks Ltd. All rights reserved. No part of this book or manual may be
reproduced or transmitted in any form or by any means, electronic or mechanical, including
photocopying, recording, or by any information storage and retrieval system, without the express
written permission from Tejas Networks Ltd.
Trademark Acknowledgments
All terms mentioned in this book that are known trademarks or service marks have been
appropriately capitalized. All trademarks duly acknowledged. Tejas Networks cannot attest to the
accuracy of third-party information. Use of a term in this document should not be regarded as
affecting the validity of any trademark or service mark.
Feedback
Your opinion is of great value and will help us improve the quality of our documentation and related
learning resources. Drop a note to docs@tejasnetworks.com and let us know how we can assist you
in your learning.
Revision History
Version Document ID Modifications Made
1.0 400-DOC000191-E Standard Release
Issue Date: 16-Apr-2021
Table of Contents
Document overview 5
Additional resources .............................................................................. 5
Target audience.................................................................................... 5
Installation procedure 13
Installing Virtual Environment................................................................ 13
Installing Proxmox Server...................................................................... 13
Preparing installation USB media on Linux ............................................... 18
Installing RHEL 8.2 .............................................................................. 21
Set the host name ............................................................................... 30
Post installation procedure .................................................................... 30
iv
Document overview
This section describes who must read this guide, how it is organized, and what
conventions are used in the document.
Additional resources
The guide listed below is published and shared as a zip bundle: NMS TJ5500 EMS
TJ5100 8.1.1.0 Guides.zip
Installed RHEL packages for 8 This document provides the list of RHEL
update 2 packages need to be installed and run for
TJ5100 and TJ5500
Target audience
This document is intended for Technician or Field engineers who install and commission
hardware or software at customer premises.
5
NMS TJ5500 & EMS TJ5100 Infrastructure Management Guide
6
Get started with installation
This chapter provides an overview of pre-requisites, server requirements, server partition
details and TCP/UDP ports required during installation of RHEL 8.2.
NOTE: As per the installation requirement, identify the correct interface on the
server to connect to the internet.
If installation media is in the form of a DVD, the server must have a built in DVD
drive, or an external DVD drive is required.
For upgrading an existing installation, ensure that you take backup of the following:
7
NMS TJ5500 & EMS TJ5100 Infrastructure Management Guide
Server requirements
Before installing Linux OS, ensure that server meets the following hardware requirements
for different TJ5100/TJ5500 Installation modes.
Standalone mode
Co-residency mode
Components 1k NEQs
Clustering mode
Components 60k NEQs (10 EMS with 6K NEQ or 20 EMS with 3K NEQ)
8
Get started with installation
NOTE: RAS server can be co-resident with EMS/NMS, or with EMS alone or NMS
alone.
9
NMS TJ5500 & EMS TJ5100 Infrastructure Management Guide
Server partitions
Following table lists the recommended partitioning of the HDD in the Linux server. The
partition scheme shown is an example, any disk size which is either lower or higher
should proportionately change the allocations as mentioned in the example.
/ 50 Linux OS
/var 160 TJ5100 Database
/opt 160 TJ5100 Software
/home 114 User Area
/swap 64 Paging of processes
/ 50 Linux OS
/var 190 TJ5500 Database
/opt 190 TJ5500 Software
/home 154 User Area
/swap 64 Paging of processes
NOTE: Make sure that swap area is always double the RAM size of the system.
The partitioning scheme is the same for a solid state drive based storage
medium. Currently, servers are being used with solid state drive based storage
media.
10
Get started with installation
TCP 20800 TJ5500 TJ5100 Co-Resident port TJ5500 and TJ5100 server
UDP 162 and TJ5500 SNMP Trap listener port TJ5100 and Nodes
163
UDP 10162 TJ5100 SNMPv3 trap listener TJ5100 and nodes
UDP 10059 Notification from NE to TJ5100 TJ5100 and nodes
TCP 20080 HTTP port for Node (If http is TJ5100 and nodes
used)
TCP 55300- SSL enabled CORBA between TJ5100 and TJ5500
55501 TJ5100 and TJ5500
TCP 13000,1300 Kannel TJ5100 and TJ5500
1,13013
TCP 465 and SMTP to send mail notifications TJ5100 and TJ5500
587
The following table lists the ports used by the TJ5500 server:
11
NMS TJ5500 & EMS TJ5100 Infrastructure Management Guide
TCP 444 HTTPS port for MTOSI NBI web TJ5500 server and TJ5500
client client
TCP 3306 MySQL DB connection port TJ5500 server and DB
server
TCP 9999 TMF notification listener port TJ5500 and TJ5100 servers
TCP 30443 Launch EMS context in TJ5500 TJ5500 and TJ5100
Topology View
UDP 1812 Radius communication Between Radius and TJ5100
and TJ5500
TCP 21004 TJ5500 to RAS communication port TJ5500 and RAS server
(if Tejas RAS is deployed)
TCP 1221 Analytics Server in TJ5500 TJ5500
TCP 20900 Naming Service port Client and Server
UDP 123 NTP Time sync
TCP 1099 RMI port for Communication Client and Server
TCP 446 REST API REST API Port
TCP 34456 NMS client app webswing TJ5500 Webswing client
port
12
Installation procedure
This chapter covers the following:
Proxmox server is an open source KVM based virtualization mechanism which can be
used to setup multiple virtual machines in a single bare metal server.
2. Proxmox VE Installer is a hybrid ISO image which can be used in one of the following
ways:
3. On the Linux system, use the dd command to copy the ISO image to the USB flash
drive.
NOTE: Make sure to replace /dev/XYZ with the correct device name and adapt
the input filename (if) path.
13
NMS TJ5500 & EMS TJ5100 Infrastructure Management Guide
4. Connect the USB flash drive to the server and make sure that booting from USB is
enabled.
1. Insert the prepared installation media into the system and boot from it. Proxmox VE
menu is displayed.
2. Select Install Proxmox VE from the menu. A prompt to select target hard disk is
displayed.
Proxmox VE can be installed on ZFS, as it offers several software RAID levels. The
target disks must be selected in the Options dialog. More ZFS specific settings can be
changed under Advanced Options.
14
Installation procedure
5. Click Next. The Location and Time Zone selection page is displayed. Select the
Country, Time Zone and the Keyboard layout from the drop-down.
6. Click Next, the Administration Password and E-mail Address page is displayed.
Provide the root password and the e-mail address.
NOTE:
15
NMS TJ5500 & EMS TJ5100 Infrastructure Management Guide
9. Click Install. The installation starts by formatting the disks and copies packages to
the target. Wait until this step is completed and then remove the installation medium
and restart your system.
10. Open web browser and enter the IP address provided during installation (https://IP:
8006). Proxmox home page is displayed.
16
Installation procedure
NOTE: Place the RHEL ISO Image under the location /var/lib/vz/template/iso.
The image placed in the mentioned location appears in the UI of Create: Virtual
Machine.
1. In the Proxmox home page, click Create VM. The Create: Virtual Machine page is
displayed.
2. In the General tab, select the VM ID from the drop-down, provide Name in the text
box and click Next.
3. Under the OS tab, select the ISO image from the drop down. Click Next.
4. Verify Hard disk, CPU and Memory details under respective tabs. For more
information refer Server requirements on page 8.
5. Select the desired network mode under the Network tab. Click Next.
17
NMS TJ5500 & EMS TJ5100 Infrastructure Management Guide
7. Click Finish, The VM will be created with the ID. To start the VM, right click on the
VM and click Start.
8. To access the VM, double click the VM or right click the VM > Console.
To start with RHEL installation on the created VM, refer to Installing RHEL 8.2 on page
21.
1. Connect the USB flash drive to the system and execute the dmesg | grep us
command to get the details of the USB device.
3. Ensure that device is not mounted by executing the command findmnt /dev/device
name. If the device is mounted, unmount the device.
4. Use dd command to write the installation ISO image directly to the USB device.
5. Wait for completion of data transfer. The data transfer is complete when the #
prompt is displayed.
18
Installation procedure
3. Power off the server device with USB connected to the system.
4. Power on the system and press specific keys to boot from USB or configure system's
Basic Input/Output System (BIOS) to boot from USB. After a short delay, boot screen
appears. The Installation program automatically begins.
NOTE: To create a USB stick which can be used as an installation media, on any
Windows/MAC computer, follow the given link
19
NMS TJ5500 & EMS TJ5100 Infrastructure Management Guide
20
Installing RHEL 8.2
Once the System boots up with RHEL ISO image, RHEL 8.2 Home page is displayed.
Wait for Automatic reboot and perform the following steps to install RHEL 8.2
1. The Language Selection screen is displayed, select the required language to use
during installation.
21
NMS TJ5500 & EMS TJ5100 Infrastructure Management Guide
3. Click Time & Date, the Time & Date window is displayed. Select the desired time,
date and timezone.
5. Click Language Support, the Language Support window is displayed. Select the
additional language to be installed.
22
Installation procedure
7. Click Keyboard Layout, the Keyboard Layout window is displayed. Choose the
keyboard layout.
23
NMS TJ5500 & EMS TJ5100 Infrastructure Management Guide
8. Click Software Selection, the Software Selection window is displayed. Select the
button against the desired option from the below list.
Under Add-Ons for Selected Environment tab, select the required packages. The
minimum required packages are Development Tools, FTP Server, Hardware
Monitoring Utilities, Load Balancer, Large Systems performance,Remote Management
for Linux, and Performance Tools.
24
Installation procedure
11. Click Done, the Manual Partitioning window is displayed. Click "+" to add the
partition manually. For partition details refer Server partitions on page 10. Device
type -lvm and filesystem-xfs, are set by default.
25
NMS TJ5500 & EMS TJ5100 Infrastructure Management Guide
15. Click Network & Host Name, The Network and Host Name window is displayed.
Select the required network card. Click IPv4 Settings tab, assign IPv4 address,
netmask and default gateway.
18. Click Begin Installation at the bottom of installation summary window, the
Configuration window is displayed.
26
Installation procedure
19. Click Root Password, the Root Password page is displayed. Type the password.
27
NMS TJ5500 & EMS TJ5100 Infrastructure Management Guide
26. Click User Creation, type Full Name, Username and Password for non-root user.
28
Installation procedure
28. Click Finish Configuration at the bottom of the page. The Login page is displayed.
29
NMS TJ5500 & EMS TJ5100 Infrastructure Management Guide
1. Login to the server as root user and perform the following tasks:
a. Edit the /etc/hosts file using the command: # vi /etc/hosts. Enter the IP address
configured on the server and the hostname. For format refer to the example
below. Save the file by pressing Esc key and typing :wq!
b. Edit the /etc/hostname file using the command: # vi /etc/hostname. Enter the
host name of server. Save the file by pressing Esc key and typing :wq!
c. Open the etc/sysconfig/network file using the command: # vi
/etc/sysconfig/network. Enter the host name. Format for entering the host name is
shown below; underscore ("_") symbol is not supported. Save the file by pressing
Esc key and typing :wq!
Figure 26: Setting Host Name
1. Make sure IP Address of the server is set appropriately along with mask and routes.
Default route to gateway must exist if applicable.
3. Check the RAM allocation of the server, make sure the same is allocated.
4. Check the disk space allocation, this should be same as allocated during installation.
30
Installing additional packages
To install additional packages, do one of the following:
1. Subscribe to Red Hat using no-cost Red Hat developer account or by procuring valid
license for an organization.
3. Activate Red Hat product using the command subscription-manager attach --auto
31
NMS TJ5500 & EMS TJ5100 Infrastructure Management Guide
Download the rhel dvd iso either through sftp or scp to a local directory in
the server /root/ISO
mkdir /media/localrepo
mount -o loop /root/ISO/<RHELX8u2.iso> /media/localrepo
3. Make sure there are two directories- BaseOS and Appstream in /media/localrepo/ to
hold all the packages.
cd /etc/yum.repos.d/
mv * /tmp
vi /etc/yum.repos.d/local.repo
[base]
name=RHEL8Base
baseurl=file:///media/localrepo/BaseOS
enabled=1
gpgcheck=0
[apps]
name=RHEL8Apps
baseurl=file:///media/localrepo/AppStream
enabled=1
gpgcheck=0
yum repolist
yum install
32
Enabling Network in RHEL 8.2
NOTE: By default, RHEL 8.2 will not enable network interface.
vi /etc/sysconfig/network-scripts/ifcfg-ethX
Change ONBOOT to “yes” from “no”
33
NMS TJ5500 & EMS TJ5100 Infrastructure Management Guide
34
Disabling SE Linux and Firewall in RHEL
8.2
1. Login as a root on RHEL 8.2 and execute the following command: vi
/etc/selinux/config
4. Disable starting firewall service during bootup using the command: systemctl disable
firewalld.service
To allow the incoming connections from 192.168.0.1, use the command # iptables -A
INPUT -s 192.168.0.1 -j ACCEPT
To allow outgoing connection from 192.168.0.1, use the command # iptables -A
OUTPUT -d 192.168.0.1 -j ACCEPT
35
NMS TJ5500 & EMS TJ5100 Infrastructure Management Guide
36
Changing the Time Zone
In order to set the time zone on the server, execute the command: ln -sf
/usr/share/zoneinfo/<time zone/area > /etc/localtime where <time zone/area > is the
time zone and the location where the server is installed. For example, ln -sf
/usr/share/zoneinfo/Asia/Kolkata /etc/localtime
37
NMS TJ5500 & EMS TJ5100 Infrastructure Management Guide
38
Checks on Linux Server
Ensure that the below protocols and softwares are installed.
gcc*
libXfont2
xorg-x11*
cpan
libvirt-client
openssl-devel
httpd
mod_ssl
mod_session
perl-LWP-Protocol-https
perl-devel
perl-Time-HiRes
If the above protocols and softwares are not installed, execute the following commands
for the installation in the command prompt:
To install gcc*
To install libXfont2
To install xorg-x11*
To install cpan
To install libvirt-client
To install openssl-devel
39
NMS TJ5500 & EMS TJ5100 Infrastructure Management Guide
To install httpd
To install mod_ssl
To install mod_session
To install perl-LWP-Protocol-https
To install perl-devel
To install perl-Time-HiRes
40
Apply IP tables
This procedure enables iptables in the RHEL server where TJ5100/TJ5500 services are
running. This will apply iptables DROP INPUT rules allowing access to few IP addresses or
a range of IP addresses and restricts MySQL access to localhost and TJ5100/TJ5500
servers only. This procedure is based on IP address only, irrespective of the ports or the
protocol.
Before applying iptables rules in TJ5100, TJ5500 and TJ5500 DB server, TJ5100/TJ5500
client access, SSH to the servers and MySQL connection from any other system would be
allowed. After applying iptables rules, only whitelisted Client IP addresses will be able to
access the servers. MySQL access through port 3306 will be restricted to localhost,
TJ5100/TJ5500 servers and its Hotstandby servers.
Procedure
NOTE: Do not copy and paste the commands mentioned in this procedure.
2. Stop and disable firewall service on the server by executing the commands:
41
NMS TJ5500 & EMS TJ5100 Infrastructure Management Guide
Command Description
iptables -P INPUT ACCEPT ; iptables -F Flushes out the existing iptables rule.
iptables -P FORWARD DROP Drops the forward packets. This command is
applicable for a router.
iptables -P OUTPUT ACCEPT Accepts/allows all outgoing packets.
iptables -A INPUT -m state --state Drops all invalid connections established to the
INVALID -j DROP RHEL server.
iptables -A INPUT -i lo -j ACCEPT Allows full access to localhost communication.
iptables -A INPUT -s <Server IPs> -j Here <Server IPs> indicates IP address of
ACCEPT TJ5100/TJ5500 Master, Slave servers and the
Virtual IP address. Only these IP address can
access the RHEL server.
iptables -A INPUT -s <Server IP> -j Here <Server IP> indicates IP address of the
ACCEPT server itself i.e. TJ5500 Database server in case of
Clustering mode. Only these IP address can access
the RHEL server.
iptables -A INPUT ! -s <Server IPs> -p Here <Server IPs> indicates IP address of
tcp --dport 3306 -j DROP TJ5100/TJ5500 Master, Slave servers and the
Virtual IP address.
Except these IPs entered here, all other IP address
trying to access MySQL through TCP port 3306 will
get dropped.
iptables -A INPUT ! -s <Server IP> -p Here <Server IP> indicates IP address of TJ5500
tcp --dport 3306 -j DROP Database servers in case of Clustering mode.
Except these IPs entered here, all other IP address
trying to access MySQL through TCP port 3306 will
get dropped.
iptables -A INPUT -s Here <IPAddress> indicates Client IP address with
<IPAddress/mask> -j ACCEPT subnet mask defining the range of IP addresses to
access the RHEL server.
iptables -A INPUT -s <IPAddress> -j Here <IPAddress> indicates Client IP address to
ACCEPT access the RHEL server.
iptables -P INPUT DROP Drops everything except the above rules.
42
Apply IP tables
Guidelines
Wrong application of iptables rules may block Hot StandBy replication or TJ5100
communication to TJ5500/nodes and server access from client PC.
Iptables is based on access/deny IPlist and restrict MySQL access to only
TJ5100/TJ5500 servers.
Command to check the applied iptables rules is: iptables -L INPUT -v -n --line-
number.
After applying iptables rules:
There will be no response for ping from clients to TJ5100 or TJ5500 or
TJ5500 DB servers except whitelisted client IPs added in iptables rules.
No client will be able to access TJ5100 or TJ5500 except those IPs added in
iptables rules.
TJ5500 MYSQL Database via port 3306 will get restricted to TJ5500 servers
only.
MySQL restriction is not necessary in TJ5500 Application server.
To append one or more rule in iptables in order to allow access to TJ5100/TJ5500
server:
iptables -A INPUT -s <IPAddress> -j ACCEPT
iptables -A INPUT -s <IPAddress/mask> -j ACCEPT
To remove iptables rules, execute the command:
iptables -P INPUT ACCEPT
iptables -P OUTPUT ACCEPT
iptables -F
Save iptables rules by executing the command: /sbin/iptables-save >
/etc/sysconfig/iptables
43
NMS TJ5500 & EMS TJ5100 Infrastructure Management Guide
44
Installing EMS/NMS/RAS
To install EMS/NMS/RAS refer to NMS TJ5500 Installation and Commissioning Guide.
45
NMS TJ5500 & EMS TJ5100 Infrastructure Management Guide
46
Cloning
Cloning is performed when there are multiple EMS to be configured in a single virtual
environment that are similar in terms of hardware requirement.
Clone the VM
3. Select target node, VM ID and VM name from the dialog box, click on clone.
Perform the following steps on the On Linux guest OSes to change the host name:
2. change the /etc/hostname file content to the new hostname (eg: "#nano
/etc/hostname")
When an existing VM is duplicated, the mac address also gets duplicated. If VM has only
one virtual NIC, perform the following steps:
2. Remove the virtual nic (eg: eth0) from pve web interface.
3. Create a new virtual nic, this obtains a new MAC and VM always refers to this as eth0.
47
NMS TJ5500 & EMS TJ5100 Infrastructure Management Guide
NOTE: Since it is a 1:1 disk to disk cloning, the Hard disk space cannot be
changed post cloning, but the RAM/CPU parameters can be modified.
Install RHEL 8.2 in Virtual Machine using RHEL 8.2 iso image.
Install the required packages.
Refer to the Prerequisite for Installing RHEL 8.2 and Installation procedure sections for
installing RHEL 8.2 server.
NOTE 1: Make sure that no EMS, NMS or RAS servers and MySQL are installed
in the virtual machine which is being used for OS cloning.
2. Once you have installed VMware vCenter Converter Standalone, run the converter.
The converter should be launched in a new window.
3. Click Convert machine menu. The conversion wizard is launched. On the Source
System screen, select one of the following:
48
Cloning
5. Select the source VMware Infrastructure virtual machine to which we have to clone.
After selecting your source VM, click Next.
49
NMS TJ5500 & EMS TJ5100 Infrastructure Management Guide
6. Set the host for the new virtual machine by selecting your destination system as
VMware Infrastructure virtual machine from the drop-down menu and, specify
the VMware Infrastructure server details by entering the IP address of destination
VMware Infrastructure virtual machine, then input the User name and Password of
an account with administrative permissions. Click Next to proceed.
50
Cloning
8. Set the parameters for the destination virtual machine by entering the Name and
selecting the location of the destination VM. Then click Next to continue.
51
NMS TJ5500 & EMS TJ5100 Infrastructure Management Guide
9. Select the location on which the new VM should run. Select the datastore attached to
that server and specify the virtual machine version. Click Next.
52
Cloning
10. Set the parameters for the conversion task. Click on the edit link displayed against
each of the parameters with the required values given in the following:
53
NMS TJ5500 & EMS TJ5100 Infrastructure Management Guide
11. Check the summary. If you are satisfied that all the settings are correct, click Finish
to start conversion.
54
Cloning
12. You can now see the status of your conversion job in the main windows of VMware
vCenter Converter. Similarly, you can add more conversion jobs.
55
NMS TJ5500 & EMS TJ5100 Infrastructure Management Guide
Post-cloning procedure
1. Start the cloned VM; let the source VM in powered off mode to avoid duplicate
IP/MAC issues in the network.
2. Change IP address, MAC address, Device name, Gateway, DNS parameters in the
cloned VM by performing the following steps:
56
Cloning
NOTE:
• Make sure that IP and MAC address should not be same across the OS and
VMs.
• The given cloning steps are applicable to only VMWare’s ESXI based
virtualization
57