This section explains how to configure and run the OCALA proxy. It assumes that you obtained the OCALA binaries by unpacking the OCALA_binary_linux_A_B.tar.gz distribution.
OCALA has been tested only in Fedora and Ubuntu. For Ubuntu, please follow the extra Ubuntu/Debian specific steps given at http://rose.cs.berkeley.edu:8080/ocalawiki/HOW-TOs
Go to the directory containing the OCALA distribution. This directory should contain files like
config_files subdirectory. Type the following command (you must have Java installed)
If you do not have java 1.4.2 or higher installed, you will not see the configuration GUI. Please refer the section on "Manually Configuring OCALA" for instructions on how you can manually configure OCALA. The configuration GUI has been only tested to work with Sun Java.
Go to the directory containing the OCALA distribution (same as in the configuration step).
If this is the first time, you are running OCALA on this machine, you need to configure the tun device. With superuser permissions, type the following command:./configure_tun.pl
(Note that you need to do this only once for a particular machine.)
To start the proxy, as super user, type the following command:./OCALA_proxy -c
The proxy will now start. To kill the proxy, press Ctrl-C. The proxy uses the configuration files in the config_files sub-directory.
Try pinging your machine using the name you specified while configuring the proxy. For example,ping NAME_U_LIKE.pli3
You should get valid responses.
If you do not get any response,
it is highly likely that your local firewall is blocking the i3 UDP packets.
Please try adding a rule to your local firewall to permit UDP packets to destination port
X, where X is the value in
config_files/proxy-config.xml for the
The other option to try is use TCP instead of UDP for i3. This can be achieved by
UseTCP attribute in
If none of the above methods work, please contact support at OCALA.
You can set up OCALA to start up as a service each time Linux boots by using
installOCALA.sh script located in the
The OCALA service can be uninstalled using the
These scripts must be run with superuser privileges.