Skip to main content

Devices

Adding a Client Device

info

Before you add a client device to the Cordatus platform, you must create a Cordatus account if you have not already done so. You can create a new account for free.

info

For Cordatus to establish a seamless connection with your device, Cordatus Client must be installed and actively running on your device.

After registering and activating your account, you can add a device to the Cordatus platform. Keep in mind that to fully use the platform's features, you need an active Cordatus account.

Adding a Device with User Credentials

  1. Launch Cordatus Client on your Ubuntu desktop or embedded device.
  2. Click the Login button and provide your Cordatus account details.
  3. After logging in, Cordatus Client will prompt you to assign a license to your device.
  4. Choose the suitable license and click Continue to move forward.
  5. Cordatus Client is now set up, enabling you to connect to it via the Cordatus Web App.

Adding a Device with Token

There are two methods for adding a device using a token: the Cordatus Client GUI or the headless terminal mode. However, before proceeding, it's necessary to generate a client token.

Generating A Single Token

  1. Log in to Cordatus Web App: Access the Cordatus Web App and log in with your Cordatus account credentials.
  2. Go to Devices Page: After logging in, navigate to the Devices page from the left-hand menu in the Cordatus Web App.
  3. Click New Device Button: Initiate the process by clicking the New Device button on the Devices page to add a new device to the Cordatus platform.
  4. Provide Name and Select a License: Specify a name for your device and choose a suitable license.
  5. Save the Device: After entering the necessary information, click "Save" to create a new device in the Cordatus platform. Cordatus will generate a token for your device.

Once you've successfully created a new device and obtained its associated token, make sure to securely store the token for future use with the Cordatus client.

 

If you lose the client token or need to generate it later, simply click the Generate Token button. You can find this button in the menu accessed through the ellipsis icon under the Actions title.

Generate Token

In the dialog box, you have two options:

  1. Use your existing token to add the selected device.
  2. Create a new token, which will delete the existing one, and use it to add your device.

Generate Token2

warning

Generating a new token will deactivate the previous one, causing any device using the old token to be logged out.

Generating Multiple Tokens

To create multiple tokens to add multiple devices:

  1. Log in to Cordatus Web App: Access the Cordatus Web App and log in with your Cordatus account credentials.
  2. Go to Devices Page: After logging in, navigate to the Devices page from the left-hand menu in the Cordatus Web App.
  3. Click New Device Button: Initiate the process by clicking the New Device button on the Devices page to create multiple tokens.
  4. Choose Add Multiple Devices from the dialog that opens up.
  5. Provide Group Name and Select Licenses: From the Add Multiple Devices modal that opens up provide the following inputs:
    • Label of the Devices: Give a group name for your devices.
    • Quantity of the Devices: Provide the number of devices you want to add to Cordatus.
    • If you want to get the list of the tokens in csv format check the related box above the license selection panel. If you do not wish to get the list of your tokens in this step, you can generate tokens later for each of your device as explained later in this section.
    • Select the available licenses for your devices from the panel at the bottom of the modal.
    • Create Devices: After entering the necessary information, click "Create Devices" to generate and download the tokens and create devices in the Cordatus platform.
    • Along with creating devices, Cordatus will also create a group for your devices added in this step which you can access on the Groups panel on the left.

Once you've successfully created devices and obtained associated tokens, make sure to securely store the tokens for future use with the Cordatus clients.

 

Adding a Device from Cordatus GUI

  1. Run Cordatus Client: Start the Cordatus client on your device.
  2. Click Login Button: In the Cordatus client window, click the Login button to connect to the Cordatus platform.
  3. Open Token Tab: Inside the Cordatus client login window, go to the Token tab.
  4. Enter Your Token: Paste the token generated by Cordatus into the designated field. If right-click doesn't work, use the ctrl+v combination.
  5. Click Login Button: After entering the token, click Login to connect your device with the Cordatus platform.

Once the connection is successful, Cordatus will configure your device and assign the associated license.

Adding a Device from the Terminal with Headless Mode

If you don't need a graphical user interface for the Cordatus client or do not have Ubuntu Desktop, you can start Cordatus in headless mode. Run the following command in your client device's terminal, including your token with the --token parameter. If Ctrl+V doesn't work for pasting the command, right-click in the terminal and choose paste from the menu:

cordatus --server --token=<your_token>

Once the connection between your device and the Cordatus platform is successfully established, Cordatus will proceed to configure your device and allocate the associated license.

 

Cordatus requires sudo privileges for certain functions like device metric tracking. You can add sudo privileges and securely store your sudo password using the following parameters with the provided commands when adding your device:

cordatus --server --token=<your_token> --sudoPass:<your_sudo_password> --saveSudoPass

If you don't enter your sudo password during device addition, you can input it later anytime when starting Cordatus in server mode using the same parameters.

After adding your device, you can start Cordatus by just entering the command below after each reboot:

cordatus --server
note

After each device boot, the Cordatus client will not start automatically. Therefore, you must manually launch the Cordatus client in headless mode by running the relevant command in the terminal.

Managing Devices

