Compiling and Installing Yate on Windows

From Yate Documentation
(Difference between revisions)
Jump to: navigation, search
(Compiling Yate on Windows)
Line 4: Line 4:
 
* The other option is to download Yate from SVN and to compile by yourself
 
* The other option is to download Yate from SVN and to compile by yourself
  
===Installing Yate on Windows ===
+
=== Installing Yate using executable file===
 
+
==== Installing Yate using executable file====
+
  
 
* Download and install Yate from [http://yate.null.ro/pmwiki/index.php?n=Main.Download download] page.  
 
* Download and install Yate from [http://yate.null.ro/pmwiki/index.php?n=Main.Download download] page.  
 
* Install Yate by following the setup.
 
* Install Yate by following the setup.
  
====Installing Yate from SVN====
+
===Installing Yate from SVN===
  
  
'''Requirements'''
+
====Requirements====
  
 
* [http://tortoisesvn.tigris.org TortoiseSVN]
 
* [http://tortoisesvn.tigris.org TortoiseSVN]
 
* Visual Studio 2005
 
* Visual Studio 2005
  
==== Using Sangoma card====
+
====Compiling Yate on Windows====
 
+
* 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 [http://yate.null.ro/sangoma/install_sangoma.html 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. [http://tortoisesvn.tigris.org/ TortoiseSVN] and [http://www.winzip.com/ 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.
 
To compile please build the "YATE" project - it will build the library and all modules without external dependencies.
Line 50: Line 41:
 
===Run Yate as service on Windows===
 
===Run Yate as service on Windows===
  
 +
If you are using Windows 2000,2003,XP then Yate will install a service.
 
'''NOTE:''' Yate can run as service on Windows as you can see in the screenshot below.
 
'''NOTE:''' Yate can run as service on Windows as you can see in the screenshot below.
  
 
[[File:yate_windows_service.png]]
 
[[File:yate_windows_service.png]]
  
 +
===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 [http://yate.null.ro/sangoma/install_sangoma.html 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/.
 +
 +
===Configure Yate===
 +
 +
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.
  
 
'''See also'''
 
'''See also'''
  
 
*[[Telephony]]
 
*[[Telephony]]

Revision as of 15:00, 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

Contents

Installing Yate using executable file

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

Installing Yate from SVN

Requirements

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

If you are using Windows 2000,2003,XP then Yate will install a service. NOTE: Yate can run as service on Windows as you can see in the screenshot below.

Yate windows service.png

Sangoma card

Configure Yate

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.

See also

Personal tools
Namespaces

Variants
Actions
Preface
Configuration
Administrators
Developers