Getting started¶
Install external dependencies¶
mr-provisioner requires the following external dependencies to be installed:
- virtualenv
- python-pip
- ipmitool
Additionally, mr-provisioner also relies on the following external services:
- postgresql
- tftp-http-proxy
- ws-subprocess
Create a virtual env¶
Set up a virtual environment to run the application:
virtualenv --python=python3 env
NOTE: Make sure to specify python 3 if your system doesn’t use it by detault (-p PYTHON_EXE)
After that, activate the virtual env:
source env/bin/activate
Install requirements¶
First, make sure the virtual env is activated (see above). Then, install the required python dependencies by running:
pip install -r requirements.txt
Configuration file¶
Copy the example configuration file from examples/config.ini to a location of your chosing, and adjust it according to your needs. At the least, you will have to configure the database uri and the TFTPRoot setting.
See Configuration options for more information.
Set up database¶
Create a new database and user for mr-provisioner if you haven’t already set one up:
sudo -u postgres -s
psql
CREATE DATABASE <dbname>;
CREATE ROLE <username> WITH PASSWORD '<password>' LOGIN;
GRANT ALL PRIVILEGES ON DATABASE <dbname> TO <username>;
Create the required tables by running the database migrations:
./run.py -c /path/to/your/config.ini db upgrade
After this, a first user called admin with password linaro will be available.
Run the app¶
First, make sure the virtual env is activated in the current shell.
Start up ws-subprocess:
/path/to/ws-subprocess -controller-url "http://localhost:5000/admin/ws-subprocess" -listen "0.0.0.0:8866"
Start up tftp-http-proxy:
/path/to/tftp-http-proxy -http-base-url "http://localhost:5000/tftp/"
And finally, start up mr-provisioner:
./run.py -c /path/to/your/config.ini tornado -h 0.0.0.0 -p 5000
Next steps¶
mr-provisioner can be used with any DHCP server, but works best with Kea and the mr-provisioner-kea plugin. See Kea integration for more information. Some of the features that are only enabled with Kea include:
- Showing DHCP IP lease in the UI
- Assigning static/reserved IPs to machines
For additional deployment instructions, see Deploy.