IXP Manager Install Scripts
This directory contains officially supported install scripts for IXP Manager. The file names will denote the target platform on the IXP Manager branch.
These install scripts are opinionated! They are intended to run exactly as specified and only on the operating system they are targeted at.
IXP Manager v4 on Ubuntu LTS 16.04
The recommended platform for the v4 branch of IXP Manager is Ubuntu LTS 16.04.
To install on this platform, please proceed as follows:
- Prepare a physical / virtual machine with (minimum) 8GB of disk space and 2GB of RAM. We recommend LVM so so partitions can be grown on the fly.
- Attach / insert the latest Ubuntu 16.04 LTS 64-bit PC (AMD64) server install image and boot.
- At the initial menu where you choose Install Ubuntu Server, first:
- Press F4
- If installing on a physical server, select Install a minimum system
- If installing on a virtual server, select Install a minimal virtual machine
- Now select Install Ubuntu Server and step through the various options and configure as you like until:
- When you reach the Software selection screen, select only
OpenSSH Serverand then complete the installation and reboot.
- When your new server has rebooted, log in and:
# change to root user sudo su - # download the installation script wget https://github.com/inex/IXP-Manager/raw/master/tools/installers/ubuntu-lts-1604-ixp-manager-v4.sh # and execute it: bash ./ubuntu-lts-1604-ixp-manager-v4.sh
The install script can be tested using Vagrant. Assuming you have Vagrant installed and have cloned the IXP Manager GitHub repository to
cd $IXPMDIR/tools/installers cp Vagrantfile.ubuntu-lts-1604-ixp-manager-v4 Vagrantfile vagrant up
Vagrant should run
ubuntu-lts-1604-ixp-manager-v4.sh --no-interaction as part of its bootstrapping and you should be able to access the resultant IXP Manager install at: http://localhost:8080/ (after ~10 mins).
However, for an as yet unknown reason, the bootstrapping fails. Instead, you can log in with
vagrant ssh and kick off the installer using:
sudo /tmp/vagrant-shell --no-interaction
If you need assistance with this, please post the contents of
/tmp/ixp-manager-install.log to an online pastebin and then send an email to the IXP Manager mailing list.