Creating a Deployment Descriptor

For each portal archive (PAR) file that you create for deployment in the portal Web application, you must create a portlet deployment descriptor. The portlet deployment descriptor is an XML file that provides all of the information that the portal Web application needs to deploy the portlets that are contained in the PAR file.

A PAR file, and its associated portlet deployment descriptor, can contain one portlet or it can contain multiple related portlets; there is no limit to the number of portlets that a PAR file and its associated descriptor can contain.

In addition, a PAR file (and its associated portlet deployment descriptor) can contain local portlets, remote portlets, or a combination of local and remote portlets.

To create a portlet deployment descriptor, use element tags as defined in the portlet deployment descriptor document type definition (DTD). The following information is provided for your reference:

• An example portlet deployment descriptor for a local portlet. You can use this example as a template for creating deployment descriptors for your own local portlets. Simply replace the element values in the example with the appropriate values.

• An example portlet deployment descriptor for a remote portlet. You can use this example as a template for creating deployment descriptors for your own remote portlets. Simply replace the element values in the example with the appropriate values.

• A detailed description of elements in the portlet deployment descriptor DTD.

After creating the deployment descriptor file, assign it the name portlet.xml. Then include it in the portal archive (PAR) file that you create for your portlet or group of portlets. For more information, see Creating a PAR File for Deployment in the Portal.