From 15df06d834b98462f6084651fd1fbd22d109f77d Mon Sep 17 00:00:00 2001 From: Blake Harnden <32446120+bharnden@users.noreply.github.com> Date: Tue, 28 Mar 2023 21:47:27 -0700 Subject: [PATCH] docs: updates to reformat and adjust documentation in regards to using specific services --- docs/services/bird.md | 5 ++--- docs/services/emane.md | 3 --- docs/services/frr.md | 28 ++++++++++++++++++++------ docs/services/nrl.md | 42 +++++++++++++++++++++++++++++---------- docs/services/quagga.md | 14 ++++++++----- docs/services/sdn.md | 8 ++++---- docs/services/security.md | 18 ++++++++++------- docs/services/utility.md | 14 +++++++------ docs/services/xorp.md | 40 ++++++++++++++++++++++++------------- 9 files changed, 114 insertions(+), 58 deletions(-) diff --git a/docs/services/bird.md b/docs/services/bird.md index 8fa7b895..db2f7701 100644 --- a/docs/services/bird.md +++ b/docs/services/bird.md @@ -1,8 +1,5 @@ # BIRD Internet Routing Daemon -* Table of Contents -{:toc} - ## Overview The [BIRD Internet Routing Daemon](https://bird.network.cz/) is a routing @@ -30,6 +27,7 @@ sudo apt-get install bird You can download BIRD source code from its [official repository.](https://gitlab.labs.nic.cz/labs/bird/) + ```shell ./configure make @@ -37,6 +35,7 @@ su make install vi /etc/bird/bird.conf ``` + The installation will place the bird directory inside */etc* where you will also find its config file. diff --git a/docs/services/emane.md b/docs/services/emane.md index 91a0f769..3f904091 100644 --- a/docs/services/emane.md +++ b/docs/services/emane.md @@ -1,8 +1,5 @@ # EMANE Services -* Table of Contents -{:toc} - ## Overview EMANE related services for CORE. diff --git a/docs/services/frr.md b/docs/services/frr.md index e69a9d1e..aa2db6ff 100644 --- a/docs/services/frr.md +++ b/docs/services/frr.md @@ -1,13 +1,14 @@ # FRRouting -* Table of Contents -{:toc} - ## Overview -FRRouting is a routing software package that provides TCP/IP based routing services with routing protocols support such as BGP, RIP, OSPF, IS-IS and more. FRR also supports special BGP Route Reflector and Route Server behavior. In addition to traditional IPv4 routing protocols, FRR also supports IPv6 routing protocols. With an SNMP daemon that supports the AgentX protocol, FRR provides routing protocol MIB read-only access (SNMP Support). +FRRouting is a routing software package that provides TCP/IP based routing services with routing protocols support such +as BGP, RIP, OSPF, IS-IS and more. FRR also supports special BGP Route Reflector and Route Server behavior. In addition +to traditional IPv4 routing protocols, FRR also supports IPv6 routing protocols. With an SNMP daemon that supports the +AgentX protocol, FRR provides routing protocol MIB read-only access (SNMP Support). FRR (as of v7.2) currently supports the following protocols: + * BGPv4 * OSPFv2 * OSPFv3 @@ -26,11 +27,13 @@ FRR (as of v7.2) currently supports the following protocols: ## FRRouting Package Install Ubuntu 19.10 and later + ```shell sudo apt update && sudo apt install frr ``` Ubuntu 16.04 and Ubuntu 18.04 + ```shell sudo apt install curl curl -s https://deb.frrouting.org/frr/keys.asc | sudo apt-key add - @@ -38,25 +41,35 @@ FRRVER="frr-stable" echo deb https://deb.frrouting.org/frr $(lsb_release -s -c) $FRRVER | sudo tee -a /etc/apt/sources.list.d/frr.list sudo apt update && sudo apt install frr frr-pythontools ``` + Fedora 31 + ```shell sudo dnf update && sudo dnf install frr ``` ## FRRouting Source Code Install -Building FRR from source is the best way to ensure you have the latest features and bug fixes. Details for each supported platform, including dependency package listings, permissions, and other gotchas, are in the developer’s documentation. +Building FRR from source is the best way to ensure you have the latest features and bug fixes. Details for each +supported platform, including dependency package listings, permissions, and other gotchas, are in the developer’s +documentation. FRR’s source is available on the project [GitHub page](https://github.com/FRRouting/frr). + ```shell git clone https://github.com/FRRouting/frr.git ``` Change into your FRR source directory and issue: + ```shell ./bootstrap.sh ``` -Then, choose the configuration options that you wish to use for the installation. You can find these options on FRR's [official webpage](http://docs.frrouting.org/en/latest/installation.html). Once you have chosen your configure options, run the configure script and pass the options you chose: + +Then, choose the configuration options that you wish to use for the installation. You can find these options on +FRR's [official webpage](http://docs.frrouting.org/en/latest/installation.html). Once you have chosen your configure +options, run the configure script and pass the options you chose: + ```shell ./configure \ --prefix=/usr \ @@ -68,8 +81,11 @@ Then, choose the configuration options that you wish to use for the installation --enable-watchfrr \ ... ``` + After configuring the software, you are ready to build and install it in your system. + ```shell make && sudo make install ``` + If everything finishes successfully, FRR should be installed. diff --git a/docs/services/nrl.md b/docs/services/nrl.md index c7e84920..da26ab25 100644 --- a/docs/services/nrl.md +++ b/docs/services/nrl.md @@ -1,13 +1,21 @@ # NRL Services -* Table of Contents -{:toc} - ## Overview -The Protean Protocol Prototyping Library (ProtoLib) is a cross-platform library that allows applications to be built while supporting a variety of platforms including Linux, Windows, WinCE/PocketPC, MacOS, FreeBSD, Solaris, etc as well as the simulation environments of NS2 and Opnet. The goal of the Protolib is to provide a set of simple, cross-platform C++ classes that allow development of network protocols and applications that can run on different platforms and in network simulation environments. While Protolib provides an overall framework for developing working protocol implementations, applications, and simulation modules, the individual classes are designed for use as stand-alone components when possible. Although Protolib is principally for research purposes, the code has been constructed to provide robust, efficient performance and adaptability to real applications. In some cases, the code consists of data structures, etc useful in protocol implementations and, in other cases, provides common, cross-platform interfaces to system services and functions (e.g., sockets, timers, routing tables, etc). +The Protean Protocol Prototyping Library (ProtoLib) is a cross-platform library that allows applications to be built +while supporting a variety of platforms including Linux, Windows, WinCE/PocketPC, MacOS, FreeBSD, Solaris, etc as well +as the simulation environments of NS2 and Opnet. The goal of the Protolib is to provide a set of simple, cross-platform +C++ classes that allow development of network protocols and applications that can run on different platforms and in +network simulation environments. While Protolib provides an overall framework for developing working protocol +implementations, applications, and simulation modules, the individual classes are designed for use as stand-alone +components when possible. Although Protolib is principally for research purposes, the code has been constructed to +provide robust, efficient performance and adaptability to real applications. In some cases, the code consists of data +structures, etc useful in protocol implementations and, in other cases, provides common, cross-platform interfaces to +system services and functions (e.g., sockets, timers, routing tables, etc). + +Currently, the Naval Research Laboratory uses this library to develop a wide variety of protocols.The NRL Protolib +currently supports the following protocols: -Currently the Naval Research Laboratory uses this library to develop a wide variety of protocols.The NRL Protolib currently supports the following protocols: * MGEN_Sink * NHDP * SMF @@ -19,11 +27,14 @@ Currently the Naval Research Laboratory uses this library to develop a wide vari ## NRL Installation -In order to be able to use the different protocols that NRL offers, you must first download the support library itself. You can get the source code from their [NRL Protolib Repo](https://github.com/USNavalResearchLaboratory/protolib). +In order to be able to use the different protocols that NRL offers, you must first download the support library itself. +You can get the source code from their [NRL Protolib Repo](https://github.com/USNavalResearchLaboratory/protolib). ## Multi-Generator (MGEN) -Download MGEN from the [NRL MGEN Repo](https://github.com/USNavalResearchLaboratory/mgen), unpack it and copy the protolib library into the main folder *mgen*. Execute the following commands to build the protocol. +Download MGEN from the [NRL MGEN Repo](https://github.com/USNavalResearchLaboratory/mgen), unpack it and copy the +protolib library into the main folder *mgen*. Execute the following commands to build the protocol. + ```shell cd mgen/makefiles make -f Makefile.{os} mgen @@ -32,16 +43,22 @@ make -f Makefile.{os} mgen ## Neighborhood Discovery Protocol (NHDP) Download NHDP from the [NRL NHDP Repo](https://github.com/USNavalResearchLaboratory/NCS-Downloads/tree/master/nhdp). + ```shell sudo apt-get install libpcap-dev libboost-all-dev wget https://github.com/protocolbuffers/protobuf/releases/download/v3.8.0/protoc-3.8.0-linux-x86_64.zip unzip protoc-3.8.0-linux-x86_64.zip ``` + Then place the binaries in your $PATH. To know your paths you can issue the following command + ```shell echo $PATH ``` -Go to the downloaded *NHDP* tarball, unpack it and place the protolib library inside the NHDP main folder. Now, compile the NHDP Protocol. + +Go to the downloaded *NHDP* tarball, unpack it and place the protolib library inside the NHDP main folder. Now, compile +the NHDP Protocol. + ```shell cd nhdp/unix make -f Makefile.{os} @@ -49,7 +66,9 @@ make -f Makefile.{os} ## Simplified Multicast Forwarding (SMF) -Download SMF from the [NRL SMF Repo](https://github.com/USNavalResearchLaboratory/nrlsmf) , unpack it and place the protolib library inside the *smf* main folder. +Download SMF from the [NRL SMF Repo](https://github.com/USNavalResearchLaboratory/nrlsmf) , unpack it and place the +protolib library inside the *smf* main folder. + ```shell cd mgen/makefiles make -f Makefile.{os} @@ -57,7 +76,10 @@ make -f Makefile.{os} ## Optimized Link State Routing Protocol (OLSR) -To install the OLSR protocol, download their source code from their [NRL OLSR Repo](https://github.com/USNavalResearchLaboratory/nrlolsr). Unpack it and place the previously downloaded protolib library inside the *nrlolsr* main directory. Then execute the following commands: +To install the OLSR protocol, download their source code from +their [NRL OLSR Repo](https://github.com/USNavalResearchLaboratory/nrlolsr). Unpack it and place the previously +downloaded protolib library inside the *nrlolsr* main directory. Then execute the following commands: + ```shell cd ./unix make -f Makefile.{os} diff --git a/docs/services/quagga.md b/docs/services/quagga.md index d894d431..6842b5e7 100644 --- a/docs/services/quagga.md +++ b/docs/services/quagga.md @@ -1,12 +1,13 @@ # Quagga Routing Suite -* Table of Contents -{:toc} - ## Overview - Quagga is a routing software suite, providing implementations of OSPFv2, OSPFv3, RIP v1 and v2, RIPng and BGP-4 for Unix platforms, particularly FreeBSD, Linux, Solaris and NetBSD. Quagga is a fork of GNU Zebra which was developed by Kunihiro Ishiguro. -The Quagga architecture consists of a core daemon, zebra, which acts as an abstraction layer to the underlying Unix kernel and presents the Zserv API over a Unix or TCP stream to Quagga clients. It is these Zserv clients which typically implement a routing protocol and communicate routing updates to the zebra daemon. +Quagga is a routing software suite, providing implementations of OSPFv2, OSPFv3, RIP v1 and v2, RIPng and BGP-4 for Unix +platforms, particularly FreeBSD, Linux, Solaris and NetBSD. Quagga is a fork of GNU Zebra which was developed by +Kunihiro Ishiguro. +The Quagga architecture consists of a core daemon, zebra, which acts as an abstraction layer to the underlying Unix +kernel and presents the Zserv API over a Unix or TCP stream to Quagga clients. It is these Zserv clients which typically +implement a routing protocol and communicate routing updates to the zebra daemon. ## Quagga Package Install @@ -17,10 +18,13 @@ sudo apt-get install quagga ## Quagga Source Install First, download the source code from their [official webpage](https://www.quagga.net/). + ```shell sudo apt-get install gawk ``` + Extract the tarball, go to the directory of your currently extracted code and issue the following commands. + ```shell ./configure make diff --git a/docs/services/sdn.md b/docs/services/sdn.md index 9381fef5..05e8606e 100644 --- a/docs/services/sdn.md +++ b/docs/services/sdn.md @@ -1,11 +1,11 @@ # Software Defined Networking -* Table of Contents -{:toc} - ## Overview -Ryu is a component-based software defined networking framework. Ryu provides software components with well defined API that make it easy for developers to create new network management and control applications. Ryu supports various protocols for managing network devices, such as OpenFlow, Netconf, OF-config, etc. About OpenFlow, Ryu supports fully 1.0, 1.2, 1.3, 1.4, 1.5 and Nicira Extensions. All of the code is freely available under the Apache 2.0 license. +Ryu is a component-based software defined networking framework. Ryu provides software components with well defined API +that make it easy for developers to create new network management and control applications. Ryu supports various +protocols for managing network devices, such as OpenFlow, Netconf, OF-config, etc. About OpenFlow, Ryu supports fully +1.0, 1.2, 1.3, 1.4, 1.5 and Nicira Extensions. All of the code is freely available under the Apache 2.0 license. ## Installation diff --git a/docs/services/security.md b/docs/services/security.md index c8856e13..a621009d 100644 --- a/docs/services/security.md +++ b/docs/services/security.md @@ -1,15 +1,15 @@ # Security Services -* Table of Contents -{:toc} - ## Overview -The security services offer a wide variety of protocols capable of satisfying the most use cases available. Security services such as IP security protocols, for providing security at the IP layer, as well as the suite of protocols designed to provide that security, through authentication and encryption of IP network packets. Virtual Private Networks (VPNs) and Firewalls are also available for use to the user. +The security services offer a wide variety of protocols capable of satisfying the most use cases available. Security +services such as IP security protocols, for providing security at the IP layer, as well as the suite of protocols +designed to provide that security, through authentication and encryption of IP network packets. Virtual Private +Networks (VPNs) and Firewalls are also available for use to the user. ## Installation -Libraries needed for some of the security services. +Libraries needed for some security services. ```shell sudo apt-get install ipsec-tools racoon @@ -71,7 +71,9 @@ sudo cp pki/dh.pem $KEYDIR/dh1024.pem Add VPNServer service to nodes desired for running an OpenVPN server. -Modify [sampleVPNServer](https://github.com/coreemu/core/blob/master/package/examples/services/sampleVPNServer) for the following +Modify [sampleVPNServer](https://github.com/coreemu/core/blob/master/package/examples/services/sampleVPNServer) for the +following + * Edit keydir key/cert directory * Edit keyname to use generated server name above * Edit vpnserver to match an address that the server node will have @@ -80,7 +82,9 @@ Modify [sampleVPNServer](https://github.com/coreemu/core/blob/master/package/exa Add VPNClient service to nodes desired for acting as an OpenVPN client. -Modify [sampleVPNClient](https://github.com/coreemu/core/blob/master/package/examples/services/sampleVPNClient) for the following +Modify [sampleVPNClient](https://github.com/coreemu/core/blob/master/package/examples/services/sampleVPNClient) for the +following + * Edit keydir key/cert directory * Edit keyname to use generated client name above * Edit vpnserver to match the address a server was configured to use diff --git a/docs/services/utility.md b/docs/services/utility.md index b2fa87b8..698de4f8 100644 --- a/docs/services/utility.md +++ b/docs/services/utility.md @@ -1,13 +1,11 @@ # Utility Services -* Table of Contents -{:toc} - -# Overview +## Overview Variety of convenience services for carrying out common networking changes. The following services are provided as utilities: + * UCARP * IP Forward * Default Routing @@ -25,15 +23,19 @@ The following services are provided as utilities: ## Installation To install the functionality of the previously metioned services you can run the following command: + ```shell sudo apt-get install isc-dhcp-server apache2 libpcap-dev radvd at ``` ## UCARP -UCARP allows a couple of hosts to share common virtual IP addresses in order to provide automatic failover. It is a portable userland implementation of the secure and patent-free Common Address Redundancy Protocol (CARP, OpenBSD's alternative to the patents-bloated VRRP). +UCARP allows a couple of hosts to share common virtual IP addresses in order to provide automatic failover. It is a +portable userland implementation of the secure and patent-free Common Address Redundancy Protocol (CARP, OpenBSD's +alternative to the patents-bloated VRRP). -Strong points of the CARP protocol are: very low overhead, cryptographically signed messages, interoperability between different operating systems and no need for any dedicated extra network link between redundant hosts. +Strong points of the CARP protocol are: very low overhead, cryptographically signed messages, interoperability between +different operating systems and no need for any dedicated extra network link between redundant hosts. ### Installation diff --git a/docs/services/xorp.md b/docs/services/xorp.md index 6b786964..a9bd108d 100644 --- a/docs/services/xorp.md +++ b/docs/services/xorp.md @@ -1,36 +1,48 @@ # XORP routing suite -* Table of Contents -{:toc} - ## Overview -XORP is an open networking platform that supports OSPF, RIP, BGP, OLSR, VRRP, PIM, IGMP (Multicast) and other routing protocols. Most protocols support IPv4 and IPv6 where applicable. It is known to work on various Linux distributions and flavors of BSD. +XORP is an open networking platform that supports OSPF, RIP, BGP, OLSR, VRRP, PIM, IGMP (Multicast) and other routing +protocols. Most protocols support IPv4 and IPv6 where applicable. It is known to work on various Linux distributions and +flavors of BSD. -XORP started life as a project at the ICSI Center for Open Networking (ICON) at the International Computer Science Institute in Berkeley, California, USA, and spent some time with the team at XORP, Inc. It is now maintained and improved on a volunteer basis by a core of long-term XORP developers and some newer contributors. +XORP started life as a project at the ICSI Center for Open Networking (ICON) at the International Computer Science +Institute in Berkeley, California, USA, and spent some time with the team at XORP, Inc. It is now maintained and +improved on a volunteer basis by a core of long-term XORP developers and some newer contributors. -XORP's primary goal is to be an open platform for networking protocol implementations and an alternative to proprietary and closed networking products in the marketplace today. It is the only open source platform to offer integrated multicast capability. +XORP's primary goal is to be an open platform for networking protocol implementations and an alternative to proprietary +and closed networking products in the marketplace today. It is the only open source platform to offer integrated +multicast capability. XORP design philosophy is: - * modularity - * extensibility - * performance - * robustness -This is achieved by carefully separating functionalities into independent modules, and by providing an API for each module. -XORP divides into two subsystems. The higher-level ("user-level") subsystem consists of the routing protocols. The lower-level ("kernel") manages the forwarding path, and provides APIs for the higher-level to access. +* modularity +* extensibility +* performance +* robustness + This is achieved by carefully separating functionalities into independent modules, and by providing an API for each + module. -User-level XORP uses multi-process architecture with one process per routing protocol, and a novel inter-process communication mechanism called XRL (XORP Resource Locator). +XORP divides into two subsystems. The higher-level ("user-level") subsystem consists of the routing protocols. The +lower-level ("kernel") manages the forwarding path, and provides APIs for the higher-level to access. -The lower-level subsystem can use traditional UNIX kernel forwarding, or Click modular router. The modularity and independency of the lower-level from the user-level subsystem allows for its easily replacement with other solutions including high-end hardware-based forwarding engines. +User-level XORP uses multi-process architecture with one process per routing protocol, and a novel inter-process +communication mechanism called XRL (XORP Resource Locator). + +The lower-level subsystem can use traditional UNIX kernel forwarding, or Click modular router. The modularity and +independency of the lower-level from the user-level subsystem allows for its easily replacement with other solutions +including high-end hardware-based forwarding engines. ## Installation In order to be able to install the XORP Routing Suite, you must first install scons in order to compile it. + ```shell sudo apt-get install scons ``` + Then, download XORP from its official [release web page](http://www.xorp.org/releases/current/). + ```shell http://www.xorp.org/releases/current/ cd xorp