Next Previous Contents

6. Man pages

This section regroups the man pages for the different tools that compose the deployment system.

6.1 kaaddnode

NAME

kaaddnode - registers nodes and their disk and partition features

SYNOPSIS

kaaddnode info_file

DESCRIPTION

kaaddnode registers nodes and their disk and partition features for them to be available to the deployment system. It can be used at the very beginning to describe a whole cluster (after having completed the installation for instance) or later when new nodes are added to a cluster already managed by the deployment system.

info_file is the name of the file that describes all the information the system needs. It contains two main parts and has to be formatted as described below:

# first part : node set description

node_name1    mac_address1    ip_address1
node_name2    mac_address2    ip_address2
node_name3    mac_address3    ip_address3
...           ...             ...
N.B. : each node is described on a separate line; fields on each line are separated by tabs or spaces.
# second part : descriptive information about the type of disk and the partitioning

device_name    device_size
partition_number1    partition_size1    deployed_env1
partition_number2    partition_size2    deployed_env2
partition_number3    partition_size3    deployed_env3
...                  ...                ...
N.B. : each partition is described on a separate line; fields on each line are separated by tabs or spaces. All size are given in Mbytes. The specified deployed_env should already exist in the deployment system otherwise default value 'undefined' will be switched to the declared one during the execution.

First and second part are separated by a - strange and arbitrary - line starting with the following characters : \#. Empty lines and commentaries (starting with #) are ignored. Before doing any modification in the deployment system database, kaaddnode tries to check if the expected description syntax is respected in both parts.

EXAMPLE

kaaddnode description.txt

with description.txt as below:

# Nodes
node1    00:02:73:49:9C:8D    192.168.10.1
node2    00:02:73:49:9C:8E    192.168.10.2
...      ...                  ...

\#

# Disk & Parts
hda  80000
1    5000    swap
2    20000   debian
...  ...     ...

6.2 kadelnode

NAME

kadelnode - unregisters nodes

SYNOPSIS

kadelnode -m|--machine hostname

DESCRIPTION

kadelnode unregisters nodes and their disk and partition features from the deployment system.

OPTIONS

-m, --machine hostname

specifies a host. This option can be used more than once to specify several hosts

EXAMPLE

kadelnode -m node1

remove all information relative to node1 from the deployment system database

6.3 kadeploy

NAME

kadeploy - deploys an environment on the given nodes

SYNOPSIS

kadeploy -e|--environment environment_name -m|--machine hostname -p|--partition partition

DESCRIPTION

kadeploy deploys the specified environment on the requested nodes. When successfully over, the nodes are available under the new and freshly installed environment.

It needs critic variables to be defined in the /etc/kadeploy/deploy.conf configuration file ; see configuration file section for further details.

OPTIONS

-e, --environment environment_name

the name of the environment to deploy

-m, --machine hostname

specifies a host. This option can be used more than once to specify several hosts. By default, it tries to deploy on all the nodes.

-p, --partition partition

the target partition. This option can't be used more than once and the partition is the same for all the nodes.

CONFIGURATION FILES

/etc/kadeploy/deploy.conf

Contains variables that should be defined prior to the command execution. These variables are grouped into several sections. A very short description is available for each variable and sometimes example values are given in commentary. The file is read once at the beginning of the execution and prior to any other action. If values are missing, it should be told as precisely as possible. The syntax is the following :

# section_name #
# ------------ #

# short description
var_name1 = var_value1

# short description
var_name2 = var_value2  # example_value

...
Also, an example of this file can be found at in the tools/cookbook/ folder.

/etc/kadeploy/deploy_cmd.conf

Contains entries describing reboot command needed for deployment. Please see kareboot man page for further details.

FILES

kadeploy needs read and write access to several folder and files to acheive a deployment. These rights should be granted to the deploy user. Here are the files and folder list :

EXAMPLE

kadeploy -e debian -m node7 -p hda3

deploys the debian on partition hda3 of node 7

kadeploy -e debian -m node1 -m node2 -p hdb6

deploys the debian on partition hdb6 of nodes 1 and 2

6.4 kareboot

NAME

kareboot - reboots a node

SYNOPSIS

