Application Bundle

This section will present the application bundle xml file. Every App containing services has a bundle. The application bundle is an xml file containing descriptors of services to be executed when the application is deployed. Each service descriptor describes where and how often they are to be executed.

e.g A bundle that runs that will execute myScript.vbs on any windows host.

<Bundle system="false">
   <status>UNINSTALLED
   <owner>demo@liquidlabs.co.uk
   <services>
       <service>
           <name>MyService
           <resourceSelection>hostname contains WINDOWS
           <fork>true
           <background><true
           <instanceCount>-<1
           <pauseSeconds><60
           <script>myScript.<vbs
       /<service>
</Bundle>

Each service is represented by a service element, composed of the following attributes:

Element	Value	Description
Name	String	The name of the service, as it will appear on the VScape panel.
resourceSelection	resource query	Determines where the service will be executed. The expression can be tested on the Agent listing page: Some examples: type contains Agent osName contains LINUX
fork	true or false	Creates the process as child process
background	true or false	Run the service as background task (generally set to true)
instanceCount	Integer	Maximum number of services to be created across all matching hosts Note: background=false and -1 will have the service run on every matching host
pauseSeconds	Integer	Duration in milliseconds in between two service runs Note: 0 means run continuously
script	String or CDATA	Path to the script (.vbs, .sh, groovy) or the script itself within CDATA block. Note: you can create processes using groovy script to query SQL, run java, etc. See the cookbook below for more examples.

Bundle Overrides

You can overwrite the properties of the bundle file using an override file. An override file has the same name as the app (without .zip), followed by -override.properties.For example

MyLogScapeApp-1.0-override.properties

is the override for MyLogScapeApp-1.0.zip

bundle.service.[ServiceName].[attribute]=[value]

Changes the values specified in the xml file for a specific service.Wwhere [ServiceName] is the name of the service, [attribute] the attribute to override and [value] the new value. ex: bundle.service.LogSpace.instanceCount=100

Setting properties across all Services

to change he values for all the services where [ServiceName] is the name of the service, [attribute] the attribute to override and [value] the new value.

bundle.defaults.[element]=[value]

Here's an example

bundle.defaults.resourceSelection=type contains WINDOWS

Resource Selection strings can be tested on the Agent page, in order to determine which agents will be affected.