MANIFEST file

To provide information about the applications and/or Web services packaged in a Genero Archive (gar) file, a MANIFEST file is created. If you are packaging applications, you will find it helpful to know how to create a MANIFEST file.

A MANIFEST file must be created and included in the Genero archive (gar) file. The following are some options to consider depending on your requirements:

  • If you have one or more applications, you can run the fglgar tool with the gar command with an --application and/or --service option for each application or service you wish to include. An Genero Archive (.gar) file is generated and a MANIFEST file is created automatically and included in it.
  • Alternatively, if you have many applications to package, you may find it easier to create the MANIFEST by hand. The fglgar checks if a MANIFEST file is present in the archive directory and uses it to create the gar.
    Important: You must not use fglgar command options that provide for the generation of a MANIFEST (such as --application and/or --service) when a MANIFEST already exists, as errors will be raised.
    Note: For more information on using fglgar, see the fglgar topic in the Genero Business Development Language User Guide.

Syntax

A MANIFEST file is an XML file. It has a MANIFEST element at its root. 
<MANIFEST>
   <DESCRIPTION></DESCRIPTION>
   [<TRIGGERS>...</TRIGGERS>]
   [<RESOURCES></RESOURCES>]
   [<APPLICATION></APPLICATION>] [...]
   [<SERVICE></SERVICE>] [...]
</MANIFEST>

Child elements

Important: Element order. If child elements are present, they must be set in the order listed or as shown.
Child elements can include the following:

MANIFEST file

<MANIFEST>
  <DESCRIPTION>This archive contains one app and one service</DESCRIPTION>
  <TRIGGERS component='comp_name'>
    <DEPLOY>deploy.sh</DEPLOY>
    <UNDEPLOY>undeploy.sh</UNDEPLOY>
  </TRIGGERS>
  <RESOURCES>res_dir</RESOURCES>
  <APPLICATION xcf='app.xcf'></APPLICATION>
  <SERVICE xcf='webserviceApp.xcf'></SERVICE>
</MANIFEST>