                   LXCF - LXC Facility

   Copyright (C) 2013-2014 FUJITSU LIMITED Allright reserved
   GNU GENERAL PUBLIC LICENSE Version 2


LXCF is a lxc facility tool.
LXCF efficiently makes  the instance.  One-instance making is a few minutes 
or less. 
The LXCF instance can  dynamically  change the resource of  CPU, MEMORY, IO 
and NET. Even if the instance has  stopped, the change in the resource  can 
be changed. 
LXCF can be used by installing it on Linux on VM as well as bare metal. 
LXCF can be operated stabilizing the job like a past system at a long term. 
Moreover, a lot of LXCF instances are generable in a short time. If a lot of 
LXCF instances become unnecessary, it is possible to delete it collectively. 
Such stateless instance can be operated. 

Lxcf operates only by Fedora 20 and Red Hat Enterprise Linux 7 now.


*** LXCF Quick Start ***

1. Install

- Installation from package

Method of installing package
# rpm -ivh lxcf-0.8-1.rpm
# reboot

Method of uninstalling package
# rpm -e lxcf

- Installation from source.

  1) tar xzf lxcf-0.8-1.tgz

  2) cd lxcf

  3) Type 'make' to compile the package.

  4) Type 'make install' to install the program and any data files and
     documentation.

2. Execution
1) LXCF container making
asia-srv and euro-srv are made in the example. 
# lxcf sysgen asia-srv euro-srv

When the specified instance exists, the instance is not made more than once. 

2) LXCF container list display

# lxcf list

3) Setting of resource
The cpu usage rate of asia-srv is specified for 80%. 
# lxcf cpurate asia-srv 80

The cpu usage rate of asia-srv and euro-srv is specified for 10%. 
# lxcf set -c 10 asia-srv euro-srv

4) Display of resource
Resource display of all containers
# lxcf show

Resource display of specified container
# lxcf show asia-srv

5) Update and package application
It updates all container with yum. 
# lxcf update yum update

It Updates all container with yum
# lxcf deploy perl-XML-Parser-2.41-8.el7.x86_64.rpm
  The package is delivered to all containers with lxcf deploy. 

# lxcf update rpm -ivh perl-XML-Parser-2.41-8.el7.x86_64.rpm
  The installation of rpm is executed with all containers. 

# lxcf deploy -d perl-XML-Parser-2.41-8.el7.x86_64.rpm
  The file that does deploy from all containers is deleted. 

6)  Start and Stop of LXCF container

shutdown
# lxcf stop asia-srv

boot
# lxcf start asia-srv

suspend
# lxcf suspend asia-srv

resume
# lxcf resume asia-srv

7) Deletion of LXCF container

# lxcf erase asia-srv euro-srv

If "Lxcf erase" is used even when the generation of the container fails, 
the container is surely deleted. 

When the specified instance does not exist, the instance is not deleted. 

8) Update of LXCF conteiner and HOST system

# lxcf deploy pkg-name.rpm
# lxcf update rpm -Uvh pkg-name.rpm

# lxcf update yum update -y

9) A lot of instances are made. 
When the specified instance exists, the instance is not made more than once. 

# lxcf sysgen-n m 10
The LXCF instance of m0001-m010 is made. 

# lxcf sysgen-n m 3 8
The LXCF instance of m0003-m008 is made. 

# lxcf clone-n asia-srv m 3 8
Asia-srv is a cloning in m0003-m0008. 

10) A lot of instances are deleted.
When the specified instance does not exist, the instance is not deleted. 

# lxcf erase-n m 2 7
LXCF instance m0002-m0007 is deleted.


Enjoy it!