On the Devices page, you can easily view a list of all your devices and manage them. You can access various properties of your devices, such as license type, name, connection status, performance metrics (CPU and RAM usage), CPU type, number of GPUs, total RAM, Client version, and uptime duration.

Grouping Devices

Device grouping in management allows you to organize and categorize devices based on shared characteristics or functions, making administrative tasks more efficient. This feature is particularly useful for organizations handling a large number of devices, providing better control and oversight.

Creating Groups and Subgroups

To simplify device management, you can create groups or subgroups and assign devices to these categories by following these steps:

  1. Click the blue plus icon in the upper right corner of the Groups window to open the New Group Modal.
  2. Enter the desired name for your new group.
  3. Optionally, provide a description for your group.
  4. If this group is intended as a subgroup within a parent group, select the relevant parent group.
  5. Add tags to your group for descriptions and easy management.
  6. Click the Save button to create your group.

Editing Groups

To edit existing groups, click the ellipsis icon next to the group and select the Settings button. In the window that opens, you can modify the name, description, parent group, and tags of the group.

Edit a group

Assigning Devices to Groups and Subgroups,

To easily assign your devices to groups, follow these steps:

  1. Click the green pencil icon in the upper right corner of the Groups window to access the Editing Groups page.
  2. For group reordering, drag and drop the desired group within the Group Hierarchy window and then click Save List.
  3. Select the group to which you want to add devices.
  4. Drag devices from the Devices window on the right and drop them into the middle window with the group's name.
  5. To remove a device from a group, drag the device from the middle window back into the Devices window on the right.
  6. After grouping, click the Save Group button at the bottom.
  7. For additional groups, repeat steps 3-6.
  8. Once done, click Back to Devices at the top left to return to the Devices page.
  9. Click the group name in the Groups window to view devices belonging to that group.

 

To check the assigned groups of a device, click the ellipsis icon below the Actions column, next to the metrics icon. Then, choose the Show Groups option in the menu. This button will reveal the groups to which the device is assigned.

Groups of Devices

Viewing Groups of Devices

 

Deleting Groups and Subgroups

To delete a group, simply click the ellipsis icon next to the group and select the "Delete Group" button.

Delete a group

caution

When deleting a group that contains subgroups, please be aware that you need to delete the subgroups first before proceeding to delete the parent group.

Renaming a Device

To change the device name, click the icon next to the device name, enter the new name in the field that appears, and then click the Save Changes button to update the device's name.

Renaming a device

Disconnect and Reconnect a Device

To disconnect a connected device, click the Disconnect button in the menu that appears when you click on the ellipsis icon beneath the Actions title.

Disconnecting a device

To reconnect with a previously disconnected device, click the Connect button under the Connection title.

Connecting a device

Monitoring Device Metrics

Cordatus allows constant monitoring of your device metrics. To access the metrics panel, click the metrics icon under the Actions title. In this panel, you can track various metrics of your device, such as CPU, GPU, and board temperatures, RAM usage, SWAP rate, and GPU memory utilization. You can also access additional information by selecting the relevant tabs, providing details about containers on your device, storage information, device alarms, jobs, and sensors. Additionally, you can restart or shut down your device by clicking the respective icons in the upper right corner.

Metrics

To view the past metrics of your devices, toggle off the "Showing Real-Time Metrics" option.

Toggle Real Time Metrics

 

In the opened metrics window, you can analyze historical data, including CPU and GPU utilization, CPU and GPU temperatures, disk usage, RAM usage, and internet connection status. Customize the time frame for your metrics using the menu at the top.

Groups of Devices

Viewing Old Metrics

 

You can also disable/enable device metrics by using the relevant buttons on the metrics modal. This option is also available on Client:

 

Restarting a Client

To remotely restart a Cordatus client installed on a device using the Cordatus Web Application, click the Restart Cordatus button. You can find this option within the menu that appears when you click the ellipsis icon located under the "Actions" title.

Restarting Client

Downloading Device Logs

Users can remotely access the activity logs generated by each device using the Cordatus Web App. To download a device's logs, simply click the Download Logs button. You can find this option within the menu that appears when you click on the ellipsis icon situated under the Actions title.

Restarting Client

Changing Device License

Users can change the license of their devices if they wish. If users have spare licenses and want to use them with one of their devices, they can follow these steps:

  1. Click the Change License button under the Actions column for the device you want to change the license for.
  2. Click on the Change License button on the menu that opens up.
  3. From the modal that opens up, choose the new license type you wish for your device.
  4. From the new panel that opens up at the bottom, choose an available license for your device.
  5. Click Change License.

Your selected license has been assigned to your device.

 

Removing a Device

To remove a device from your account, you have two options:

  1. To remove a device, click on the device you wish to delete and then select the Delete Selected button at the top.
  2. Alternatively, you can click the Remove button, found in the menu that appears when you click on the ellipsis icon under the Actions title.
  3. If you choose the second method to remove your device, you can choose whether to remove the device from your account while keeping the Client and related files on your device, or if you want to remove some or all of the data along with the device's removal from your account.