---
title: "Workspot Agent Logs in the Linux VM"
slug: "workspot-agent-logs-in-the-linux-vm"
updated: 2025-08-22T18:42:23Z
published: 2025-08-22T18:42:23Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.workspot.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Workspot Agent Logs in the Linux VM

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/”.

![](https://cdn.us.document360.io/ad9153e1-c8de-4f56-94f2-b717a1fc3a68/Images/Documentation/d201ed9a-3872-4f7b-ab85-c97107c25fc3.png)

## **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.

![](https://cdn.us.document360.io/ad9153e1-c8de-4f56-94f2-b717a1fc3a68/Images/Documentation/f35cf3b1-6c8e-43dd-ab00-edf4df12e9e5.png)

> **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 `

![](https://cdn.us.document360.io/ad9153e1-c8de-4f56-94f2-b717a1fc3a68/Images/Documentation/bdba7b4e-bb1f-47ce-8a87-388daa36864e.png)

### **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](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`