1E Product Pack Deployment Tool (PPDT)

TeamViewer DEX Platform 26.7 Green checkmark | 1E Platform 23.11 Green checkmark | 1E Platform on-premises 9.x Green checkmark

Learn how to deploy integrated DEX Packs to quickly add prebuilt automation, monitoring, and remediation content to your Platform environment. This guide explains deployment prerequisites, installation steps, update management, and best practices for enabling product-specific capabilities and accelerating endpoint management.

The latest release of the Platform does not require all downloadable components to be updated. Refer to the Release notes for what is new, and what is compatible. You can download tools for the Platform and the 1E Client from TeamViewer Support Portal.

You can use the 1E Product Pack Deployment Tool (PPDT) to upload DEX Packs into the Platform. DEX Packs are available from TeamViewer DEX Hub. Refer to DEX Packs reference

Getting started

To run the tool, you need the following:

Account permissions

The account used to run the Tachyon.ProductPackDeploymentTool.exe must have the following:

  • Local administrator rights on the computer it is running on.

  • Exist as a Platform user assigned to either Installer or Full Administrator role.

    • Guaranteed State administrator.

    • Instruction Set administrator.

Locating the 1E Product Pack Deployment Tool

  • Tachyon.ProductPackDeploymentTool.exe (and its supporting files) is used to upload DEX Packs into the Platform.

  • The tool creates a log file called Tachyon.ProductPackDeploymentTool.log in the same folder.

Running the 1E Product Pack Deployment Tool

Here are the steps for running the tool:

  1. Navigate to the directory where the tachyonproductpacks.<version>.zip file has been unzipped.

  2. In this directory you can also see the 1E Product Pack Deployment Tool files.

    • Newtonsoft.Json.dll

    • Tachyon.ProductPackDeploymentTool.exe

    • Tachyon.ProductPackDeploymentTool.exe.config

    • Tachyon.SDK.Consumer.dll

  3. Double-click on Tachyon.ProductPackDeploymentTool.exe.

  1. Click on Yes if any UAC dialog is displayed.

  1. The 1E Product Pack Deployment Tool dialog will appear.

    • You must specify the URL of the 1E Consumer API in the Server field and then click on Test Connection to verify that you have entered the correct value.

    • The Available Product Packs table will be populated with all the zip files encountered in the directory the tool was launched from and all its sub-directories.

    • The Select all box can be used to select or deselect all the items in the Available Product Packs table.

    • Click Use non-default credentials if you need to use alternative credentials. Domain is not required if connecting to a non-domain joined server, or server in an untrusted domain.

Uploading DEX Packs

When you have selected and checked the 1E Consumer API location you will then be able to upload the selected Available Product Packs by clicking Upload selected. The content of the selected packs will then be uploaded to the Platform. The Results field displays the progress of the operation.

Updating Policies, Rules, Fragments, and Triggers that already exist in the Platform database is supported, but you need to be careful to ensure that the new artifacts uploaded are compatible with the existing ones.

Any new fragments and trigger templates uploaded need to have the same parameters that are used by the version of the same artifact that already exists in the database. Otherwise, any rules that are passing the previous set of parameters to the fragments will be broken when the new fragments start requiring a different set of parameters to be passed to them.

Cleanup option

Cleanup... on the main screen displays a dialog that lets you remove items from the Platform. You would not normally perform a cleanup on a production server. This option is intended mainly for use in lab environments where you want to delete and re-upload the content in order to test different DEX Packs.

There are two types of data that can be deleted using the Cleanup dialog and you will need to check the boxes for each type you want to delete.

Type of data

Description

Endpoint Automation

Selecting this will delete all Policies, Rules, Fragments and Trigger templates from 1E and any previous associations those items had with any Management Groups will be permanently lost.

Instruction Sets

Selecting this will delete all the Instruction Sets and any Instruction definitions they contain. When you do this all the Instruction Sets and Instruction definitions currently loaded into 1E will be deleted and any permissions associated with them will be permanently lost.

Errors will be generated if you try to delete any Instruction definitions that have active Instructions or schedules based on those definitions.

You need to read the warnings displayed on the dialog and be completely sure about wanting to delete the content before clicking on Delete. The program will display an additional confirmation dialog before proceeding to delete the selected content.

The deployment tool then calls the Consumer API and tells it to delete the selected items. If the Consumer API then decides that it cannot delete something because its current status doesn’t allow it, then it returns an error to the deployment tool. The deployment tool displays the message. The tool doesn’t care about whether a policy is enabled, or deployed or whatever. All validations are delegated to the Platform.

Log files

The log file is called Tachyon.ProductPackDeploymentTool.log. It is created in the same folder where the tool executable is located. The logging level can be changed by adding the parameter -log <level> on the command line, for example, -log DEBUG. Supported values available:

  • TRACE

  • DEBUG

  • INFO (default)

  • WARN

  • ERROR

Command-line options

  • -server or -url: Specifies the url for the Consumer API.

  • -log: Sets the logging level. Supported values available: Trace, Debug, Info, Warn, Error

  • -domain, -user and -password : These options allow you to override the default behavior of using the currently logged-in Windows user. A domain is not required if connecting to a non-domain joined server. This option is useful when you need to upload DEX Packs to a Platform running in the cloud, or from a computer that is not joined to the same domain.

Example

Copy 
Tachyon.ProductPackDeploymentTool -server https://platform.acme.local/Consumer -log debug -user administrator -password notasecret