4.2. OpenVZ Kickstart Options

Along with standard Linux options, OpenVZ provides a number of specific parameters and keywords that you need to add to your kickstart file.

The table below lists all available parameters and keywords.

Table 4.1. General Parameters

ParameterDescription

key <key>

Mandatory. Installs the OpenVZ product key on the server. This key is needed to start using the OpenVZ software.

cep [--agree|--disagree]

Mandatory. Specify whether you want to participate in the Customer Experience Program.

  • --agree. Join the program. In this case, OpenVZ will periodically collect the information about the configuration of your physical server and virtual machines and containers and use it to make the product better fit your needs. No private information like your name, e-mail address, phone number, and keyboard input will be collected.
  • --disagree. Do not join the program.

vznetcfg

Optional. Invokes the vznetcfg utility with the specified options. This parameter accepts all options that you can normally pass to vznetcfg. The options and their values should be separated by an equals sign (for example, vznetcfg --net=virt_network1:eth0). For detailed information on the vznecfg options, refer to the vznetcfg section in the OpenVZ Command Line Reference Guide.

vziptables

Deprecated. To configure iptables modules for containers, use the NETFILTER parameter in the container configuration file (for details, see the OpenVZ Command Line Reference Guide).

vztturlmap

Optional. Sets the URL of the repository and repository mirrors to use for handling EZ OS and application templates. By default, OpenVZ uses the following URLs:

  • http://fedora.redhat.com for handling Fedora-related templates.
  • http://mirror.centos.org for handling CentOS-related templates.
  • http://archive.ubuntu.com for handling Ubuntu-related templates.
  • http://download.opensuse.org for handling openSUSE-related templates.
  • ftp://ftp.suse.com for handling SUSE-related templates.
  • ftp://ftp.de.debian.org for handling Debian-related templates.
  • http://vzdownload.swsoft.com for obtaining specific software packages for the aforementioned Linux distributions. These packages are necessary for the correct operation of your OS templates.

To use your own URL, you first need to specify the name of the respective Linux distribution, followed by = and the desired URL (e.g., $FC_SERVER=http://myrepository.com to redefine the default repository for Fedora). To use several URLs, separate them by space.

Note

Note: Some Linux distributions (e.g., Red Hat Enterprise Linux and SUSE Linux Enterprise Server) do not have official repositories. So you should manually create software repositories before starting to use OS templates for such distributions. Refer to the OpenVZ Templates Management Guide to learn how you can do it.

up2date

Optional. Does the following:

  1. Configure the repositories with updates for OpenVZ software and templates.
  2. Check the repositories for available updates.
  3. Download and install the updated packages, if any, on the server.

Using this option, you can ensure that you have the latest OpenVZ software packages and templates right after the installation, without the need to manually check for updates.

nosfxtemplate

Optional. Skips installing the pre-created and pre-cached EZ templates on the server. The current version of OpenVZ is shipped with only one pre-created and pre-cached OS EZ template: centos-6-x86_64.

%eztemplates

Optional. Installs EZ templates on the server. All available templates are listed in the /Packages directory of the OpenVZ distribution. You can easily identify them by the -ez-<number>.swsoft.noarch.rpm ending (e.g., centos-6-x86-ez-3.0.0-14.swsoft.noarch.rpm). The names of the templates must be specified without the ending and separated by the new-line character, for example:

%eztemplates
centos-6-x86
devel-centos-6-x86

When using this parameter, keep in mind the following:

  • If you specify an empty list, no templates will be installed on the server.
  • If you skip this parameter, all templates included in the OpenVZ distribution will be installed on the server.
  • You can indicate the --cache argument next to a respective OS template to cache it after installation. To cache all specified OS templates, specify --cache after %eztemplates.

    Note

    Note: To cache OS templates for some Linux distributions (e.g. Red Hat Enterprise Linux and SUSE Linux Enterprise Server), you should first create special repositories storing the necessary software packages for these OS templates. Refer to the OpenVZ Templates Management Guide to learn how you can do it.

  • This option must be specified as the first one after the keys.

ignoredisk

Optional. Ignores the specified drives or all drives except the one specified. Used with one of the following arguments:

  • --drives=<drive>[,…] - A comma-separated list of drives to ignore. If a server has drives other than those specified in this option, the installer will ask what to do with them.
  • --only-use=<drive> - Ignore every drive except the specified.

prlnet [--ip-scope-start <start_IP_addr> --ip-scope-end <end_IP_addr>] [--ip <adapter_IP_addr>[/<mask>]] [--dhcp-ip <DHCP_IP_addr>] --name <name>

Optional. Defines the range of IP addresses the DHCP server will be able to allocate to virtual machines in host-only networks; virtual adapter IP address and subnet mask; DHCP server IP address; and virtual network name. If you omit one or more parameters, the following default values will be used:

  • --ip-scope-start: 10.37.130.1,
  • --ip-scope-end: 10.37.130.254,
  • --ip: 10.37.130.2/255.255.255.0,
  • --dhcp-ip: 10.37.130.1.

%packages

Specifies the package groups to install on the server:

  • @base and @core (mandatory). Installs the packages required for the correct operation of your system.
  • @vz (mandatory). Installs the packages specific to the OS virtualization part of OpenVZ.
  • @ps (mandatory). Installs the packages specific to the hardware virtualization part of OpenVZ.
  • @clustering (optional). Installs the packages required for creating clusters from OpenVZ systems.
  • @templates (optional). Installs all templates included in the OpenVZ distribution. If you want to install specific templates only, use the %eztemplates option.
  • @optional (optional). Installs additional packages that are not installed with OpenVZ by default.