Compiling and Installing Yate on Windows

Revision as of 16:23, 21 December 2012

Installing Yate on Windows

• Download and install Yate from download page. The other option is to download Yate from CVS and to compile by yourself. You will need Visual Studio 2005 and yate-tables.zip - decompress the files to the engine\tables directory.
• Install Yate by following the setup.
• 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. 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 on 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.

See also

• Telephony