File

Distributes files from the Distributor's file system, or removes files from a target file system. With this type you can select files and directories for the Distribution and select a destination path for extraction on the Subscriber.

Select Type
Select File.

Files To Be Distributed
An expandable tree structure showing file paths and filenames.

The root entry (added using the New Target button) signifies where the extraction will begin. Any directories you add manually (with the Add Directory button) will create the path structure for files or directories to be extracted into.

Any directories or files you browse for on your Distributor's file system will display their full paths. These paths are only for locating the directories or files for copying. The paths will not be replicated on the Subscriber's file system.

New Target
The target file system's root location. The variable %DEST VOLUME% is the default, or you can enter an exact volume or shared folder name.

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

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

When entering a directory name, be sure to press Enter or the change will not be saved.

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 will be 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 will also be 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 will not be expandable. You can only remove items listed in the tree structure in the Files To Be Distributed box.

WARNING: Directories that you select for the Distribution and any target directories cannot be Read-Only. This will cause file-writing to such target directories to fail.

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

Synchronize Directories
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 will be 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 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 will be teated the same as the other target Subscribers.

Verification Distributions
Each time a Distribution changes, such as when files are modified or added, a new version is built and subsequently sent to the Subscribers. However, Subscribes may 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
During file extraction, retries overwriting a locked file the number of times you select before failing to replace the file. Leave this check box disabled to not replace locked files on the target file system.

Kill Conn On Open Files
Kills the connection that is holding the file open so that the file can be overwritten and the extraction can continue.

Maintain Trustees
Only on NetWare® servers, maintains the source file's trustee attributes. The trustee information is obtained when the Distribution is built.

Error Handling
Select one:

Fail on Error
Extraction of the Distribution stops. You can fix the error before resending it. This is the default option.

Continue on Error
The extraction is continued with an error written to the Subscriber's log file concerning the part of the extraction that failed.



ZENworks Online Documentation

A trademark symbol (®, TM, etc.) denotes a Novell trademark. An asterisk denotes a third-party trademark. For more information, see Legal Notices.