A.3 FTP

This option distributes files from one or more FTP sources. Each source can contain one or more directories and/or files.

The FTP Distribution type enables the files to pass through your firewall as they are gathered into the Distribution.

If a target file is locked during extraction, the Subscriber throws an exception stating that the file could not be copied. The Distributor receives this information from the Subscriber and log the failure in the reporting database.

If you want to distribute an RPM software package from a Linux or Solaris FTP site, use the RPM type of Distribution rather than the FTP type.

Use the following fields and buttons to configure an FTP Distribution:

A.3.1 Files To Be Distributed

An expandable tree structure showing target paths to the FTP files to be distributed.

Modify the Distribution’s content as needed, then either click Apply to save the updated Distribution contents list, or click OK to save the changes and exit the Distribution’s properties.

A.3.2 New FTP Source

Specifies an FTP server from which to gather files for distribution:

  • FTP Server: Specify the fully qualified host name of the FTP server.

  • Login Name: Specify the login name that the Distributor Agent should use to access the FTP server. The default is Anonymous, which is often sufficient.

  • Password: Provide the password for the login name. (You might need to scroll to the right to see the field.) For Anonymous, the password is typically your e-mail address.

A.3.3 New Target

If you do not want to use the default variable %DEST_VOLUME%, replace it with a target location indicating where you want the FTP files to be distributed; for example:

  • A volume on a NetWare server, such as data:\

  • A drive on a Windows server, such as D:\

  • A file system on a Linux or Solaris server, such as /

Otherwise, press Enter to accept the variable. You can also replace it with a different variable.

The target can also be a full or partial path, not just the root designation of volume, drive, or root. For example:

  • A volume on a NetWare server, such as data:\ftp_distribution\files

  • A drive on a Windows server, such as d:\ftp_distribution\files

  • A file system on a Linux or Solaris server, such as /user/ftp_distribution/files

You must press Enter to add the target location change to the Distribution contents list.

Any target entries that do not exist in the target location are automatically created by the Distribution.

A.3.4 Add Directory

This option builds the target path. If you did not provide the full path using the New Target option, replace New Directory with a directory name.

You can use this option to add multiple directories to create the full path. You can also add sibling directories to create additional paths, as determined by the subdirectory you select before clicking Add Directory.

You must press Enter each time to add the target directory change to the path.

A.3.5 Add Files

If you specified the correct FTP server information under New FTP Source, then you are provided access to the FTP server. Browse for the files. You can add multiple files.

If you added sibling directories using Add Directory, be sure to select those target paths and click Add Files to browse for the files to be distributed to those path locations.

When you are finished adding files and target locations, either click Apply to save the updated Distribution contents list, or click OK to save the changes and exit the Distribution’s properties.

A.3.6 Delete

Deletes whatever you have selected:

  • Root Location: Removes all directories and FTP files below it from the tree.

  • Directory: Removes the directory and any of its FTP files and subdirectories from the tree.

  • File: Removes the FTP file from the tree, but not from the FTP location.

Deleting any part of a target location, including a directory, means that the designated FTP files that were in the Distribution are no longer sent to the deleted location.

However, deleting FTP files from the Distribution means that the corresponding files are deleted from each Subscriber server when the Distribution is sent again and processed.

Click Apply to save your changes.

A.3.7 Properties

Displays the properties of the selected FTP source.

A.3.8 Binary Transfer

Enables file transfers in binary for when you are distributing executable files. Text files do not require a binary transfer.

A.3.9 Include Symbolic Link Files

If you want all symbolic link files in the added directory (including from all of its subdirectories) to be part of the FTP Distribution, select this box. This applies only when you add a directory.

You do not need to check this box for individually added symbolic link files.

This check box does not have any control over whether symbolic link files are displayed when browsing to add directories and files.

Click Apply to save your changes, or click OK to save the changes and exit the Distribution’s properties.