Practical VoIP Using VOCAL

Installing and Deploying VOCAL

Once you have finished downloading the tarball, you need to untar it, recompile VOCAL, and run the deploy script before you can test it.

Tip

All of these steps should be done as root.

Untarring VOCAL

Extract the tarball, vocal-1.3.0.tar.gz, into a temporary directory on your machine.

To untar the tarball, as root, type:

               tar -xvzf vocal-1.3.0.tar.gz

After untarring this file, we suggest deleting vocal-1.3.0.tar.gz to free up some space.

Compiling VOCAL

The source code comes uncompiled, because if we offered it as binaries, the file size (267.8 MB) would be too large for most of our community to download over the public Internet. By the way, if you have both the JRE RPM file and the VOCAL tarball on your machine, you might want to move them to /tmp or delete them to free up some disk space for compiling.

Optimizing the code

In the instructions, we recommend running make all with the CODE_OPTIMIZE=1 option. Running the make command with this option passes the -O option to the C++ compiler, which is shorthand for “enable optimization.” This works on almost every C or C++ compiler that has a command-line interface.

The gcc compiler supports the -O, -O0, -O1, -O2, and -O3 options for different levels of optimization. If you were to compile VOCAL with CODE_OPTIMIZE=2, the command would pass the -O2 option, which is a GNU C++-specific variant of -O that means “optimize more than -O.” Refer to the documentation for your compiler for more information about its optimization ...