kareboot [-n|--noreboot] [-s|--soft] [-h|--hard] [-d|--deploy] -m|--machine hostname [-e|--environment name] [-p|--partition partition]

DESCRIPTION

kareboot can execute software or hardware reboots on given nodes. It can execute five types of query : no reboot, simple reboot, deploy reboot, environment reboot and partition reboot. For all of them, the user can specify one or several hosts.

Here is a brief description of the effects of each reboot type :

Consult the example section below for more explicit usage descriptions.

kareboot needs the appropriate command (softboot, hardboot, deployboot) to be defined in the configuration file in order to be able to execute the requested reboot on the given node ; see configuration file section for further details.

OPTIONS

-n, --noreboot

setups pxe, grub and tftp stuff

-s, --soft

requests a software reboot (default reboot type)

-h, --hard

requests a hardware reboot

-d, --deploy

specify to reboot on the deployment kernel

-m, --machine hostname

specifies a host. This option can be used more than once to specify several hosts.

-e, --environment

gives an (already installed) environment to boot. When used, only one environment can be specified.

-p, --partition

gives a partition to boot on. When used, only one partition can be specified.

CONFIGURATION FILE

/etc/kadeploy/deploy_cmd.conf

Can contain four entry types per node whose three are relative to the kareboot command. Those three entries describe the reboot commands for the soft, hard and deploy reboot type. Here is the description of the expected syntax :

host_name reboot_type command

where reboot_type can be either softboot, hardboot or deployboot.

Example for idpot1 of idpot cluster :

In this example,

EXAMPLE

No reboot

kareboot -n -m node1 -e debian

setups pxe, grub and tftp stuff for rebooting node1 on debian environment (if already installed)

kareboot -n -m node7 -p hda5

setups pxe, grub and tftp stuff for rebooting node7 on partition hda5 (if an environment is found)

Simple reboot

kareboot -s -m node1

executes a software reboot of node1

kareboot -h -m node7 -m node6

executes a hardware reboot of nodes 7 and 6

kareboot -m node7

executes a software reboot of node7

Deploy reboot

kareboot -d -m node2

(soft) reboots on deployment kernel

kareboot -d -h -m node2

(hard) reboots on deployment kernel

Environment reboot

kareboot -e debian -m node3

looks for environment debian on node3 and (soft) reboots on it if it exists

kareboot -h -e debian -m node3

looks for environment debian on node3 and (hard) reboots on it if it exists

Partition reboot

kareboot -s -p hda6 -m node4

checks the environment installed on partition hda6 of node4 and (soft) reboots on it if appropriate

6.5 kaconsole

NAME

kaconsole - opens a console on a remote node

SYNOPSIS

kaconsole -m|--machine hostname

DESCRIPTION

kaconsole opens a console on a remote node. This tool is designed to help the user that would try to find out the reason of a deployment failure or to follow a boot sequence for instance. It needs the appropriate command to be defined in the configuration file in order to be able to open a remote console on the given node ; see configuration file section for further details.

OPTIONS

-m, --machine hostname

specifies a host. This option cannot be used more than once.

CONFIGURATION FILE

/etc/kadeploy/deploy_cmd.conf

Can contain four entry types per node whose only one is relative to the kaconsole command. This entry describes the command to open a remote console on the specified node of the cluster. Here is the description of the expected syntax :

host_name console command

Example for idpot1 of idpot cluster :

idpot1 console ssh -t localuser@ldap-idpot kermit -l /dev/ttyUSB0 -b 38400 -c

In this example, kaconsole -m idpot1 means to open a serial connection on idpot1 node via kermit software from ldap-idpot

EXAMPLE

kaconsole -m node

opens a console on node (if appropriately equipped)

6.6 karecordenv

NAME

karecordenv - registers a environment

SYNOPSIS

karecordenv
   -n |  --name        registration name
   -v |  --version     version            # default is 1
   -d |  --description description
   -a |  --author      author email
   -fb| --filebase    environment image path
   -ft| --filesite    post-installation file path
   -s |  --size        size (Mo)
   -i |  --initrdpath  initrdpath        # default is none
   -k |  --kernelpath  kernel path
   -p |  --param       kernel param 
   -fd| --fdisktype   fdisk type         # default is 82
   -fs| --filesystem  file system        # default is ext2
