3.3. Getting the examples to run

Once you have successfully installed orbit, getting the examples to run should be fine. The examples are available by http from http://www.gnome.org/projects/ORBit2/orbit-docs.tar.gz Gunzip and untar the package, perhaps like:


bash $gunzip -c orbit-docs.tar.gz | tar -xvf -
This should build a documentation directory that contains this documentation in both sgml (docbook) and html, and an examples directory. Move to the examples directory, and go

bash $./configure
bash $cd echo
bash $make
Proceed similarly for the calculator example.

To actually run the echo example, open two windows up. Run echo-server in one and echo-client in the other (echo-server writes out the file echo.ref which echo-client reads). If you want to have fun now, compile orbit on a different machine, make echo-client on the different machine, move echo.ref from the first machine to the second and run echo-client: eh voila - client/server over tcp/ip with the same code that ran using unix sockets on a single machine.

Note

From ORBit 0.5.3, IIOP communications over IP sockets are disabled by default for security reasons. You should create an /etc/orbitrc (for a system-wide settings), or an ~/.orbitrc (for one user's setting) containing something like :


ORBIIOPUSock=1
ORBIIOPIPv4=1
ORBIIOPIPv6=0
Alternatively, you can also use command line parameters.