Concerto Platform AMI launch guide

przemyslawlis edited this page May 30, 2018 · 43 revisions

This installation method is now retired, not supported and it’s not recommended to use it anymore. Guide below is outdated and will it will stay like that. Please use docker-compose Installation guide for currently recommended installation method.

This guide will explain how to quickly launch your own Concerto Platform instance using a free trial server from Amazon Web Services.

Sign in to Amazon Web Services Console

  1. Sign in to Amazon Web Services console at: https://aws.amazon.com/ You will need a credit card and phone number (they will send a PIN) in order to confirm your account. At the time of writing (April 2016), Amazon allow a certain amount of free usage for 12 months after creating an account. We are going to show you how to set up a free instance so you should not be charged if you follow the instructions carefully.
  2. Go to EC2 dashboard
  3. Concerto Platform v5 AMI (Amazon Machine Image) is currently only available in EU (Ireland) region. Be sure to check in the upper-right corner if you’re on EU (Ireland) region (see screenshot below), otherwise you won’t be able to locate the AMI.
  4. Go to Instances section where you’ll be able to launch your new instance. Currently this is available by clicking on Compute, and then EC2 – Virtual Servers in the Cloud
  5. Begin the creation of a new instance by pressing the Launch Instance button

Launch Instance

  1. Choose an Amazon Machine Image (AMI)
    • Go to Community AMIs tab (see below highlighted in yellow)
    • In the search box enter: Concerto Platform v5, it should find an AMI with following full name: Concerto Platform v5 – Ubuntu 14.04 – ami-3c32b24f
    • Select the AMI by pressing Select button next to it
  2. Choose an Instance Type
    • Select any instance type from the list (notice that there should be some instance types that are eligible for free tier. If you don’t want to pay money then ensure you choose a free instance! Please note that at the time of writing [May 2016] Amazon allows up to 750 hours per month. This equates to one free tier server running continuously. If you run multiple servers then you might go over the limit and Amazon will charge you. We cannot be responsible for any charges you incur.)
    • Press Next: Configure Instance Details button
  3. Configure Instance Details
    • At the bottom, expand Advanced Details section by clicking on it
    • Make sure that User Data field is set to be entered As text
    • Paste following script into User Data:
      #!/bin/bash
      export HOME=/root
      Rscript -e "install.packages(c('catR','digest','ggplot2','jsonlite'), repos='https://www.stats.bris.ac.uk/R/')"
      sh /var/www/html/update.sh
      php /var/www/html/concerto-platform/app/console concerto:content:import --convert

      This script will update Concerto Platform to latest version and import starter content to your instance.
    • Press Next: Add Storage button
  4. Add Storage
    • Leave at defaults and press Next: Tag Instance
  5. Tag Instance
    • You should see a list of your instance tags. By default you will have a Name tag inserted. Enter a name for your instance in Value column field (e.g. “My first Concerto instance”).
    • Press Next: Configure Security Group button when you’re ready
  6. Configure Security Group
    • Select Create a new security group option
    • Enter Security group name (e.g. “Concerto security group” – basically it saves the settings you have so that when you create a new Concerto instance in future you can select this group rather than creating a new one)
    • Press Add Rule button, which will insert a new rule to your rules list
    • In newly inserted rule change its Type to HTTP
    • Press Review and Launch
  7. Review Instance Launch
    • Press Launch button
  8. Select an existing key pair or create a new key pair
    • Select Create a new key pair option
    • Enter Key pair name (e.g. “my aws concerto key pair”)
    • Press Download Key Pair
    • Your browser should automatically start to download pem file with the name you entered. Keep it somewhere safe as you will need it in the future for SSH access
    • Press Launch Instances button when done
  9. Launch Status
    • You should now be presented with a launch status page. Press View Instances button to go to the list of your instances.

Launch Concerto Platform Panel

  1. Locate your newly created instance Public IP from your instance list (see screenshot below)
  2. You can log in to your Concerto Platform Panel by using your Public IP. Let’s say your Public IP is 127.0.0.1 then your URL will be:
    http://127.0.0.1/admin
    default login: admin
    default password: admin

Congratulations! You’ve just set up your own independent server with Concerto Platform installed on it.

Tips

How to Install the Dev Branch

Concerto also has a dev branch, which has the latest development version. If you need the very latest untested possibly buggy Concerto then run the following code in the ‘configure instance details’ step:

#!/bin/bash
export HOME=/root
cd /var/www/html/concerto-platform
git fetch origin
git checkout -b dev origin/dev
Rscript -e "install.packages(c('catR','digest','ggplot2','base64enc','jsonlite'), repos='https://www.stats.bris.ac.uk/R/')"
sh /var/www/html/update.sh
php /var/www/html/concerto-platform/app/console concerto:content:import --convert

How to Install Packages

You can install any R package you want, when logged in to SSH. For example if you want to install catR R package, enter following command:

sudo Rscript -e "install.packages('catR',repos='https://www.stats.bris.ac.uk/R/')"

Amazon has a guide to logging into SSH using PuTTY