Preparing the Application Package Using the Deployment Tool

The following procedures explain how to create the application package (.zpk), which contains the data, scripts, and an XML descriptor file for your application.

What is the application package?

How do I deploy the application package?

Creating the Package

Zend's Deployment Tool allows you to create a skeleton package, and pack the contents into a .zpk package. For more information on the tool, see Zend Deployment Tool.

Instructions on how to complete a procedure

To create the package skeleton:

Select a directory, and use the create command to create the skeleton of your .zpk package. This includes the XML descriptor file, the data folder and the hook scripts (templates):
- Linux: <install_dir>/bin/zdpack create <application-name>
- Windows: zdpack.exe create <application-name> where <application-name> is your application's name.
Go to the directory to see that the resources have been created:
- Data folder - The folder that will contain your application files.
- Scripts folder - The hook script skeletons available for you to edit as needed, and existing monitoring and caching rules (For more information, see Understanding the Package Structure).
- deployment.xml file - The template of the XML descriptor for you to edit as needed.
Perform the following actions:
1. Place your application files in the data folder.
2. Edit the hook scripts according to your needs. You can select from a list of available hook script constants to insert in the scripts.
  
  To deploy an application with pre-defined and customized monitoring and caching rules, first export your configurations, and edit the included 'pagecache_rules.xml' and 'monitor_rules.xml' files. After you have finished, insert these files in the Scripts folder of your .zpk package.
3. Edit the XML file as needed. The XML template is made up of example elements. The required elements are name, version and appdir. For more information see the The XML Descriptor File.
4. Validate the package by using the validate command :
  - Linux: '<install_dir>/bin/zdpack validate [--schema=<xsd-file>] <package-xml-descriptor-file>'
  - Windows: 'zdpack.exe validate [--schema=<xsd-file>] <package-xml-descriptor-file>'
    The XSD file is located at: <install_dir>/share/deployment.xsd
Use the pack command to pack the contents into a .zpk package. By default, the Deployment Tool will create the package in the working directory:
- Linux: <install_dir>/bin/zdpack pack <application-name>
- Windows: zdpack.exe pack <application-name>'

Once you have a .zpk application package ready and packed, you can deploy your application or update an existing application.

Zend Deployment Tool

The Deployment Tool usage includes the following:

Tool location - The tool is located in:
- Linux - '/usr/local/zend/bin/zdpack'
- Windows - 'C:Program Files\Zend\ZendServer\bin\zdpack'
Usage - Run the help command from the bin directory to see the usage:
- Linux: <install_dir>/bin/zdpack --help
- Windows: zdpack.exe --help

Command Line Actions

Action	Description
create <application-name>	Create a skeleton for new application
validate [--schema=<xsd-file>] <package-xml-descriptor-file>	Validate a given Zend package descriptor against the schema file
pack	Create a package. The pack options should contain pointers to the application data directory, the package descriptor file, and the package scripts directory.

Command Line Options

Option	Description
package-directory	A directory containing the data and the script directories, in addition to the package descriptor file.
--src-dir=directory	The directory that contains the application resources (PHP sources, JavaScript, etc.). The directory's internal structure must match the necessary structure for the application to be functional.
--scripts-dir=directory	The directory which contains the package deployment scripts. The Deployment Tool will search this directory for the expected files (as described in section 2.2.1) and then packs them.
--package-descriptor=xml-file	The package descriptor file.
--output-dir=directory	The directory in which the package is created. The package name will be created as "<app-name>-<app-version>.zpk".
--php-exe=php-executable	The PHP executable to use for lint.
--lint	Performs a PHP lint test on the deployment scripts before creating the package.
--help	Displays the tool's usage.
--schema=xsd-file	The path to the package descriptor schema used for validation.