D.1 Using the Protect Agent Utility for Windows

To download the Protect Agent utility for Windows to the source workload:

  1. Log in to the source Windows computer as the Administrator user.

  2. In a web browser, launch the Web Interface and log in.

  3. Click the Downloads tab.

  4. Click the Protect Agent application link for the Windows target platform, then save the compressed ProtectAgent.cli.exe file.

  5. Extract the contents of the file to access the executable file.

  6. (Optional) View the Protect Agent Help by entering

    Protect.Agent.cli.exe -h

The utility is available on the PlateSpin Server host in a compressed file. Extract the contents of the file to access the executable file.

C:\Program Files\PlateSpin Protect Server\bin\ProtectAgent

The syntax for running the Protect Agent utility for Windows is:

ProtectAgent.cli.exe {command} [command_option] [/psserver=%IP%]

Table D-1 describes the commands, command option, and switch available for the ProtectAgent.cli.exe command.

Table D-1 Protect Agent Utility for Windows Commands, Command Option, and Switch

Usage

Description

Commands

h |? | help

Displays usage and options for the command.

logs | view-logs

Opens the application log directory.

status

/status [/psserver=%IP%]

Shows installation status for the PlateSpin controller and drivers on this workload.

If you specify the PlateSpin Server, it checks for driver upgrades from the server.

din | driver-install

/din [/psserver=%IP%]

Installs the PlateSpin drivers.

If you specify the PlateSpin Server, it checks for driver upgrades from the server.

dup | driver-upgrade

/dup [/psserver=%IP%]

Upgrades the PlateSpin drivers.

If you specify the PlateSpin Server, it checks for driver upgrades from the server.

dun | driver-uninstall

[/dun /psserver=%IP%]

Uninstalls the PlateSpin drivers.

con | config

/con /setting=<setting_name>:<value>

Example:

ProtectAgent.cli.exe /config /setting=psserver:10.10.10.202

Specifies the name of the setting and its value to change in the configuration file on this workload.

The psserver option stops the OFX Controller (ofxcontroller) service, modifies the OfxController.exe.config file with the new IP address, and restarts the service. If you modify the public IP address of the PlateSpin Server, you must run this command on each of the source workloads that are configured for the server.

Switch

/psserver=%IP%

Downloads the block-based transfer drivers from the specified server when you invoke the status, driver-install, or driver-upgrade options.

Command Option

setting

/setting=<setting_name>:<value>

Specifies the setting name and value of the configuration setting to modify.

Supported setting names are:

  • psserver
  • altAddress
  • heartbeat