• Stars
    star
    194
  • Rank 200,219 (Top 4 %)
  • Language
    Go
  • License
    MIT License
  • Created over 8 years ago
  • Updated over 1 year ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Jazigo is a tool written in Go for retrieving configuration for multiple devices, similar to rancid, fetchconfig, oxidized, Sweet.

license Go Report Card Go Reference

Table of Contents

Created by gh-md-toc

About Jazigo

Jazigo is a tool written in Go for retrieving configuration for multiple devices, similar to rancid, fetchconfig, oxidized, Sweet.

Installation and usage are supposed to be dead simple. If you hit any surprising difficulty, please report.

Supported Platforms

Please send pull requests for new plataforms.

Features

  • Written in Go. Single executable file. No runtime dependency.
  • Straightforward usage: run the binary then point browser to web UI. Default settings should work out-of-the-box.
  • Tool configuration is automatically saved as YAML. However one is NOT supposed to edit configuration file directly.
  • Spawns multiple concurrent lightweight goroutines to quickly handle large number of devices.
  • Very easy to add support for new platforms. See the Cisco IOS model as example.
  • Backup files can be accessed from web UI.
  • See file differences directly from the web UI.
  • Support for SSH and TELNET.
  • Can directly store backup files into AWS S3 bucket.
  • Can call an external program and collect its output.

Requirements

Quick Start - Short version

This is how to boot up Jazigo very quickly:

git clone https://github.com/udhos/jazigo ;# clone outside of GOPATH
cd jazigo
go install ./jazigo
mkdir etc repo log
JAZIGO_HOME=$PWD ~/go/bin/jazigo

Open jazigo interface - http://localhost:8080/jazigo/

Quick Start - Detailed version

Installation and usage are supposed to be dead simple. If you hit any surprising difficulty, please report.

If you want to build from source code, start from step 1.

If you downloaded the executable binary file, start from step 2.

1. Build from source

git clone https://github.com/udhos/jazigo
cd jazigo
go install ./...

2. Decide where to store config, backup, log and static www files

Example:

export JAZIGO_HOME=$HOME/jazigo
mkdir $JAZIGO_HOME
cd $JAZIGO_HOME
mkdir etc repo log www

Hint: By default, Jazigo looks for directories 'etc', 'repo', 'log', and 'www' under $JAZIGO_HOME. If left undefined, JAZIGO_HOME defaults to /var/jazigo. See command line options to fine tune filesystem locations.

3. Copy static files (CSS and images) to $JAZIGO_HOME/www

Example:

