Tailoring The Configurations

How To Tailor The Configurations

Now that you have tried the buildsystem, you need to know how to make changes that will modify your seri.cfgs to do what you want.  Obviously, you can run configure again, either using ./configure default new (to explicitly say that you want to overwrite your previous configuration) or by creating a new server configuration using ./configure newconfig. Each time you run configure with a parameter, a new directory under local/ will be created for your configuration. And when you run make to generate a new configuration file, you use the name of the configuration you want to build, ex. make newconfig.  The buildsystem will then use the configurations found in local/common and local/newconfig to create a new SERi configuration file called ser_newconfig.cfg (and if you don't specify a config, you now know that default will be used and ser_default.cfg will be created.)

So, each time you run make the configurations found in local/common/ and local/default/ (or your specified configuration) will be used to create a new configuration file. Thus, there are two main configuration files that control how your ser.cfg will be created: common/local.m4 and default/config.m4.

local.m4:
This file controls the overall functionality and things like debugging, logging etc. What you find here are recommended values for most setups. For new releases of SER and the buildsystem, a new local.m4 will be made available to you. If you want to tweak these settings, you will have to do the same tweaks for this new local.m4.
The original local.m4 can be found in templates/site/common/

config.m4:
This file contains all the server-specific configuration parameters and is thus the most important configuration file. It is automatically generated from the configure script and once you have generated it, you will normally not use configure, but rather edit config.m4 directly.  For new SER releases, the migration guide will specify which configurations must be added or changed. This makes it easy for you to adapt your local server configurations to a new version.

DO NOT EDIT files in the templates/ directory tree!!! These files will be changed and by just replacing templates/ with an updated version, you can auto-generate your server configuration files with all the updates.