A tool to automate and simplify the installation/configuration/testing of Linux systems running on the IBM Z platform.
Main functions available in the tool:
- Automatic installation and management of Linux operating systems on IBM Z machines
- Datacenter resources management: storage servers, volumes, network subnets, ip addresses
- Job scheduling for automatic execution of tasks/scripts
- Command line client and REST-like API
- Role based permission model
See the documentation's Users section for detailed information about what the tool offers.
Hypervisors supported:
- zHMC (classic and DPM modes)
- z/VM
- KVM for IBM Z
Linux distributions supported:
- RHEL 7.2+
- SLES12 SP1+
- Ubuntu 16.04+
A detailed list of supported installation combinations can be found here.
Deploy using docker containers, you will need docker 1.12.0+ and docker-compose 1.9.0+ installed on your system.
# install pip for python3
$ apt-get install python3-pip
# clone repo and install the deploy tool requirements
$ git clone https://gitlab.com/tessia-project/tessia.git
$ cd tessia && pip3 install -r tools/ci/requirements.txt
# build the docker images
$ tools/ci/orc build
# start the containers (it's done via docker-compose)
$ tools/ci/orc run
# see the 3 containers running - server, database, and client
$ docker-compose ps
# use the admin user available in the client container to test the service:
$ docker exec -ti --user admin tessia_cli_1 tess conf show
The tool is ready for use. To learn how to install your first system, visit Getting started.
IMPORTANT: In order to be able to install LPARs, one more step is needed. Refer to the section Deployment of the auxiliar live-image for details.
Other deployment options are listed in Server installation guide.
Server configuration explains how to set proper authentication and other configuration details.
Check the Release notes.
User documentation is available at the Users section. For an introduction about the tool concepts, see Resources model. To learn how to use the command line client, see Getting started.
If you are interested in contributing to the project, read How to contribute (development process). Additional topics for developers are available at the Developers section.
Feel free to open issues and raise questions in tessia issue tracker. If you are not comfortable disclosing issue details or it is a security related issue, please send an email to (tessia-private at lists.openmainframeproject.org) instead.
You can join us on IRC at the #tessia channel on OFTC and our mailing list (tessia-user at lists.openmainframeproject.org)
Tessia is licensed under the Apache 2.0 license.