Delete

Agent > Install Agents > Delete

The Delete page deletes three different combinations of machine ID accounts and agents.

Machine IDs vs. Agents

When discussing agents it is helpful to distinguish between the machine ID / group ID / organization ID and the agent. The machine ID / group ID / organization ID is the account name for a managed machine in the VSA database. The agent is the client software installed on the managed machine. A one-to-one relationship exists between the agent on a managed machine and its account name on the VSA. Tasks assigned to a machine ID by VSA users direct the agent's actions on the managed machine.

Agent License Counts

The following events affect agent license counts:

• An "unused" agent license is changed to "used" if a machine ID account is created and the agent installed.
• If the agent is deleted but not the account, the agent license is still considered "used".
• If the account is deleted, regardless of what happens to the agent, the agent license goes back to "unused".
• If an account is created, but the agent is not yet installed the first time, the account is called a machine ID template. Machine ID template accounts are not counted as "used" until you install the agent.

Deleting Agents with Tickets

Deleting a machine account reassociates any Service Desk tickets or Ticketing tickets with the machine group or organization that machine account was a member of.

Procedure

1. Select one or more machine IDs in the paging area.
2. Click one of the following radio buttons:
   • Uninstall agent first at next check-in - Uninstall the agent from the machine and remove the machine ID account from the Kaseya Server. The account is not deleted until the next time the agent successfully checks in.
   • Delete account now without uninstalling the agent - Leave the agent installed and remove the machine ID account from the Kaseya Server.
   • Uninstall the agent and keep the account - Uninstall the agent from the machine without removing the machine ID account from the Kaseya Server.
3. Click the Delete Accounts button.

Note: Uninstalling an agent does not remove K-VNC or the KBU client, KES client, or KDPM client. Before you delete the agent, use Remote Control > Uninstall RC to uninstall K-VNC on the managed machine. Uninstall all add-on module clients as well.

Select old accounts that have not checked in since <date>.

Click the Select old hyperlink to check all machine IDs in the paging area that have not checked in since the specified date. This is an easy way to identify and remove obsolete machine IDs.

Clean Database

Removing a machine account using this Delete page marks the machine account for deletion. Actual deletion usually occurs during off hours to reserve resources during working hours. There are some cases where it is useful to purge machine accounts immediately. For example, your Kaseya Server may exceed the agent license count. Click Clean Database to immediately purge machine accounts that are already marked for deletion.

Select All/Unselect All

Click the Select All link to check all rows on the page. Click the Unselect All link to uncheck all rows on the page.

Check-in status

These icons indicate the agent check-in status of each managed machine. Hovering the cursor over a check-in icon displays the agent Quick View window.

Online but waiting for first audit to complete

Agent online

Agent online and user currently logged on.

Agent online and user currently logged on, but user not active for 10 minutes

Agent is currently offline

Agent has never checked in

Agent is online but remote control has been disabled

The agent has been suspended

Machine.Group ID

The list of Machine.Group IDs displayed is based on the Machine ID / Group ID filter and the machine groups the user is authorized to see using System > User Security > Scopes.

Last Check-In

Displays the time the machine's agent last checked in to the Kaseya Server. Agents that have not checked-in recently display this information in red text.