This documents how to build your own ISO, complete with custom kickstart (system default configuration), set of RPM and splash screens.
Step 1. Download base CentOS base ISOs
Download the first CD ISO image from the CentOS operating system for 32 and/or 64 bit. Mirror lists are here
Put the ISOs into a single directory and do not rename them, In this example we'll use ~/downloads/centos
Step 2. Download or build sipXecs RPMS
Obtain a copy of all the RPMs needed to install sipXecs including the rpms built from the ./lib directory such as ruby-postgres, sipx-freeswitch, etc. into a directory. It can be organized anyway you want, in fact it can be a directory that also acts as a yum repository. For this example, we'll put these into ~/build/sipxecs
Step 3. Configure
Run the standard script to setup the configuration script
Then run configure pointing to your CentOS ISO and sipXecs rpms. In our example this will be.
Step 4. Build
If you're building RPMS, go ahead and run your target. For example
make distro.centos-5-x86_64.rpm distro.centos-5-i386.rpm.
Step 5. Build ISO
Unfortunately the make process needs to mount the ISO and unless you configure mount only root can do that.
if you want to just build the 32 bit or the 64 bit ISO, you can run
make iso-32 or
make iso-64 respectively.
Step 6. Contribute
If you have can changes you'd like to submit back, please post on sipx-dev mailing list and/or initiate git pull requests.
Reasons to customize the ISO
- ISO makes a lot of assumptions about your system. US locale for example, size of the disk for auto-formatting is greater than 13GB, the default size of the partitons, etc. To change these, you must customize the ISO
- If you want to brand the ISO with your company logos, colors or welcome messages
- If you want to include extra RPMs by default
If you don't you'll produce the standard SIPfoundry ISO and may be all that you desire. If you do decide to customize, then create a separate directory to hold your custom files and configure your build to use this directory. For example ./configure ... OEM_DIR=~/work/ezuce
Contents of ~/work/ezuce
iso.mak.in - override various make variables used to create the ISO. See Makefile.in for a list of all the variables you could override. Here is an example
oem.m4 - Contains M4 macros that you can use to extend the kickstart file. Look in ks.m4 for an idea of the hooks that are currently in place you can alter. Here is an example
splash.lss - this is a graphic that is the initial splash screen and is in a format that is not well supported, but google around for how to edit this file on your OS.