Skip to content

Latest commit

 

History

History
75 lines (45 loc) · 3.23 KB

README-cloud.md

File metadata and controls

75 lines (45 loc) · 3.23 KB
Raw

UrbanFootprint Cloud Installation

These are the recommended steps for getting up and running with a demo UrbanFootprint production instance on a cloud server.

Prerequisites

You'll need:

  • A dedicated server running Ubuntu 14.04 that you have ssh access to. On AWS, we recommend "Ubuntu Server 14.04 LTS (HVM), SSD Volume Type"
  • A user account with root privileges (usually via sudo).

We recommend at least 2 CPUs and 8GB of RAM. On AWS, select t2.large or larger instance type.

Installation

We provide a "quickstart" script that handles installing all dependencies and pre-loads a sample data set.

wget https://raw.githubusercontent.com/CalthorpeAnalytics/urbanfootprint/master/quickstart.sh
chmod +x quickstart.sh
sudo ./quickstart.sh

Expect this script to take 15-20 minutes to complete. You'll know it's done when you see something like this:

********************************************************************
********************************************************************

  UrbanFootprint quickstart is complete. Open your web browser to:
    http://<YOUR-IP-HERE>/
  using the following default credentials:
    user: [email protected]
    pass: admin@uf

********************************************************************
********************************************************************

Running in Production Mode or Development Mode

By default the "quickstart" UF installation will be in Production Mode. This mode intended for using UF via the web interface, but is not suitable for active Python or JavaSscript code development. For active development you should use Development Mode, which can be switched to via:

sudo su - calthorpe # become the calthorpe user
fab -f footprint/installer localhost switch_to_dev

In development mode you will see a Sproutcore application page with a menu of available options. Select the "fp" option and

To switch back to production mode this run:

sudo su - calthorpe # become the calthorpe user
fab -f footprint/installer localhost switch_to_prod

NOTES:

Using UF

Login with the default login

The quickstart script will attempt to detect the public IP address of the server and print out a URL to use. If that doesn't work, determine the server's IP address using your cloud provider's tools and put the IP address in your web browser's location bar.

When you first access your UF instance, you will be directed to the login page. Login credentials are the following:

username: [email protected]

password: admin@uf

For information on how to create new users, please reference the User Manager section of the documentation.

User Guide

http://urbanfootprint-v1.readthedocs.io/en/latest/

Copyright (C) 2016 Calthorpe Analytics