From 833b804fe8e04c8dfc1c0356af0588c4dcf958be Mon Sep 17 00:00:00 2001 From: ryan Date: Mon, 25 Apr 2016 17:09:22 +0200 Subject: [PATCH 01/10] fix yml --- docker-compose-monitor.yml | 47 +++++++++++++++++++------------------- 1 file changed, 24 insertions(+), 23 deletions(-) diff --git a/docker-compose-monitor.yml b/docker-compose-monitor.yml index 6865931d..f32d0fa3 100644 --- a/docker-compose-monitor.yml +++ b/docker-compose-monitor.yml @@ -1,25 +1,26 @@ -influxdb: - image: tutum/influxdb - ports: - - "8083:8083" - - "8086:8086" - expose: - - "8090" - - "8099" - environment: - PRE_CREATE_DB: "telegraf" +version: '2' +services: + influxdb: + image: tutum/influxdb + ports: + - "8083:8083" + - "8086:8086" + - "8090" + - "8099" + environment: + PRE_CREATE_DB: "telegraf" -grafana: - image: bigchaindb/grafana-bigchaindb-docker - tty: true - ports: - - "3000:3000" - links: - - influxdb:localhost + grafana: + image: bigchaindb/grafana-bigchaindb-docker + tty: true + ports: + - "3000:3000" + environment: + INFLUXDB_HOST: "influxdb" -statsd: - image: bigchaindb/docker-telegraf-statsd - ports: - - "8125:8125/udp" - links: - - influxdb:localhost \ No newline at end of file + statsd: + image: bigchaindb/docker-telegraf-statsd + ports: + - "8125:8125/udp" + environment: + INFLUXDB_HOST: "influxdb" \ No newline at end of file From 821cfe2b38bac870e099cac2e52758ec64442a92 Mon Sep 17 00:00:00 2001 From: Rodolphe Marques Date: Mon, 25 Apr 2016 17:15:13 +0200 Subject: [PATCH 02/10] fixed indentation error --- docker-compose-monitor.yml | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docker-compose-monitor.yml b/docker-compose-monitor.yml index f32d0fa3..305ade2d 100644 --- a/docker-compose-monitor.yml +++ b/docker-compose-monitor.yml @@ -2,11 +2,11 @@ version: '2' services: influxdb: image: tutum/influxdb - ports: - - "8083:8083" - - "8086:8086" - - "8090" - - "8099" + ports: + - "8083:8083" + - "8086:8086" + - "8090" + - "8099" environment: PRE_CREATE_DB: "telegraf" From 0d0fe384969561c4ac20e61aee82e08a02013e15 Mon Sep 17 00:00:00 2001 From: ryan Date: Thu, 28 Apr 2016 13:45:10 +0200 Subject: [PATCH 03/10] whitespace error --- docker-compose-monitor.yml | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docker-compose-monitor.yml b/docker-compose-monitor.yml index f32d0fa3..305ade2d 100644 --- a/docker-compose-monitor.yml +++ b/docker-compose-monitor.yml @@ -2,11 +2,11 @@ version: '2' services: influxdb: image: tutum/influxdb - ports: - - "8083:8083" - - "8086:8086" - - "8090" - - "8099" + ports: + - "8083:8083" + - "8086:8086" + - "8090" + - "8099" environment: PRE_CREATE_DB: "telegraf" From dd21349df13f25384f3a61cf8abbb2e00e1838a4 Mon Sep 17 00:00:00 2001 From: Rodolphe Marques Date: Fri, 29 Apr 2016 10:41:23 +0200 Subject: [PATCH 04/10] Added fabfile to install docker on aws --- deploy-cluster-aws/fabfile-monitor.py | 37 +++++++++++++++++++++++++++ 1 file changed, 37 insertions(+) create mode 100644 deploy-cluster-aws/fabfile-monitor.py diff --git a/deploy-cluster-aws/fabfile-monitor.py b/deploy-cluster-aws/fabfile-monitor.py new file mode 100644 index 00000000..8e9cd939 --- /dev/null +++ b/deploy-cluster-aws/fabfile-monitor.py @@ -0,0 +1,37 @@ +from fabric.api import sudo, env +from fabric.api import task + +# Ignore known_hosts +# http://docs.fabfile.org/en/1.10/usage/env.html#disable-known-hosts +env.disable_known_hosts = True + +env.user = 'ubuntu' +env.key_filename = 'pem/bigchaindb.pem' + + +@task +def install_docker(): + """Install docker on an ec2 ubuntu 14.04 instance + + Example: + fab --fabfile=fabfile-monitor.py \ + --hosts=ec2-52-58-106-17.eu-central-1.compute.amazonaws.com \ + install_docker + """ + + # install prerequisites + sudo('apt-get update') + sudo('apt-get -y install apt-transport-https ca-certificates linux-image-extra-$(uname -r) apparmor') + + # install docker repositories + sudo('apt-key adv --keyserver hkp://p80.pool.sks-keyservers.net:80 \ + --recv-keys 58118E89F3A912897C070ADBF76221572C52609D') + sudo("echo 'deb https://apt.dockerproject.org/repo ubuntu-trusty main' | \ + sudo tee /etc/apt/sources.list.d/docker.list") + + # install docker engine + sudo('apt-get update') + sudo('apt-get -y install docker-engine') + + # add ubuntu user to the docker group + sudo('usermod -aG docker ubuntu') From 55e219c61c2ea5605df2650c9f2993ce492fe032 Mon Sep 17 00:00:00 2001 From: Rodolphe Marques Date: Tue, 3 May 2016 14:37:12 +0200 Subject: [PATCH 05/10] Added fab command to install docker compose. Added fab command to run monitor --- deploy-cluster-aws/fabfile-monitor.py | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-) diff --git a/deploy-cluster-aws/fabfile-monitor.py b/deploy-cluster-aws/fabfile-monitor.py index 8e9cd939..b0ff4841 100644 --- a/deploy-cluster-aws/fabfile-monitor.py +++ b/deploy-cluster-aws/fabfile-monitor.py @@ -1,5 +1,6 @@ from fabric.api import sudo, env from fabric.api import task +from fabric.operations import put, run # Ignore known_hosts # http://docs.fabfile.org/en/1.10/usage/env.html#disable-known-hosts @@ -10,7 +11,7 @@ env.key_filename = 'pem/bigchaindb.pem' @task -def install_docker(): +def install_docker_engine(): """Install docker on an ec2 ubuntu 14.04 instance Example: @@ -35,3 +36,17 @@ def install_docker(): # add ubuntu user to the docker group sudo('usermod -aG docker ubuntu') + + +@task +def install_docker_compose(): + sudo('curl -L https://github.com/docker/compose/releases/download/1.7.0/docker-compose-`uname \ + -s`-`uname -m` > /usr/local/bin/docker-compose') + sudo('chmod +x /usr/local/bin/docker-compose') + + +@task +def run_monitor(): + # copy docker-compose-monitor to the ec2 instance + put('../docker-compose-monitor.yml') + run('docker-compose -f docker-compose-monitor.yml up -d') From b82e60f074774b7f3a7a7533e74e1dde59ed98bf Mon Sep 17 00:00:00 2001 From: Rodolphe Marques Date: Tue, 3 May 2016 16:30:30 +0200 Subject: [PATCH 06/10] Added option to specify a mount point for influxdb. INFLUXDB_DATA=/somedir/ docker-compose -f docker-compose-monitor up --- docker-compose-monitor.yml | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docker-compose-monitor.yml b/docker-compose-monitor.yml index 305ade2d..e695387c 100644 --- a/docker-compose-monitor.yml +++ b/docker-compose-monitor.yml @@ -9,6 +9,8 @@ services: - "8099" environment: PRE_CREATE_DB: "telegraf" + volumes: + - $INFLUXDB_DATA:/data grafana: image: bigchaindb/grafana-bigchaindb-docker From 389319e497e861e860e0b525bf2a8471fa77260b Mon Sep 17 00:00:00 2001 From: Rodolphe Marques Date: Tue, 3 May 2016 17:06:58 +0200 Subject: [PATCH 07/10] Added fab task to run monitor Updated documentation --- deploy-cluster-aws/fabfile-monitor.py | 31 +++++++++++++++++++++++++-- docs/source/deploy-on-aws.md | 22 +++++++++++++++++++ docs/source/monitoring.md | 7 +++++- 3 files changed, 57 insertions(+), 3 deletions(-) diff --git a/deploy-cluster-aws/fabfile-monitor.py b/deploy-cluster-aws/fabfile-monitor.py index b0ff4841..71c5b100 100644 --- a/deploy-cluster-aws/fabfile-monitor.py +++ b/deploy-cluster-aws/fabfile-monitor.py @@ -17,7 +17,7 @@ def install_docker_engine(): Example: fab --fabfile=fabfile-monitor.py \ --hosts=ec2-52-58-106-17.eu-central-1.compute.amazonaws.com \ - install_docker + install_docker_engine """ # install prerequisites @@ -40,13 +40,40 @@ def install_docker_engine(): @task def install_docker_compose(): + """Install docker-compose on an ec2 ubuntu 14.04 instance + + Example: + fab --fabfile=fabfile-monitor.py \ + --hosts=ec2-52-58-106-17.eu-central-1.compute.amazonaws.com \ + install_docker_compose + """ sudo('curl -L https://github.com/docker/compose/releases/download/1.7.0/docker-compose-`uname \ -s`-`uname -m` > /usr/local/bin/docker-compose') sudo('chmod +x /usr/local/bin/docker-compose') +@task +def install_docker(): + """Install docker and docker-compose on an ec2 ubuntu 14.04 instance + + Example: + fab --fabfile=fabfile-monitor.py \ + --hosts=ec2-52-58-106-17.eu-central-1.compute.amazonaws.com \ + install_docker + """ + install_docker_engine() + install_docker_compose() + + @task def run_monitor(): + """Run bigchaindb monitor on an ec2 ubuntu 14.04 instance + + Example: + fab --fabfile=fabfile-monitor.py \ + --hosts=ec2-52-58-106-17.eu-central-1.compute.amazonaws.com \ + run_monitor + """ # copy docker-compose-monitor to the ec2 instance put('../docker-compose-monitor.yml') - run('docker-compose -f docker-compose-monitor.yml up -d') + run('INFLUXDB_DATA=/influxdb-data docker-compose -f docker-compose-monitor.yml up -d') diff --git a/docs/source/deploy-on-aws.md b/docs/source/deploy-on-aws.md index 49c83021..0d23fdeb 100644 --- a/docs/source/deploy-on-aws.md +++ b/docs/source/deploy-on-aws.md @@ -149,6 +149,28 @@ You have 2 allocated elactic IPs which are not associated with instances (It has Domain = vpc.) ``` +## BigchainDB Monitor Deployment + +The deployment for the monitor requires an aws ec2 instance running Ubuntu 14.04 with a system folder `/influxdb-data`. +This folder can be a [mount point of an EBS volume](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-using-volumes.html) +for data persistence. + +With the instance setup we first need to install `docker` and `docker-compose`: +```text +$ fab --fabfile=fabfile-monitor.py --hosts= install_docker +``` + +After docker is installed run the monitor with: +```text +$ fab --fabfile=fabfile-monitor.py --hosts= run_monitor +``` + +To access the monitor follow the instructions on [Monitoring](monitoring.html) replacing `localhost` with the +hostname of the ec2 instance running the monitor. + +To configure bigchaindb to start sending statistics to the monitor change statsd host in the configuration file +(in `$HOME/.bigchaindb` by default) to the hostname of the ec2 instance running the monitor. + ## Known Deployment Issues ### NetworkError diff --git a/docs/source/monitoring.md b/docs/source/monitoring.md index 4fb53072..dd3b1c6f 100644 --- a/docs/source/monitoring.md +++ b/docs/source/monitoring.md @@ -16,7 +16,12 @@ $ docker-compose -f docker-compose-monitor.yml build $ docker-compose -f docker-compose-monitor.yml up ``` -then point a browser tab to: +It is also possible to mount a host directory as a data volume for influxdb by settings the `INFLUXDB_DATA` env. +```text +$ INFLUXDB_DATA=/data docker-compose -f docker-compose-monitor up +``` + +After starting docker-compose point a browser tab to: [http://localhost:3000/dashboard/script/bigchaindb_dashboard.js](http://localhost:3000/dashboard/script/bigchaindb_dashboard.js) From eab54e1a0247a236bcf541019d87df7b59278d42 Mon Sep 17 00:00:00 2001 From: diminator Date: Tue, 3 May 2016 20:32:56 +0200 Subject: [PATCH 08/10] update docs/test file to avoid conflicts between testcases --- docs/source/python-server-api-examples.md | 4 +-- .../doc/run_doc_python_server_api_examples.py | 30 ++++++++++++------- 2 files changed, 21 insertions(+), 13 deletions(-) diff --git a/docs/source/python-server-api-examples.md b/docs/source/python-server-api-examples.md index c191fe74..f8a9c003 100644 --- a/docs/source/python-server-api-examples.md +++ b/docs/source/python-server-api-examples.md @@ -324,8 +324,8 @@ tx_multisig_transfer_signed = b.sign_transaction(tx_multisig_transfer, [testuser b.write_transaction(tx_multisig_transfer_signed) # Check if the transaction is already in the bigchain -tx_multisig_retrieved = b.get_transaction(tx_multisig_transfer_signed['id']) -tx_multisig_retrieved +tx_multisig_transfer_retrieved = b.get_transaction(tx_multisig_transfer_signed['id']) +tx_multisig_transfer_retrieved ``` ```python diff --git a/tests/doc/run_doc_python_server_api_examples.py b/tests/doc/run_doc_python_server_api_examples.py index 56a6aa31..6be75a3b 100644 --- a/tests/doc/run_doc_python_server_api_examples.py +++ b/tests/doc/run_doc_python_server_api_examples.py @@ -29,7 +29,7 @@ tx_signed = b.sign_transaction(tx, b.me_private) # included in a block, and written to the bigchain b.write_transaction(tx_signed) -sleep(10) +sleep(8) """ Read the Creation Transaction from the DB @@ -61,10 +61,12 @@ tx_transfer = b.create_transaction(testuser1_pub, testuser2_pub, tx_retrieved_id # sign the transaction tx_transfer_signed = b.sign_transaction(tx_transfer, testuser1_priv) + +b.validate_transaction(tx_transfer_signed) # write the transaction b.write_transaction(tx_transfer_signed) -sleep(10) +sleep(8) # check if the transaction is already in the bigchain tx_transfer_retrieved = b.get_transaction(tx_transfer_signed['id']) @@ -95,10 +97,12 @@ tx_multisig = b.create_transaction(b.me, [testuser1_pub, testuser2_pub], None, ' # Have the federation sign the transaction tx_multisig_signed = b.sign_transaction(tx_multisig, b.me_private) + +b.validate_transaction(tx_multisig_signed) b.write_transaction(tx_multisig_signed) # wait a few seconds for the asset to appear on the blockchain -sleep(10) +sleep(8) # retrieve the transaction tx_multisig_retrieved = b.get_transaction(tx_multisig_signed['id']) @@ -111,15 +115,16 @@ tx_multisig_retrieved_id = b.get_owned_ids(testuser2_pub).pop() tx_multisig_transfer = b.create_transaction([testuser1_pub, testuser2_pub], testuser3_pub, tx_multisig_retrieved_id, 'TRANSFER') tx_multisig_transfer_signed = b.sign_transaction(tx_multisig_transfer, [testuser1_priv, testuser2_priv]) +b.validate_transaction(tx_multisig_transfer_signed) b.write_transaction(tx_multisig_transfer_signed) # wait a few seconds for the asset to appear on the blockchain -sleep(10) +sleep(8) # retrieve the transaction -tx_multisig_retrieved = b.get_transaction(tx_multisig_transfer_signed['id']) - -print(json.dumps(tx_multisig_transfer_signed, sort_keys=True, indent=4, separators=(',', ':'))) +tx_multisig_transfer_retrieved = b.get_transaction(tx_multisig_transfer_signed['id']) +assert tx_multisig_transfer_retrieved is not None +print(json.dumps(tx_multisig_transfer_retrieved, sort_keys=True, indent=4, separators=(',', ':'))) """ Multiple Inputs and Outputs @@ -127,9 +132,10 @@ Multiple Inputs and Outputs for i in range(3): tx_mimo_asset = b.create_transaction(b.me, testuser1_pub, None, 'CREATE') tx_mimo_asset_signed = b.sign_transaction(tx_mimo_asset, b.me_private) + b.validate_transaction(tx_mimo_asset_signed) b.write_transaction(tx_mimo_asset_signed) -sleep(10) +sleep(8) # get inputs owned_mimo_inputs = b.get_owned_ids(testuser1_pub) @@ -137,9 +143,10 @@ print(len(owned_mimo_inputs)) # create a transaction tx_mimo = b.create_transaction(testuser1_pub, testuser2_pub, owned_mimo_inputs, 'TRANSFER') -tx_mimo_signed = b.sign_transaction(tx_mimo, testuser1_priv) +tx_mimo_signed = b.sign_transaction(tx_mimo, testuser1_priv) # write the transaction +b.validate_transaction(tx_mimo_signed) b.write_transaction(tx_mimo_signed) print(json.dumps(tx_mimo_signed, sort_keys=True, indent=4, separators=(',', ':'))) @@ -178,10 +185,11 @@ threshold_tx['id'] = util.get_hash_data(threshold_tx) # sign the transaction threshold_tx_signed = b.sign_transaction(threshold_tx, testuser2_priv) +b.validate_transaction(threshold_tx_signed) # write the transaction b.write_transaction(threshold_tx_signed) -sleep(10) +sleep(8) # check if the transaction is already in the bigchain tx_threshold_retrieved = b.get_transaction(threshold_tx_signed['id']) @@ -266,7 +274,7 @@ assert b.is_valid_transaction(hashlock_tx_signed) == hashlock_tx_signed b.write_transaction(hashlock_tx_signed) print(json.dumps(hashlock_tx_signed, sort_keys=True, indent=4, separators=(',', ':'))) -sleep(10) +sleep(8) hashlockuser_priv, hashlockuser_pub = crypto.generate_key_pair() From 4dd4de120f8296001b58079ef24c54368270b2d0 Mon Sep 17 00:00:00 2001 From: troymc Date: Wed, 4 May 2016 17:10:27 +0200 Subject: [PATCH 09/10] Edits to docs on monitoring --- docs/source/deploy-on-aws.md | 72 +++++++++++++++++++++++------------- docs/source/monitoring.md | 9 +++-- 2 files changed, 53 insertions(+), 28 deletions(-) diff --git a/docs/source/deploy-on-aws.md b/docs/source/deploy-on-aws.md index 0d23fdeb..a27e686a 100644 --- a/docs/source/deploy-on-aws.md +++ b/docs/source/deploy-on-aws.md @@ -83,9 +83,53 @@ Add some rules for Inbound traffic: **Note: These rules are extremely lax! They're meant to make testing easy.** You'll want to tighten them up if you intend to have a secure cluster. For example, Source = 0.0.0.0/0 is [CIDR notation](https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) for "allow this traffic to come from _any_ IP address." -## AWS Deployment +## Deploy a BigchainDB Monitor -### AWS Deployment Step 1 +This step is optional. + +One way to monitor a BigchainDB cluster is to use the monitoring setup described in the [Monitoring](monitoring.html) section of this documentation. If you want to do that, then you may want to deploy the monitoring server first, so you can tell your BigchainDB nodes where to send their monitoring data. + +You can deploy a monitoring server on AWS. To do that, go to the AWS EC2 Console and launch an instance: + +1. Choose an AMI: select Ubuntu Server 14.04 LTS. +2. Choose an Instance Type: a t2.micro will suffice. +3. Configure Instance Details: you can accept the defaults, but feel free to change them. +4. Add Storage: A "Root" volume type should already be included. You _could_ store monitoring data there (e.g. in a folder named `/influxdb-data`) but we will attach another volume and store the monitoring data there instead. Select "Add New Volume" and an EBS volume type. +5. Tag Instance: give your instance a memorable name. +6. Configure Security Group: choose your bigchaindb security group. +7. Review and launch your instance. + +When it asks, choose an existing key pair: the one you created earlier (named `bigchaindb`). + +Give your instance some time to launch and become able to accept SSH connections. You can see its current status in the AWS EC2 Console (in the "Instances" section). SSH into your instance using something like: +```text +cd deploy-cluster-aws +ssh -i pem/bigchaindb.pem ubuntu@ec2-52-58-157-229.eu-central-1.compute.amazonaws.com +``` + +where `ec2-52-58-157-229.eu-central-1.compute.amazonaws.com` should be replaced by your new instance's EC2 hostname. (To get that, go to the AWS EC2 Console, select Instances, click on your newly-launched instance, and copy its "Public DNS" name.) + +Next, create a file system on the attached volume, make a directory named `/influxdb-data`, and set the attached volume's mount point to be `/influxdb-data`. For detailed instructions on how to do that, see the AWS documentation for [Making an Amazon EBS Volume Available for Use](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-using-volumes.html). + +Then install Docker and Docker Compose: +```text +# in a Python 2.5-2.7 virtual environment where fabric, boto3, etc. are installed +fab --fabfile=fabfile-monitor.py --hosts= install_docker +``` + +After Docker is installed, we can run the monitor with: +```text +fab --fabfile=fabfile-monitor.py --hosts= run_monitor +``` + +For more information about monitoring (e.g. how to view the Grafana dashboard in your web browser), see the [Monitoring](monitoring.html) section of this documentation. + +To configure a BigchainDB node to send monitoring data to the monitoring server, change the statsd host in the configuration of the BigchainDB node. The section on [Configuring a BigchainDB Node](configuration.html) explains how you can do that. (For example, you can change the statsd host in `$HOME/.bigchaindb`.) + + +## Deploy a BigchainDB Cluster + +### Step 1 Suppose _N_ is the number of nodes you want in your BigchainDB cluster. If you already have a set of _N_ BigchainDB configuration files in the `deploy-cluster-aws/confiles` directory, then you can jump to step 2. To create such a set, you can do something like: ```text @@ -99,7 +143,7 @@ That will create three (3) _default_ BigchainDB configuration files in the `depl You can look inside those files if you're curious. In step 2, they'll be modified. For example, the default keyring is an empty list. In step 2, the deployment script automatically changes the keyring of each node to be a list of the public keys of all other nodes. Other changes are also made. -### AWS Deployment Step 2 +### Step 2 Step 2 is to launch the nodes ("instances") on AWS, to install all the necessary software on them, configure the software, run the software, and more. @@ -149,28 +193,6 @@ You have 2 allocated elactic IPs which are not associated with instances (It has Domain = vpc.) ``` -## BigchainDB Monitor Deployment - -The deployment for the monitor requires an aws ec2 instance running Ubuntu 14.04 with a system folder `/influxdb-data`. -This folder can be a [mount point of an EBS volume](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-using-volumes.html) -for data persistence. - -With the instance setup we first need to install `docker` and `docker-compose`: -```text -$ fab --fabfile=fabfile-monitor.py --hosts= install_docker -``` - -After docker is installed run the monitor with: -```text -$ fab --fabfile=fabfile-monitor.py --hosts= run_monitor -``` - -To access the monitor follow the instructions on [Monitoring](monitoring.html) replacing `localhost` with the -hostname of the ec2 instance running the monitor. - -To configure bigchaindb to start sending statistics to the monitor change statsd host in the configuration file -(in `$HOME/.bigchaindb` by default) to the hostname of the ec2 instance running the monitor. - ## Known Deployment Issues ### NetworkError diff --git a/docs/source/monitoring.md b/docs/source/monitoring.md index dd3b1c6f..acae3fea 100644 --- a/docs/source/monitoring.md +++ b/docs/source/monitoring.md @@ -16,15 +16,18 @@ $ docker-compose -f docker-compose-monitor.yml build $ docker-compose -f docker-compose-monitor.yml up ``` -It is also possible to mount a host directory as a data volume for influxdb by settings the `INFLUXDB_DATA` env. +It is also possible to mount a host directory as a data volume for InfluxDB +by setting the `INFLUXDB_DATA` environment variable: ```text -$ INFLUXDB_DATA=/data docker-compose -f docker-compose-monitor up +$ INFLUXDB_DATA=/data docker-compose -f docker-compose-monitor.yml up ``` -After starting docker-compose point a browser tab to: +You can view the Grafana dashboard in your web browser at: [http://localhost:3000/dashboard/script/bigchaindb_dashboard.js](http://localhost:3000/dashboard/script/bigchaindb_dashboard.js) +(You may want to replace `localhost` with another hostname in that URL, e.g. the hostname of a remote monitoring server.) + The login and password are `admin` by default. If BigchainDB is running and processing transactions, you should see analytics—if not, [start BigchainDB](installing-server.html#run-bigchaindb) and load some test transactions: ```text $ bigchaindb load From 9e4cab7ffc2e60d6c529ca9aa8fe05f4d27dd7eb Mon Sep 17 00:00:00 2001 From: troymc Date: Wed, 4 May 2016 17:12:18 +0200 Subject: [PATCH 10/10] Minor stylistic/consistency edits to fabfile-monitor.py --- deploy-cluster-aws/fabfile-monitor.py | 16 ++++++++++++---- 1 file changed, 12 insertions(+), 4 deletions(-) diff --git a/deploy-cluster-aws/fabfile-monitor.py b/deploy-cluster-aws/fabfile-monitor.py index 71c5b100..4d26097b 100644 --- a/deploy-cluster-aws/fabfile-monitor.py +++ b/deploy-cluster-aws/fabfile-monitor.py @@ -1,3 +1,11 @@ +# -*- coding: utf-8 -*- +"""A Fabric fabfile with functionality to install Docker, +install Docker Compose, and run a BigchainDB monitoring server +(using the docker-compose-monitor.yml file) +""" + +from __future__ import with_statement, unicode_literals + from fabric.api import sudo, env from fabric.api import task from fabric.operations import put, run @@ -12,7 +20,7 @@ env.key_filename = 'pem/bigchaindb.pem' @task def install_docker_engine(): - """Install docker on an ec2 ubuntu 14.04 instance + """Install Docker on an EC2 Ubuntu 14.04 instance Example: fab --fabfile=fabfile-monitor.py \ @@ -40,7 +48,7 @@ def install_docker_engine(): @task def install_docker_compose(): - """Install docker-compose on an ec2 ubuntu 14.04 instance + """Install Docker Compose on an EC2 Ubuntu 14.04 instance Example: fab --fabfile=fabfile-monitor.py \ @@ -54,7 +62,7 @@ def install_docker_compose(): @task def install_docker(): - """Install docker and docker-compose on an ec2 ubuntu 14.04 instance + """Install Docker and Docker Compose on an EC2 Ubuntu 14.04 instance Example: fab --fabfile=fabfile-monitor.py \ @@ -67,7 +75,7 @@ def install_docker(): @task def run_monitor(): - """Run bigchaindb monitor on an ec2 ubuntu 14.04 instance + """Run BigchainDB monitor on an EC2 Ubuntu 14.04 instance Example: fab --fabfile=fabfile-monitor.py \