How do I use the request.cfg file for automatic installation of probe packages?

Document ID : KB000034728
Last Modified Date : 08/11/2018
Show Technical Document Details
Introduction:
The request.cfg file is used for automatic installation of probe packages and monitoring configuration but there are no detailed instructions on what is required in this file.
Question:

How is the request.cfg file configured and used when doing automatic installation of probe packages?

Environment:
CA UIM 8.2 or higher
distsrv, robot, and automated_deployment_engine package versions which are included in the CA UIM Server 8.2 and higher distribution.
Answer:
To use request.cfg you create a simple text file called 'request.cfg' and place it in the Nimsoft directory of the robot to force the robot to pull specifically referenced probes or superpackages down when the Robot starts up. The general format is shown below.

<distribution request>
packages = baseOS-silver, base-apache, custom-0815
</distribution request>


Be sure that the hub managing the robot has access to a local distsrv probe.

request.cfg also supports auto-(re)initialization by adding the key following key and value to the file:

expect_ip_change = yes

When the robot starts up, it will look for a file called 'request.cfg' in the Nimsoft directory. The package requests are submitted to the distsrv probe, or ADE (Automatic Deployment Engine) probe if you are running 8.3 or higher, which then performs the installation.

Here is an example of the contents of a request.cfg file:

<distribution request>
packages = cdm, processes, ntevl
</distribution request>


To perform a complete installation of a Robot and a set of packages, you should prepare a request.cfg file and copy it to the intended Nimsoft installation directory (normally C:\Program Files (x86)\Nimsoft) then install the Nimsoft Robot.

Please also note that a script can start and stop a robot but a script cannot push the request.cfg as this is a built-in function of the robot. If the request.cfg is in the correct location (and has no mistakes in the file contents) - when the robot starts and the robot is in good working condition, it will recognize the existence of the request.cfg file and process it.
Additional Information:

Is it possible to specify the path to distsrv in request.cfg ?

Yes, for controller (robot) version 5.00 or higher please use:

<distribution request>
distsrv = /<domain>/<hub>/<robot>/distsrv

where you replace the following parts of the UIM address of the distsrv probe you want to use with the following:
<domain> = UIM domain name
<hub> = hub name
<robot> = hub robot name

Note that the UIM address specified is case sensitive.  For example, my_uim_domain is not the same as my _UIM_domain.


Can I use request.cfg to deploy a super package to apply changes to multiple probes?

Yes, the request.cfg can also deploy a super package during its operations as well - just specify its name in the list of packages in the request.cfg file.
 

Can I use the automated_deployment_engine (ADE) probe to deploy packages with the request.cfg file?

As of CA UIM 8.20 or higher:

The following comments pertain to support for request.cfg deployment with robot v7.70 and higher...

Upon startup, the robot/controller looks for request.cfg, a user-created text file that enables automatic deployment of the probes specified in that file to the robot. Previously, these requests could only be facilitated by distsrv, which still handles them by default.

To have a v7.70 robot direct the requests to ADE, use the Raw Configure utility to add the deploy_addr parameter to the robot.cfg, and specify the UIM Nimsoft address of the ADE probe:

deploy_addr=/<domain>/<hub>/<robot>/automated_deployment_engine

 

See also CA UIM  Release Notes for more information:

automated_deployment_engine (Automated Deployment Engine) Release Notes

 

Here is another link that you may find useful regarding use of ADE which can still be used in CA UIM version 8.2.

Bulk Robot Deployment with an XML File
 

Other related information on request.cfg and ADE usage can be searched and found in the CA Community/Experts Forum at this link:


https://communities.ca.com/community/ca-experts-forum/infrastructure-management-ef/nimsoft-monitor-ef/content?query=request.cfg



keywords: request cfg request.cfg file silent install installation ADE distsrv how auto automatic