Chapter 3. Creating and using the package file

Once the package XML has been written, stub configuration files have been created and source files have been gathered, it is time to combine all of the files into a ReST package. Part of the ReST suite is the ReST Packager utility. This utility combines all of the necessary files into one package for easy distribution. Below is an example of how the ReST Packager is used.

Example 3.1. Running the ReST Packager.

> java -jar ReSTPackager.jar -X examplepackage.xml -f example.rsp file1 file2 stub.cfg

In the above example, the user has run the ReST Packager, which is included in the ReST suite to create a package named example.rsp. The -X argument tells the ReST Packager to use examplepackage.xml as the package XML file for this package. The -f argument tells the packager the name of the file to create. The remaining arguments tell the Packager which files to include. Every file that is declared in the package.xml must be included in the Packager arguments. The resulting file can be distributed by whatever means desired and used with the ReST Installer.

Once the package file is created, it simply needs to be installed from the ReST Installer. To install the package, run the ReST Installer with the name of the package as an argument. The package can be local or placed on a web server, although larger packages will run more quickly if they are local. Here is an example of our package being used by the ReST Installer.

Example 3.2. Installing a Package

> java -jar ReSTInstaller.jar example.rsp