File

Use this option when a Distribution consists of files on the Distributor's file system that are to be copied to a Subscriber server's file system.

Use the following fields and buttons to configure a File Distribution:


New Target

The target file system's location for where you want the Distribution to be extracted.

%DEST VOLUME% is the default.

IMPORTANT:  If you change the default, you must press the Enter key for the entry to be saved.

You can use any type of variable, or the actual location names. Examples of literal locations:

However, do not use a UNC path or all Distributions will be sent to only that one location. Instead, use variables. For more information, see Variables.


Add Directory

New Directory is the default name, which you should change to the directory name you want at the target location.

IMPORTANT:  If you change the default, you must press the Enter key for the entry to be saved.

Use this button to create the desired directory structure on your target Subscriber's file system for the files and directories you are adding.


Add Files

Browse for directories or files on the Distributor's file system that you want copied to the target Subscriber's file system.

Each directory or file you select is displayed with the full path that it has on the source file system. This path identifies where to obtain the directory or file for copying to the target file system. The only path that is created on the target file system is the one you create using the New Target and Add Directory buttons, and any directories that you select with the Add Files button to add under them.

If you select a directory, all files and subdirectories under it are also selected for copying. Unlike the Copy File component in the Server Software Package, you cannot prune files and subdirectories from a selected directory. Any directory you browse for and add is not expandable. You can only remove items listed in the tree structure in the Files To Be Distributed box.


Delete

Only deletes whatever you have selected from the tree structure in the Files To Be Distributed box:


Synchronize Directories

This causes the directories on the target server to be synchronized with the directories contained in the Distribution.

WARNING:  If the target server contains directories not contained in the Distribution, those directories and all files and subdirectories are deleted from the target server's file system when the Distribution is extracted.

This can be very destructive, especially if the target directory is a root directory. Only enable directory synchronization where you are certain you want to allow existing directories that are not contained in the Distribution to be deleted.

Also, if the Distributor whose files system you are using for this Distribution is also a Subscriber that is subscribed to the Distribution, the Distributor's file system is treated the same as the other Subscribers' file systems.

For more information on synchronization, see Directory Sync Granularity for File Distributions.


Verify Distributions

Each time a Distribution changes, such as files are modified or added, a new version is built and subsequently sent to the Subscribers. However, Subscribes might need to verify that the files contained in a Distribution have been extracted and installed to all Subscribers, even when there is no new version to send.

The verification option allows you to specify that when the Send schedule starts, if there is no new version of the Distribution to send, the Distributor should send a request for the Subscriber to re-extract the current version to ensure that the files are installed.


Retry __ Times

Retries overwriting a locked file the number of times you select before failing to replace the file. Leave this check box deselected to not replace locked files on the target file system.


Kill Connection on Open Files

Attempts to kill the connection of locked files so that they can be overwritten. This applies only to files being extracted, not to files being accessed to build the Distribution. If a file belonging to a Distribution is locked when the Distribution is being built, the build fails.

Also, server and NLMTM connections cannot be killed.


Maintain Trustees

Maintains each file's trustee attributes for the target NetWare file system to be as they are on the source file system. The trustee information is obtained when the Distribution is built.

This is additive, meaning it does not remove trustees on the target file system.

If synchronization is turned on for directories in a Distribution, the trustees of those directories are also synchronized.


Error Handling

You have two options: