Installation guide

PXE installation of XenServer Host

C.3.2. Installation media repository metadata

The XS-REPOSITORY file is used to describe a Citrix-format installation media repository. It has

four fields, separated by newlines:

• repository id

• repository name

• intended target product

• intended target version

Repository IDs should be alphanumeric strings that provide a machine identifier for the repository.

They should be unique within a target product and version. Best practice is to use the form

vendor:repository

Citrix repositories start with xs (for example, xs:main), custom repositories should be

custom:my-repo, and third-party add-ons should be identified as such by using an appropriate

vendor string. This will help avoid name clashes.

Repository names are presented to the user, so should be a string that identifies the repository

in a sensible manner so the user can confirm that they wish to install from it.

The intended target product will be XenServer; version 4.1.0-build.

C.3.3. Package metadata

The XS-PACKAGES file describes the packages in a repository, one line per package. Fields are

separated by spaces.

There are three types of packages:

• tbz2 packages are bzipped tarballs that get extracted onto the root filesystem

• driver packages are kernel modules that get loaded by the installer at runtime as well as being

installed into the filesystem

• firmware packages are made available during the installation so that they may be loaded by

udev in addition to getting installed into the target filesystem.

Firmware loading support is currently limited; this will be addressed in a future release.

The first three fields are mandatory: package name, package size, and package checksum

(md5). The fourth field is the package type, either tbz2, driver, or firmware. Which type is

used dictates the contents of the subsequent fields.

If the type is tbz2, the subsequent fields are required or optional, source filename,

and destination (usually just /).

Example:

docs 37750 2ba1783d84d10c71f07469252c555427 tbz2 required docs.tar.bz2 /