IORI(1)

NAME
iori - deploy and config management tool for LXC

SYNOPSIS
iori [options] sub-command [sub-cmd-options] [infile]

DESCRIPTION
This manual page documents briefly the iori commands.

Iori Iori is a command line tool for deploying and config management tool of Linux Containers (LXC). When you use LXC, you ust use LXC userland command line tool as start with "lxc-*" generally. LXC is provided template config file and scripts. But this way if you want to manage from a remote contoller host is difficult to treat containers by bulk. So this tool controls LXC with libvirt API, and manages these config files with Git repository.

OPTIONS
These programs follow the usual GNU command line syntax, with long options starting with two dashes (`-'). A summary of options is included below. For a complete description, see the Info files.

-h, --help
    Show summary of options.

-V, --version
    Show program's version number.

-d DIRPATH, --dirpath DIRPATH
    Specify Git repository path.

SUB COMMANDS

newrepo
    Generate Git repository that path is $HOME/.iori, "master" branch is for mapping of LXC host nodes with IP address, user account using libvirt, etc. "template" branch is a template of each LXC host node branch.

addnode
    Register LXC host node to Git repository. Generate a branch is named from a node name. Then execute "listnode" subcommand, display registered nodes.

deploy
    Create a container of LXC. Firstly generate domain XML and define to libvirt. Then store that XML to Git repository. If without '--rootfs' option, a temporary(ephemeral) container will start.

start
    Start defined container.

destroy
    Destroy(Stop) a online container. Libvirt 0.9.12 does not support shutdown, reboot, reset for LXC.

delete
    Undefine a container from Libvirt and remove XML file from Git repository.

listnode
    Display registered LXC host nodes.

listcont
    Display deployed containeres.

SUB COMMAND OPTIONS
These programs follow the usual GNU command line syntax, with long
    options starting with two dashes (`-'). A summary of options is included below. For a complete description, see the Info files.

-n NODENAME, --nodename NODENAME
    Specify a hostname or IP address of LXC host node.

-c CONTNAME, --contname CONTNAME
    Specify a container name.

--vcpu num
    Specify VCPU numbers. (Default: 1)

--mem num
    Specify memory size. unit is KB. (Default: 64000)

--clock offset
    Specify clock offset. (Default: utf)

--network network
    Specify libvirt network name. (Default: default)

--rootfs
    When define a container, define rootfs path is /var/lib/lxc/$(containername).

--debian
    When define a container, create rootfs image with debootstrap.

SEE ALSO
The programs are documented by
    README, available via the Info system.

AUTHOR
iori was written by Kouhei Maeda <mkouhei@palmtb.net>.

This manual page was written by Kouhei Maeda <mkouhei@palmtb.net>. for the Debian project (and may be used by others).