Name, kernel_path, environment_image_path and post-installation_file_path must be defined

DESCRIPTION

karecordenv registers an environment in order to be able to use it with the deployment system.

OPTIONS

-n, --name registration_name

the registration name for the environment

-v, --version version

the version number of the environment (if needed) ; default is 1

-d, --description "description"

a brief description of the environment

-a, --author author_email

the author email address

-fb, --filebase environment_image_path

the complete path to the environment image

-ft, --filesite post-installation_file_path

the complete path to the post-installation file

-s, --size size (Mo)

the size of the environment ; in order to perform partition size check before a deployment

-i, --initrdpath

the complete initrd path in the environment (including intrd name)

-k, --kernelpath kernel_path

the complete kernel path in the environment (including kernel name)

-p, --param

arguments passed to kernel at boot (

root
parameter is set automatically), if left empty, default kernel parameters can be configured

-fd, --fdisktype fdisk_type

the fdisk type ; default is 82

-fs, --filesystem file_system

the file system type ; default is ext2

EXAMPLE

karecordenv -n debian -v 2 -d "debian maison prête à l'installation" -a katools@imag.fr -fb file://home/nis/jleduc/ImagesDistrib/image_Debian_current.tgz -ft file://home/nis/jleduc/Boulot/postinstall/traitement.tgz -size 650 -k /boot/vmlinuz -i /initrd -p "console=ttyS0,38400n8 ETH_DRV=tg3" -fd 83 -fs ext2

registers a debian image whose features are explicitly given in parameter

6.7 kaarchive

NAME

kaarchive - creates an environment image

SYNOPSIS

kaarchive [-X | --exclude-from file] [-z | --gzip] [--output-directory output_directory] [-i | --image image_name] --root-directory root_directory

DESCRIPTION

kaarchive creates a environment image from a running system one.

OPTIONS

-X, --exclude-from file

excludes files named into file from the generated environment

-z, --gzip

filters the archive through gzip

--output-directory output_directory

sets the output directory for the generated environment ; default is current directory

-i, --image image_name

sets the output image name ; default is output_image

--root-directory root_directory

sets the root directory for the environment creation

EXAMPLE

kaarchive -z -X /path/to/files_to_exclude_list.txt -i debian --root-directory /mnt/debian/

creates the debian.tgz image file from /mnt/debian excluding the files listed into /path/to/files_to_exclude_list.txt

6.8 kacreateenv

NAME

kacreateenv - creates and registers a new environment

SYNOPSIS

kacreateenv 
   -e | --environment environment_name 
   -v | --version version 
   -X | --exclude-from file 
   -z | --gzip
   --output-directory output_directory
   --root-directory root_directory
   --author email_address
   --description "description"
   --file-base file
   --file-site file
   --size size
   --kernel-path kernel_path
   --fdisk-type fdisk_type_number
   --file-system file_system_type

DESCRIPTION

kacreateenv creates and registers a new environment from a running system one.

OPTIONS

-e, --environment environment_name

the registration and output image name for the environment

-v, --version version

the version number of the environment (if needed) ; default is 1

-d, --description "description"

a brief description of the environment

-a, --author author_email

the author email address

-fb, --filebase environment_image_path

the complete path to the environment image

-ft, --filesite post-installation_file_path

the complete path to the post-installation file

-s, --size size (Mo)

the size of the environment ; in order to perform partition size check before a deployment

-k, --kernelpath kernel_path

the complete kernel path in the environment

-fd, --fdisktype fdisk_type_number

the fdisk type ; default is 82

-fs, --filesystem file_system_type

the file system type ; default is ext2

--root-directory root_directory

sets the root directory for the environment creation

-X, --exclude-from file

excludes files named into file from the generated environment

-z, --gzip

filters the archive through gzip

--output-directory output_directory

sets the output directory for the generated environment ; default is current directory

EXAMPLE

kacreateenv -e toto_env --description "toto's special image" --author toto@fai.fr -fb file://home/images_folder/toto_env.tgz -ft file://home/images_folder/toto_spec_file.tgz --size 650 -k /boot/vmlinuz --root-directory /home/toto_img/ -X /path/to/file_to_exclude.txt -z

creates and registers the environment according to the parameters


Next Previous Contents