cloud/chapters/01-Getting-Started.md

   1 _[next chapter >](02-Application-Servers.md)_
   2
   3 # 🚴 Getting Started
   4
   5 ### Create an AWS Account
   6
   7 1. Navigate to [https://aws.amazon.com/](https://aws.amazon.com/), and then click **Create an AWS Account**. If you already have an account, feel free to continue to the next section.
   8 2. Follow along with the signup wizard.
   9
  10 ### Select a Region
  11
  12 This guide uses services that are _only_ available in certain AWS regions. As of this writing, you will need to make sure you're in one the of four Amazon regions described below.
  13
  14 1. In the AWS Management Console, click **Services**, and then click **EC2**.
  15 2. In the region dropdown in the top right corner, select either **N. Virginia** (least expensive), **Oregon**, **Ireland**, or **Sydney**. Be sure to remain in this region for the remainder of this guide.
  16
  17 ### Generate an SSH Keypair
  18
  19 1. In the AWS Management Console, click **Services** and then click **EC2**.
  20 2. In the left pane, under **Network & Security**, click **Key Pairs**.
  21 3. Click **Create Key Pair**.
  22 4. When the **"Create Key Pair"** dialog appears, enter your username for the **Key pair name** field and click **Create**.
  23 5. When the **Save As** dialog appears, save the .pem keyfile to a safe place. This file will be referred to in later chapters. _IMPORTANT: This will only be available once for download and is needed for future systems access._
  24
  25 ### Launch your Cloud
  26
  27 1. Click the region link below that corresponds to the region you created your keypair in:
  28    * [N. Virginia](https://console.aws.amazon.com/cloudformation/home?region=us-east-1#/stacks/new?stackName=OpenEMR&templateURL=https://s3.amazonaws.com/openemr-useast1/OpenEMR.016.json)
  29    * [Oregon](https://console.aws.amazon.com/cloudformation/home?region=us-west-2#/stacks/new?stackName=OpenEMR&templateURL=https://s3.amazonaws.com/openemr-uswest2/OpenEMR.016.json)
  30    * [Ireland](https://console.aws.amazon.com/cloudformation/home?region=eu-west-1#/stacks/new?stackName=OpenEMR&templateURL=https://s3.amazonaws.com/openemr-euwest1/OpenEMR.016.json)
  31    * [Sydney](https://console.aws.amazon.com/cloudformation/home?region=ap-southeast-2#/stacks/new?stackName=OpenEMR&templateURL=https://s3.amazonaws.com/openemr-apsoutheast2/OpenEMR.016.json)
  32 2. Click **Next**, and configure your stack on this page.
  33    * For **DocumentStorage**, enter the size of your patient documents database in gigabytes.
  34    * For **EC2KeyPair**, select the key pair you created in the last section.
  35    * For **PatientRecords**, enter the size of your patient records database in gigabytes.
  36    * For **RDSPassword**, enter a [strong password](https://www.random.org/passwords/?num=1&len=16&format=html&rnd=new) and note it in a safe place. Note that this is the administrator's password to the MySQL database.
  37    * For **TimeZone**, select the appropriate value from [this list](http://php.net/manual/en/timezones.php). Note that this value must be exact and spaces should not be entered (e.g.: **America/New_York** is valid while **America/New York** is not).
  38
  39 3. Click **Next**, then **Next** again.
  40 4. Checkbox the acknowledgement at the bottom of the page.
  41 5. Click **Create** and wait around 15-30 minutes for your OpenEMR cloud to be installed. Note that you can proceed to the next section while this install is in progress.
  42
  43 ### Secure your Account
  44
  45 1. In the AWS Management Console, click **Services** and then click **IAM**.
  46 2. In the left pane, click **Dashboard**, and store the **IAM users sign-in link** in a safe place.
  47 3. In the left pane, click **Users**.
  48 4. Click **Add user** to the top.
  49 5. Under **Set user details**, enter your username in the **User name** field.
  50 6. Under **Select AWS access type**, checkbox only **AWS Management Console access** in the **Access type** area.
  51 7. Click **Next: Permissions**.
  52 8. Under **Set permissions for ...**, click the **Attach existing policies directly**  box.
  53 9. With the table at the bottom of the page in view, select **AdministratorAccess** (will be the first row).
  54 10. Click **Next: Review**.
  55 11. Under **Review**, ensure all information reflects the above steps.
  56 12. Click **Next: Create user**.
  57 13. Log out of the AWS console, go to the sign-in link you noted in step 2, and log in with your new credentials.