Installing Kaseya Agent on Thin Client: A Step-by-Step Guide

=====================================================================================

Introduction

----------

Thin clients are lightweight computers or devices that rely entirely on a central server for processing power, storage, and other resources. One popular tool used to manage and monitor thin client environments is the Kaseye agent.

This article will walk you through the process of installing the Kaseya Agent on a thin client device running various operating systems, including Windows XP/2000 Professional SP3 or later versions up with Service Pack 2 (SP2) installed as well as Linux distributions such as Red Hat Enterprise Linux 4 and Ubuntu Server Editions from Hardy Heron onwards.

Prerequisites

---------

Before proceeding, ensure that you have met the following prerequisites:

1. A Kaseya Cloud Management Platform (CMP) account is set up.

2. The Kaseye agent software has been downloaded for your chosen operating system(s).

3. Root or administrator privileges are available on all target thin clients.

Step 1: Download and Extract Agent Software

-----------------------------------------

1. Log in to the Kaseya CMP dashboard using valid credentials.

2. Navigate to Inventory > Agents from the left-hand menu bar.

3. Click on Download Agent next to each device you wish to manage, selecting either a Windows or Linux agent depending on your client OS.

For Windows:

* Double-click the downloaded .exe file (e.g., kaseyaagent.exe) and follow prompts until extracted to C:\Program Files\Kaseya\Agent.

* Alternatively, right-click the downloaded zip archive (e.g., KACE-Agent-x.x.x-Windows.zip), select Extract All, choose a destination folder like C:, then click Extract.

For Linux:

* Change into an empty directory where you want to extract the agent files using `cd`.

* Untar or tar.gz-compressed archives as root with commands such as: `tar -xvf KACE-Agent-Linux-.tar` (for .tar) or `tar xzvf KACE-Agent-Linux-.tar.gz`.

Step 2: Run Agent Setup Wizard

------------------------------

Double-click the extracted agent executable file for Windows (.exe), named something like 'KaseyaAgent.exe', and follow on-screen instructions.

For Linux:

1. Change into the directory containing the newly extracted files with `cd`.

2. As root, run ./KACEagent.bin to launch the setup wizard.

Follow all prompts carefully during installation; accept default settings whenever possible unless otherwise specified by your organization's IT department policies or Kaseya documentation recommendations.

Step 3: Configure Agent Communication

-----------------------------------

After completing agent installation:

1. In most cases, the agent will automatically detect and connect with a nearby management server via UDP port 1698 (default). If not detected:

* For Windows clients only: Click Next at the 'Agent Not Found' dialog box.

Enter your Kaseya CMP FQDN or IP address under Agent Name field followed by colon (:), then enter either '1698' for default non-SSL communication port, like `your_server_name_or_IP_address:1698`. Click Test Connection to verify connectivity. If successful, proceed with agent configuration.

* For Linux clients:

Edit /opt/kace/agent.properties (or similar path depending on your distribution) using a text editor such as nano or vi.

Locate the following lines and modify them according:

`KACE_AGENT_SERVER_NAME = `

`KACE_AGENT_PORT=1698`

Save changes and then restart agent services: For Red Hat-based systems, run `service kaceagent start` (or `/etc/init.d/kasey-agent restart`). On Ubuntu/Debian-like distributions use: `sudo /opt/KACEAgent/bin/KASEAGENT restart`.

Step 4: Verify Agent Connectivity

------------------------------

1. Log back into the Kaseye CMP dashboard using your credentials.

2. Navigate to Inventory > Agents again and look for the newly managed device(s) under their respective groups or All Devices section.

If all steps were completed correctly, you should now see a green checkmark icon next to each agent status column indicating successful communication with the management server.

Troubleshooting Tips

----------------

* Ensure that your thin client devices have proper network connectivity and are able to reach the Kaseye Agent download location.

* Verify that necessary ports (UDP 1698 by default) are open on both the agent machine's firewall rules as well as any intervening firewalls or routers between them.

-------

With these instructions, you should now be equipped with a solid understanding of how to install and configure the Kaseya Agent on thin client devices running various operating systems. Remember always refer to official documentation for up-to-date information specific to your environment's configuration requirements. Happy agent deployment!

Installing kaseya agent on thin client