Information

This site will undergo maintenance on Friday, 26 September at 2:00 AM CDT / 12:30 PM IST and may experience a short period of instability during that time.

Deploying files to Agents


Pushing files to Agents by using the Manager

The Manager can push the files to Agents by creating a customization.zip file on the Manager in this location: /app/clarity/dmanager/var/

Warning

Note

In a Multi-Manager configuration, only the Satellite Manager pushes files to the agents.

The customization.zip file contains the app_manifest.xml file. The following example shows a customization.zip file:

Information
Example
# zip /app/clarity/dmanager/var/customization.zip app_manifest.xml
adding: app_manifest.xml (deflated 51%)

# unzip -v /app/clarity/dmanager/var/customization.zip
Archive: customization.zip
Length   Method Size    Ratio Date     Time  CRC-32   Name
-------- ------ ------- ----- ----     ----  ------   ----
501      Defl:N 247     51%   04-15-08 20:18 73474678 app_manifest.xml
--------        ------- ---                           -------
501             247     51%                           1 file
Warning

Note

The app_manifest.xml file must not be in a subdirectory within the .zip file.

After the dmanager process is restarted on the Manager, the dmanager process pushes the customization.zip file to all the Agents and the Agents extract its contents on each of their filesystems in the following directory: /app/clarity/dagent/etc/custom.

Any files in the /app/clarity/dagent/etc/custom directory that have the same name are overwritten.

After the files are installed on the Agents, and the dagent process on the Agent is restarted, the dagent process loads code in /app/clarity/dagent/etc/custom. BMC Database Automation discovers any generic or other applications on the Agents and reports back to the Manager. If there are databases or instances that are not approved into BMC Database Automation, applications or databases within those databases or instances are not discovered. If the application has not been approved into BMC Database Automation, it appears in the Pending Approval section of the Management Console.

After the files are installed on the Agents, and the dmanager process is restarted on the Manager, custom code is pushed from the Manager to the Agents.

Warning

Note

The only way to push custom code from the Manager to the Agents is when the dmanager process is restarted on the Manager. The only exception is if an agent was down when the dmanager process was restarted, in which case the dmanager will push the code out to the agent when it comes back up.

Copying files directly to Agents

The app_manifest.xml file and application modules can be delivered to Agents by placing copies of these files in this directory on each Agent: /app/clarity/dagent/etc/custom_local

When a file placed in the custom_local directory has the same name as a file placed in the custom directory, the file from the custom_local directory is used. This enables you to have a particular Agent use a configuration that is different than the configuration used by the other Agents associated with a Manager.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC Database Automation 8.5