Previous page

Next page

Locate page in Contents

Print this page

vzmktmpl

This utility is used to create new EZ templates.

Syntax

vzmktmpl [ options ] <metafile>

Options

Name

Description

--pre-cache <file>

The path to the script which will be executed by the vzpkg cache command before installing the packages included in the EZ template on the server. This script is executed in the server context and relevant for OS EZ templates only.

--post-cache <file>

The path to the script which will be executed by the vzpkg cache command after installing the packages included in the EZ template on the server. This script is executed in the server context and relevant for OS EZ templates only.

--pre-install <file>

The path to the script which will be executed by the vzpkg install command before adding the application EZ template to the Container. This script is executed in the Container context and relevant for application EZ templates only.

--post-install <file>

The path to the script which will be executed by the vzpkg install command after adding the application EZ template to the Container. This script is executed in the Container context and relevant for application EZ templates only.

--pre-upgrade <file>

The path to the script which will be executed by the vzpkg upgrade command before upgrading the OS EZ template inside the Container. This script is executed in the Container context.

--post-upgrade <file>

The path to the script which will be execute by the vzpkg upgrade command after upgrading the OS EZ template inside the Container. This script is executed in the Container context.

--pre-update <file>

The path to the script which will be executed by the vzpkg update command before updating the packages included in the application EZ template inside the Container. This script is executed in the Container context.

--post-update <file>

The path to the script which will be executed by the vzpkg update command after updating the packages included in the application EZ template inside the Container. This script is executed in the Container context.

--pre-remove <file>

The path to the script which will be executed by the vzpkg remove command before removing the application EZ template from the Container. This script is executed in the Container context and relevant for application EZ templates only.

--post-remove <file>

The path to the script which will be executed by the vzpkg remove command after removing the application EZ template from the Container. This script is executed in the Container context and relevant for application EZ templates only.

--environment <file>

The path to the file storing a list of environment variables. The variables should be set in the form of key = value . The variables specified in this file are used when running the vzpkg create cache and vzpkg update cache commands and exported to the Container environment during the EZ template scripts execution.

-d, --doc <file>

The path to the file containing the information on the EZ template. You can specify several files and separate them by commas.

-s, --spec-only

Creates the package specification file only.

-r, --srpm

Creates the package source file only.

-h, --help

Displays the utility usage and exits.

The only required parameter for vzmktmpl is the path to the metafile containing the template configuration. In most cases, however, you also need to include a number of scripts in the template. These scripts will be executed at different stages of the template life cycle (e.g., when you add the template to a Container) and ensure the correct template operation. To learn what scripts are required for your template:

  1. Install an official template provided by Parallels for the same Linux distribution for which you are creating the template. For example, if you are making a template for CentOS 5, install the CenOS 5 OS template (use the vzupdate -z command, if necessary).
  2. Go to the configuration directory ( /vz/template/ TemplateName / TemplateArch /config/os/default ) of the installed template.
  3. Look for the files starting with " pre- " and " post- " (e.g, pre-cache or post-install ).

Note: The vzmktmpl utility is a part of the vztt-build package, which is not installed by default. If installed, the package can be found in the /virtuozzo/RPMS/optional directory of your Parallels Cloud Server distribution. So, before you can start using the vzmktmpl utility, you first need to install the package on your server with the rpm -i command.