Ubiquiti’s UNMS on OVH Kimsufi server : tutorial

You are the proud user of a Kimsufi Server from OVH ? You certainly noticed they use their own Ubuntu Server kernel, fully incompatible with the Docker environement required for your UNMS setup…

There is an easy solution, so SSH to your Kimsufi and follow the instructions :

 sudo su
 apt-cache search linux-image-extra

Here, you’ll find the latest kernel version.
When I wrote this article, I got this :

linux-image-extra-4.8.0-22-generic - Linux kernel extra modules for version 4.8.0 on 64 bit x86 SMP
linux-image-extra-virtual - Extra drivers for Virtual Linux kernel image
linux-image-extra-4.8.0-39-generic - Linux kernel extra modules for version 4.8.0 on 64 bit x86 SMP
linux-image-extra-4.8.0-59-generic - Linux kernel extra modules for version 4.8.0 on 64 bit x86 SMP

So, 4.8.0-59 was the last kernel number, linux-image-extra-4.8.0-59-generic to be precise. In the future, you’ll get a newer image, so just replace the 4.8.0-59 with the up-to-date version number.
Now, let’s install this image on our server :

apt-get install linux-image-extra-4.8.0-59-generic
update-grub

You’ll then get something like that, just remember you MUST find the kernel you just installed, here 4.8.0-59 :

Generating grub configuration file ...

Found linux image: /boot/bzImage-3.14.32-xxxx-grs-ipv6-64
Found linux image: /boot/vmlinuz-4.8.0-59-generic
Found initrd image: /boot/initrd.img-4.8.0-59-generic
done

Let’s go on with :

fgrep menuentry /boot/grub/grub.cfg

Now, let’s change some setup, edit the Grub configuration file :

nano /etc/default/grub

and add at the bottom :

GRUB_DEFAULT="Advanced options for Ubuntu>Ubuntu, with Linux 4.8.0-59-generic"

Of course, replace the version number shown here with the kernel version you just installed. Now, let’s reboot :

reboot now

Wait few minutes, and SSH back to your server. Type :

uname -r

you’ll then see the new kernel version, not the OVH kernel :

4.8.0-59-generic

in our example, great !! Again, in the future you’ll get an updated version number, so don’t worry, you do not need to find 4.8.0-59, just something which isn’t the OVH kernel.

Now, Docker is working fine, just install UNMS :

curl -fsSL https://raw.githubusercontent.com/Ubiquiti-App/UNMS/master/install.sh > /tmp/unms_install.sh && sudo bash /tmp/unms_install.sh

and that’s it !

Now http://youserver_ip and finish the setup :