OS4X Core parallel installation

multiple separated configurations

OS4X supports parallel installation on one machine with just one license key. The license key is machine dependant, so you can re-use it in every installation.

If you plan to install more than one OS4X instance on a machine you have to:

• create a separate OS4X configuration file for each installation (os4x.conf)
• use a different web interface directory for each installation
• use a different binary installation directory for each installation (like in the above used examples, "/opt/os4x" should be copied completely). This also affects the incoming, outgoing, temporary, backup, RRD etc. directories (say: all directories which are configurable).
• Use a different MySQL database. This is an absolute MUST!

You may want to share some parts of OS4X between all instances, like the event scripts, backup directories or others (as you wish). This is done by configuring each instance to the appropriate values.

If you define the OS4X web interface to use "file" as a configuration source, all calls from the web interface will use this configured file as a parameter for all binary calls. If configured the web interface with the type „direct“, this functionality is not available, but all calls of OS4X binaries are used using the configured binary installation directory. Some scripts may need special attention if a different configuration file is used.

same configuration on multiple servers

Another solution is running OS4X receive and send queue daemons with the parameter "-i", which defines the instance of this running installation. With this parameter, all send queue entries in the configured database with the used server ID are processed. This feature allows running multiple OS4X instances on the same database with the same configuration.