SER 2.0.0 Release Candidate 1
Keywords: 2.0.x | SER

Release candidate 1 has been thoroughly tested and also used in several commercial production environments. It has thus proven stable.

SERi 2.0 Release Candidate 1 was made available May 12, 2007. A detailed ChangeLog is available, while an overview of news can be found in the NEWS file.
Installation Instructions

You can either compile SER from the sources or install a binary package. Standard SER is fairly easy to compile, so compiling it from sources should be fine. You should have a SER 2.0 up and running in 15-30 minutes by following the procedures below!
Installing from binary packages

    * See at the end of this page for an overview of binary packages available.
    * If you have downloaded an installable package, install using rpm or the appropriate tool for your OS.
    * If you have downloaded a binary tar-package , you will get a ./usr/local directory in your current directory when you unpack it. This directory tree reflects how SER is installed in the /usr/local directory tree in a standard installation. You can choose to copy everything into /usr/local or run SER from ./usr/local.

Compiling from sources

   1.
      Download the source package.
   2.
      In the directory you want SER sources, unpack the tar archive: tar xzf seri-2.0.0-rc1_src.tar.gz
   3.
      cd ser-2.0.0-rc1
   4.
      You can choose to include different modules when compiling SER. See the INSTALL file for detailed information on options.
      The very basic configuration (without dependencies) can be compiled using: make group_include="standard" all
      Alternatives (see step 5 for instructions when installing to a different prefix than /usr/local):
      make group_include="standard mysql" all will also add the mysql database modules.
      make group_include="standard standard-dep" all will add the standard modules with dependencies (first install mysql, mysql-devel, libcurl, libcurl-devel, libxml2, and libxml2-devel packages for your OS) and if you also want to compile the standard-dep RADIUSi-based modules (for authentication and groups), you need to install radiusclient-ng first. See INSTALL file for information on dependencies per module.
   5.
      If you don't get any errors (except possibly RADIUS-modules not compiling if you include standard-dep), you are now ready to install:
      make group_include="standard" install
      Make sure you use the same group_include here as when compiling above. SER will be installed to /usr/local as default. By adding prefix=/install/to/path, you can change this. If you do, remember to also add the same prefix to make in step 4 above (to make sure that the default ser.cfg path is correct).

Creating your first configuration file

   1.
      Download the SER configuration file buildsystem. (it will later be included in SER 2.0 release, but it is external in this release candidate).
      Unpack it to where you want to maintain your configuration file (tar xzf ser.buildsystem.latest.tar.gz). You can for example use /usr/local/etc/ser. When unpacking, you get a new directory called buildsystem.
   2.
      Change directory into the buildsystem directory (cd buildsystem)
   3.
      To create your basic helloworld configuration file:
      Run ./configure and answer all the questions. You can safely accept all the defaults (in this release candidate only gettingstarted helloworld is currently supported!), except if you have installed to another prefix (same prefix as you used in make command).
   4.
      Run make and then make prefix=/path/to/your/etc/dir install (if you omit prefix, the config will be installed to /usr/local/etc/ser/
   5.
      Go to the directory where you installed the configuration file. Create a symbolic link from ser_default.cfg (the newly generated and installed configuration) to ser.cfg:
      ln -s ser_default.cfg ser.cfg
   6.
      Start SER: /usr/local/sbin/ser -f /path/to/your/etc/dir/ser.cfg  (default is again /usr/local/etc/ser/ser.cfg)
   7.
      Run /usr/local/sbin/sercmd and type ctl.listen to see if SER is running and listening. Type help to see other commands available.
   8.
      Congratulations, you have a working SER 2.0!!
      Configure a SIP client with your domain and register and start making calls :-)
      Username: anything
      AOR: anything@yourdomain.com
      Domain: yourdomain.com
      Password: anything
      Registrar: IP address of your server/public DNS name of your server
      NOTE: Not all parameters above are used for all user clients

SERCTLi 2.0 (optional, but recommended) 

   1.
      Download the SERCTL tool for controlling SER, unpack it where you want it (tar xzf serctli-2.0.0-rc1_src.tar.gz) , for example to /usr/local/sbin/ser. You need python (at least 2.3) and python-mysqld installed because SERCTL is made in python.

Beyond Hello World

    *
      sercmd is a simple tool for local control of SER, but most people have more needs, like creating domains, users, etc. SERCTL 2.0 is the tool for that. It can run both locally and remotely. 
      If you have installed ser_ctl, you can run it like this: ser_ctl -j ps (or skip ps to get a list of commands).
      If you have changed the fifo path (in buildsystem/local/common/local.m4), you need to specify -J /path/to/fifo
    *
      In the packages, you will find an etc directory with ser.cfg and ser_basic.cfg. These two files include lots of more functionality than the hello world example. Modify them to your local parameters (IP address) and try it out by changing the ser.cfg symbolic link. (These example files will probably be included in the buildsystem in the future to simplify installation and management of your configuration files.)
    *
      ser.cfg can become big and wieldy for a production setup, and the buildsystem is also there to help you manage your configuration files. Check out the buildsystem documentation.
    *
      We are working on a migration guide from 0.9.x and a reference guide. Meanwhile, you can check out the what's new to get an idea of the new features.
    *
      To find all the available commands, parameters, functions, and selects in SER 2.0, both for core and module, you can use the search tool. You can also access the module documentation directly.

How to get help and report bugs

    * Please use serusers@iptel.org to ask questions, comment on SER 2.0 or tell about your experiences and ideas.
    * If you believe you have found a bug, please register as much information as possible on the tracker. Don't worry if it is not a bug, it will be checked and either fixed or closed with a comment.

Binary Packages

For production installations, we recommend compiling from sources, but here you can find some binary packages for convenient installation.

These packages have been compiled with standard and standard-dep modules. If you can provide a binary package for inclusion here, please contact us or just add the package below. In order to create a binary package, please use: 
make group_include="standard standard-dep" all; make prefix=/tmp/usr/local group_include="standard standard-dep" install; cd /tmp;tar czf /tmp/ser-2.0.0-rc1_your_os_architecture.tar.gz usr