Mirroristas/bigchaindb
2
0
Fork 0
mirror of https://github.com/bigchaindb/bigchaindb.git synced 2024-10-13 13:34:05 +00:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #928 from bigchaindb/remove-docs-on-old-azure-template

Browse Source 
Removed old Azure Quickstart Template docs, edited new ones
This commit is contained in:
Troy McConaghy 2016-12-10 16:44:34 +01:00 committed by GitHub
commit efbc1e1b9a
3 changed files with 20 additions and 71 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
docs/server/source/cloud-deployment-starter-templates/new-azure-template.md → docs/server/source/cloud-deployment-starter-templates/azure-quickstart-template.md
View File

@ -1,30 +1,36 @@
# New Azure Template
# Azure Quickstart Template
If you didn't read the introduction to the [cloud deployment starter templates](index.html), please do that now. The main point is that they're not for deploying a production node; they can be used as a starting point.
One can deploy a BigchainDB node on Azure using the template in the `bigchaindb-on-ubuntu` directory of Microsoft's `azure-quickstart-templates` repository on GitHub:
Note: There was an Azure quickstart template in the `blockchain` directory of Microsoft's `Azure/azure-quickstart-templates` repository on GitHub. It's gone now; it was replaced by the one described here.
1. Go to [the `bigchaindb-on-ubuntu` directory in that repository](https://github.com/Azure/azure-quickstart-templates/tree/master/bigchaindb-on-ubuntu).
One can deploy a BigchainDB node on Azure using the template in the `bigchaindb-on-ubuntu` directory of Microsoft's `Azure/azure-quickstart-templates` repository on GitHub. Here's how:
2. Click the button labelled **Deploy to Azure**.
1. Go to [that directory on GitHub](https://github.com/Azure/azure-quickstart-templates/tree/master/bigchaindb-on-ubuntu).
3. If you're not already logged in to Microsoft Azure, then you'll be prompted to login. If you don't have an account, then you'll have to create one.
1. Click the button labelled **Deploy to Azure**.
4. Once you are logged in to the Microsoft Azure Portal, you should be taken to a form titled **BigchainDB**. Some notes to help with filling in that form are available [below](new-azure-template.html#notes-on-the-blockchain-template-form-fields).
1. If you're not already logged in to Microsoft Azure, then you'll be prompted to login. If you don't have an account, then you'll have to create one.
5. Deployment takes a few minutes. You can follow the notifications by clicking the bell icon at the top of the screen. When done, you should see a notification saying "Deployment to resource group '[your resource group name]' was successful." The install script (`init.sh`) installed RethinkDB and ran it with default configs. It also used `pip` to install [the latest **bigchaindb** from PyPI](https://pypi.python.org/pypi/BigchainDB).
1. Once you are logged in to the Microsoft Azure Portal, you should be taken to a form titled **BigchainDB**. Some notes to help with filling in that form are available [below](azure-quickstart-template.html#notes-on-the-blockchain-template-form-fields).
6. Find out the public IP address of the virtual machine in the Azure Portal. Example: `40.69.87.250`
1. Deployment takes a few minutes. You can follow the notifications by clicking the bell icon at the top of the screen. At the time of writing, the final deployment operation (running the `init.sh` script) was failing. We will fix that, but for now, just follow these instructions and we'll update them once that's fixed.
7. ssh in to the virtual machine at that IP address, i.e. do `ssh <Admin_username>@<machine-ip>` where `<Admin_username>` is the admin username you entered into the form and `<machine-ip>` is the virtual machine IP address determined in the last step. Example: `ssh bcdbadmin@40.69.87.250`
1. Find out the public IP address of the virtual machine in the Azure Portal. Example: `40.69.87.250`
8. You should be prompted for a password. Give the `<Admin_password>` you entered into the form.
1. ssh in to the virtual machine at that IP address, i.e. do `ssh <Admin_username>@<machine-ip>` where `<Admin_username>` is the admin username you entered into the form and `<machine-ip>` is the virtual machine IP address determined in the last step. Example: `ssh bcdbadmin@40.69.87.250`
9. Configure BigchainDB Server using the default BigchainDB settings: `bigchaindb -y configure`
1. You should be prompted for a password. Give the `<Admin_password>` you entered into the form.
10. Run BigchainDB Server: `bigchaindb start`
1. Go to the `init.sh` script at [https://github.com/Azure/azure-quickstart-templates/blob/master/bigchaindb-on-ubuntu/scripts/init.sh](https://github.com/Azure/azure-quickstart-templates/blob/master/bigchaindb-on-ubuntu/scripts/init.sh)
BigchainDB Server should now be running on the Azure VM.
1. Manually run all the commands in that `init.sh` script *except for* **sudo easy_install3 pip**. This will install RethinkDB, run RethinkDB, and install BigchainDB Server.
1. Configure BigchainDB Server using the default BigchainDB settings: `bigchaindb -y configure`
1. Run BigchainDB Server: `bigchaindb start`
BigchainDB Server should now be running on the Azure virtual machine.
Remember to shut everything down when you're done (via the Azure Portal), because it generally costs money to run stuff on Azure.

3
docs/server/source/cloud-deployment-starter-templates/index.rst
View File

@ -12,5 +12,4 @@ If you find the cloud deployment starter templates for nodes helpful, then you m
template-terraform-aws
template-ansible
new-azure-template
old-azure-template
azure-quickstart-template

56
docs/server/source/cloud-deployment-starter-templates/old-azure-template.md
View File

@ -1,56 +0,0 @@
# Old Azure Template
**Note: As its name suggests, this is an old template for deploying a node on Azure. It will probably be removed eventually. We advise you use the [New Azure Template](new-azure-template.html) instead.**
<hr>
If you didn't read the introduction to the [cloud deployment starter templates](index.html), please do that now. The main point is that they're not for deploying a production node; they can be used as a starting point.
One can deploy a BigchainDB node on Azure using the template in the `blockchain` directory of Microsoft's `azure-quickstart-templates` repository on GitHub:
1. Go to [the `blockchain` directory in that repository](https://github.com/Azure/azure-quickstart-templates/tree/master/blockchain).
2. Click the button labelled **Deploy to Azure**.
3. If you're not already logged in to Microsoft Azure, then you'll be prompted to login. If you don't have an account, then you'll have to create one.
4. One you are logged in to the Microsoft Azure Portal, you should be taken to a form titled **Blockchain Template**. There are some notes to help with filling in that form at the bottom of this page.
5. Deployment takes a few minutes. You can follow the notifications by clicking the bell icon at the top of the screen. When done, you should see a notification saying "Deployment to resource group '[your resource group name]' was successful." The install script (`bigchaindb.sh`) installed RethinkDB, configured it using the default RethinkDB config file, and ran it. It also used pip to install [the latest `bigchaindb` from PyPI](https://pypi.python.org/pypi/BigchainDB).
6. Find out the public IP address of the virtual machine in the Azure Portal. Example: `40.69.87.250`
7. ssh in to the virtual machine at that IP address, e.g. `ssh adminusername@40.69.87.250` (where `adminusername` should be replaced by the Admin Username you entered into the form, and `40.69.87.250` should be replaced by the IP address you found in the last step).
8. You should be prompted for a password. Enter the Admin Password you entered into the form.
9. Configure BigchainDB using the default BigchainDB settings: `bigchaindb -y configure`
10. Run BigchainDB: `bigchaindb start`
BigchainDB should now be running on the Azure VM.
Remember to shut everything down when you're done (via the Azure Portal), because it generally costs money to run stuff on Azure.
## Notes on all the Blockchain Template Form Fields
**Resource group** - You can use an existing resource group (if you have one) or create a new one named whatever you like, but avoid using fancy characters in the name because Azure might have problems if you do.
**Location** is the Microsoft Azure data center where you want the BigchainDB node to run. Pick one close to where you are located.
**Vm Dns Prefix** - Once your virtual machine (VM) is deployed, it will have a public IP address and a DNS name (hostname) something like `DNSprefix.northeurope.cloudapp.azure.com`. The `DNSprefix` will be whatever you enter into this field.
You can use whatever **Admin Username** and **Admin Password** you like (provided you don't get too fancy). It will complain if your password is too simple. You'll need these later to ssh into the VM.
**Blockchain Software** - Select `bigchaindb`.
For **Vm Size**, select `Standard_D1_v2` or better.
**\_artifacts Location** - Leave this alone.
**\_artifacts Location Sas Token** - Leave this alone (blank).
Don't forget to scroll down and check the box to agree to the terms and conditions.
Once you've finished the form, click the button labelled **Purchase**. (Generally speaking, it costs money to run stuff on Azure.)