STEP 1: Locate the config_files directory. This directory contains all the configuration files used by OCALA.
Windows Binary Distribution: If you are using the Windows binary distribution of OCALA (i.e. you installed OCALA from OCALA_Setup.exe), the config_files subdirectory is located in C:\Program Files\OCALA, unless you specified a different installation directory when running the setup program.
Windows Source Distribution: If you are compiling OCALA from source in Windows, the config_files directory will be in OCALA/visual_studio/Debug or in OCALA/visual_studio/Release, depending on the compilation mode.
Linux or Mac OS X: If you are running the proxy manually on Linux or Mac OS X, the config_files directory will be in the OCALA/generic_proxy subdirectory within the directory created when you untarred the OCALA source distribution.
Linux Service: If you are running OCALA as a Linux service, the config_files directory will be in /usr/local/OCALA.
STEP 2: Set up an i3 name for your machine. This step is essential if you want to leverage i3 to access this machine, if it is located behind a NAT. You will use the name set up in this step to refer to your machine.
You need to change only the file myNames.xml. Add the following XML snippet in between the <MyNameList> start and end tags.
<MyName
name="REPLACE_WITH_YOUR_CHOICE.pli3"
ocdId="pli3"
active="true"
i3TriggerType="public"
/>
STEP 3: If you want use OCALA Secure Connection, add a rule of the form given below to outbound.xml. The following rule says that all connections to all URLs ending in .gov should be secure by OCALA Secure Connection. You may add multiple such XML snippets with different url patterns. For example, if you want all your traffic to be secured, you can use * as the urlPattern.
<PathInfo >
<Match urlPattern = "*.gov" />
<Security protocol = "customSSL" mode = "endhostonly" />
<Compression algo = "zlib" level = "5" />
<FakeAddressNegotiation preference = "not necessary" />
<Hop overlayId = "rspTunnelOCD" hopEndPointName = "ocalarsp.closestnode.com" />
<Hop overlayId = "ipv4" authenticate="no"/>
</PathInfo>
STEP 4: That's it! You have configured OCALA. You can now restart OCALA. Make sure to look out for error messages in the appropriate debug files, just in case you made a typo.
We strongly recommend installing the latest version from java.sun.com. Java will surely be a useful software to have installed on your machine.