13.10 ConfigSiteNetFlowCtrl

Use this Knowledge Script to configure the characteristics of NetIQ Corporation AppManager Client Communication Manager service (NetIQccm) communication to the management server for the current repository.

This script allows you to control the flow of network traffic from a managed client to the management server by defining upper and lower bandwidth limits for the size of message batches transferred. One batch is sent at each communication interval. You can also set the length of the communication interval in seconds.

13.10.1 Resource Objects

Windows 2003 Server or later

13.10.2 Default Schedule

The default interval for this script is Run once.

13.10.3 Setting Parameter Values

Set the following parameters as needed:

Parameter

How to Set It

Network flow upper limit

Specify an upper bandwidth limit, in KB, for each network message batch from NetIQccm to the management server. The default of 0 indicates no upper limit.

Network flow lower limit

Specify a minimum bandwidth, in KB, for each network message batch from NetIQ Corporationccm to the management server. The default of 0 indicates no lower limit.

Communication interval

Specify the frequency (in seconds) with which NetIQccm can send message batches to the management server. The default is 0 indicates no delay between message batches.

Tune network flow dynamically?

Set to y to have the NetIQccm agent service dynamically tune and control the size of network message flows to the management server, based on the management server’s current load. The default is n.

Raise event if job succeeds?

Set to y to raise an event indicating the success or failure of the operation. The default is n.

Event severity when job...

Set the event severity level, from 1 to 40, to reflect the importance when the job:

... succeeds. If you set this script to raise an event when the job succeeds, set the event severity level for a successful discovery. The default is 25 (blue event indicator).

... fails. The default is 5 (red event indicator).

13.10.4 Example of How this Script Is Used

This script is intended to help you manage network bandwidth and control and tune the transfer of data from managed clients to the management server to suit your network capacity. Using this script, you can restrict the amount of data the NetIQccm agent service sends at any one time, as well as the frequency of data transfers.

For example, assume you define an upper limit of 100K, a lower limit of 2K, and a communication interval of one hour (3600 seconds). With this configuration, NetIQccm sends up to 100K of data per hour to the management server until the data waiting to be transferred falls below 2K. NetIQccm then stores the data in the local repository. At the next interval, if the data to be transferred is greater than 2K, NetIQccm resumes sending the data to the management server. If the data package is still below 2K, NetIQccm continues to store the data in the local repository until the next interval.

“Dynamic tuning” provides additional flexibility by allowing NetIQccm to respond to load changes on the management server. When the Tune network flow dynamically? parameter is enabled and the management server becomes busy, NetIQccm decreases the amount of data sent and increases the communication interval until the load on the management server is reduced.

Each time the NetIQccm service connects to transfer data, it checks the current load on the management server. If load has increased, NetIQccm further reduces the amount of data sent in each batch. NetIQccm continues to reduce the amount of data sent until the amount of data to be sent falls below the lower limit you set, or until load on the management server decreases, freeing up bandwidth.