Lotus Domino Designer 8 Help - Limiting the contents of a replica

APPLICATION MANAGEMENT

Limiting the contents of a replica
Use the following replication settings in the File - Replication Settings dialog box to limit the size of a replica or to display a subset of information relevant to a particular group of users.

Remove documents not modified in the last x days (Space Savers panel)

The number of days specified here, known as the purge interval, controls when IBM® Lotus® Domino(TM) purges deletion stubs from a database. Deletion stubs are markers that remain from deleted documents so that Domino knows to delete documents in other replicas of the database. Because deletion stubs take up disk space, Domino regularly removes deletion stubs that are at least as old as the value specified. It checks for deletion stubs that require removal at 1/3 of the purge interval. For example, assuming the default value, 90 days, when a user opens a database, Domino checks if it has been at least 30 days since it removed deletion stubs, and if so it removes any deletion stubs that are at least 90 days old. The Updall task, which runs by default at 2:00 AM, also removes deletion stubs.

You can shorten the purge interval, if you want, but be sure to replicate more frequently than the purge interval; otherwise, deleted documents can be replicated back to the replica.

Optionally, you can select the check box to remove documents in the replica that haven't changed within the purge interval. If you select the check box, when Domino removes deletion stubs it also removes documents that haven't changed within the specified number of days. These documents are purged, meaning no deletion stubs remain for the documents, so the documents aren't deleted in other replicas. The "Only Replicate Incoming Documents Saved or Modified After: date" setting prevents the purged documents from reappearing through replication. If the other replicas have this check box selected, similar document purging occurs in them.

Caution If you select the check box on a database that does not replicate, documents are lost and you can only recover them from a system backup.

Note Domino regularly removes deletion stubs according to the purge interval even if you don't select the check box.

Only Replicate Incoming Documents Saved or Modified After: date (Other panel)

A replica can only receive documents created or modified since the date specified. If you clear the database replication history, during the next replication, Domino scans only documents created or modified since the date specified here. If you clear the date before clearing the replication history, Domino scans all documents in the database.

Use this option in conjunction with clearing the replication history to solve replication problems. If you clear or change this date, when Domino next purges deletion stubs, it resets the date to correspond to the number of days specified in "Remove documents not modified in the last x days" setting. For example, if Domino purges deletion stubs on 1/1/99 and the "Remove documents not modified in the last x days" setting is 90, on 1/1/99 Domino resets the date to 10/1/98. If the check box is selected in the "Remove documents not modified in the last x days" setting -- meaning documents that meet the purge interval criteria are purged as well as deletion stubs -- this automatic date reset ensures that the purged documents aren't replicated back into the replica.

For more information on the replication history, see Lotus Domino Administrator Help.

Receive summary and 40KB of rich text only (Space Savers panel)

If you select this setting, Domino prevents large attachments from replicating and shortens the documents that this replica receives. The shortened documents contain only a document summary that includes basic information, such as the author and subject, and the first 40KB of rich text.

When users open a shortened document, they see "(TRUNCATED)" in the document title. To view the entire document, users must choose Actions - Retrieve Entire Document from the open document.

Keep the following points in mind when using this setting:

Users can't categorize or edit shortened documents.
Agents don't work on shortened documents.
Shortened documents replicate only if the destination replica also has this option selected.

Replicate a subset of documents (Space Savers Advanced panel)

Use this setting to specify that a replica receives only the documents in a specific folder or view or only documents that meet selection criteria specified in a formula. Replication formulas are similar to view selection formulas.

For more information on view selection formulas, see Programming which documents display in a view.

Keep in mind the following points when you use replication formulas:

You cannot use @DbLookup, @UserName, @Environment, or @Now in a replication formula.
Using @IsResponseDoc in a replication formula causes all response documents in a database to replicate, not just those that meet the selection criteria. Use @AllChildren or @AllDescendants instead and make sure the database performance property "Don't support specialized response hierarchy" is not selected.

For more information on database performance properties, see Setting advanced database properties.

Replicate (Advanced panel)

Use this setting to control which non-document elements a replica receives. This table describes the Replicate options:

Replicate Default Description

Forms, views, and so on Selected If selected, allows a replica to receive design changes, such as changes to forms, views, and folders from a source replica.
If deselected, prevents a replica from receiving design changes. Alternatively, you can assign source servers Editor access or lower in the ACL; however, doing so prevents agents from replicating.
Don't select this option when you first create the replica because the new replica won't contain any design elements for displaying information.

Agents Selected If selected, allows a replica to receive agents. If deselected, prevents the replica from receiving agents, although the replica still receives changes made by the agents.

Replication formula Not selected If selected, ensures that replication settings specified for multiple destination replicas from one source replica can replicate. This option is required if you're using a central source replica to manage replication settings for multiple replicas.

Access control list Selected If selected, allows the replica to receive ACL changes from any server that has Manager access in the replica's ACL.

Deletions Selected If selected, allows the replica to receive document deletions. If deselected, the replica won't receive deletions through replication, but users assigned "Delete documents" access in the replica ACL can still delete documents from the replica.
Note If "Do not send deletions made in this replica to other replicas" (on the Send panel of the Replication Settings dialog box) is selected for the source replica, this replica won't receive deletions from the source replica, regardless of this setting.

Fields Not selected If deselected, the replica receives all fields in each document received. If selected, you select a subset of fields to receive, but you should only do this if you have a thorough knowledge of application design.
If you're replicating a Domino Directory, you can also choose among minimal Address Book options. These options provide a way for mobile users to replicate a small version of a Domino Directory locally. The minimal Address Book options are also available in the Space Savers panel.
Note that users can also use a mobile directory catalog to have local access to names in a Domino Directory.

For information on the minimal Address Book options, see Lotus Notes Help.

For information on directory catalogs, see Lotus Domino Administrator Help.

See Also

Replication settings

Limiting what a replica sends

Specifying replication settings

Glossary

Feedback on Help or Product Usability?

Help on Help

All Help Contents

Glossary

Replicate	Default	Description
Forms, views, and so on	Selected	If selected, allows a replica to receive design changes, such as changes to forms, views, and folders from a source replica. If deselected, prevents a replica from receiving design changes. Alternatively, you can assign source servers Editor access or lower in the ACL; however, doing so prevents agents from replicating. Don't select this option when you first create the replica because the new replica won't contain any design elements for displaying information.
Agents	Selected	If selected, allows a replica to receive agents. If deselected, prevents the replica from receiving agents, although the replica still receives changes made by the agents.
Replication formula	Not selected	If selected, ensures that replication settings specified for multiple destination replicas from one source replica can replicate. This option is required if you're using a central source replica to manage replication settings for multiple replicas.
Access control list	Selected	If selected, allows the replica to receive ACL changes from any server that has Manager access in the replica's ACL.
Deletions	Selected	If selected, allows the replica to receive document deletions. If deselected, the replica won't receive deletions through replication, but users assigned "Delete documents" access in the replica ACL can still delete documents from the replica. Note If "Do not send deletions made in this replica to other replicas" (on the Send panel of the Replication Settings dialog box) is selected for the source replica, this replica won't receive deletions from the source replica, regardless of this setting.
Fields	Not selected	If deselected, the replica receives all fields in each document received. If selected, you select a subset of fields to receive, but you should only do this if you have a thorough knowledge of application design. If you're replicating a Domino Directory, you can also choose among minimal Address Book options. These options provide a way for mobile users to replicate a small version of a Domino Directory locally. The minimal Address Book options are also available in the Space Savers panel. Note that users can also use a mobile directory catalog to have local access to names in a Domino Directory.