Silent Distribution by IT

Follow these steps to download the Agent and the MSI installers:

  1. Navigate to the Admin Panel.

  2. Download the installer.

Note: You can add new teams in Team settings

  1. Open instructions to see team specific tokens and instructions. Each connected team needs their own invitation tokens and thus separate installation groups in Intune. Replace the MSI file name with the name of the msi package in use.

  2. Three alternatives to set team-specific invitation tokens

    • As an installation parameter during the installation: separate installation package for each team.

    • Distribute the system variable before MSI deployment via Powershell script with one installation package for all computers a. Variable name = WORKFELLOW_INVITATION_TOKEN b. Variable value = c. Agents can be also be installed proactively to everyone, and the data collection starts after the system variable is distributed.

    • Unattended team-token distribution through ProcessMaker Support.

  1. Install command: msiexec /i "workfellow-plug-in.msi" /qn INVITATION_TOKEN="INSERT-TOKEN-HERE"

  2. Uninstall command: msiexec /x {GUID} /qn

  3. Detection rules format: Manually configure detection rules

  4. Detection rules: Rule type: Registry Key path: Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Workfellow Oy\Workfellow Windows Plug-In Value name: Version Detection method: Value exists

  5. Assignments: hide all toast notifications content download in background

  6. Please remember to allow-list the application if custom restriction policies are applied in your organization. A restart is not mandatory.

Automatic updates can be disabled with a parameter UPDATE_CHANNEL="no-update" in the installation command. If there have been automatic updates performed, then use the script on the following page to uninstall.

Unattended team-token distribution (optional)

Currently, this is supported through ProcessMaker Support.

Customer can deploy team-tokens during the installations as installation parameters or manually by the source-computer users.

Another option is to upload the list of source-computer users emails with the ProcessMaker team. In such case the functionality is as follows:

  1. Agent connects to the Process Intelligence Cloud.

  2. It checks if a new team-token is available with that email.

  3. New team-token is assigned to that computer.

  4. Data-collection starts for that team.

  5. Email is no longer used or linked to the collected data.


Configuring Plug-In to Use a Proxy

This section describes the process of configuring the plug-in to use a proxy. This will allow your application to securely access the internet through an intermediary server. We will also provide information on how to use a Network Tester to check your connection to the cloud and how to restart your computer to ensure the changes take effect.

Plug-in proxy override

PowerShell

export http_proxy=http://{{proxy_url}}:{{port_number}}
export https_proxy=http://{{proxy_url}}:{{port_number}}

Configuring web proxy override on windows

To configure the plug-in to use a proxy, you need to set up specific environment variables on your computer. These variables will tell the plug-in to route all its network requests through the proxy server.

Follow these steps to configure the environment variables:

  1. Open the Start menu and search for "Environment Variables."

  2. Click on "Edit the system environment variables."

  3. In the System Properties window, click on "Environment Variables."

  4. Under "System variables," click "New."

  5. Enter "HTTP_PROXY" as the variable name and your proxy server's address as the value (e.g., http://proxy.example.com:8080).

  6. Click "OK" to save the new variable.

  7. If you have https proxy as well: Repeat steps 4-6, but this time use "HTTPS_PROXY" as the variable name.

  8. Click "OK" to close the Environment Variables window, and then click "OK" again to close the System Properties window.

Testing for proper configuration propagation

Using the Network Tester you can check that connection is possible to PI Infrastructure.

  1. If the Network Tester is already running, close it first.

  2. Restart the Network Tester.

  3. The tester will automatically check your connection to the cloud using the configured proxy.

The plug-in reads environment variables only at startup. To successfully apply proxy configuration changes, restart the plug-in. The simplest way to do this is by restarting the computer, ensuring the plug-in follows its natural lifecycle.

Last updated