Compiling and Installing Yate on Windows

Revision as of 13:51, 10 January 2013

There are two ways to install Yate under Windows:

• Download and install Yate from download page.
• The other option is to download Yate from SVN and to compile by yourself

Installing Yate on Windows

Installing Yate using executable file

• Download and install Yate from download page.
• Install Yate by following the setup.

Installing Yate from SVN

Requirements

• TortoiseSVN
• Visual Studio 2005

Using Sangoma card

• If you are using a Sangoma card don't forget to first install the motherboard drivers, then Sangoma drivers, and then Yate with Sangoma drivers support. You can find a guide about how to install Sangoma on Windows for Yate. Sangoma drivers can be downloaded from http://www.sangoma.com/windows/drivers/A101_A102_API_WANPIPE/.
• If you are using Windows 2000,2003,XP then Yate will install a service. Yate can be configured by edit files from directory conf.d. More documentation about what those files should contain can be found modules page. To reload the configuration use YateGUI or remote connection to address 127.0.0.1 port 5038.

No matter how you get the sources, you must make sure the End Of Line characters are properly converted. They are stored in LF-only format in CVS and the tar.gz archives. Visual Studio needs them in CR LF style - at least for the workspace and project files. TortoiseSVN and WinZip have options to do this conversion and you must use them. If you have no other option you can open the files in Wordpad and save them.

Compiling Yate on Windows

To compile please build the "YATE" project - it will build the library and all modules without external dependencies. After taking Yate from SVN ( the URL to use is: http://voip.null.ro/svn/yate/trunk), go to windows\ folder from your "Yate" project where you will find YATE.sln that you have to build in your Visual Studio environment.

The "Extra" project holds modules that have external dependencies. You will not be able to build them without installing extra headers and libraries in your Visual Studio environment:

• h323chan needs PWLib and OpenH323, you can find more about it in page Installing OpenH323 under Windows;
• gsmcodec needs a GSM 06.10 static library;
• Qt4Client needs Qt® and its tools (MOC);
• mysqldb needs MySQL client headers and libraries;
• pgsqldb needs PostgreSQL client headers and libraries.

Problems

If you build Yate from sources and Visual Studio crashes or hangs beyond cancellation please clean the build and repeat from scratch. Already compiled object files may be good or may be damaged - just stay on the safe side.

NOTE: Compilation may fail because of WinDNS.h included from engine/Resolver.cpp - in this case you have two options:

• Install a newer WinDNS.h - for example one from Platform SDK 2008 - NAPTR records will be resolved on any Windows version that provides windns.dll
• Remove the define HAVE_DNS_NAPTR_DATA from the Libyate project - in this case NAPTR can be resolved only on older versions of Windows and only if they provide windns.dll

Please see the notes at the top of engine/Resolver.cpp for more details.

Run Yate as service on Windows

NOTE: Yate can run as service on Windows as you can see in the screenshot below.

See also

• Telephony