Changes between Version 22 and Version 23 of Nmm2022/Agenda/oxidize

Timestamp:

Jul 15, 2022, 7:03:00 AM (2 years ago)

Author:

dushmantha

Comment:

--

Nmm2022/Agenda/oxidize

@@ -2 +2 @@
 == '''Network Device Configuration Management - Oxidized ''' ==
 
-In this lab, you will install and configure Oxidized and integrate it with LibreNMS.''' When you are changing users, always start from root.''' When you are coping the commands, copy and execute line by line. Otherwise, you may get errors and worst case have to start from the beginning.
+In this lab, you will install and configure Oxidized and integrate it with LibreNMS.''' When you are changing users, always start from root.''' You may use '''exit''' to logout current user. When you are coping the commands, copy and execute line by line. Otherwise, you may get errors and worst case have to start from the beginning.
 
 '''Requirements:'''
@@ -140 +140 @@
 }}}
 
+Create oxidized-report-git-commits file.
+
+{{{
+nano .config/oxidized/oxidized-report-git-commits
+}}}
+
+Copy the following content to the file and save it.
+
+{{{
+#!/bin/sh
+trap '/bin/rm -f "$tmpfile"' EXIT
+
+tmpfile=$(mktemp) || exit 1
+
+subject="Oxidized updates for ${OX_NODE_NAME}"
+scriptname=`basename $0`
+
+usage()
+{
+    echo "Usage: ${scriptname} [-f] [ -s email_subject ] [ -r email_recipient ]"
+    exit 1
+}
+
+email_on_gitfail=1
+while getopts "fs:r:" opt; do
+    case $opt in
+        s)
+            subject=$OPTARG
+            ;;
+        r)
+            recipient=$OPTARG
+            ;;
+        f)
+            email_on_gitfail=0
+            ;;
+        *)
+            usage
+            ;;
+    esac
+done
+
+
+if [ "${OX_EVENT}" = "node_fail" ]; then
+    echo "${scriptname}: ${OX_NODE_NAME}": 'Job failed'
+    exit 64
+fi
+
+if [ -z "${OX_REPO_COMMITREF}" ]; then
+        echo "${scriptname}: "'$OX_REPO_COMMITREF not set'
+        exit 64
+fi
+
+if [ -z "${OX_REPO_NAME}" ]; then
+        echo "${scriptname}: "'$OX_REPO_NAME not set'
+        exit 64
+fi
+
+cat > ${tmpfile} <<EOF
+Node name: ${OX_NODE_NAME}
+Group name: ${OX_NODE_GROUP}
+Job status: ${OX_JOB_STATUS}
+Job time: ${OX_JOB_TIME}
+Git repo: ${OX_REPO_NAME}
+Git commit ID: ${OX_REPO_COMMITREF}
+
+EOF
+
+# test if commit exists
+git --bare --git-dir="${OX_REPO_NAME}" rev-parse --quiet --verify "${OX_REPO_COMMITREF}" > /dev/null 2>&1
+gitret=$?
+
+if [ ${gitret} -eq 0 ]; then
+    git --bare --git-dir="${OX_REPO_NAME}" show --pretty='' --no-color "${OX_REPO_COMMITREF}" >> ${tmpfile} 2>&1
+else
+    echo "${scriptname}: commit ${OX_REPO_COMMITREF} does not exist" >> ${tmpfile}
+fi
+
+if [ ! -z "${recipient}" -a \( ${gitret} -eq 0 -o ${email_on_gitfail} -eq 1 \) ]; then
+    cat ${tmpfile} | mail -s "${subject}" "${recipient}"
+else
+    cat ${tmpfile}
+fi
+}}}
+
+Give execution privileges. 
+
+{{{
+chmod +x .config/oxidized/oxidized-report-git-commits
+}}}
+
 '''Setup Oxidized Service'''
 
@@ -179 +269 @@
 You can view ''Show version'' and ''Show diff'' buttons '''if there are configuration changes/ changing history, after Oxidized has connected with the devices.''' Try to get that screen by changing a configuration and '''saving''' that of a connected device. All device passwords are ''123''. You may refer this [https://ws.learn.ac.lk/wiki/Cnbp2022/Agenda/NetworkSetup]
 
+The default output will be ''Show version''.
+
+[[Image(history.png, 1200px)]][[BR]]
+
 Click '''Show diff'''. Below '''Hide line numbers''' a minus (-) mark in front of the command says that particular command is reverted ('''red'''). And a plus (+) mark in front of the command says the reverted command is replaced by it ('''green''').
 
-[[Image(history.png, 1200px)]][[BR]]
+[[Image(diff.png, 1300px)]][[BR]]
 
 '''Postfix Installation'''