-
Notifications
You must be signed in to change notification settings - Fork 32
/
INSTALL
158 lines (111 loc) · 4.76 KB
/
INSTALL
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
BUILD REQUIREMENTS
==================
The UniMRCP project depends on a number of third party tools and libraries which must be installed first.
All the required dependencies are available to download prepackaged for the UniMRCP use from the
following location:
http://www.unimrcp.org/downloads/dependencies
Alternatively, original versions of the libraries as well as patches on them can be downloaded
separately from the following location:
http://www.unimrcp.org/dependencies
References:
1. Apache Portable Runtime [>=1.2.x] (http://apr.apache.org).
In order to build any part of the UniMRCP project, the Apache Portable Runtime (APR) and
the APR Utility (APR-util) libraries are required. The libraries provide a consistent interface to
underlying platform-specific implementations.
2. Sofia-SIP [>=1.12.6] (http://sofia-sip.sourceforge.net).
Sofia-SIP is an open-source SIP User-Agent library, compliant with the IETF RFC3261 specification.
The library is utilized for implementation of SIP signaling for MRCPv2. The SDP message parser is
also used for both MRCPv2 (SIP/SDP) and MRCPv1 (RTSP/SDP).
GNU BUILD
=========
Prerequisites:
autoconf 2.59 or newer
automake
libtool 1.4 or newer
gcc
pkg-config
Procedure:
If the UniMRCP source is checked out from the repository, the "bootstrap" script must be run first
in order to generate the "configure" script and other required files.
./bootstrap
The usual "configure", "make", "make install" sequence of commands should follow in order to build
and install the project from source.
./configure
make
make install
As a result, the project will be installed in the directory "/usr/local/unimrcp" with the following
layout:
bin binaries (unimrcpserver, unimrcpclient, ...)
conf configuration files (unimrcpserver.xml, unimrcpclient.xml, ...)
data data files
include header files
lib shared (convenience) libraries
log log files
plugin run-time loadable modules
There are a couple of options which can additionally be configured.
In order to specify where to look for the APR and APR-util libraries, use the "--with-apr=" and
"--with-apr-util=" options respectively. For example:
./configure --with-apr=/usr/local/apr --with-apr-util=/usr/local/apr
In order to specify where to look for the Sofia-SIP library, use the "--with-sofia-sip=" option.
For example:
./configure --with-sofia-sip=/usr/local/sofia-sip
In order to generate executables and shared libraries for x86-64 architecture, use the "-m64"
option as follows:
CFLAGS=-m64 CXXFLAGS=-m64 LDFLAGS=-m64 ./configure
In order to generate executables and shared libraries for i386 architecture, use the "-m32" option
as follows:
CFLAGS=-m32 CXXFLAGS=-m32 LDFLAGS=-m32 ./configure
In order to install the default configuration, use the following commands:
cd conf
make def-conf
In order to install the default data files, use the following commands:
cd data
make def-data
In order to build a Doxygen generated documentation, use the following command:
make dox
WINDOWS BUILD
=============
Prerequisites:
Microsoft Visual Studio 2005 or 2010.
One-time pre-build setup: [optional]
This step can be skipped if the dependencies are installed in their default locations. Otherwise,
the paths in the corresponding property sheets must be modified accordingly. Below is the content
of property sheets for Visual Studio 2005, which are located in the directory "build/vsprops".
Similarly, property sheets for Visual Studio 2010 can be found in the directory "build/props".
apr.vsprops
<UserMacro
Name="AprDir"
Value="$(SolutionDir)libs\apr"
/>
<UserMacro
Name="AprUtilDir"
Value="$(SolutionDir)libs\apr-util"
/>
sofiasip.vsprops
<UserMacro
Name="SofiaDir"
Value="$(SolutionDir)libs\sofia-sip"
/>
Procedure:
1. Open one of the available solution files:
* for Visual Studio 2005, use unimrcp.sln,
* for Visual Studio 2010, use unimrcp-2010.sln.
2. Choose a platform (Build -> Configuration Manager):
* win32
* x64.
3. Choose a configuration (Build -> Configuration Manager):
* Debug
* Release.
4. Build the solution (Build -> Build Solution).
One-time output directory setup:
Build the "prepare.vcproj" utility project by right clicking on the project icon from the Solution
Explorer (tools->prepare) and selecting the Build command from the context menu. This routine will
setup the output directory and copy all the required APR, APR-Util, and Sofia-SIP libraries as well
as the default configuration and data files. As a result, the output directory layout will look
like the following:
bin binaries (unimrcpserver, unimrcpclient, ...) and all the required dlls
conf configuration files (unimrcpserver.xml, unimrcpclient.xml, ...)
data data files
lib libraries
log log files
plugin run-time loadable modules