Changes between Version 79 and Version 80 of InstallationGuidelines/Amazon

Timestamp:

05/26/14 11:16:54 (11 years ago)

Author:

gnarula

Comment:

--

InstallationGuidelines/Amazon

@@ -303 +303 @@
 To troubleshoot any errors in installation of EC2 visit its [http://aws.amazon.com/documentation/ec2/ documentation]. If you encounter problems installing eden on the EC2 instance, you can contact us via [http://webchat.freenode.net/?channels=sahana-eden&uio=d4/ IRC] or the [https://groups.google.com/forum/#!forum/sahana-eden/ mailing list].
 
+== Setting up an EC2 instance as a master node ==
+
+Once you've registered for Amazon's Web Services, login to the EC2 Management Console. You'll be greeted with the EC2 dashboard as in the picture below
+
+[[Image(http://eden.sahanafoundation.org/raw-attachment/wiki/InstallationGuidelines/Amazon/Dashboard.png, 75%)]]
+
+Next, click on Launch Instance. This new instance will act as a master node for future deployments. We'll use Debian as the OS since the bootstrapping scripts support it. In the "Select your Amazon Machine Image" pane, select "AWS Marketplace" from the left sidebar. Scroll down, click on "Operating Systems" and select "Debian GNU/Linux"
+
+[[Image(http://eden.sahanafoundation.org/raw-attachment/wiki/InstallationGuidelines/Amazon/SelectAMI.png, 75%)]]
+
+In the next step, select the instance of your choice. The t1.micro instance is a good choice if you're eligible for Free Tier.
+
+Next, in the Configure Instance pane, expand the Advanced Details tab and enter the following script in the User-Data field
+{{{
+#!/bin/bash
+exec > >(tee /var/log/user-data.log|logger -t user-data -s 2>/dev/console) 2>&1
+
+# Update
+sudo apt-get update
+
+# Install git
+sudo apt-get install git-core
+
+# Install ansible dependencies
+sudo apt-get install python-pip python-dev git -y
+sudo pip install PyYAML jinja2 paramiko
+
+# Install Ansible
+sudo pip install ansible
+
+# Clone bootstrap scripts
+git clone https://github.com/gnarula/eden_deploy
+
+# Run the install
+cd eden_deploy
+
+echo "Running install script"
+bash install-eden-cherokee-postgis.sh
+
+# Run PostgreSQL optimisations for micro instance
+pg512
+
+echo "Running configuration script"
+bash configure-eden-cherokee-postgis.sh -h <hostname> -d <domain> -t <template>
+
+# Run uWSGI
+sudo /etc/init.d/uwsgi-prod start
+}}}
+
+The configure-eden-cherokee-postgis.sh script takes in three optional parameters. Please replace the placeholders with the appropriate values or remove them from the command in case you'd like to proceed with the default values (domain name being your Instance public dns and opting for the "default" template).
+
+Note: You may want to change `pg512` to pg1024 if you're running a configuration than what a micro instance has to offer.
+
+Moving on to Step 6, create a new security group with a rule for SSH and HTTP as shown in the screenshot below.
+
+[[Image(http://eden.sahanafoundation.org/raw-attachment/wiki/InstallationGuidelines/Amazon/SecurityGroup.png, 75%)]]
+
+Finally, review the configuration and launch the instance. You'll be prompted to select an existing key pair or generate a new one. In case you're a new user or you don't have access to your key, generate a new keypair, save it and proceed.
+
+That's it! Your new instance will have Eden Installed and set up for it to be used as a master node in future deployments. Do note that the deployment takes some time even after the Web UI states the instance as "Running". Logs for the process may be found by sshing into the newly created instance with your key and viewing /var/log/user-data.log
+
+It's important to note that the log file contains a randomly generated password to your PostgreSQL database. We advice you to memorize it and remove it from the logs thereafter.
+
 == Next ==
 [wiki:UserGuidelines/Admin Administration Guide]