Recent Changes - Search:

Documents

Download

Building

Support

Wiki Stuff

edit SideBar

Building Opal on Unix

Main.BuildingOpalUnix History

Hide minor edits - Show changes to output

Changed lines 34-35 from:
  apt install libgsm1-dev libspeex-dev libopus-dev libavcodec-dev libx264-dev libvpx-dev libtheora-dev libspandsp-dev capiutils dahdi
to:
  apt install libsrtp-dev libgsm1-dev libspeex-dev libopus-dev libavcodec-dev libx264-dev libvpx-dev libtheora-dev libspandsp-dev capiutils dahdi
Changed line 38 from:
  yum install gsm-devel speex-devel opus-devel avcodec-devel x264-devel libvpx-devel theora-devel libspandsp-devel capiutils dahdi
to:
  yum install libsrtp-devel gsm-devel speex-devel opus-devel avcodec-devel x264-devel libvpx-devel theora-devel libspandsp-devel capiutils dahdi
Changed line 38 from:
  yum install gsm-devel speex-devel opus-devel avcodec-devel x264-devel vpx-devel theora-devel libspandsp-devel capiutils dahdi
to:
  yum install gsm-devel speex-devel opus-devel avcodec-devel x264-devel libvpx-devel theora-devel libspandsp-devel capiutils dahdi
November 24, 2018, at 12:36 PM by RJJ - Update linux build dependencies
Changed lines 34-35 from:
  apt-get install libgsm1-dev libspeex-dev libopus-dev libavcodec-dev libx264-dev libvpx-dev libtheora-dev
to:
  apt install libgsm1-dev libspeex-dev libopus-dev libavcodec-dev libx264-dev libvpx-dev libtheora-dev libspandsp-dev capiutils dahdi
Changed lines 38-39 from:
  yum install gsm-devel speex-devel opus-devel avcodec-devel x264-devel vpx-devel theora-devel
to:
  yum install gsm-devel speex-devel opus-devel avcodec-devel x264-devel vpx-devel theora-devel libspandsp-devel capiutils dahdi

To use the Cisco OpenH.264 library, download http://ciscobinary.openh264.org/libopenh264-1.8.0-linux64.4.so.bz2, unzip and rename it to /usr/local/lib/libopenh264.so
Changed lines 28-33 from:
* gcc 3.2.2 or later. Earlier versions of gcc may work, but are not maintained.

* GNU @@bison@@ and @@flex@@ must be installed.

