Prerequisites

From YateBTS
Jump to: navigation, search

For any operating system, there are sets of prerequisites that have to be met in order for the installation process to go smoothly. After common tools, such as GCC or Autoconf, have been installed, you need to install Yate (Yet Another Telephone Engine). Yate is used by YateBTS to summon many useful tools. The installation of Yate is also covered on this page.


Linux Prerequisites

Please note that some of the tools listed below may already be installed on your machine.

  • A Subversion (SVN) client: as root go to /usr/src or wherever you would like to store source code
  • GnuMake: GNU Make is a tool which controls the generation of executables and other non-source files of a program from the program's source files
  • Autoconf: an extensible package of M4 macros that produces shell scripts to automatically configure software source code packages
  • gcc: GNU Compiler Collection
  • libusb-1.0-0-dev: (2:0.1.12-23.3 and others) a Library for programming USB applications without the knowledge of Linux kernel internals
  • libgsm1-dev

To install any of the tools you can use the package manager specific to your distribution or one of the following commands:

For RedHat/CentOS:

 # yum install {prerequisite tool} 
 

For Debian:

 # apt-get install {prerequisite tool}

For Mageia/Mandriva:

 # urpmi {prerequisite tool}

Both YateBTS and Yate can be built from a source tarball. In this case subversion and autoconf are not needed.


Yate Installation

To install YateBTS 3 you need at least Yate version 5.3.0.

It is recommended to check if your machine has already installed an older version of Yate and, if the case, you should remove it. This can be done by:

  • using your distribution Package Manager if Yate was installed from your distro repository or
  • running make uninstall in the directory where the Yate sources are located if it was installed from sources

To install Yate proceed with the following steps:

Download Yate sources from SVN

Once you have the SVN client installed, getting the sources is simple: type the following command in your terminal:

cd /usr/src/
svn checkout http://voip.null.ro/svn/yate/trunk yate

Install Yate from SVN

Go to the directory where Yate was downloaded and run autogen.sh. This will generate the configure script that checks dependencies. Then run make install-noapi that will compile and install Yate.

Instead of make install-noapi you can use make install but make sure to install the doxygen or the kdoc package.

cd yate/
./autogen.sh
./configure
make install-noapi

Compile Yate

  • The first line will generate the configure file
  • The second line will configure the source code
  • The third line will compile the source code
./autogen.sh
./configure
sudo make
sudo make install

For additional information about Yate's installation and configuration, please see: 'Compiling and Installing Yate from SVN article or 'Begginers in Yate article.


Troubleshooting

If you get any errors when running ./configure you'll probably have to install additional packages.

Also, you should check for the lines in the output:

  • checking for gsm.h in /usr/include/... ... yes - if it says no, install libgsm1-dev (or libgsm-devel or lib64gsm-devel depending on distribution).
  • checking for libusb in /usr... yes - if it says no, install libusb-1.0-0-dev (or libusb1.0-devel or lib64usb1.0-devel)


If you try to run yate and get:

yate: error while loading shared libraries: libyate.so.5.5.1: cannot open shared object file: No such file or directory

Then run

export LD_LIBRARY_PATH=/usr/local/lib/:$LD_LIBRARY_PATH

You could now make sure you have installed a valid version of Yate by running these commands:

updatedb
locate libyate

In the output you should see what version of Yate libraries exists on your machine. If there are multiple, make sure you uninstall previous Yate versions.