4,146
edits
Changes
From Amahi Wiki
Created page with "Amahi 6 Working Notes = 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..."
Amahi 6 Working Notes
= 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-6-devel branch (and tell git to follow it on the remote server):
<code>git checkout amahi-6-devel</code>
The amahi-6-devel 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 <code>/path/to/git/clone/platform/platform</code>
* Execute <code>./hda-create-db-and-user amahi_6_devel</code>
* Go to <code>/path/to/git/clone/platform/platform/html/script</code>
* Execute <code>./db-duplicate hda_production amahi_6_devel</code>
* Go to <code>/path/to/git/clone/platform/platform/html</code>
* Execute <code>rake db:migrate</code>
Now we have a working amahi-6-devel branch which can be used to develop features, gadgets, widgets and fix bugs.
To reach the amahi-6-devel branch you need to go to <code>/path/to/git/clone/platform/platform/html</code> and execute
<code>./script/server amahi_6_devel</code>
The development dashboard can be reached with your favorite browser using the link <code>http://ip.addr.of.dev:3000</code>
To stop the development server, just hit <code>Ctrl+C</code> 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 <code>/path/to/git/clone/platform/platform/html</code>
* Execute <code>rake gadgets:install source=/path/to/the/gadget/source</code>, 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 <code>/path/to/git/clone/platform/platform/html</code>
* Execute <code>rake gadgets:uninstall source=/path/to/the/gadget/source</code>
= 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!)
= 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-6-devel branch (and tell git to follow it on the remote server):
<code>git checkout amahi-6-devel</code>
The amahi-6-devel 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 <code>/path/to/git/clone/platform/platform</code>
* Execute <code>./hda-create-db-and-user amahi_6_devel</code>
* Go to <code>/path/to/git/clone/platform/platform/html/script</code>
* Execute <code>./db-duplicate hda_production amahi_6_devel</code>
* Go to <code>/path/to/git/clone/platform/platform/html</code>
* Execute <code>rake db:migrate</code>
Now we have a working amahi-6-devel branch which can be used to develop features, gadgets, widgets and fix bugs.
To reach the amahi-6-devel branch you need to go to <code>/path/to/git/clone/platform/platform/html</code> and execute
<code>./script/server amahi_6_devel</code>
The development dashboard can be reached with your favorite browser using the link <code>http://ip.addr.of.dev:3000</code>
To stop the development server, just hit <code>Ctrl+C</code> 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 <code>/path/to/git/clone/platform/platform/html</code>
* Execute <code>rake gadgets:install source=/path/to/the/gadget/source</code>, 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 <code>/path/to/git/clone/platform/platform/html</code>
* Execute <code>rake gadgets:uninstall source=/path/to/the/gadget/source</code>
= 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!)