* A version of PTLib installed in a shared location
, or built in a directory pointed to by the PTLIBDIR environment variable (see [[http://wiki.opalvoip.org/index.php?n=Main.BuildingPTLibUnix|the page on building PTLib]]) for more information. Note when using local PTLib it must be configured '''and''' built '''before''' OPAL is configured.
to:
* A version of PTLib installed in a shared location, e.g. /usr/local, or built in a directory pointed to by the PTLIBDIR environment variable (see [[http://wiki.opalvoip.org/index.php?n=Main.BuildingPTLibUnix|the page on building PTLib]]) for more information. Note when using local PTLib it must be configured '''and''' built '''before''' OPAL is configured.
Added lines 31-39:

For Ubuntu etc, there are the following optional packages:

  apt-get install libgsm1-dev libspeex-dev libopus-dev libavcodec-dev libx264-dev libvpx-dev libtheora-dev

For CentOS, Fedora etc, use:

  yum install gsm-devel speex-devel opus-devel avcodec-devel x264-devel vpx-devel theora-devel

Changed lines 32-33 from:
* A version of PTLib installed in a shared location, or built in a directory pointed to by the PTLIBDIR environment variable (see [[http://wiki.opalvoip.org/index.php?n=Main.BuildingPTLibUnix|the page on building PTLib]]) for more information.
to:
* A version of PTLib installed in a shared location, or built in a directory pointed to by the PTLIBDIR environment variable (see [[http://wiki.opalvoip.org/index.php?n=Main.BuildingPTLibUnix|the page on building PTLib]]) for more information. Note when using local PTLib it must be configured '''and''' built '''before''' OPAL is configured.
Added lines 95-96:
'''IMPORTANT''': you must set the environment variable '''''before''''' executing the configure script or the system will get very confused.
Added lines 118-120:
Note that it may be necessary to add /usr/local/lib to LD_LIBRARY_PATH and set PKG_CONFIG_PATH to /usr/local/lib/pkgconfig
in order for other packages to be detected correctly.

Changed lines 10-11 from:
to:
# [[#aclocal|Editing configure.ac, and running aclocal and autoconf]]
Added lines 117-130:

[[#aclocal]]
!!4. Editing configure.ac, and running aclocal and autoconf
If you are developer, it may be necessary to modify the configure.ac file and regenerate the configure script using autoconf.

The following message may appear

  configure.ac:5: error: possibly undefined macro: dnl
        If this token and others are legitimate, please use m4_pattern_allow.
        See the Autoconf documentation.

If this occurs, then you need to regnerate the aclocal.m4 file by running the following command:

  aclocal
Changed lines 97-99 from:
   For Linux x86 32 bit    ${OPALDIR)/lib_linux_x86
  For Linux x86 64 bit    ${OPALDIR)/lib_linux_x86_64
to:
   For Linux x86 32 bit    ${OPALDIR}/lib_linux_x86
  For Linux x86 64 bit    ${OPALDIR}/lib_linux_x86_64
Changed lines 40-41 from:
It is also necessary to set the LD_LIBRARY_PATH environment variable so that programs can find the Opal libraries at link or run time.
to:

It is also necessary to set the LD_LIBRARY_PATH environment variable so that programs can find the Opal libraries at link or run time. 

If you are using plugins, the PTLIBPLUGINDIR environment variable must be set to the location of the installed plugins. By default, this is /usr/local/lib/opal-''a''.''b''.''c'', where ''a''.''b''.''c'' is the version of PTlib being used. For the current revision of Wolf, this is /usr/local/lib/opal-3.4.2, but please check your installation as the version numbers may have changed. Note that the PTLib plugin path must also be included

Changed lines 49-51 from:
to:
  export PTLIBPLUGINDIR=/usr/local/lib/ptlib-''x''.''y''.''z'':/usr/local/lib/opal-''a''.''b''.''c''

Changed lines 56-57 from:
to:
  setenv PTLIBPLUGINDIR /usr/local/lib/ptlib-''x''.''y''.''z'':/usr/local/lib/opal-''a''.''b''.''c''
Added line 93:
Changed lines 95-101 from:
to:
The correct directory name depends on the host architecture:

  For Linux x86 32 bit    ${OPALDIR)/lib_linux_x86
  For Linux x86 64 bit    ${OPALDIR)/lib_linux_x86_64

If you are using plugins, the PTLIBPLUGINDIR environment variable must be set to the location of the compiled plugins. This will be the same directory as used above for the LD_LIBRARY_PATH

Changed lines 105-106 from:
   export LD_LIBRARY_PATH=/usr/local/lib
to:
   export LD_LIBRARY_PATH=/usr/local/lib:${PTLIBDIR}/linux_x86:${OPALDIR}/lib_linux_x86
  export PTLIBPLUGINDIR=${PTLIBDIR}/lib_linux_x86:${OPALDIR}/lib_linux_x86

Changed lines 111-112 from:
   seetnv LD_LIBRARY_PATH /usr/local/lib
to:
   setenv LD_LIBRARY_PATH /usr/local/lib:${PTLIBDIR}/linux_x86:${OPALDIR)/lib_linux_x86
  setenv PTLIBPLUGINDIR ${PTLIBDIR}/lib_linux_x86:${OPALDIR}/lib_linux_x86

Changed lines 3-4 from:
This page describes how to build Opal from revision 2.4.2 (Wolf) or later. For information on building earlier releases of Opal, see [[BuildOpalPreWolf|this page]]
to:
This page describes how to build Opal from revision 3.4.2 (Wolf) or later. For information on building earlier releases of Opal, see [[BuildOpalPreWolf|this page]]
Changed lines 31-32 from:
* A version of PTLib installed in a shared location, or built in a directory pointed to by the PTLIBDIR environment variable (see [[http://wiki.opalvoip.org/index.php?n=Main.BuildingPTLibUnix|the page on building PTLib]] for more information.
to:
* A version of PTLib installed in a shared location, or built in a directory pointed to by the PTLIBDIR environment variable (see [[http://wiki.opalvoip.org/index.php?n=Main.BuildingPTLibUnix|the page on building PTLib]]) for more information.
Changed lines 31-34 from:
* A version of PTLib installed in a shared location, or built in a directory pointed to by the PTLIBDIR environment variable (see [[http://wiki.opalvoip.org/index.php?n=Main.BuildingPTLibUnix||the page on building PTLib]] for more information.

* A copy of the Opal source archive from the [[http://sourceforge.net/project/showfiles.php?group_id=204472|SourceForge download page]] or from [[http://wiki.opalvoip.org/index.php?n=Main.Subversion|Subversion]]. This is extracted into a directory referrred to as ''srcdir''
to:
* A version of PTLib installed in a shared location, or built in a directory pointed to by the PTLIBDIR environment variable (see [[http://wiki.opalvoip.org/index.php?n=Main.BuildingPTLibUnix|the page on building PTLib]] for more information.

* A copy of the Opal source archive from the [[http://sourceforge.net/project/showfiles.php?group_id=204472|SourceForge download page]] or from [[http://wiki.opalvoip.org/index.php?n=Main.Subversion | Subversion]]. This is extracted into a directory referrred to as ''srcdir''
Changed line 86 from:
This allows other libraries that use PTLib to find the code without using pkg-config.
to:
This allows other libraries that use Opal to find the code without using pkg-config.
Changed lines 8-10 from:
# [[#Downloads|Download the Opal source code]]
# [[#Build|@@configure@@ and build]]
to:
# [[#Install|Default build and install]]
# [[#Noinstall|Build and use without install]]
Changed lines 14-15 from:
Opal is built from source using @@make@@ and @@configure@@ in the same way as most other Unix programs.
to:
Opal is built from source using @@make@@ and @@configure@@ in the same way as most other Unix programs.

If you want to install Opal into a shared location accessible by all users of the system
(normally /usr/local), and you have root access, then you can use the default configure and install procedure [[#Install|Introduction]] described here.

If you want do not want to install Opal into a shared location, because you do not have root access or because you want to have
more than one version of Opal on the same host, then follow [[#Noinstall|this procedure]]
.
Changed lines 27-51 from:
* gcc 3.2.2 or later. Earlier versions of gcc may work, but are not maintained.

* A [[http://wiki.opalvoip.org/index.php?n=Main.BuildingPTLibUnix|compiled installation of PTLib]]

* A copy of the Opal source archive from the [[http://sourceforge.net/project/showfiles.php?group_id=204472|SourceForge download page]] or from [[http://wiki.opalvoip.org/index.php?n=Main.Subversion|Subversion]]

[[#Download]]
!!3. Download and install the Opal source code

Download and extract the Opal source code. For the purposes of this document, the directory that contains Opal will be indicated as ''installdir''/OPAL

[[#Build]]
!!4. @@configure@@ and build

To build the release (optimised) version of Opal, use the following commands:

--> @@cd@@ ''installdir''@@/OPAL@@
--> @@./configure@@
--> @@make opt@@

To build the debug version (includes debugging symbols) of Opal, use the following commands:

--> @@cd@@ ''installdir''@@/OPAL@@
--> @@./configure@@
--> @@make debug@@
to:
* gcc 3.2.2 or later. Earlier versions of gcc may work, but are not maintained.

* GNU @@bison@@ and @@flex@@ must be installed.

* A version of PTLib installed in a shared location, or built in a directory pointed to by the PTLIBDIR environment variable (see [[http://wiki.opalvoip.org/index.php?n=Main.BuildingPTLibUnix||the page on building PTLib]] for more information.

* A copy of the Opal source archive from the [[http://sourceforge.net/project/showfiles.php?group_id=204472|SourceForge download page]] or from [[http://wiki.opalvoip.org/index.php?n=Main.Subversion|Subversion]]. This is extracted into a directory referrred to as ''srcdir''

[[#Install]]
!!3. Default build and install

By default, Opal will install into the /usr/local tree.
In order for other packages locate Opal, the directory /usr/local/lib/pkgconfig must be added to the search path for pkg-config. This is usually done by setting the PKG_CONFIG_PATH environment variable.
It is also necessary to set the LD_LIBRARY_PATH environment variable so that programs can find the Opal libraries at link or run time.

For bash/sh

  export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig
  export LD_LIBRARY_PATH=/usr/local/lib

For tcsh/csh

  setenv PKG_CONFIG_PATH /usr/local/lib/pkgconfig
  setenv LD_LIBRARY_PATH /usr/local/lib

Use the following command to build and install the release version (optimised) as a shared library

  cd ''srcdir''
  ./configure
  make
  sudo make install

Use the following command to build and install the release version (optimised) as a static library

  cd ''srcdir''
  ./configure --disable-shared
  make
  sudo make install

Use the following command to build and install the debug version (includes debugging symbols) as a shared library

  cd ''srcdir''
  ./configure --enable-debug
  make debug
  sudo make install

Use the following command to build and install the debug version (includes debugging symbols) as a static library

  cd ''srcdir''
  ./configure --enable-debug --disable-shared
  make debug
  sudo make install

Multiple versions can be built in the same directory tree and installed separately

[[#Noinstall]]
!!3. Build and use without install

Set the OPALDIR environment variable to point to ''srcdir'' as follows.
This allows other libraries that use PTLib to find the code without using pkg-config.
It is also necessary to set the LD_LIBRARY_PATH environment variable so that programs can find the Opal libraries at link or run time.

For bash/sh

  export OPALDIR=''srcdir''
  export LD_LIBRARY_PATH=/usr/local/lib

For tcsh/csh

  setenv OPALDIR ''srcdir''
  seetnv LD_LIBRARY_PATH /usr/local/lib

Once this is done, configure and build the appropriate version of the code using the same commands
as described in section 3 above, but omit the ''sudo make install''
Changed lines 3-4 from:
This page describes how to build Opal from revision 2.4.2 (Wolf) or later. For information on building earlier releases of PTLib, see [[BuildPTLibPreWolf|this page]]
to:
This page describes how to build Opal from revision 2.4.2 (Wolf) or later. For information on building earlier releases of Opal, see [[BuildOpalPreWolf|this page]]
Added lines 3-4:
This page describes how to build Opal from revision 2.4.2 (Wolf) or later. For information on building earlier releases of PTLib, see [[BuildPTLibPreWolf|this page]]
October 31, 2007, at 10:34 AM by 202.7.166.166 -
Changed lines 33-45 from:
Enter the following commands:
[@   
     
cd ''installdir''/OPAL
     ./configure
     make opt
@]

To build the debug version
, use the following:
[@   
      cd
''installdir''/OPAL
     ./configure
     make debug
@]
to:
To build the release (optimised) version of Opal, use the following commands:

--> @@
cd@@ ''installdir''@@/OPAL@@
--> @@
./configure@@
--> @@make opt@@

To build the debug version (includes debugging symbols) of Opal
, use the following commands:

--> @@cd@@ ''installdir''@@/OPAL@@
--> @@
./configure@@
--> @@make
debug@@
October 31, 2007, at 10:15 AM by 202.7.166.166 -
Added lines 1-45:
(:title Building Opal on Unix:)

!! Contents
# [[#Introduction|Introduction]]
# [[#Prerequisites|Prerequisites]]
# [[#Downloads|Download the Opal source code]]
# [[#Build|@@configure@@ and build]]

[[#Introduction]]
!!1. Introduction

Opal is built from source using @@make@@ and @@configure@@ in the same way as most other Unix programs.

[[#Prerequisites]]
!!2. Prerequisites

You will need the following:

* gcc 3.2.2 or later. Earlier versions of gcc may work, but are not maintained.

* A [[http://wiki.opalvoip.org/index.php?n=Main.BuildingPTLibUnix|compiled installation of PTLib]]

* A copy of the Opal source archive from the [[http://sourceforge.net/project/showfiles.php?group_id=204472|SourceForge download page]] or from [[http://wiki.opalvoip.org/index.php?n=Main.Subversion|Subversion]]

[[#Download]]
!!3. Download and install the Opal source code

Download and extract the Opal source code. For the purposes of this document, the directory that contains Opal will be indicated as ''installdir''/OPAL

[[#Build]]
!!4. @@configure@@ and build

Enter the following commands:
[@   
      cd ''installdir''/OPAL
      ./configure
      make opt
@]

To build the debug version, use the following:
[@   
      cd ''installdir''/OPAL
      ./configure
      make debug
@]
Edit - History - Print - Recent Changes - Search
Page last modified on July 29, 2020, at 09:29 AM