# If you have downloaded jazigo using 'go get':
cp ~/go/src/github.com/udhos/jazigo/www/* $JAZIGO_HOME/www

# Otherwise get static files from https://github.com/udhos/jazigo/tree/master/www
cd $JAZIGO_HOME/www
wget https://raw.githubusercontent.com/udhos/jazigo/master/www/fail-small.png
wget https://raw.githubusercontent.com/udhos/jazigo/master/www/ok-small.png
wget https://raw.githubusercontent.com/udhos/jazigo/master/www/jazigo.css
wget https://raw.githubusercontent.com/udhos/jazigo/master/www/GitHub-Mark-32px.png

4. Run jazigo once (see -runOnce option)

~/go/bin/jazigo -runOnce

Watch messages logged to standard output for errors.

Hint: Since root privileges are usually not needed, run Jazigo as a regular user.

5. Run jazigo forever

~/go/bin/jazigo -disableStdoutLog

6. Open the web interface

Point web browser at: http://localhost:8080/jazigo

Global Settings

You might want to adjust global settings. See the Jazigo admin window under http://localhost:8080/jazigo/admin.

maxconfigfiles: 120
holdtime: 12h0m0s
scaninterval: 10m0s
maxconcurrency: 20
maxconfigloadsize: 10000000

maxconfigfiles: This option limits the amount of files stored per device. When this limit is reached, older files are discarded.

holdtime: When a successful backup is saved for a device, the software will only contact that specific device again after expiration of the 'holdtime' timer.

scaninterval: The interval between two device table scans. If the device table is fully processed before the 'scaninterval' timer, the software will wait idly for the next scan cycle. If the full table scan takes longer than 'scaninterval', the next cycle will start immediately.

maxconcurrency: This option limits the number of concurrent backup jobs. You should raise this value if you need faster scanning of all devices. Keep in mind that if your devices use a centralized authentication system (for example, Cisco Secure ACS), the authentication server might become a bottleneck for high concurrency.

maxconfigloadsize: This limit puts restriction into the amount of data the tool loads from a file to memory. Intent is to protect the servers' memory from exhaustion while trying to handle multiple very large configuration files.

Importing Many Devices

You can use the Web UI to add devices, but it is not designed for importing a large number of devices.

The easiest way to include many devices is by using the command line option -deviceImport.

1. Build a device table using this format:

$ cat table.txt
#
# model   id   hostport      transports username password enable-password
#
cisco-ios lab1 router1905lab telnet     san      fran     sanjose
cisco-ios lab2 router3925lab telnet     san      fran     sanjose
junos     auto ex4200lab     ssh,telnet backup   juniper1 not-used
junos     auto 1.1.1.1:2222  ssh        backup   juniper1 not-used
$

Hint: The device id must be unique. You can generate a meaningful device id manually as you like. You can also let Jazigo create id's automatically by specifying the special id auto.

2. Then load the table with the option -deviceImport:

$ ~/go/bin/jazigo -deviceImport < table.txt

SSH Ciphers

You can control ciphers for the SSH transport by editing these device properties:

  • sshclearciphers: if enabled remove all default ciphers.
  • sshaddciphers: list of ciphers to add.

Example:

sshclearciphers: true # remove all default ciphers
sshaddciphers:
    - aes128-ctr      # add cipher aes128-ctr

Using AWS S3

Quick recipe for using S3 bucket:

1. Create a bucket 'bucketname' on AWS region 'regionname'.

2. Authorize the client to access the bucket

An usual way is to create an IAM user, add key/secret, and put those credentials into ~/.aws/credentials:

$ cat ~/.aws/credentials
[default]
aws_access_key_id = key
aws_secret_access_key = secret

3. Run jazigo pointing its config and repository paths to S3 bucket ARN:

S3 bucket ARN: arn:aws:s3:regionname::bucketname/foldername

# Example
ARN=arn:aws:s3:regionname::bucketname/foldername
~/go/bin/jazigo -configPathPrefix=$ARN/etc/jazigo.conf. -repositoryPath=$ARN/repo

Hint: You could point config and repository to distinct buckets.

Calling an external program

You can use the pseudo model run to call an external program to collect custom configuration.

Create a device using the model run, then specify the program arguments in the attribute runprog:

Example:

# This example calls: /bin/bash -c "env | egrep ^JAZIGO_"
runprog:
- /bin/bash
- -c
- env | egrep ^JAZIGO_

The external program invoked by the model run will receive its device authentication credentials as environment variables:

JAZIGO_DEV_ID=deviceid
JAZIGO_DEV_HOSTPORT=host[:port] -- port is optional
JAZIGO_DEV_USER=username
JAZIGO_DEV_PASS=password

The external program is expected to issue captured configuration to stdout and then to exit with zero exit status.

More Repositories

1

update-golang

update-golang is a script to easily fetch and install new Golang releases with minimum system intrusion
Shell
1,653
star
2

goben

goben is a golang tool to measure TCP/UDP transport layer throughput between hosts.
Go
515
star
3

conbox

conbox is a Go implementation of unix-like utilities as single static executable intended for small container images.
Go
36
star
4

fugo

fugo - fun with Go. gomobile OpenGL game
Go
35
star
5

basgo

basgo compiles BASIC-lang to Golang. Then 'go build' can translate code to native executable binary.
Go
32
star
6

gwob

gwob - Pure Go Golang parser for Wavefront .OBJ 3D geometry file format
Go
32
star
7

equalfile

Go package to compare files
Go
25
star
8

gowebhello

gowebhello is a simple golang replacement for 'python -m SimpleHTTPServer'.
Go
14
star
9

disbalance

disbalance - automagic load balancer
Go
13
star
10

fetchconfig

fetchconfig is a Perl script for retrieving configuration of multiple devices
Perl
13
star
11

golang-concurrency-tricks

Golang concurrency model based on goroutines and channels is not free from sharp edges.
9
star
12

qpimd

PIM Daemon for Quagga - ATTENTION: qpimd has been merged into Official Quagga
C
7
star
13

acigo

Acigo is a Go package for interacting with Cisco ACI using API calls.
Go
6
star
14

obj

OBJ (3d geometry definition format) parser for Dart
Dart
4
star
15

a10-go-rest-client

Go golang API rest client for A10 Networks devices
Go
4
star
16

apishell

Run commands using APIs.
Go
3
star
17

awk_examples

2
star
18

hellolambda

golang aws hello world
Go
2
star
19

modhello

modhello - starter recipe for working with golang modules
Go
2
star
20

gobule

Golang Go parser for the Bule Language
Go
2
star
21

mustago

mustago - simple golang mustache template evaluation in html
JavaScript
2
star
22

kubegroup

kubegroup provides autodiscovery for groupcache peer pods in kubernetes cluster
Go
2
star
23

gateboard

gateboard resolves AWS Private API Gateway ID.
Go
1
star
24

miniapi

miniapi serves a tiny API.
Go
1
star
25

lavalake

lavalake - Manage security groups uniformly across multiple cloud providers.
Go
1
star
26

fapip

fapip stands for fast ping probe, a tool for measuring packet loss against a remote host.
C
1
star
27

sipswitchd

Experimental SIP soft switch
Go
1
star
28

suco

sun colony
Go
1
star
29

ebsnap

Shell
1
star
30

sqs-to-sns

sqs-to-sns is an utility written in Go to forward messages from AWS SQS Queues to AWS SNS Topics.
Go
1
star
31

nexthop

Dynamic Internet Routing Suite in Go
Go
1
star
32

findcidr

Go
1
star
33

gitcheat

1
star
34

jmud

JMud, mud server written in Java in 1990's.
Java
1
star
35

negentropia

Negentropia is a webgl experiment on 3D browser gaming
JavaScript
1
star