oliviazhang0809 / puppet-sandbox

Metrics Setup Instructions

Introduction

This program is a multi-VM Vagrant-based Puppet development environment used for creating and testing new modules outside of your production environment. It will set up and configure following machines with customized settings.

• puppet - the Puppet master server
• influxdbSeed - the influxdb seed node
• influxdbChild1 - influxdb client nodes
• influxdbChild2 - influxdb client nodes
• grafana - grafana + apache server
• hekad - heka daemon

Initial Setup

Open Ports

The program will use following forward host ports so please be sure they are available when running the program.

• 8142 for puppet master
• 8003 for grafana
• 8004 for influxdbSeed
• 8005 for influxdbChild1
• 8006 for influxdbChild2
• 8007 for hekad

If any of these ports has special usage, you can always make changes in vagrantfile.

Default Value Setup

Please check settings in Vagrantfile, to see if the following variables are set as you expected.

environment: "dev" -- development environment

cluster_seed_servers: "influxdbSeed.example.com"

db_name: "test2" -- default database

Running with virtualbox, these machines are using following IP addresses and ports:

• puppet - 172.16.32.10:8140
• influxdbSeed - 172.16.32.11:8083
• grafana - 172.16.32.12:80
• influxdbChild1 - 172.16.32.13:8083
• influxdbChild2 - 172.16.32.14:8083

For influxdb cluster, the default username and password are both root.

Environment Installation

To vagrant up your c3 boxes, please finish INSTALLATION to have correct environment setup. Note: for this project, your keypair should be named as metrics instead of vagrant.

Correct Activation Order

• Puppet master (puppet) node must be activated before all other nodes.
• influxdbSeed must be activated before child nodes (influxdbChild1, influxdbChild2).

Bring up your machines

You can easily bring up your machine by

$ . bin/metrics.sh

In the prompt, you can specify the provider of your machines: v -- virtualbox, o -- openstack.

If you are running with c3 instances, you need to set up cluster_seed_servers ($project_root/hieradata/env/dev/common) after you have influxdbSeed node up so that the client nodes can have a recognizable hostname to join.

Check Your Handiwork

To log on to the virtual machines and see the result of your applied Puppet modules, just use standard Vagrant Multi-VM Environment commands, and provide the proper VM name:

$ vagrant ssh influxdbSeed

See Visualized Result!

1. Database cluster - you should be able to see all nodes of the cluster under cluster tab from any of the hosts in influxdb GUI. To access the GUI, you can go to $influxdb_seed_node_ip:8083, i.e. 172.16.32.11:8083 if you are running with virtualbox.

2. Grafana - grafana is connected with influxdb seed node. You can see the visualization from $grafana_domain:$grafana_port, i.e.172.16.32.12 if you are running with virtualbox. Currently there should be nothing inside because the databases are newly created.