OpenNMS 101 - Module 1a: Installation via RPM (RHEL/CentOS) Video Lecture | A Complete Guide: OpenNMS - IT & Software

hello and welcome back to open NMS 101
my name is tarick a log and I am one of
the main tailors of the epididymis
project we've put together this series
of videos to provide an online training
course to get you up to speed on the
wonderfulness it is open a mess
I assume ah now you've watched the first
video in the series which is the
introduction open MS and so let's get
down to installing it now open MS can be
installed on rpm based distro such as
Red Hat Enterprise Linux as well as
Debian based discos such as you're good
to they're slightly different
so in this installation we're going to
cover the RPM version will have another
installation video on the Debian Ubuntu
version now there are two versions open
MS Meridian vs. horizon um both of them
required job currently I believe we
require a Java 8 if you're running a lot
of devices on the developers will
probably tell you to use Oracle's JDK
for most of my installs I'm fine with
open JDK but again if you're into some
performance issues one of the main
things you may want to check is your
Oracle version we're going to install
the Oracle JDK version in this exercise
both have some sort of some small amount
of C code now back in the late 90s and
one that started job I didn't have an
API for repeating they didn't have an
ICMP API I don't know about you guys but
the first thing I do in trying to
diagnose a network problem is I try to
tame the device so we wrote a piece of
code that will actually do our pings for
us it's called J ICMP also to integrate
with the Rd tool for graphing we use jRD
I want to do this install horizon this
is freely available downloads for app 2
nor p.m. or really use the RPM distro if
you choose our Red Hat Enterprise Linux
version which features lags horizon but
meridian actually
is a little more stable and we're tested
a little easier to support it's very
similar except with Veridian the
repositories password-protected now if
you go to young open em a story profiles
and I'm just going to do that so if I go
here you will see there's a ton of these
rpm um one of the cool things we do with
open in ms is the customer open source
and the mantra is released early and
really reads often we actually build
rpms for pretty much every branch in our
gate repository we have a bleeding-edge
repo which is the route of the branch
for every various branch that has a name
like here's one horizon 151 so if I were
to go into issues open MS or which is
our JIRA instance and look up horizon
151 that would tell me what this branch
is for here's all the different issues
that go through and there's a ton of
them like I said if you find out one of
our developers is working on a cold
feature just go and dig the feature
branch there was one here for cop kind
minion we're doing a rap integration of
top configuration here's the minion cop
game it's there you can go you can
follow right along it's great but as
most of you have some are pretty new to
open and that's what you want to look
for is to be scan only down to the
bottom here you will see the stable
release so going a lot of branches
now what you need to look for is you
want the RPM that corresponds to your
operating system because there is a
little piece of C code and they're
slightly different depending on what
version you're using now I've installed
a virtual machine with Red Hat
Enterprise well CentOS 7 which is
equivalent to red Enterprise Linux 7 so
I'm going to choose this open NMS repos
stable right here and I'll right mouse
click and I will copy that link now all
I need to do here is to go over to my
at save session and then just RPM - vvh
and add that repo so you can see it's
now installed the repo now all it did is
install one file into the Omri fuzzy
directory I'll just go look at that so
at C um you puts B actually there it is
we code Z and if you look there is a
file now called open image repo stable
and if I look at that it's going to be
it'll tell you all of the stuff where to
find the variety of and where to find
the open in the software and so now all
I need to do is type yum install what
I'm s
couldn't be easier now I'll probably end
up having to cut a little bit of this
out but we're going to take a little
while to download even on our fairly
fast connection system I've installed
the minimal CentOS of distribution here
I strongly recommend running open in a
map of its own server and I strongly
recommend using the minimal install it
just makes basic sense no software is
bug free the more software you have on
your system the greater chance for bugs
so you might as well minimize the amount
of software you install so as you can
see here we're installing the open MS
package this is a wrapper package it's
really tiny
it's only like 6 K but we need Java
because we're a job application so
here's going to install the Java 8 JT k
ji c and p + j s 56 are the pieces of c
code that we use for doing pings jsep
and fixes for IP version 6 and JP is for
IP version 4 obon ms core is the core
package with all the applications in it
when that jetty is our web app
application and you see that they're
quite large we use terms in terms of
various which get imported so you can
see this whole things with me about half
a gig but more than half a gig and we
need a back-end database so with
installed Postgres PostgreSQL lives and
prescription server and so I'm going to
fit incidences okay
and it's going to go ahead and start
downloading this this is going to take a
few seconds so I'm going to stop
recording for a bit and then we'll go
and come back to this when it's done
okay now we've got everything downloaded
I didn't take too long um you will see
that it's offering to install a key I
would go ahead and say yes and then
there's the Center 70 this is the first
time I've ever done anything on the
system also yes again and as you can see
it's now going to go ahead and install
the various rpm so we'll get Postgres
installed we'll get Jessie and P
installed and we'll get the JDK
installed now um we're not quite ready
once we do this we have a few other
things to do I find it pretty simple
install open an MS but it can be a
little bit difficult so we actually do
have an installation guide some of the
documentation an open an MS is a little
hard to find so I wanted to kind of show
you that if I go to doxepin an MS org
you'll see here's the various open
limits projects as we are making
documentation alongside every release so
since the last release of horizon is 18
and 3 I could click on 1803 here but
documentation is constantly being
updated so I can always look at the
development version so I'm going to
click on this 20 dollar snapshot an
agency we've got release notes admin
developers installation users and a few
other things I'm going to click on the
HTML guide here for the installation
guide and this will actually bring up a
pretty detailed set of documents for
install so if what I'm giving you here
isn't good enough feel free to go and
check
the database check the documentation now
once everything is installed before we
can do anything we have to initialize
the database and use this with this
PostgreSQL - setup command and so if I
go back here I can type PostgreSQL - set
up to do this room
[Music]
Griss ql setup in it DB now what this is
going to do is it's going to create the
initial database directory and that
happens to live in VAR Lib PG SQL so
there's your data directory now if you
ever need to get rid of the database you
can stop up at MS and delete this data
directory and you'll be back at square
one and so now what we're going to end
up doing is I'm going to sing to the
data directory now there's number of
files in here and the two files we deal
with a lot or PostgreSQL comp and PG
underscore HB a.com PostgreSQL comp is a
bunch of Postgres settings for the
purposes of this installation I'm not
going to mess with it I have a slide
that I'll show you in a second that
talks about where you can go for more
information on customizing Postgres open
MS doesn't need PostgreSQL on the same
server you can run on a different server
and if you do that it's it can it can
give you some good performance benefits
quite frequently the Postgres
transaction logs and open an MS RD files
compete for disk
spindle bandwidth the disk just is too
busy writing so if you move PostgreSQL
to a different server it can help but
one thing we have to do right now well
it's just easiest to do is to edit this
PG underscore HB a.com file this stands
for host based authentication and it's
how um it's how Postgres determines who
can connect now I'm going to go to the
very bottom here and you will see this
line here it says local all peer ho
all one 27.0 once I started to I bet and
host all all : : one plus 128 I been
that is for there three lines this one
here the local all is for socket
connections when you're logged into the
system ipv4 connections are limited to
localhost and ipv6 connections are also
limited to local is that : coal is one /
128 is an ipv6 localhost address I want
to change all of these I'm going to
change all three of these to be trust
now um you can do this and you can come
set it back and acquire passwords I know
a lot of systems a lot of if you get
audited for security they don't like
having trust now granted this only
limits people who have shell access to
the open event server with a post press
server and we assume that that's limited
but this just makes the install a lot
easier once open and a message installed
the database it does use a password you
can set that and you can go change it in
here as well if you were to connect if
you were to install Postgres only
different box what you would need to do
here is set up a connection probably
ipv4 that allows the open and immense
server to connect so you would put in
here the IP address slash 32 to limit it
to just that IP address to connect here
and I will use a method of password to
make sure that it is a password
connected of protected connection so
I've set all these things to trust which
means that it won't prompt me for a
password if I'm on the shell using a
socket connection it will trust me for
password if I connect to be a local host
IP v4 or local host ipv6 so let me save
that now once I do this I am ready to
start PostgreSQL so I can use system
control start let's go this ql
I think that'll work and I hope it's fun
PSVs type grab post and we'll see that
the postmaster is running excellent so
now we have post grasses set up now
something else you may want to do is
enable poke stress if we were to restart
if we would restart this system we had
to reboot it
Postgres would not start automatically
and it is required for opening the mess
so I'm going to add that line too so I
was in system control enable post URL so
now it will be turned on it every time
we reboot this post press will start on
that but if you don't want that don't do
this and if you ever want to turn it off
you can disable but it's always good to
turn that on
now I mentioned there is a wiki entry on
tuning PostgreSQL and what a little
label you to do is depending it on how
much memory and the kind of systems you
have post critical running on you can
increase certain parameters to to make
it perform better for the exercises in
this class for the openness 101 class
you won't maybe do that and so I'm going
to leave that as an exercise to the
keyword okay now there's two things we
have to do before we start using open a
mess the first thing is we have to tell
it what Java use now I'm going to clear
this out and go to the op open in the
mystery almost everything in open MS is
in the OP of it in the directory and if
you do a list here you'll see there's a
bin directory which is where binaries
are stored if a contribution directory
we have a data directory which is used
for crafts as a deployment XE we're
going to spend forever in the empty
directory that's our configuration
directory the web server lives in JT Web
Apps live is where all the jar files the
libraries that make up open in the nest
live logs is assembly to borrow log of a
mess and share
there is a symlink tomorrow the new mess
logs pretty self-explanatory share is
where on your Rd data is stored and this
is assistant directory as well that you
don't use very much in this case we're
going to go into the bin directory
and what we want to do is run a command
called run Java - s this says go look
for a valid version of Java and set and
so basically it's stored it found out
the default Java user bin Java is 5 it
meets all the criteria we need so it has
stored user bin Java in the Java comp
file in exit so now we've installed open
in a match with installed Postgres we've
opened up Postgres to be able to modify
it the next step is to create the
database and also in this bin directory
there is an install command and I'm
going to add three flags D is to be
perfectly honest I'm not sure what they
do I can look them up if our own install
without this but it modifies the
database and looks for IP like and runs
a bunch of database command this will
take a second small talk over it so
basically what it's doing is it's going
through and bringing up terms and tons
and tons of information here it's
setting up the database it's making
changes etc you can even downgrade
easiness we use something called likkle
base to do all of the stuff and it's
it's very very powerful so now we have
the database installed now I'm going to
go back up to my history I want to go to
the very top of this and show you a
couple of things if we go to the top
you'll see here it's checking for Libby
Rd so the first thing I checked for is
Liz JIT MP we have to have logician T in
order to DP Linda jRD is optional Lib
jRD allows us to use our D tool instead
of the built-in J Robert J Robin is a
Java port of our detour
and there was a time where J Robert was
a performed better than our D towards it
was written in Java it was
multi-threaded etc Sascha Markovic the
guy who invented Jai Robin ended up
leaving the project he donated to Robin
to us we were the major users of Jai
Radha and we quite frankly have not
maintained it
I mean we've made changes that make it
work better with opening the mask but
Toby oetiker who maintains our D told
has done a lot of amazing stuff so at
this point in time it's actually better
to to use our detour so what we are
going to do now is I want to install JRR
D rooted in such a RR d 2j r d2 is a
multi-threaded version of our our D
library so it works really really well
so if I do a yum install of jRD to it'll
go in and note that it requires our
detailed by naturally and our detail
requires a bunch of these other
libraries so there is our D tool right
there so we're going to go ahead and
install these packages so this will
install our detail um with we've said
Java we've opened up the database we've
set Java and we've installed we've
installed the open in this database now
we're going to install our D tool
there's one other step we have to do in
order to turn our D tool on and that is
we have to go into the Rd tool
configuration file and set it to use our
de tool versus J Robin now I had
mentioned before that in open an MS in
the opt open in the math directory there
would be subdirectories been contributed
deploy etc we spend a lot of time in etc
and as you can see there's tons of files
in here we're going to touch on almost
every one of them but right now I want
to edit this Rd configuration properties
so let me show you that
kind of fast so our our D dash
configuration dot properties it is opt
over to the met C and if you notice
right here at the top is it says to
switch to the j'ni implementation
uncomment the following lines this is
what we want to do so these three lines
here open it a mess strategy class open
a visitor face jar this will switch it
these three lines will switch open and
msqrd tool so you want to use our veto
because it's it forms better but you
have to make this decision now while J
Robin is fine and with many cases it
works fine J Robin files are not binary
compatible with our detail files so you
can't switch them and so what we really
end up doing is if you start collecting
data under J Robin and they decide to
later
you want to use our D tool you have to
bait you it's possible to export and
import your data but it's difficult so I
strongly recommend that you use our D
tool and you start with our new tools so
we're going to save that right there now
there's one other thing I want to
install IP like so I feel like is a tool
we wrote to enable you to do to manage
IP addresses IP addresses are weird I
mean it's a series of numbers that goes
from 0 to 254 and there's four groupings
of them for rock cats and I might want
to say hey show me everything on the
10.10 dot 1 network well with I feel
like I can say show me where the IP
address is IP like 10.10 dot 1 that star
now there is a version of IP like I
don't scrolled off Maya my screen we
have written a version of I feel like
using Postgres using PostgreSQL own
scripting language it works it's fine
it's just not as efficient and we assume
you're looking at open to the mess
because you're looking for scalability
so let's install I feel like now we
can't install IP life
until the database is installed and
that's why it's not installed by default
otherwise people forget to install it
etc so now that we've run the install
that bis command we're actually in a
position to install IP like Saudi yum
install IT like yes so it'll go ahead
and install and it will install it into
the open MS database now you can install
the elephant as being as being there but
then you have to run a command to
manually add it to the database now I'm
going to run I'm going to go back into
the bin directory here and I'm going to
run the installer a second time one of
the nifty things about opening that is
you run the installer as many times as
you want and it won't cause any problems
but what I want to show you is this fit
right here this is a piece I was
searching for in my previous setup
checking to see if I feel like is usable
yes so this lets me know that I have
successfully installed IP like and if I
go up here you will see that I have
successfully installed jRD too so
learning is all based upon repetition so
let's repeat what we did the first thing
we did was we installed a repository
that allowed us to find open at MSU VM
then we did a yum install open to the
mass which installed all the necessary
dependencies I'm old enough to remember
when dependency hell was a real thing
but BAM I got everything we needed to
install up into the mess then we use run
Java - s to set the Java version we ran
install that vis aa backup we then went
and created the Postgres database so
once we had Postgres installed we
initialize the database opened up the
PGH be a comm file to trust were closed
connection then we ran run Java - s to
set the Java version and then install
dot B is - to install the database then
we installed jrv - we edited rd2 rd -
configuration dot properties to enable
open ms to use already tool and then we
installed IP like and we bear
find that all that was working so now
it's time to start open a mess so we'll
use the system control thing as well
again I recommend using enable if you
want to automatically start open MSM a
reboot if you're still playing with this
or you're diagnosing problems you may
not want to do that
but what I'm going to do is go here and
our games system control enable open the
mess and then system control start
opening it and assuming we did
everything well of anime should start
now
I'm not sure which sets off seven I
believe I will not be able to connect to
the server so I'm going to go over to my
server here now if you're running this
on a system with a graphical user
interface you can just connect to
localhost but I'm not I'm running this
in the VM with no graphical funding
whatsoever as it said I like to do a
minimal install so if I check I can use
IP - adder to show my IP address and as
you can see it's 172 21.1 24 so what I'm
going to do is I'm going to go back to
my web server here and I'm going to try
to go to 172 21.1 24 4 89 80 because
that's the port that open NS runs on and
as you can see it says unable to connect
and the reason is the sentox firewall
blocks connections so going back to our
slides you can see we have this firewall
commands or public ed port and make it
permanent so let me try to memorize that
little thing and cut paste so the
firewall rule command did you do what
was the next thing
some public - - zone equals public - -
port equals 89 80 / tcp and - -
permanent trust filled of it I'm a Cuddy
pasty cunning honest or if I had to
Sandy at father's do that add port sorry
to and support success it worked and
then we need to reload it so far wall
command reload and now if you get
everything right you should be able to
access be open to the best web user
interface there we go make that a little
bigger circle and see so now we were on
open NMS the username is admin and the
password is admin it's quite tricky and
I can log in and I can say hey there is
open an MS now the first time you log in
it's going to ask you whether or not you
want to opt in to sending data token a
mess we have a website called spat not
opening the mess under work which
reports all of the information that we
get from the various installs so right
now we've just introduced this we have
eleven hundred and sixty seven people in
the last seven days have installed open
an MS and basically what this helps us
do is a we don't know who used open it
and we'd like to know so we'd like to
know what versions they're running as
you can see here the different versions
that we have running and we have the
operating systems that they're running
on so we have that there and we also
have the ability to get what devices
you're using so if I go back to the web
console if I say show what's being sent
right now we have nothing but it will
show us the total number of alarms total
number of events how many interfaces
monitor services etc you can see exactly
um what we're asking for this connects
via
this connects me an SL connection to
stats synthesis information so I'm going
to hit fit opt-in for here now if you
ever want to change that you can go to
this admin menu configure open in a mess
and go to the very bottom and you'll see
it says data choices and if I collect on
that that will bring you back to that
screen so I'm going to leave it there so
go find go ahead install open an MS and
go find the next video which will talk
to you about navigating the web UI and
things like that and I hope you found
this useful see you next time