Omnis Technical Note TNLI0004 July 2008

Setting up Omnis on Debian Linux

For Omnis Studio
by Mathias Henze, MHC Software GmbH

HINT: Get root to do all this by "sudo bash" or if you have set a root password by "su -".

NOTE: This is a very basic setup without the setup of the web client for firefox !!

Debian and Debian-like systems like Ubuntu do not support rpm directly. Omnis Software only provides the Omnis Linux package as an rpm, and the rpm just creates /usr/local/rainingdata/osXXX/osXXX.tgz - nothing else. Then you have to do the setup manually anyway.

I recommend on a Debian (-like) system to convert the RPM with "alien". First install alien:

apt-get install alien

then get the

rpm: cd /tmp
wget ftp://omnis.tech/OmnisStudio/Studio432/Studio/Development/Linux/
   Omnis-Studio-4.3.2-1.i386.rpm

and convert it:

alien -t Omnis-Studio-4.3.2-1.i386.rpm

then you get Omnis-Studio-4.3.2.tgz. Now unpack it:

tar xfz
Omnis-Studio-4.3.2-1.i386.rpm

now you should have:

/Tmp/usr/local/rainingdata/os432/
os432.tgz

To be consistent with the rest of the doc do:

mv /tmp/usr/local/rainingdata/os432/
os432.tgz /tmp
rm -rf /tmp/usr

If you have installed the RPM, move the tgz to be consistent with the rest of this doc:

mv /usr/local/rainingdata/os432/
os43.tgz /tmp

assuming that os432.tgz is located at /tmp do the following:

cd /opt
mkdir os432
cd os432
tar xfz /tmp/os432.tgz
cd ..
chmod -R ogu+rw os432

To get it running you need a start script. Do:

cat /opt/os432/os.sh <<EOF
#!/bin/sh

LD_LIBRARY_PATH=/opt/os432:
$LD_LIBRARY_PATH
export LD_LIBRARY_PATH
/opt/os432/omnis $1 $2 $3 $4 $5 $6 $7 $8
EOF
chmod +x /opt/os432/os.sh

This is the minimum. You may need other environment variables in this script set depending on what DBMS and what connector you want to use, e.g. for Oracle you need ORACLE_HOME set and you may need to extend LD_LIBRARY_PATH. You can do all this by editing:

/opt/os432/os.sh

now you can start omnis by:

/opt/os432/os.sh

To create a menu entry do:

cat > /Usr/share/applications/omnis.desktop
<<EOF
[Desktop Entry]
Name=Omnis Studio 4.3.2
Comment=Omnis Studio 4.3.2
Exec=/opt/os432/os.sh
Icon=/opt/os432/studio.png
Terminal=0
Type=Application
Encoding=UTF-8
Categories=Development;Application;
EOF

We thank Mathias Henze, founder and managing director of MHC Software GmbH based in Itzgrund in Germany for providing this tech tip. More information at: www.mhcsoftware.de