Reference › DSA Commands (DXserver Commands) › Commands Reference › set agreement Command—Create a DISP Agreement

set agreement Command—Create a DISP Agreement

This command has the following format:

set agreement id.version =
{
	initiator	= dsaname { supplier | consumer } 
	responder	= dsaname { anonymous | clear-password | ssl-auth }
	[relay		= dsaname { anonymous | clear-password | ssl-auth }]
	area		= DN
	[filter	= search-filter ]
	[attributes	= attribute-list ]
	[strategy	= onchange | frequency time type ]
};

id.version

The agreement identification and version numbers (for example, 1.2).

initiator

The DSA initiating the DISP update:

dsaname

The name of the initiating DSA.

supplier

Specifies that the initiating DSA is acting as a supplier.

consumer

Specifies that the initiating DSA is acting as a consumer.

responder

The DSA receiving the DISP update.

dsaname

The name of the responding DSA.

anonymous

Specifies that the responding DSA can receive an anonymous connection.

clear-password

Specifies that the responding DSA requires a user ID and password.

ssl-auth

Specifies that the responding DSA requires a SSL authentication.

relay

(Optional) Specifies an intermediate DSA used to relay the DISP update:

dsaname

Names the relay DSA.

anonymous

Specifies that the relay DSA can receive an anonymous connection.

clear-password

Specifies that the relay DSA requires a user ID and password.

ssl-auth

Specifies that the relay DSA requires a SSL authentication.

area = DN

Specifies the distinguished name of the entry at the top of the subtree covered by this agreement.

filter = search-filter

(Optional) Specifies an X500 search filter that restricts the entries to be included in the DISP update.

attributes = attribute-list

(Optional) Specifies a comma-separated list of attributes to include or exclude from the DISP update.

strategy

(Optional) Enables automatic DISP updates, or specifies when the updates will take place:

onchange

Enables automatic DISP updates.

frequency

Specifies the update frequency. Use one of the following values: hourly, daily, weekly, or monthly.

time

Specifies the time at which the update will occur. Use one of these formats: dd:hh:mm or hh:mm.

type

Specifies the type of update. Use one of the following values: incremental or full.

Example: Create a DISP Agreement

set agreement 0.0 =
{

initiator = EAGLE supplier
responder = BACKUP anonymous
area      = <c AU><o Democorp>
strategy  = daily 03:00 incremental

};

Example: Create a Selective Shadowing Agreement

set agreement 2.1 =
{

initiator = EAGLE supplier
responder = BACKUP anonymous
area = <c AU><o Democorp>
filter = { attr = objectClass value = organizationalPerson }
attributes = { { exclude = title, description, telephoneNumber } }
strategy = on-change

};

More information:

Set a DSA to Use DISP Replication