Linux

Linux
Prev	Binary Distribution	Next

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.

Note

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

STEP 1: Configuring OCALA

Go to the directory containing the OCALA distribution. This directory should contain files like OCALA_proxy, ProxyConfig.jar and config_files subdirectory. Type the following command (you must have Java installed)

java -cp . -jar ProxyConfig.jar or configureOCALA.sh

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.

STEP 2: Running OCALA

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.

STEP 3: Testing

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.

Testing Failed: What do I do?

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 I3_LocalPortNum attribute.

The other option to try is use TCP instead of UDP for i3. This can be achieved by setting the UseTCP attribute in config_files/i3-cfg.xml to true.

If none of the above methods work, please contact support at OCALA.

STEP 4: Installing/Uninstalling OCALA

You can set up OCALA to start up as a service each time Linux boots by using installOCALA.sh script located in the OCALA_Suite directory. The OCALA service can be uninstalled using the uninstallOCALA.sh script. These scripts must be run with superuser privileges.