Soma-Installation-HOWTO

There are some unofficial Debian packages for the Soma Suite at http://www.somasuite.org/debian/. They are for Debian testing(codename lenny), in the i386 and amd64 architectures, and now they are from the stable release of soma (2.4) and somax (1.3). For get them you can add to your /etc/apt/sources.list the following lines:


FOR i386:
deb http://www.somasuite.org/debian/i386/debian binary/
deb-src http://www.somasuite.org/debian/i386/debian source/

FOR amd64:
deb http://www.somasuite.org/debian/amd64/debian binary/
deb-src http://www.somasuite.org/debian/amd64/debian source/

if you want to partecipate to the develop of soma packages probably you want to test them adding those lines in your sources.list file:

FOR i386:
deb http://www.somasuite.org/debian/test/i386/debian binary/
deb-src http://www.somasuite.org/debian/test/i386/debian source/

FOR amd64:
deb http://www.somasuite.org/debian/test/amd64/debian binary/
deb-src http://www.somasuite.org/debian/test/amd64/debian source/

The 2º line in booth architectures is for get the source packages only, not for get the binary ones.

Them, you can install the soma binary package by making:

apt-get update
apt-get install soma

For compile yourself the sources you need to install the following Debian packages (in Sarge, but in others (ex. Etch) is similar) for have the proper development environment:

apt-get install binutils g++ gcc make libc6-dev libssl-dev libncurses5-dev libreadline5-dev libxml2-dev openssl pkg-config

Compiling and installing soma...

Get the soma's source from the www.somasuite.org website, for example with wget (but with a web browser too) (use the proper version number):

mkdir soma
cd soma
wget www.somasuite.org/src/soma-2.4.tar.gz

Decompress the sources:

tar xvfz soma-2.4.tar.gz

Configure, compile and install the soma's sources:

cd soma-2.4
./configure --prefix=/usr --sysconfdir=/etc
make
su -c "make install"
or
sudo make install

Now you have the Soma daemon (somad) and other command line applications (somaclient, somacheck and soma-config) installed in your system. For get more information you can have a look to its manual pages (somad(1), soma-config(1), somacheck(1) and somaclient(1)).

If you want PYSOMA (the bindings for access to libsoma by the Python programming language):

apt-get install python-dev
cd /usr/src/soma-2.4
./configure --prefix=/usr --sysconfdir=/etc --enable-pysoma
make
su -c "make install"
or
sudo make install

If you want PHPSOMA (the bindings for access to libsoma by the PHP programming language):

apt-get install php4-dev
cd /usr/src/soma-2.4
./configure --prefix=/usr --sysconfdir=/etc --enable-phpsoma
make
su -c "make install"
or
sudo make install



For get more information about how to configure soma, you can see the following manual pages:

• soma.cfg(5): that have the info about the main configuration file of soma (/etc/somad/soma.cfg).
• palinsesto.cfg(5): that have the info about the system wide scheduling file (normally /etc/somad/palinsesto.cfg).
• spot.cfg(5): that have the info about the spot controller file (normally /etc/somad/spot.cfg).

Configuring soma.cfg:

Creating the soma's user:

adduser --shell /bin/false soma
cd /etc
chown soma:soma -R somad
cd somad
chmod 600 *

Getting the /etc/somad/soma.cfg config file:

mv soma.cfg_example soma.cfg

Editing the /etc/somad/soma.cfg config file with any text editor (you need at least to modify the following):

Change from:
#User = baku
to:
User = soma

From:
#Ssl = true
#Certificate = "/etc/somad/certificate.pem"
#PrivateKey = "/etc/somad/private.pem"
to:
Ssl = true
Certificate = "/etc/somad/certificate.pem"
PrivateKey? = "/etc/somad/private.pem"

From:
Password = "passwd"
to:
Password = Your_Password?

From:
PidFile? = "/var/run/somad.pid"
to:
PidFile? = "/tmp/somad.pid"

There isn't a default player for somad, you can use any command-line sound player in the "ProgramItem" tag (mplayer, alsaplayer and somaplayer are good examples). If you need some command-line options for your player, you can put them in the "OptionsItem" tag. For example they can be:

ProgramItem? = "mplayer"
OptionsItem? = "-msglevel avsync=5 -ao esd,alsa,oss, -af volnorm -novideo -noconsolecontrols -nojoystick -nolirc -nomouseinput"

Creating openssl certificates:

