Following describes how to install ORBit2 on a Linux machine:
1: set up PKG_CONFIG_PATH enviroment variable
* it is better to set this variable in a .bashrc (or similar one depending on which shell you are using).
>export PKG_CONFIG_PATH=$HOME/orbit2/lib/pkgconfig
2: install glib library
2.1 download glib from ftp://ftp.gnome.org/pub/gnome/sources/glib/ to $HOME/temp. (assuming we download glib-2.8.5.tar.gz)
2.2 install glib
>cd $HOME/temp
>gunzip glib-2.8.5.tar.gz
>tar -xvf glib-2.8.5.tar
>cd glib-2.8.5
>./configure --prefix=$HOME/orbit2 <----important ! we will install all libraries under $HOME/orbit2
>make
>make install
3. install libIDL library
3.1 download libIDL from http://ftp.gnome.org/pub/GNOME/sources/libIDL/ to $HOME/temp. (assuming we download libIDL-0.8.5.tar.gz)
3.2 install libIDL
>cd $HOME/temp
>gunzip libIDL-0.8.5.tar.gz
>tar -xvf libIDL-0.8.5.tar
>cd libIDL-0.8.5
>./configure --prefix=$HOME/orbit2
>make
>make install
4. install ORBit2
4.1 download ORBit2 source from ftp://ftp.gnome.org/pub/gnome/sources/ORBit2/ to $HOME/orbit2/src. (assuming we download ORBit2-2.13.1.tar.gz)
4.2 install ORBit2
>cd $HOME/src
>gunzip ORBit2-2.13.1.tar.gz
>tar -xvf ORBit2-2.13.1.tar
>cd ORBit2-2.13.1
>If you want to build ORBit2 in Eclipse later, edit configure file by changing "LT_VERSION=1:0:1" to "LT_VERSION=1"
>./configure --prefix=$HOME/orbit2
>make
>make install
5. test ORBit2
5.1 export LD_LIBRARY_PATH to be $HOME/orbit2/lib
>export LD_LIBRARY_PATH=$HOME/orbit2/lib
5.2 download the example from the Beginners Documentation http://www.gnome.org/projects/ORBit2/orbit-docs.tar.gz to $HOME/orbit2/examples
5.3 install orbit-docs.tar.gz
>cd $HOME/orbit2/examples
>gunzip orbit-docs.tar.gz
>tar -xvf orbit-docs.tar
>cd orbit-docs
>cd examples
>cd echo
>export PREFIX=$HOME/orbit2
>make
>ldd echo-server
if you see something like: (assuming $HOME is /home/mwgong )
libORBitCosNaming-2.so.1 => /home/mwgong/orbit2/lib/libORBitCosNaming-2.so.1 (0x40017000)
libORBit-2.so.1 => /home/mwgong/orbit2/lib/libORBit-2.so.1 (0x4001b000)
libm.so.6 => /lib/tls/libm.so.6 (0x40076000)
libgmodule-2.0.so.0 => /home/mwgong/orbit2/lib/libgmodule-2.0.so.0 (0x40098000)
libdl.so.2 => /lib/libdl.so.2 (0x4009c000)
libgthread-2.0.so.0 => /home/mwgong/orbit2/lib/libgthread-2.0.so.0 (0x400a0000)
libglib-2.0.so.0 => /home/mwgong/orbit2/lib/libglib-2.0.so.0 (0x400a4000)
libpthread.so.0 => /lib/tls/libpthread.so.0 (0x40122000)
libc.so.6 => /lib/tls/libc.so.6 (0x42000000)
libgobject-2.0.so.0 => /home/mwgong/orbit2/lib/libgobject-2.0.so.0 (0x40130000)
libpopt.so.0 => /usr/lib/libpopt.so.0 (0x40161000)
/lib/ld-linux.so.2 => /lib/ld-linux.so.2 (0x40000000)
then your ORBit2 is built successfully and ready to be called.
5.4 test ORBit2:
>./echo-server
Writing service reference to: echo.ref
open another teminal
>export LD_LIBRARY_PATH=$HOME/orbit2/lib
>cd $HOME/orbit2/examples/orbit-docs/examples/echo/
>./echo-client
Reading service reference from file "echo.ref"
Type messages to the server
a single dot in line will terminate input
If you type a "abc", and press Enter, then "abc" will be shown on the terminal where "echo-server" is running.
You could type "." to terminate the input from client.
You could type CTRL-C to stop echo-server in its terminal.
6. How to build ORBit2 in Eclipse ?
You could build ORBit2 as a C project with a Standard Makefile. The Makefile is the one in the $HOME/orbit2/src/ORBit2-2.13.1/.
7. How to build a traceable ORBit2 ?
Run configure with "--enable-debug" and rebuild ORBit2.
Do "export ORBIT2_DEBUG=traces:giop" before running the server or client.