Silent Installation of Discovery Robots

This section describes procedures for a silent installation of the Discovery Robots. See UI Setup Wizard of Discovery Robots to install using the UI Setup Wizard.

When you run a silent install of the Discovery Robots, you can simply execute the installation file DiscoveryRobotSetup.exe; or you can choose to:

  1. Run the installation file with a START/WAIT command that let's you see the exit codes of the installation when it completes; or

  2. Include installation parameters in the command line; or

  3. Both

If you choose to add parameters in the command line, Silent mode installation supports the inclusion of the following installation parameters:

Parameter Name

Default Value

(if unspecified/leave blank)

Description

InstallFolder

C:\Program Files\PDDR

Folder in which the Discovery Robot files will be installed

AddToStartup

true

Determines whether the Discovery Robot will run automatically each time a user of the machine logs in to Windows

messagesBrokerHost

localhost

Of the Discovery Server

stealthMode

false

Determines whether the robot's icon will appear in the Windows taskbar:

  • false = icon will appear in the taskbar

  • true = icon will not appear in the taskbar (robot will be invisible to user)

persistRecords

false

Determines whether a copy of the robot's will be maintained on the robot (in addition to syncing to the server). Setting this parameter to true is recommended for debugging purposes only.

START_ROBOT

true

Launches the Discovery Robot after installation

CaptureScreenshots

true

Determines whether screenshots are collected when recording.

Setting this parameter to false allows recording in a 'metadata only' mode, which is collecting the data of application usage and work-patterns without capturing screenshots.

PDDR_KEYS_PATH

Installation Path

This points to the directory where the keys file for the connection between the robot and the server is located.

standaloneMode

false

Stand Alone Mode allows you to run the robot without a connection to the server.

This means that the robot is not uploading the recording to the server, it is just storing it locally.

For more details, see this section: Standalone Discovery Robots

HashUserName

 

true / false

messagesBrokerProtocol

 

https / https

messagesBrokerPort

 

80 / 443

To run the discovery robot installation package silently:

  1. Access the command prompt and run as an administrator.

  2. Change directory to the location of where you copied the installation files by typing in: CD {Folder location}.

  3. For example, CD C:\FolderName\

  4. Hit <ENTER>.

  5. Based on your installation preferences:

    1. To simply run the installation file, type in: DiscoveryRobotSetup.exe -silent

    2. To see the exit codes of the installation when it completes, type in: START/WAIT DiscoveryRobotSetup.exe -silent

    3. To specify parameters to either of option a or b above: add the parameters to the command line. The command line would look like this when parameters are specified:

      • When using START/WAIT:

      • START/WAIT DiscoveryRobotSetup.exe [Parameter1=Value1 Parameter2=Value2 Parameter3=Value3] -silent

      • When not using START/WAIT:

      • DiscoveryRobotSetup.exe [Parameter1=Value1 Parameter2=Value2 Parameter3=Value3] -silent

        Parameters must be specified using exact parameter names. For example, DiscoveryRobotSetup.exe /Silent InstallFolder="C:\The folder\The Company\The PDDR"

      • Immediately after installation completes, run the ECHO command with the %errorlevel% parameter, by typing in the command line: ECHO %errorlevel%.

        The exit codes are shown in the command line as follows:

        • 0 = success

        • 1602 = user canceled

        • 1641, 3010 = success, but must reboot to finish install

  6. During installation the system may restart one or more times. Following restart, Discovery Robot installation will resume right where it left off.

  7. You can view an exit code following installation when you install using a START/WAIT command, as explained above:

  8. Continue by configuring the Discovery Server address and additional Discovery Robot settings as required.

  9. When done configuring Discovery Robot settings, restart the robot.

    1. Right-click the robot's tray icon, and select Quit

    2. Run {MainRobotFolder}/ pddr.exe to start the robot

The {MainRobotFolder} is the folder in which the files were installed:

  • By default, this folder is C:\Program Files\PDDR 

  • If you specified a different location during installation, the {MainRobotFolder} is the folder you specified

Immediately after installation completes, run the ECHO command with the %errorlevel% parameter, by typing in the command line: ECHO %errorlevel%.

The exit codes are shown in the command line as follows:

    • 0 = success

    • 1602 = user canceled

    • 1641, 3010 = success, but must reboot to finish install