Project

General

Profile

Install

Requirements

In order to run DomotiGa you need a working Gambas 2 environment.
With the current DomotiGa code you the latest version which is 2.24.0 (install it from the svn repository if you pkg system doesn't have it)
Look here how to install it on your system.

Note: We are currently starting to port all of DomotiGa's code to Gambas 3.
Gambas 3 is not ready for production yet, but you can install it next to Gambas 2 and start playing with it.
If you want instructions on how to install Gambas 3, look here.

Howto Install DomotiGa

Login as the user you want to run DomotiGa as, Do not use root! It's a security risk!
Then create an installation directory in your home directroy and download a the latest release of DomotiGa with svn.

$ mkdir -p  ~/install
$ cd ~/install

$ git clone https://github.com/DomotiGa/DomotiGa.git domotiga

This will create a new directory called 'DomotiGa' with all code in it.

Copy these files over to your home dir and work from there, otherwise an update of the svn will overwrite your files.

$ cp -rp ~/install/domotiga ~
$ cd ~/domotiga
$ rm -rf `find . -type d -name .git`

Last command deletes all hidden .git directories.

Create DomotiGa Database

If you start the DomotiGa GUI and it can't find a database it will ask if you want to install the database for you.

If you run DomotiGaServer only you can create and import a database manually as described below.

You need to create and import the example database, for this you need your mysql root password.

Note: Ubuntu/Debian asks for this password when you are installing mysql-server package, so you can skip this step.
Configure your MySQL Install:

If this is the first time you use a MySQL database on this machine, please set a MySQL root account password first:

$ mysqladmin -u root password "yourpassword" (without quotes)

DomotiGa uses a default database name, username and password as supplied in domotiga.sql, if you want to use different ones
you need to edit the file domotiga.conf before starting the program.

Next create and import the Domotiga example database:

$ mysqladmin -u root -p create domotiga
$ mysql -u root -p domotiga  <~/domotiga/install/domotiga.sql

Now you can start Gambas2 IDE and Open Project, browse to ~/domotiga/DomotiGa and open it.
Start the project to run DomotiGa.

You can also create a shortcut/launcher which starts DomotiGa directly.
See the README inside the domotiga directory.

(you have to compile/create executable of the project first if you have made changes to the source code)

Update your DomotiGa from svn

Goto your svn repos you have downloaded before, for example.

$ cd ~/install/domotiga
$ git pull origin

Make a backup of your old code directory.

$ cp -rp ~/domotiga ~/domotiga.backup

Make a backup of your database.
Use Menu Tools -> Database Admin -> Backup

Or run from cli.

$ mysqldump -u root -p domotiga >domotiga-backup.sql

You can also download a new tree ofcourse.
If you installed domotiga under your home directory, copy the new files over.
$ cp -rp ~/install/domotiga ~
$ cd ~/domotiga
$ rm -rf `find . -type d -name .git`

Now restart DomotiGa, it will update your database automatically to the latest version.
It's also a good idea to compile a new executable, because the latest small changes are not already in there.

$ gambas2

Load DomotiGa or DomotiGaServer project from ~/domotiga/..
Select menu Project -> Make -> Executable
Save to domotiga directory.

Related Resources

    Updated by: jessekerkhoven, Updated over 5 years ago
    Access count: 88809 since 2011-08-25

    Attached Files

    Also available in: PDF HTML TXT