Difference between revisions of "Profiles.xml"

Revision as of 21:32, 5 December 2007

This document in other languages: French

profiles.xml is a file which defines the software packages or scripts, which will be installed/executed on hosts.

This file has to be placed in the same directory as wpkg.js.

WPKG will not work without this file.

Hosts are defined in hosts.xml file.
Packages are defined in packages.xml file.

profiles.xml structure

The structure of profiles.xml is as follows:

<profiles>
    <profile id="default">
       <package package-id="acrobat" />
       <package package-id="firefox" />
    </profile>
    <profile id="custom">
       <depends profile-id="default" />
       <package package-id="thunderbird" />
    </profile>
</profiles>

Which means, that if a host, defined in hosts.xml has a profile default (the first profile above), it will have acrobat and firefox installed - because profile id="default" contains these two packages.

Now take a look at <depends profile-id="default" /> entry in the next profile - <profile id="custom">.
This profile only seems to contain a thunderbird package.
But because it depends on <profile id="default">, which contains two more packages (acrobat and firefox) - it all sums up, and in the end, a host with a profile custom will have three packages installed: acrobat, firefox and thunderbird.

This way you can easily create a group of packages to be installed on all workstations (for example, in profile default), and then create specific profiles for different rooms, departments etc.

Profiles can depend on more than one package.

Quick examples

<profiles>
<profile id="default">
<package package-id="firefox" />
</profile>

<profile id="custom">
<depends profile-id="default" />
<package package-id="thunderbird" />
<package package-id="acrobat" />
</profile>

<profile id="basement">
<package package-id="photoshop" />
</profile>

<profile id="administration">
<depends profile-id="custom" />
<package package-id="firefox" />
<package package-id="database" />
</profile>
</profiles>

Individual XML profiles files

If you would rather keep your profiles XML description in separate files, you can of course do it: just create a profiles directory where wpkg.js is, and place individual XML files there (i.e., basement.xml, administration.xml etc.). The syntax is the same as that of profiles.xml.

Note, if you decide to keep all your profiles in separate XML files, still, you need to have profiles.xml file. It should at least contain an empty entry:

<profiles>
</profiles>

See also

• hosts.xml - defines the hosts.
• packages.xml - defines the list of packages.
• wpkg.js - WPKG engine.