Options

Description

Run Packages As

Sets the global default for how deployments are executed on target computers.

This global setting can be overwritten at the Step, Package, and Schedule levels.

For a sample demonstration of the Run As options, see the following video.

VIDEO: Deployment Run As Options

(https://support.pdq.com/hc/en-us/articles/220538547)

Deploy User

Executes deployments on target computers in a non-interactive session as the Deploy User.

This setting is appropriate for the vast majority of deployments. Consequently, this is the recommended setting for Preferences.

Deploy User (Interactive)

Executes deployments that include both silent and interactive steps. This setting is the same as Deploy User with one important exception—the Windows process running the deployment is run in an interactive session.

This setting is most appropriately used for individual deployments that require user input, but the overall process still requires Administrator rights that logged on users may not have. Because these types of deployments are more specialized and because running the deployment in interactive mode requires more processing resources, it is recommended that you apply this setting only as needed at the Package or Step level.

IMPORTANT: This feature is available only in Enterprise mode.

Local System

Executes deployments using the Local System account on the target computer. PDQ Deploy connects to the target computer using the Deploy User credentials, copies the specified files, creates the PDQDeployRunner service, then instructs the service to log on as Local System.

This setting is used only for installations that require Local System. These types of deployments are very rare. Consequently, it is recommended that you apply this setting only as needed at the Package or Step level.

IMPORTANT: Deployments, Packages, or Steps that run as Local System are not able to access network resources.

Logged on User

Attempts to run packages in interactive mode as the Logged On User of the target machine.

This setting is used to deploy applications that are installed per user or when the Logged on User needs to provide information for the deployment to succeed such as a license key. It can also be used to modify the HKEY_CURRENT_USER registry hive for the Logged on User or to access user-specific settings such as %APPDATA% or the Logged on User’s user directory. These types of deployments are highly specialized. Consequently, it is recommended that you apply this setting only as needed at the Package or Step level.

IMPORTANT: This feature is available only in Enterprise mode.

Timeout

Specifies how many minutes deployments should run before being timed out by the server.

This timeout applies only to the duration of a deployment to a target computer. The timeout does not include the initial process of copying installation files to the target. The default value is 60 minutes.

This setting may be overridden in the individual Package Properties.

When configuring your local system, it is best practice to set the shortest timeout interval as the global default in Preferences and increase the timeout interval only in individual packages. For example, if you typically deploy small packages such as browser, Java, or Adobe reader updates, you may choose to set the global timeout interval to 20 minutes. You could then increase the timeout interval for individual packages that take longer to install, such as a Windows Service Pack or a package containing many nested packages.

Cleanup

Specifies how many days deployment histories are archived in the PDQ Deploy database before they are deleted.

The cleanup process ensures that old deployment history is cleared out. You can set this value higher or lower depending on how many deployments you run and how long you wish to see the results of finished deployments. The default age is 30 days, i.e. one month after the deployment finishes.

Setting the cleanup to 0 days disables automatic cleanup; PDQ Deploy never deletes deployment histories.

WARNING! Keeping this value high or setting it to 0 days may cause the PDQ Deploy database to get very large, which could slow PDQ Deploy performance.

Scanning

Initiates an inventory scan from PDQ Inventory after a deployment to identify what is installed on the deployment’s target computers. You can select which scan profile you want to use for the post-deployment scan. This feature can be very helpful in maintaining up-to-date inventory for target machines.

This setting may be overridden in the individual Package Properties. For example, if you have a package that doesn't install an application, then you may want to disable inventory scanning in the respective package’s Package Properties.

IMPORTANT: This feature is available only in Enterprise mode and also requires PDQ Inventory version 3.1 or later in Enterprise mode. Additionally, the target computer must already be in PDQ Inventory with a name or hostname that matches the name used in PDQ Deploy.

You may choose which scan profile to use. The default scan profile is defined in PDQ Inventory in Preferences > Scan Profiles. You can choose to scan with any scan profile that has been configured in PDQ Inventory. It is common to use either the Applications or Standard scan profiles.

Offline Status

The Offline Status is used to determine whether or not target computers will receive a ping or Wake-on-LAN prior to deployment.

Ping before deployment

Performs a ping (ICMP echo) before attempting the deployment. If the target does not respond to the ping within 2 seconds, then the deployment is not attempted on that target. 

Enabling this option can increase the overall speed of the deployment because PDQ Deploy will only deploy to online computers.

NOTE: Typically, the ping should take only a few milliseconds. However, if your DNS isn’t solid or your network is experiencing latency issues, then the ping response may take more than 2 seconds. 

When this is not selected, PDQ Deploy attempts the deployment regardless of the online or offline status of the target computer. If the target is offline or otherwise unavailable, Windows will timeout after ~60 seconds. Leaving this unchecked can decrease the overall speed of the deployment due to these attempts and extra wait time.

Send Wake-on-LAN and attempt deployment

Attempts the deployment then sends a Wake-on-LAN to offline target computers. The deployment is attempted again if it comes online. After 5 minutes if the computer is still offline, the deployment will be attempted again. 

The advantage of this feature is that offline computers can immediately be made available for deployment. However, it can increase deployment time.

IMPORTANT: This feature is available only in Enterprise mode of both PDQ Deploy and PDQ Inventory. Furthermore, PDQ Inventory must have the MAC address of the target computers’ NICs.

Retry Queue

The Retry Queue is a deployment queue for target computers that are unreachable or offline during a deployment. The deployments are held in the Retry Queue and deployment is retried as per the following configured parameters.

IMPORTANT: The Retry Queue is available only in Enterprise mode.

Put Offline targets in Retry Queue

Enables the Retry Queue. By default, target computers that are unreachable or offline during a deployment are held in the Retry Queue and deployment is retried.

This global setting can be overridden in the individual Package, Deployment or Schedule properties.

The advantage of this feature is that offline computers are automatically queued for re-deployment. This simplifies the process of ensuring that critical updates are deployed to all target computers. However, it is recommended that you enable this option per package or deployment rather than applying it globally in Preferences.

TIP: Some packages with specific, non-critical functions should not use the Retry Queue. For example, it is not advisable to use this option with a package that only reboots target computers because offline computers were probably turned off to begin with and, depending on the target computers’ availability, PDQ Deploy may reboot users’ computers at inopportune times.

Allowed Retries

Sets the number of retry attempts for an offline computer. This applies per target per deployment.

The default setting is 72. To set unlimited retries, set this value to 0.

This global setting can be overridden in the individual Package and Schedule properties.

Retry Interval

Specifies the amount of time between deployment retry attempts.

The default setting is 1 hour. The minimum interval setting is 15 minutes.

The Retry Interval is a global setting.

Options

Description

Concurrent Target Limits

Defines how package deployments are limited to concurrent targets. The higher the numbers, the greater the use of server memory, CPU resources, and network bandwidth.

NOTE: Using the prioritize feature will allow the targets to exceed the Concurrent Targets per Deployment, but will not exceed the Total Concurrent Targets set in Preferences > Performance.

Concurrent Targets per Deployment

The maximum number of targets that can be deployed concurrently for each deployment.

The default setting is 8. Additional targets are placed in a queued state until a connection is available.

This number cannot be higher than the Total Concurrent Targets.

IMPORTANT: This setting is available only in Enterprise mode.

Total Concurrent Targets

The maximum number of concurrent targets in total (multiple deployments).

Once this limit is reached, additional targets are placed in a queued state until a connection is available.

The default setting is 32.

IMPORTANT: This setting is available only in Enterprise mode.

Copy Mode

Defines how PDQ Deploy copies deployment files to target computers.

When files (such as installation files) are copied to a target, PDQ Deploy uses either Push or Pull Copy Mode. By default, PDQ Deploy uses Push Copy Mode.

This global setting can be overridden in the individual Package properties.

IMPORTANT: This setting is available only in Enterprise mode.

VIDEO: Understanding Push and Pull Deployments

Push

Copies files to the target computers from the PDQ Deploy computer. This method is best if the package’s install files are located on the PDQ Deploy computer.

This option is the default copy mode.

Bandwidth throttling (see below) applies to all simultaneous file copies combined.

Pull

Sends lists of files to the target computers which then pull the files from a centralized location. This method works best in WAN environments where the files may be on a file server closer to the target computers than the computer where PDQ Deploy is running.

For this method to work, all files need to be accessible using a UNC path (e.g. \\server\share\installer.msi).

WARNING: Files on fixed or mapped drives are not accessible to the target computers; therefore, a valid UNC path must be provided.

Note Bandwidth throttling (see below) is not enforced when using Pull Copy Mode.

IMPORTANT: This setting is available only in Enterprise mode.

Limit Bandwidth Usage

Sets the percentage of available bandwidth to use during the copy phase of the deployment when large files are being copied down to the target computers.

PDQ Deploy can throttle bandwidth as it copies software to target computers. This can be particularly helpful over slow links. The throttling works based on a percentage of available bandwidth, with the default rate being 50%. This limit is achieved by ensuring that the server waits between packets long enough to keep its utilization below the given threshold. Therefore, even if the server is copying to a computer on the same subnet and a computer over a slow WAN, it will keep 50% headroom on each link.

If set to 100%, then no limit is imposed and the file copy operation takes as much bandwidth as is available.

IMPORTANT: The Bandwidth Limit will apply to all simultaneous file copies combined.

NOTE: Throttling doesn't apply when using Pull Copy Mode (see above).

IMPORTANT: This setting is available only in Enterprise mode.