Documentation

Documentation.Install-CompileAndInstall-1-9 History

Hide minor edits - Show changes to output

August 05, 2013, at 03:47 PM by 109.99.235.212 -
Changed line 4 from:
[- Page for other versions: [[Install-CompileAndInstall|devel]] 1.9 [[Install-CompileAndInstall-1-8|1.8]] old versions: [[Install-CompileAndInstall-1-7|1.7]] [[Install-CompileAndInstall-1-6|1.6]] [[Install-CompileAndInstall-1-5|1.5]] [[Install-CompileAndInstall-1-4|1.4]] -]
to:
(:allVersions Install-CompileAndInstall 1.9 :)
May 29, 2013, at 03:06 PM by 109.99.235.212 -
Changed lines 15-16 from:
The following page of the manual is addressed to users that want to compile and install OpenSIPS 1.9 from sources. If you have download an OpenSIPS package, than please feel free to skip this page, and install your package according to your platform ( dpkg for Debian, rpm for CentOS, etc ).
to:
The following page of the manual is addressed to users that want to compile and install OpenSIPS 1.9 from sources.
>>tip<<
If you have download an OpenSIPS package, than please feel free to skip this page, and install your package according to your platform ( dpkg for Debian, rpm for CentOS, etc ).
>><<
Changed lines 43-44 from:
make all
to:
[@
make all
@]
Changed lines 54-55 from:
apt-get install libncurses5-dev
to:
[@
apt-get install libncurses5-dev
@]
Changed lines 59-60 from:
make menuconfig
to:
[@
make menuconfig
@]
Changed lines 82-84 from:
make install
to:
[@
make install
@]
May 29, 2013, at 03:03 PM by 109.99.235.212 -
Added lines 1-82:
!!!!Documentation -> [[Documentation.Manuals|Manuals]] -> [[Documentation.Manual-1-9 |Manual 1.9]] -> Compile And Install
(:title Compile and Install - ver 1.9 :)
----
[- Page for other versions: [[Install-CompileAndInstall|devel]] 1.9 [[Install-CompileAndInstall-1-8|1.8]] old versions: [[Install-CompileAndInstall-1-7|1.7]] [[Install-CompileAndInstall-1-6|1.6]] [[Install-CompileAndInstall-1-5|1.5]] [[Install-CompileAndInstall-1-4|1.4]] -]

\\

|| %color=#185662%[+'''Compile and Install v1.9'''+]%% ||

||[[Install-Download-1-9|Prev]] || [[Install-DBDeployment-1-9|Next]]||
----

(:toc-float Table of Content:)

The following page of the manual is addressed to users that want to compile and install OpenSIPS 1.9 from sources. If you have download an OpenSIPS package, than please feel free to skip this page, and install your package according to your platform ( dpkg for Debian, rpm for CentOS, etc ).

Go for the '''OpenSIPS''' [[http://opensips.svn.sourceforge.net/viewvc/opensips/branches/1.9/INSTALL | install instructions]] - this is a link directly to the INSTALL file from the SVN repository, which contains the up-to-date version.

The INSTALL file provides information about:

# Supported Architectures and Requirements
# Howto Build OpenSIPS From Source Distribution
# Quick-Start Installation Guide
## Getting Help
## Disclaimers
## Quick Start
## OpenSIPS with Persistent Data Storage
# Troubleshooting


----

!!! Video Tutorial

The OpenSIPS team has held a webinar, which will guide you through the process of doing a quick installation of OpenSIPS ( downloading sources, compiling, installing, etc ) and OpenSIPS Control Panel ( installing, provisioning users ), and will show you what you have to do in order to get a fully functional platform in a matter of minutes. If you find video tutorials easier that text based ones, please feel free to go to the [[ Documentation/Tutorials-GettingStarted | OpenSIPS Installation Webinar ]] page and download the webinar recording.

!!! Compile

Navigate to the OpenSIPS sources root folder. From this folder you can simply run
make all

and the OpenSIPS core, along with all it's configured modules, will be compiled.

!!!! Configuring Compilation Flags

OpenSIPS has various compile-time options, that affect it's capabilities. For example, you can opt to enable the memory debugging allocator, or to enable TLS ( which is by default disabled ), etc.

In order to change such compile-time options, you should use the 'menuconfig' tool. Since the menuconfig tool is curses-based, before attempting to run it you should install the ncurses development library. On Debian based system, you can usually do this by running
apt-get install libncurses5-dev

After that you can go to the OpenSIPS sources root folder, and run
make menuconfig

Navigate to the 'Configure Compile Options' menu, Here you can simply use the arrows keys ( UP + DOWN ) to go through all the Options ( they are explained briefly at the bottom of the console ). Enabling or disabling an option is done via the SpaceBar key. After finishing your configurations, you can go back via the 'q' key and then hit 'Save Changes'.

After any changes to the Compilation Flags, you should re-compile & re-install your OpenSIPS.

!!!! Compiling Modules with External Dependencies

There are some OpenSIPS modules which are not compiled by default, since they require external dependencies which may or not come by default on your system. Thus, such modules require your manual attention when downloading & installing from sources. Some examples of such modules are DB_MYSQL ( depends on the mysql devel library ), JSON ( depends on the external JSON parser ), etc.

To enable the compilation of such modules, you should use the menuconfig tool as well.

Run 'make menuconfig' from the OpenSIPS sources root folder, and then go to 'Configure Excluded Modules'. In that section you will see the list of all the modules that are not enabled by default, along with a brief explanation of the module functionality shown at the bottom of the console.

Enabling / disabling a specific module is done with the SpaceBar key. Once you have selected all your needed modules, you should hit the 'q' key in order to go back to the previous menu, and then hit 'Save Changes'. The tool will display that you have enabled certain modules, and it will tell you what are the dependencies that you need to install in order to succesfully compile the modules.

After any changes to the Compilation Flags, you should re-compile & re-install your OpenSIPS.

!!! Install

In order to install OpenSIPS, go to the sources root folder and run
make install

By default, OpenSIPS will be installed in the / directory.

!!!! Configuring Install Path

Sometimes, you might want to change the OpenSIPS installation path, due to various reasons ( like having to deploy two OpenSIPS instances on the same machine ).
In order to do that, you should have to use the menuconfig tool.

Run 'make menuconfig' and go to 'Configure Install Prefix'. Then type in your custom OpenSIPS installation directory and hit enter. Then navigate down to 'Save Changes' and hit enter. Afterwards you can do 'make install' again and OpenSIPS will be deployed in your newly configured directory.

Page last modified on August 05, 2013, at 03:47 PM