Installation¶
Installation methods¶
The OML project comprises two distinct components:
- the OML server
- the OML client library
There are currently two ways to obtain and install OML, from our package repository or from our Git source code repository. If you get the source code, all the components can be installed at the same time. If you use our package repository, each component can be installed separately. We recommend using the Ubuntu package repository for most users. Instructions for this method are here:
If you want to make changes to OML itself, you'll need to check out the source from our Git repository. Instructions for this can be found here:
Operating system and hardware requirements¶
We develop OML for GNU/Linux systems on x86 hardware, because that's what we use for our other work. We release both x86 and amd64 packages for Ubuntu/Debian/Fedora/CentOS. OML is known to build and run on other platforms, including Mac OS X on Intel hardware, and ARM processors running Linux. It's not as well tested on those platforms though. If you've had success running OML on another combination of OS and hardware, we'd love to know about it! (Contact information here.)
About operating system limits¶
If you plan to have several hundreds of OML client applications, which will connect to the OML server to send measurements to it, then you may consider increasing the maximum open file descriptor limit for the system user which will run the oml2-server daemon. This can be done by editing /etc/security/limits.conf and adding the line:
your_oml2_user_here - nofile 100000
This allows a maximum of 100K open sockets/files per process for the user your_oml2_user_here. The default in Ubuntu is 1024. If this is not increased you may run into a problem where the oml2-server does not accept any more incoming TCP connections after its 1024th connected client.