dial-a-device

instant setup on heroku from windows

• Install Heroku Toolbelt

    https://toolbelt.heroku.com/windows
  

• Open a command shell

    git clone https://github.com/Cominch/dial-a-device
    
    cd dial-a-device
    
    heroku login
  
    heroku create
    
    heroku ...
    
    git push heroku master
  

• Open a web browser and start using dial-a-device

    http://yourappname.herokuapp.com
  

set up your own dial-a-device server on Ubuntu 13.04

• Install Ruby on Rails environment

    sudo apt-get install build-essential openssl libreadline6 libreadline6-dev curl git-core zlib1g zlib1g-dev libssl-dev libyaml-dev libsqlite3-dev sqlite3 libxml2-dev libxslt-dev autoconf libc6-dev ncurses-dev automake libtool bison subversion pkg-config cmake
  
    curl -L get.rvm.io | bash -s stable --auto
    . ~/.bash_profile
  
    rvm autolibs enable
    rvm install 1.9.3
    rvm use 1.9.3
    gem install rdoc
    gem install rails -v 3.2.13
    gem install bundler
  

• Install PostgreSQL

    sudo apt-get install postgresql libpq-dev
  

  Open the postgres console:

    sudo su postgres -c psql
  

  Perform the following postgresql command:

    CREATE ROLE lsirailsprototype SUPERUSER LOGIN PASSWORD 'lsirailsprototype';
  

  Close the postgresql console

    \q
  

  Edit /etc/postgresql/9.1/main/pg_hba.conf

    sudo nano /etc/postgresql/9.1/main/pg_hba.conf
  

  In nano, Replace line "local all all peer" by "local all all md5" (Save with CTRL+O, Enter, CTRL+X)

  Restart the postgres server

    sudo service postgresql restart
  

• Install additional libraries

    sudo apt-get install libpq-dev openbabel imagemagick
  

• Clone the project and set it up

    git clone https://github.com/Cominch/dial-a-device.git
    cd dial-a-device
    bundle install --without production
    rake db:create:all
    rake db:migrate
    rake db:seed
  

• Go!

  Start the rails server ("thin" webserver)

    RAILS_ENV=localserver rails s
  

  If rails is not detected, update your bash profile again:

    . ~/.bash_profile
  

  Open your webbrowser:

    http://localhost:3000/
  

deploy on your local server

• Customize parameters

  host name etc. in

    config/initializers/x-customization.rb
  

  mail server in

    config/environments/localserver.rb
  

• Create the background service

    rvmsudo foreman export upstart /etc/init -f Procfile.localserver -a dial-a-devie -u yourusername
  

• Enable port forwarding

    iptables -t nat -A PREROUTING -i eth0 -p tcp --dport 80 -j REDIRECT --to-port 5000
  

• Make iptables permanent

    sudo su
    iptables-save > /etc/iptables.conf
    
    nano /etc/network/interfaces
    
    -- add this line after each adapter:
    post-up iptables-restore < /etc/iptables.conf
  

deploy on heroku

• create an account on heroku and install toolbelt

  Create an account on heroku.com

  TODO: Explain how to install heroku toolbelt

    cd dial-a-device
  
    heroku login
  

• create your app on heroku

    heroku create yourappname
  
    heroku labs:enable user-env-compile
  
    heroku config:set BUNDLE_WITHOUT="development:test:localserver"
  
    heroku labs:enable websockets 
  
    heroku addons:add sendgrid
  
    heroku config:add BUILDPACK_URL=https://github.com/ddollar/heroku-buildpack-multi
  
    heroku config:add LD_LIBRARY_PATH=/app/vendor/openbabel/lib
  
    git push heroku master
  
    heroku run rake db:migrate
  
    heroku run rake db:seed
  

access legacy devices via vnc

• set up websockify gateway

    git clone https://github.com/hsanjuan/websockify
  

• fill up target list

    cd websockify
  
    nano targets
  
    ipadress:port:token
  

• add to crontab

    crontab -e
  
    append this line:
  
    @reboot cd /home/username/websockify && ./websockify :8091 --target-list ./targets
  

License

[GPLv3](http://www.gnu.org/licenses/gpl.html)