Working Directories

Distributors and Subscribers use working directories on the servers for Distributions, patches, status files, and temporary working files. The size of a working directory is determined by the size and number of Distributions.

The working directories default to the SYS: volume on NetWare servers or the C: Drive on Windows servers. Because of disk space considerations on NetWare servers, we recommend that you select a different location on the server, such as a DATA: volume.

The default working directory names for NetWare and Windows servers are Path\ZENWORKS\PDS\TED\DIST for the Distributor and Path\ZENWORKS\PDS\TED\SUB for the Subscriber. For Linux and Solaris servers, the paths are usr/ZENworks/PDS/TED/Working/Dist and usr/ZENworks/PDS/TED/Working/Sub. You can change working directory names in the properties of the TED object.

The following sections describe the TED directory structures:


NetWare Distributor Directories

The following directories are used by NetWare Distributors:


volume:\installation_path\ZENWORKS\PDS\TED

Contains the TED software for the Distributor.


volume:\installation_path\ZENWORKS\PDS\TED\Security\Private

Contains the Distributor's private key.


volume:\working_directory

Contains one subdirectory for each Distribution that belongs to the Distributor. The working directory name is user-defined in the Distributor object.


volume:\working_directory\Distribution_directory

Each Distribution has its own subdirectory that is created under the working directory. The Distribution directory's name is derived from the following syntax: Tree_DN_of_Distribution. For example, TestTree_Files.TED.Novell.


volume:\working_directory\Distribution_directory\time_stamp_directory

Each Distribution directory contains multiple time stamp directories, which are named according to the date and time the Distribution was built.

Each time a Distribution is built, the Distributor checks to see if anything has changed since the last time the Distribution was built. If so, a new time stamp directory is created.

The number of time stamp directories kept is determined by the Maximum Number of Revisions to Keep field in the Distribution object's properties. There are occasions when the number of time stamp directories will exceed the maximum number specified because the Distributor will not delete a time stamp directory that is in use. The Distributor removes the oldest time stamp directories first.

Sometimes a time stamp directory name will have _TEMP appended to it. When a Distributor builds a Distribution, it creates a *_TEMP directory before it determines if anything has changed. If changes are discovered, the _TEMP is removed and the directory is used for the new build.

A Distributor's time stamp directories contain the following files:

Filename Description

DISTFILE.TED

The Distribution that was built. All Distributions have the same filename. They are distinguished by their time stamp directory's name and path.

digest_file

This file will only exist if the Distributor Agent creates it (optional).

Digests are used by Distributors and Subscribers to verify that Distributions have not been tampered with while in transit. The digest provides a checksum for the Subscriber to compare.

The syntax for creating the digest filename is:

    %AGENT%AgentDigest.TED

For example:

FTPAgentDigest.TED
HTTPAgentDigest.TED
FileAgentDigest.TED
CPKAgentDigest.TED


NetWare Subscriber Directories

The following directories are used by NetWare Subscribers:


volume:\installation_path\ZENWORKS\PDS\TED

Contains the TED software for the Subscriber and/or Distributor.


volume:\installation_path\ZENWORKS\PDS\TED\Security

Contains certificates received from Distributors.


volume:\working_directory

Contains one subdirectory for each Distribution that it receives from a Distributor. The working directory name is user-defined in the Subscriber object.


volume:\working_directory\Distribution_directory

Each Distribution has its own subdirectory that is created under the working directory. The Distribution directory's name is derived from the following syntax: Tree_DN_of_Distribution. For example, TestTree_Files.TED.Novell.


volume:\working_directory\Distribution_directory\time_stamp_directory

Each Distribution directory contains multiple time stamp directories, which are named according to the date and time the Distribution was built.

The number of time stamp directories kept is determined by the Maximum Number of Revisions to Keep field in the Distribution object's properties.

Once a threshold is met, the Subscriber receives the maximum revision information and deletes the oldest time stamp directories first.

A Subscriber's time stamp directories contain the following files:

Filename Description

DISTFILE.TED

The Distribution that was built. All Distributions have the same filename. They are distinguished by their time stamp directory's name and path.

DISTSTATUS.TED

Once a Distribution has been successfully received, this file is created.

digest_file

This file will only exist if the Distributor Agent has created it (optional).

Digests are used by Distributors and Subscribers to verify that Distributions have not been tampered with while in transit. The digest provides a checksum for the Subscriber to compare.


Windows NT Distributor Directories

The following directories are used by Windows NT Distributors:


installation_path\ZENWORKS\PDS\TED

Contains the TED software for the Distributor.


installation_path\ZENWORKS\PDS\TED\Security\Private

Contains the Distributor's private key.


Windows NT Subscriber Directories

The following directories are used by Windows NT Subscribers:


installation_path\ZENWORKS\PDS

Contains the TED software for the Subscriber.


installation_path\ZENWORKS\PDS\TED\Security\Private

Contains certificates received from Distributors.


local_drive:\working_directory\Distribution_directory\time_stamp_directory

Each Distribution directory contains multiple time stamp directories, which are named according to the date and time the Distribution was built.


UNIX Distributor Directories

The following directories are used by UNIX Distributors:


usr/ZENworks/PDS/TED/Working/Dist

Contains the TED software for the Distributor.


usr/ZENworks/PDS/TED/Security/Private

Contains the Distributor's private key.

Each Distribution directory contains multiple time stamp directories, which are named according to the date and time the Distribution was built.


UNIX Subscriber Directories

The following directories are used by UNIX Subscribers:


usr/ZENworks/PDS/TED/Working/Sub

Contains the TED software for the Subscriber.


usr/ZENworks/PDS/TED/Security/Private

Contains certificates received from Distributors.

Each Distribution directory contains multiple time stamp directories, which are named according to the date and time the Distribution was built.