.\"Generated by nroff_template.wdt (28-Apr-06). Do NOT edit this output file. Instead, edit the source FM+SGML file.
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH ovagtrep "" "" ""
.ds )H Hewlett-Packard Company
.ds ]L
.ds ]W August 2006
.SH NAME
ovagtrep - Enables configuration and control of the discovery agent and agent repository.
.SH "SYNOPSIS"

.LP
\fIovagtrep [-clearAll] |
         [-run <policy name>] |
         [-publish] \fR

.SH "DESCRIPTION"

.LP
The discovery agent is an extension to the HTTPS agent, which runs service discovery policies that have been deployed from a management server. It stores the services that it discovers in the agent repository, which is a local data store of services that exist on the node.

.LP
The agent synchronizes the services in the agent repository with the management server. The management server receives details of new, changed, and removed services only. Details of unchanged services are not resent.

.LP
The ovagtrep command enables you to configure and control the discovery agent and agent repository. It has the following options:

.LP
\fI-clearAll\fR

Clears all services from the agent repository. The next time that the discovery agent runs service discovery policies, it will recreate the services. The agent then synchronizes the services with the management server. This is enables you to force the agent to synchronize unchanged services with the management server.

.LP
\fI-run <policy name>\fR

Runs a service discovery policy. Use this to run a policy at an unscheduled time, to discover any changes immediately. The agent sends details of changes to the management server. You can find the names of installed policies using ovpolicy.

.LP
\fI-publish\fR

Resends details of all the services that are currently in the agent repository to the management server. Use this for troubleshooting if services fail to appear on the management server.

.LP
The discovery agent and agent repository are part of a component that is registered with the HP OpenView control service. You can start and stop the component with the commands ovc -start agtrep and ovc -stop agtrep.

.LP
You can use the command ovconfchg to modify the following settings in the agtrep name space:

.LP
\fIACTION_TIMEOUT <minutes>\fR

Sets the maximum number of minutes that a service discovery policy can run. If the policy runs any longer, the discovery agent stops running the policy and logs an error in the system log (<\fIdata_dir\fR>/log/System.txt).

.LP
\fIINSTANCE_DELETION_THRESHOLD <value>\fR

Sets the number of times that service discovery policies must fail to discover existing services before the agent deletes the services from the agent repository.

If a service discovery policy can no longer discover a service that exists in the agent repository, the discovery agent deletes the service from the agent repository only after the service discovery policy has run the number of times that you specify with this setting.

.LP
For example, to set the action timeout to five minutes with the command ovconfchg -ns agtrep -set ACTION_TIMEOUT 5.

.LP
After you change the action timeout or instance deletion threshold, restart the component with the command ovc -restart agtrep.

.SH "AUTHOR"

.LP
ovagtrep was developed by Hewlett-Packard Company, LP.

.SH "SEE ALSO"

.LP
ovc

.LP
ovpolicy

.LP
ovconfchg