= !DomotiGaServer =
[[TracNav(TracNav/TOC)]]

== Usage ==

Very new is the !DomotiGaServer project.
It's !DomotiGa without the GUI, you can create an executable by loading it's project into Gambas IDE and choose Project -> Make -> Executable.
And save it in your domotiga directory.

Then run it from a shell with:
{{{
$ cd ~/domotiga
$ ./DomotiGaServer.gambas
2009/11/11 20:02:34   ---- Program Restart ----
2009/11/11 20:02:34 Starting DomotiGaServer V0.1.172 last updated on 2009-11-11 at 20:02:33
2009/11/11 20:02:34 Running on server (pid 11779) as user ron (id 1000) with language en_US.UTF-8
2009/11/11 20:02:34 Program base directory is '/home/ron/domotiga/'.
2009/11/11 20:02:34 Database settings are loaded from 'domotiga.conf'.
2009/11/11 20:02:34 Active logfiles are 'server-main-2009-11.log', 'server-speak-2009-11.log' and 'server-debug-2009-11.log'.
2009/11/11 20:02:34 Running on Gambas version 2.17.0
2009/11/11 20:02:34 Server uptime is  20:02:34 up 10 days, 8:41, 4 users, load average: 0.22, 0.10, 0.0
2009/11/11 20:02:34 Checking directory structure ...
2009/11/11 20:02:34 Connecting to database ...
2009/11/11 20:02:34 Loading modules ...
...
...
}}}

It will output the normal log text to stdout.

You can also give it an -d argument and it will start as a daemon, detached from the command line.
But I haven't tested that enough, had an issue with the log buffers being written to the logfiles correctly.

{{{
$ ./DomotiGaServer.gambas -d
}}}

You can stop the daemon like this, until we created a decent init.d script.
{{{
$ ps aux|grep gb
ron      11657 18.0  0.0  21676  2852 ?        Rs   19:57   0:02 gbr2 ./DomotiGaServer.gambas -d
ron      11674  0.0  0.0   3036   804 pts/2    S+   19:58   0:00 grep --color=auto gb

$ kill 11657
}}}

You can monitor !DomotiGaServer by looking at it's logfiles, those are written in !DomotiGa's normal logs directory and are called server-[main|debug|speak]-<date>.log.

Until we have build a web gui to change the program settings, you have to use the normal !DomotiGa program to do this.
From version 0.1.173 you can start the DomotiGa program in client/server mode.
Just change it's domotiga.conf to use the servers mysql and xmlrpc services.

Some notes about client/server setup between 2 different machines;
Default mysqld is connected to localhost only, so you cannot connect to it from other hosts.

Change the config file:
{{{
$ sudo vi /etc/mysql/my.conf

#
# Instead of skip-networking the default is now to listen only on
# localhost which is more compatible and is not less secure.
# bind-address            = 127.0.0.1
bind-address            = 0.0.0.0
}}}

Restart mysql server.

{{{
$ sudo /etc/init.d/mysql restart
}}}

Now you have to grant the domotiga user access to the database.

{{{
$ mysql -u root -p
Enter password: 
Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 132
Server version: 5.1.37-1ubuntu5 (Ubuntu)

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

mysql> GRANT ALL ON domotiga.* TO domouser@'%' IDENTIFIED BY 'kung-fu';
Query OK, 0 rows affected (0.00 sec)

mysql> FLUSH PRIVILEGES;
Query OK, 0 rows affected (0.00 sec)

mysql> quit
Bye
}}}

This is also a nice moment to change your mysql password from the default to your own!

== MySQL server has gone away error ==
Change wait_timeout parameter value to prevent database connection lost.
{{{
$ sudo vi /etc/mysql/my.conf
wait_timeout            = 2147483
}}}

== System Init Script ==

Egon build a system init script for Fedora 11/12, it probably works on Redhat too.

Copy tools/domotiga.fedora script to system:
{{{
$ sudo cp tools/domotiga.fedora /etc/init.d/domotiga
$ cd /etc/init.d
}}}

Edit basedir path to reflect your domotiga location:
{{{
$ sudo vi domotiga
BASEDIR=/opt/domotiga
}}}

Create a settings file so it starts in daemon mode:
{{{
sudo vi /etc/sysconfig/domotiga
OPTIONS="-d" 
}}}

Add script to startup configuration:
{{{
chkconfig --add domotiga
}}}

You can now start and stop !DomotiGaServer with:

"service domotiga start" en "service domotiga stop".