Workspot Agent Logs in the Linux VM

  • Updated on Aug 22, 2025
  • Published on Jul 16, 2024
  • 1 minute(s) read
  • Robert Plamondon
  • d
 Prev Next

Logs on a Workspot Linux VM can be found at:

  • Agent logs: /root/workspotagent.

  • xRDP logs: /var/log/xrdp.log (for RDP issues).

Agent Logs

To check agent logs: 

  • Log in to the machine as a root user. 

  • Go to the “workspotagent” directory with “cd /root/workspotagent/”.

Workspot Agent Scripts

  • Workspot Agent Script directory: /var/opt/workspotagent/config 

  • Workspot Agent Script Logs: /var/log/workspotagent/wsscriptslog

Task: One-Time Configuration

To run setup commands the first time the Agent runs after the VM is cloned from its template, create a wssetupcomplete.bsh script:

  1. Create wssetupcomplete.bsh, with commands to perform the desired operations, such as creating a directory or installing a package in silent/quiet mode. 

  2. Copy wssetupcomplete.bsh to /var/opt/workspotagent/config 

  3. Provide execute permission to the script:

# Sudo chmod +x  /root/workspotagent/config/ wssetupcomplete.bsh 

  1. Make sure that the scripts and the resources it needs are on the newly cloned VM (that is, make sure they’re on the template).

Task: Register/Reregister the Workspot Agent Using a Token

Go to /usr/libexec/workspotagent/ location and run the below commands to check the Agent’s registration status with Workspot Control and to reregister the Agent with a token obtained from Workspot Control.

Note: This requires root user permissions.

Task: Uninstall the Workspot Agent

Run below command to uninstall the Workspot Agent and its configuration:

sudo rpm erase workspotagent 

Task: Reconfigure the Workspot Agent and its Domain-Join Details

To reconfigure the domain-join details or to reconfigure Workspot Agent:

Sudo bash workspot_installer.sh --reconfigure 

 WorkspotAgent Service Commands 

  • sudo systemctl status workspotagent.service (to check the Workspot Agent service status)

  • sudo systemctl restart workspotagent.service (to restart the Workspot Agent service status)

  • sudo systemctl start workspotagent.service (to start the Workspot Agent service status)

  • sudo systemctl stop workspotagent.service (to stop the Workspot Agent service status)

  • sudo systemctl disable workspotagent.service (to disable the Workspot Agent service status)

  • sudo systemctl enable workspotagent.service  (to enable the Workspot Agent service status) 

Other Commands

  • To install Workspot Agent in silent mode:

    • sudo bash workspot_installer.sh –silent 

  • To Check agent version in Debian/Ubuntu:

    • sudo yum info workspotagent 

  • To Check Workspot xrdp version:

    • sudo yum info xrdp-workspot 

  • To Perform a manual upgrade, run:

curl -O https://cdn.us.document360.io/ad9153e1-c8de-4f56-94f2-b717a1fc3a68/Images/Documentation/workspotagent 1.2.1.4-1 amd64.tar.gz 

/autoupgrade https://cdn.us.document360.io/ad9153e1-c8de-4f56-94f2-b717a1fc3a68/Images/Documentation/workspotagent 1.2.1.4-1 amd64.tar.gz ./upgrade.log 

apt install workspotagent 

  • To Check Agent version  

    • apt-cache policy workspotagent  

  • Install latest Agent 

  1. Sign into the Linux VM or template as root.

  2. Go to https://downloads.workspot.com in your browser.

  3. Note the URL of the latest version of the Agent for your version of Linux and download it with:

curl -O URL

  1. Go to /root/workspotagent/config/workspotscripts and run:

./autoupgrade.bsh path-and-filename-of-downloaded-agent ./upgrade.log