Skip to content

Pool Wizard

jiriprochazka edited this page Sep 19, 2014 · 2 revisions

On this page we will learn how to use the machine pool generation wizard. You have two ways of setting up your machine pool, either manually or via Wizard. For manual setting, you can use this tutorial. If you want to use wizard, continue reading this page.

1. Installing Wizard

Wizard should be already part of the latest lnst release, if you are using the git version, you can check if the Wizard is a part of the package by switching to the directory where the lnst is extracted and typing ./lnst-pool-wizard --help. If you installed lnst via the yum repository, try lnst-pool-wizard --help. Output should look like this:

Usage:
 lnst-pool-wizard [mode] [hostname[:port]]

Modes:
 -h, --help                display this help text and exit
 -i, --interactive         start wizard in interactive mode (this is default mode)
 -n, --noninteractive      start wizard in non-interactive mode
Examples:
 lnst-pool-wizard --interactive
 lnst-pool-wizard --noninteractive 192.168.122.2
 lnst-pool-wizard -n 192.168.122.2:8888 192.168.122.3:9999 192.168.122.4

If no output is shown, make sure you have installed the latest version of lnst.

REMINDER: Don't forget to check the lnst version on the slave machines as well, you should have the same lnst version on all slaves and the controller.

2. Running Wizard

First, make sure you have running lnst-slave service on machines you want to add to the machine pool. Wizard currently supports two modes, interactive and non-interactive.

2.1 Interactive mode

Interactive mode lets you choose the machine pool directory and interfaces you wish to add on the current machine as well as the name of each output file. It guides you step-by-step through the whole process and is recommended for less experienced users.

2.2 Non-interactive mode

This mode requires list of host names, separated by space, as arguments. Each host name can also have specified port on which is lnst listening. This mode will automatically create the machine pool directory in your home directory, at ~/.lnst/pool/. It cycles through all hosts, creates .xml files named after entered host names and adds all viable interfaces without asking.

3. Notes

As viable interface (both in interactive and non-interactive mode) is considered only ethernet interface in down state.

If no viable interface is detected, no output file will be generated. If that occurs, check host's interfaces manually, for examply with ip a utility and take corresponding actions.