Skip to content

Commit a950f23

Browse files
committed
commit
1 parent a13f71c commit a950f23

File tree

1 file changed

+3
-5
lines changed

1 file changed

+3
-5
lines changed

_tutorials/2018-06-04-telemetry-collection-stack-detailed-overview.md

+3-5
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ published: true
33
date: '2018-06-04 16:13 -0700'
44
title: Telemetry Collection Stack Detailed Overview
55
author: Viktor Osipchuk
6-
position: hidden
6+
position: top
77
excerpt: >-
88
Detailed explanation of the script that installs and configures the IOS XR
99
Model Driven Telemetry Stack
@@ -20,7 +20,7 @@ tags:
2020
{% include toc icon="table" title="IOS XR Telemetry Collection Stack Detailed Overview" %}
2121
{% include base_path %}
2222

23-
In our [previous tutorial](URL) we provided a high-level overview of the IOS XR Telemetry Collection Stack. The goal of the stack is to help engineers to quickly start testing telemetry and not to waste time to research on how to integrate an application A with application B and application C.
23+
In our [previous tutorial](https://xrdocs.github.io/telemetry/tutorials/2018-06-04-ios-xr-telemetry-collection-stack-intro/) we provided a high-level overview of the IOS XR Telemetry Collection Stack. The goal of the stack is to help engineers to quickly start testing telemetry and not to waste time to research on how to integrate an application A with application B and application C.
2424

2525
While working on this script, attention was given to the fact that people with a very different level of Linux/programming knowledge will use that script. That's why description was added for almost every step there. It might seem not very elegant, but I think it is essential for every person to understand how it works and what will run on his/her server. Also, the decision was to use a single language, with no overcomplication, and not to jump between different tools, as this, again, could bring unnecessary confusion for people who want to understand how it works (obviously, this task could be done in many different ways)
2626

@@ -627,7 +627,6 @@ The purpose of the code is to modify ["~/.bashrc"](https://www.lifewire.com/bash
627627
The code itself is pretty compact and refers to the ["wrappers.txt"](https://github.com/vosipchu/XR_TCS/blob/master/wrappers.txt) file.
628628

629629
```
630-
#!/bin/bash
631630
################################################################################
632631
######### Telemetry Collection CLI Aliases ##########
633632
################################################################################
@@ -656,7 +655,7 @@ fi
656655
</pre>
657656
</div>
658657

659-
As was described in our [previous post](LINK TO ALIASES), you can start (and stop) running Pipeline in "troubleshooting mode", where all the Telemetry messages are dumped into the "dump.txt" file.
658+
As was described in our [previous post](https://xrdocs.github.io/telemetry/tutorials/2018-06-04-ios-xr-telemetry-collection-stack-intro/#alias-commands-to-manage-the-collection-stack), you can start (and stop) running Pipeline in "troubleshooting mode", where all the Telemetry messages are dumped into the "dump.txt" file.
660659
In order to do that, a special function is added into the "~/.bashrc" file.
661660
When you plan to start using Pipeline in troubleshooting mode, the code will look for an active instance of Pipeline and kill it (together with an active instance of "screen"). Then it will use "SED" to modify the content of the "pipeline.conf" file, by activating dumping to a file. Finally, it starts a Pipeline. It is expected, that you will go and [start checking the "dump.txt" file contents](https://www.howtoforge.com/linux-tail-command/) in real time to see the messages, that's why the code will also remove the previous version of the "dump.txt" file. This way you will see the actual information you're looking for, not the data from previous troubleshooting sessions.
662661
At some moment you won't need to run this mode anymore, and you will stop it. The code will find the active running instance of Pipeline, kill it, update the configuration of the "pipeline.conf" file back and start a new instance of Pipeline in a screen.
@@ -891,7 +890,6 @@ If you decided to remove your Collection Stack from the server, you might want t
891890
It will remove all the added lines from ".bashrc" and you will not see anything next time you log in!
892891

893892
```
894-
#!/bin/bash
895893
#######################################################
896894
######## This removes aliases from your server #######
897895
#######################################################

0 commit comments

Comments
 (0)