Skip to main content

Device Actions

Use Device Actions to manage a single device from the Devices table.
You open these actions from the ellipsis ( … ) button in the device row.

This page explains:

  • Restart Client
  • Download / View Logs
  • Change License
  • Remove Device

Before you start​

  • The device should be Connected for most actions. (See Connectivity & Sessions.)
  • Some actions may briefly interrupt monitoring or sessions.
info

If the device is Offline, only limited actions are available (for example, removing the device).
If the device is Online but not yet Connected, Cordatus will try to connect automatically.
If the automatic connection fails, connect the device manually before running actions.

Restart/Shutdown OS​

Use Power actions to restart or shut down the operating system of a connected device.
Unlike Restart Client, these actions affect the entire operating system — not just the Cordatus Client.

Before you start

  • The device must be Connected.
  • Active SSH or Remote Desktop sessions will be terminated when the device restarts or powers off.
  • After a reboot, the device typically transitions Connected → Offline → Online automatically.
  • After a shutdown, the device remains Offline until manually powered on.

Steps

  1. Go to Devices → find your device.
  2. In the Actions column, click the Metrics icon to open the metrics panel.
  3. In the panel header at the top right — next to the connection status and device name — click one of the following icons:
    • Restart (circular arrow) — Restarts the entire operating system.
    • Shut Down (power) — Powers off the device safely.
  4. Confirm the action in the dialog.

Results

  • During reboot, you may briefly see the status change sequence Connected → Offline → Online.
  • During shutdown, the device remains Offline until it is powered on.

Restart and Shutdown

Restart / Shutdown OS

 

caution

Performing a shutdown or reboot will terminate active sessions and may interrupt running workloads.
Be sure to save any important data before proceeding.

Restart Client​

Restarting the Cordatus Client refreshes its services and connection on the device. It does not reboot the operating system.

Steps

  1. Go to Devices → find your device.
  2. In the Actions column, click the ellipsis ( … ).
  3. Click Restart Cordatus.
  4. Confirm in the dialog.

The menu adapts to the client state: a Connected device offers Restart Cordatus and Stop Cordatus, while a device whose client is not running offers Start Cordatus.

Results

  • Client stops and starts again.
  • Status may show Connected → Online → Connected during the restart (a few seconds).
  • Monitoring and remote sessions resume after the client is back.

Restart Client

Restart Cordatus Client
tip

Use a client restart when metrics freeze, the SSH/Remote Desktop will not start, or after changing license/settings.

Logs (Download or Live View)​

You can download log files for support or view live logs in your browser during troubleshooting.

Download Logs​

  1. Go to Devices → find your device.
  2. In the Actions column, click the ellipsis ( … ).
  3. Click Download Logs.

Download Logs

Download Logs

View Live Logs​

  • Shows real-time log lines in the browser (tail).
  • Useful when you want to reproduce and observe a problem.

Steps

  1. Go to the Logs page.
  2. In the Scope menu, select the source: Client Logs or Stream Engine Logs.
  3. In the Select Device menu, choose your device. Logs start streaming once both are set.
  4. Use the remaining filters to narrow results: Type, Topic, Sub Topic, or free-text Search.
  5. (Optional) Click Open logs in new tab to follow the stream in its own browser tab.

 

info

Log contents may include technical details (timestamps, process IDs).
Credentials are never stored in plaintext by Cordatus.

Logs in the Client (on-device)​

You can also access logs directly from the Cordatus Client installed on the device.
This is useful if the device cannot connect to the cloud, or if you are working locally.

Steps

  1. Open the Cordatus Client on the device.
  2. Click the settings icon in the bottom-left corner, then open the LOGS tab.
  3. In Scope, select Client Logs or Stream Engine Logs.
  4. Narrow the stream with the Type, Topic, Sub Topic, Search and Timezone filters.
  5. Scroll through the entries, or leave Auto-scroll on to follow new lines as they arrive. The buttons at the top right of the log panel open the logs in a separate window or download them.

Client Logs

Logs in the Client
info

Client-side logs show the same categories (Client, Metrics, Sessions, Stream Engine).
They are local and do not depend on cloud connectivity.

note

When requesting support, make sure to include the renderer.log file for a thorough examination of the issue.

Enabling / Disabling Logs​

You can control whether the Client Logs and Stream Engine Logs are collected and stored.
This is useful to reduce disk usage or stop unnecessary logging in production.

There are two ways to manage these settings:

1. From the Web (Device Hub)​

  1. Go to Devices → select your device.
  2. Open the Metrics Panel (click the metrics icon in the device row).
  3. Go to Settings → General Settings.
  4. Toggle:
    • Enable Client Logs
    • Enable Stream Engine Logs

Toggle Logs

Enable / Disable Logs on Web

2. From the Cordatus Client (on-device)​

  1. On the device, open the Cordatus Client.
  2. Click the settings icon in the bottom-left corner.
  3. In the General tab, toggle:
    • Enable Client Logs
    • Enable Stream Engine Logs

Toggle Logs

Enable / Disable Logs on Client
caution

If logging is disabled, some diagnostic data may not be available for support or troubleshooting.
Enable logs when investigating issues, and disable them again to save resources if needed.

Change License​

Use this to move a device to a different plan or to apply an expired/renewed license.

Steps

  1. Devices → device row → ellipsis ( … ) → Change Licence.
  2. In the licence table, tick the licence type you want to move the device to. The Generated Licence Keys table for that type appears below.
  3. Tick one Assignable key from that table.
  4. Click Change Licence, then confirm in the dialog that follows.
  5. Wait for the Licence Changed confirmation; the new licence appears in the device row.
note

The device must be connected — on an offline device the change is not applied.

What happens next

  • The client validates the new license with Cordatus.
  • Some features may enable/disable based on the new license.
  • The client may restart automatically.

Remove Device​

Removes the device from your Cordatus account.
You can choose what to do with the data associated with this device.

Steps

  1. Devices → device row → ellipsis ( … ) → Remove.
  2. In the Removing Device dialog, choose whether the Stream Engine and Inference Engine should keep running on the device: select Continue Without Closing, or Close & Continue.
  3. In Choose type, pick Remove device only (keeps all data on the device) or Remove with data (also deletes the Cordatus data listed in the storage table), then click Continue.
  4. In Confirm, review the data categories and their sizes, type DELETE in the confirmation box, and click Delete.
note

Remove with data requires the device to be connected. On an offline device only Remove device only is available, and Cordatus data stays on the machine.

Results and notes

  • The device disappears from Devices.
  • If the same physical machine reconnects later, it appears as a new device.
  • Deleted data cannot be recovered.
caution

This action cannot be undone.
Be sure to export any needed logs or reports before removal.

Troubleshooting​

  • Logs are empty
    • Check that Enable Client Logs / Enable Stream Engine Logs are ON under Settings → General Settings.
    • For metrics-related logs, make sure metric collection is running (the Metrics tab shows Streaming live, not a stopped state).
  • License change did not apply
    • Retry after a Restart Client. Confirm there is network access.
  • Remove failed
    • Try again after the device is Disconnected, or contact your admin.