{"id":1204,"date":"2015-03-26T21:26:57","date_gmt":"2015-03-26T21:26:57","guid":{"rendered":"http:\/\/amlight.net\/?page_id=1204"},"modified":"2023-01-20T15:31:04","modified_gmt":"2023-01-20T20:31:04","slug":"operation","status":"publish","type":"page","link":"https:\/\/www.amlight.net\/?page_id=1204","title":{"rendered":"Operation"},"content":{"rendered":"<div class=\"fusion-fullwidth fullwidth-box fusion-builder-row-1 hundred-percent-fullwidth non-hundred-percent-height-scrolling\" style=\"--awb-border-radius-top-left:0px;--awb-border-radius-top-right:0px;--awb-border-radius-bottom-right:0px;--awb-border-radius-bottom-left:0px;--awb-overflow:visible;--awb-flex-wrap:wrap;\" ><div class=\"fusion-builder-row fusion-row\"><div class=\"fusion-layout-column fusion_builder_column fusion-builder-column-0 fusion_builder_column_1_1 1_1 fusion-one-full fusion-column-first fusion-column-last fusion-column-no-min-height\" style=\"--awb-bg-size:cover;--awb-margin-bottom:0px;\"><div class=\"fusion-column-wrapper fusion-flex-column-wrapper-legacy\"><div class=\"accordian fusion-accordian\" style=\"--awb-border-size:1px;--awb-icon-size:13px;--awb-content-font-size:13px;--awb-icon-alignment:left;--awb-hover-color:#f9f9f9;--awb-border-color:#cccccc;--awb-background-color:#ffffff;--awb-divider-color:#e0dede;--awb-divider-hover-color:#e0dede;--awb-icon-color:#ffffff;--awb-title-color:#0097d8;--awb-content-color:#141414;--awb-icon-box-color:#333333;--awb-toggle-hover-accent-color:#1a80b6;--awb-title-font-family:&quot;Roboto&quot;;--awb-title-font-weight:400;--awb-title-font-style:normal;--awb-title-font-size:16px;--awb-content-font-family:&quot;Roboto&quot;;--awb-content-font-style:normal;--awb-content-font-weight:400;\"><div class=\"panel-group fusion-toggle-icon-boxed\" id=\"accordion-1204-1\"><\/div><\/div>\n<h3>SDN Operation and integration<\/h3>\n<p>On this page, you can find useful codes and procedures created by AmLight engineers aiming to help the SDN operation and integration.<div class=\"fusion-panel panel-default panel-89d52d42476da98da fusion-toggle-has-divider\"><div class=\"panel-heading\"><h4 class=\"panel-title toggle\" id=\"toggle_89d52d42476da98da\"><a class=\"active\" aria-expanded=\"true\" aria-controls=\"89d52d42476da98da\" role=\"button\" data-toggle=\"collapse\" data-parent=\"#accordion-1204-2\" data-target=\"#89d52d42476da98da\" href=\"#89d52d42476da98da\"><span class=\"fusion-toggle-icon-wrapper\" aria-hidden=\"true\"><i class=\"fa-fusion-box active-icon awb-icon-minus\" aria-hidden=\"true\"><\/i><i class=\"fa-fusion-box inactive-icon awb-icon-plus\" aria-hidden=\"true\"><\/i><\/span><span class=\"fusion-toggle-heading\">OESS backend for OpenNSA<\/span><\/a><\/h4><\/div><div id=\"89d52d42476da98da\" class=\"panel-collapse collapse in\" aria-labelledby=\"toggle_89d52d42476da98da\"><div class=\"panel-body toggle-content fusion-clearfix\">\n<p>UNDER CONSTRUCTION: Open NSA + OESS Integration<\/p>\n<p>AmLight links are used to interconnect AMPATH and SouthernLight Academic Exchange Points\/GLIF GOLES. Both AMPATH and SouthernLight support NSI. Nonetheless, with the SDN deployment at AmLight in 2014 the NSI Agent installed on both sites &#8211; OpenNSA &#8211; had its backend replaced. As there was no solution for NSI+OESS at that time, an OESS backend have been developed to work with OpenNSA.This documentation assumes that you already have OpenNSA installed in your environment, with all topologies and CA certificates in place. If you don&#8217;t, please click here.To integrate your OESS installation with your OpenNSA installation follow the steps below:<\/p>\n<p>UNDER CONSTRUCTION:<\/p>\n<ol>\n<li>Download the <a href=\"http:\/\/www.sdn.amlight.net\/pub\/SDN\/OessOpennsa\/oess.py.txt\">oess.py<\/a> backend and place it on OPENNSA_FOLDER\/opennsa\/backends\/<\/li>\n<li>Apply the patch <a href=\"http:\/\/www.sdn.amlight.net\/bin\/view\/SDN\/OpennsaPatch\">opennsa_oess_patch.patch<\/a> to create the backend on OpenNSA structure<\/li>\n<li>Follow the <a href=\"http:\/\/www.sdn.amlight.net\/bin\/view\/SDN\/OessGuide\">OESS configuration guide<\/a> and follow all the steps to create the configuration<\/li>\n<\/ol>\n<p>Useful links:<\/p>\n<ul>\n<li>OpenNSA &#8211; <a href=\"https:\/\/github.com\/NORDUnet\/opennsa\">https:\/\/github.com\/NORDUnet\/opennsa<\/a><\/li>\n<li>OESS &#8211; <a href=\"http:\/\/globalnoc.iu.edu\/sdn\/oess.html\">http:\/\/globalnoc.iu.edu\/sdn\/oess.html<\/a><\/li>\n<\/ul>\n<\/div><\/div><\/div>\n<p>&nbsp;<\/p>\n<div class=\"fusion-panel panel-default panel-722eed213e00aadf1 fusion-toggle-has-divider\"><div class=\"panel-heading\"><h4 class=\"panel-title toggle\" id=\"toggle_722eed213e00aadf1\"><a class=\"active\" aria-expanded=\"true\" aria-controls=\"722eed213e00aadf1\" role=\"button\" data-toggle=\"collapse\" data-parent=\"#accordion-1204-2\" data-target=\"#722eed213e00aadf1\" href=\"#722eed213e00aadf1\"><span class=\"fusion-toggle-icon-wrapper\" aria-hidden=\"true\"><i class=\"fa-fusion-box active-icon awb-icon-minus\" aria-hidden=\"true\"><\/i><i class=\"fa-fusion-box inactive-icon awb-icon-plus\" aria-hidden=\"true\"><\/i><\/span><span class=\"fusion-toggle-heading\">OESS and Zabbix Integration<\/span><\/a><\/h4><\/div><div id=\"722eed213e00aadf1\" class=\"panel-collapse collapse in\" aria-labelledby=\"toggle_722eed213e00aadf1\"><div class=\"panel-body toggle-content fusion-clearfix\">\n<h3>OESS and Zabbix Integration<\/h3>\n<p>OESS is an excellent tool to provision and manage Layer 2 circuits in an OpenFlow 1.0 environment. Using its User Interface (UI), it&#8217;s possible to create OpenFlow circuits, see their utilization per link, reprovision, etc. Sometimes, however, Network Operations teams want to have all information centralized in a single Network Management System (NMS), which would make it easier to manage permissions, integrate with SMS, Jabber or e-mail systems. Zabbix was the NMS chosen by AmLight a few years ago, and it manages all IT components involved in the daily operations. Even OESS being capable to provide info through a nice and clean UI, AmLight Network Engineering team decided to keep using Zabbix as the central platform for all notifications and event visualization. A tool was created to gather info from OESS and import into the Zabbix database, and this How-To will explain how this integration works. This How-To assumes Zabbix is up and running, with version 2.2.9+ on a CentOS 6.6 64 bits.<\/p>\n<p>Features provided by this integration:<\/p>\n<ul>\n<li>Each node or link will have historical data of when it was up or down;<\/li>\n<li>Each circuit will have historical data of when was it using the primary or the backup path and when it was down;<\/li>\n<li>The number of circuits along per time frame will be provided as a\u00a0graph;<\/li>\n<li>Triggers will alert admins of circuits in the backup or down state<\/li>\n<\/ul>\n<p>1 &#8211; Download the oess_cli.py script to your Zabbix&#8217;s &#8220;externalscripts&#8221; folder:<\/p>\n<blockquote><p>cd \/usr\/share\/zabbix\/externalscripts\/<\/p>\n<p>git clone\u00a0https:\/\/github.com\/jab1982\/oess-cli<\/p>\n<p>cp oess-cli\/oess-cli.py .<\/p><\/blockquote>\n<p>2 &#8211; Configure all local variables accordingly to your topology:<\/p>\n<blockquote><p>url, user, password and group associated with the user in the OESS<\/p>\n<p>This user should be read-only.<\/p><\/blockquote>\n<p>3 &#8211; Import the Zabbix OESS Template:<\/p>\n<blockquote><p>Download it from <a title=\"OESS template for Zabbix\" href=\"https:\/\/ultralog.ampath.net\/file\/zbx_export_templates.xml\">[2]<\/a><\/p>\n<p>Log as admin on Zabbix<\/p>\n<p>Click Configuration -&gt; Templates -&gt; Import -&gt; Chosen File.<\/p>\n<p>Select the downloaded Zabbix template file and click on Import<\/p><\/blockquote>\n<p>4\u00a0&#8211; Add the OESS Template to the node where OESS is installed<\/p>\n<blockquote><p>Still on Zabbix, click on Configuration -&gt; Hosts<\/p>\n<p>Select the node where OESS is installed<\/p>\n<p>Click on the Template tab<\/p>\n<p>In the text box write: Template OESS<\/p>\n<p>Click on Add then Save.<\/p><\/blockquote>\n<p>5 &#8211; Wait a few minutes until Zabbix collect enough information and it&#8217;s done.<\/p>\n<\/div><\/div><\/div>\n<p>&nbsp;<\/p>\n<p>&nbsp;<\/p>\n<p>See also <a href=\"http:\/\/amlight.net\/?page_id=1188\">Q&amp;A<\/a>\u00a0| <a href=\"http:\/\/amlight.net\/?page_id=1199\">Documentation<\/a>\u00a0| <a href=\"http:\/\/amlight.net\/?page_id=1204\">Operation<\/a> | <a href=\"http:\/\/www.sdn.amlight.net\/bin\/login\/Intranet?foswiki_origin=GET%2cview%2c\/Intranet\">Intranet<\/a><div class=\"fusion-clearfix\"><\/div><\/div><\/div><\/div><\/div>\n","protected":false},"excerpt":{"rendered":"","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"_links":{"self":[{"href":"https:\/\/www.amlight.net\/index.php?rest_route=\/wp\/v2\/pages\/1204"}],"collection":[{"href":"https:\/\/www.amlight.net\/index.php?rest_route=\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.amlight.net\/index.php?rest_route=\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.amlight.net\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.amlight.net\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=1204"}],"version-history":[{"count":20,"href":"https:\/\/www.amlight.net\/index.php?rest_route=\/wp\/v2\/pages\/1204\/revisions"}],"predecessor-version":[{"id":3438,"href":"https:\/\/www.amlight.net\/index.php?rest_route=\/wp\/v2\/pages\/1204\/revisions\/3438"}],"wp:attachment":[{"href":"https:\/\/www.amlight.net\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=1204"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}