openssl genrsa -out private.pem 1024
openssl req -new -x509 -key private.pem -out certificate.pem
chown soma:soma certificate.pem private.pem
chmod 600 certificate.pem private.pem

Now you can run somad for test it:

somad

Soma 2.4 - Copyright (C) 2003-7 - bakunin <bakunin@autistici.org>

19 Thu 19:14:06 Build audio file trees...
19 Thu 19:14:06 Audio Files - Songs: 0 -Spot: 0
19 Thu 19:14:06 Read spot file...
I/O warning : failed to load external entity "/etc/somad/spot.cfg"
19 Thu 19:14:06 Error open spots file /etc/somad/spot.cfg
19 Thu 19:14:06 No spot file founded!
19 Thu 19:14:06 Read palinsesto file...
I/O warning : failed to load external entity "/etc/somad/palinsesto.cfg"
19 Thu 19:14:06 Error open palinsesto file /etc/somad/palinsesto.cfg
19 Thu 19:14:06 No palinsesto founded!
19 Thu 19:14:06 Somad started.

The errors are because we don't have currently any schedule file configured. So we need to stop Somad by typing CTRL + C.

Now for configure the schedule files (/etc/somad/palinsesto.cfg and /etc/somad/spot.cfg) we can edit them with any text editor (follow the palinsesto.cfg(5) and spot.cfg(5) manual pages). But we can make it too in a graphical manner if we install the SomaX package.



If you have added to your sources.list the unofficial repository of the Soma Suite Debian packages, you can install the somax binary package by making:

apt-get update
apt-get install somax

For compile yourself the SomaX sources you need to install the following Debian packages (in Sarge, but in others (ex. Etch) is similar) for have the proper development packages:

apt-get install pkg-config libgtk2.0-dev libgtksourceview-dev libgnomeprintui2.2-dev libvte-dev libsm-dev

Compiling and installing somax...

Get the somax's source from the www.somasuite.org website, for example with wget (but with a web browser too) (use the proper version number):

cd /usr/src/
wget www.somasuite.org/src/somax-1.3.tar.gz

Decompress the sources:

tar xvfz somax-1.3.tar.gz

Configure, compile and install the somax's sources:

cd somax-1.3/
./configure --prefix=/usr --sysconfdir=/etc
make
su -c "make install"
or
sudo make install

Now you have some graphical applications (somax, somax-editor, somax-nextitem and somax-config) installed in your system. For get more information you can have a look to its manual pages (somax(1), somax-editor(1), somax-nextitem(1) and somax-config(1)).

Now, we can make the proper schedule files in a graphical environment. Run somax-editor and create a new file of palinsesto (and another of spot if you wish). You have some info about how to create the palinsesto (in Spanish) and some screenshots at http://www.sindominio.net/garraxi/biltegi/ayudas/ayudagarraxi7.html. You can use too the somax-editor(1) manual page, of course.

When your palinsesto (and spot) file is O.K. move it to its default place, with the proper permisions:

cp your_palinsesto /etc/somad/palinsesto.cfg
cp your_spot /etc/somad/spot.cfg
chown soma:soma /etc/somad/*
chmod 600 /etc/somad/*

After all config files are O.K., we can run the Somad daemon (with the user "soma" because we put this in its config file) and manage it by Somax.

su soma -c somad
somax



If you have added to your sources.list the unofficial repository of the Soma Suite Debian packages, you can install the following binary packages by making:

apt-get update
apt-get install 'packagename1' 'packagename2' ...

SOMA_MYSQL:

cd /usr/src
apt-get install libmysqlclient12-dev
wget www.somasuite.org/src/soma_mysql-0.2.tar.gz
tar xvfz soma_mysql-0.2.tar.gz
cd soma_mysql-0.2/
./configure
make
su -c "make install"
or
sudo make install

SOMA_RUN:

cd /usr/src
wget www.somasuite.org/src/soma_run-0.1.tar.gz
tar xvfz soma_run-0.1.tar.gz
cd soma_run-0.1/
./configure
make
su -c "make install"
or
sudo make install

SOMAWRAPPER:

cd /usr/src
wget www.somasuite.org/src/somawrapper-0.1.tar.gz
tar xvfz somawrapper-0.1.tar.gz
cd somawrapper-0.1/
./configure --prefix=/usr --sysconfdir=/etc
make
su -c "make install"
or
sudo make install
cd /etc
mv somawrapper.cfg_example somawrapper.cfg