Amahi Edge

From Amahi Wiki
Jump to: navigation, search

Amahi Edge is the developer version of Amahi, with the very latest and greatest code in it. It lives in a branch of the Amahi Git repo, called

  amahi-edge

This page is about working notes for the latest in the development tree.

How to Get Amahi Edge Running

First you need to get the latest git repository (see how on the Contribute-page)

After you've got the latest master branch you need to switch to the amahi-edge branch (and tell git to follow it on the remote server):

git checkout amahi-edge

The amahi-edge code uses a different database for it's data so we need to create one, copy the production data in it and migrate it to the new datamodel:

  • Go to /path/to/git/clone/platform/platform
  • Execute ./hda-create-db-and-user amahi_devel
  • Go to /path/to/git/clone/platform/platform/html/script
  • Execute ./db-duplicate hda_production amahi_devel
  • Go to /path/to/git/clone/platform/platform/html
  • Execute rake db:migrate

Now we have a working amahi-edge branch which can be used to develop features, gadgets, widgets and fix bugs.

To reach the amahi-edge branch you need to go to /path/to/git/clone/platform/platform/html and execute

./script/server

The development dashboard can be reached with your favorite browser using the link http://ip.addr.of.dev:3000

Or simply:

  http://localhost:3000

To stop the development server, just hit Ctrl+C in the terminal where you started the server.

How to install one Gadget

If you have developed a new gadget or fixed some bugs on an existing one you can install it using:

  • Go to /path/to/git/clone/platform/platform/html
  • Execute rake gadgets:install source=/path/to/the/gadget/source, e.g.
         rake gadgets:install source=../../gadgets/gadget_last_modified_files

When there are errors after installing the gadget you can uninstall it using:

  • Go to /path/to/git/clone/platform/platform/html
  • Execute rake gadgets:uninstall source=/path/to/the/gadget/source


Step by step tutorial for setting up the new Amahi-7 Ruby on Rails developer code

This tut assumes you have Ruby and rails installed as a normal user and a directory for new projects somewhere in your home directory.

1) download the latest tarball from http://alpha.amahi.org/tmp/ 2) extract the tarball into your user folder use tar or your file manager-extract function 3) then cd /amahi-7 ; bundle install; rake db:create; rake db:migrate; rails s

Tips

  • Start with VM with snapshots. Take a snapshot of your VM to begin, in case you have to revert
  • If you do not have a VM, take a snapshot of your development database. You can use ./script/db-duplicate and ./script/db-restore (use with care!)