Register Device (Agent 7.0)
This page describes how to connect a single Linux-based device using the wget command on your device. For use with Connect Agent 7.0 or higher.
Last updated
This page describes how to connect a single Linux-based device using the wget command on your device. For use with Connect Agent 7.0 or higher.
Last updated
This procedure is applicable for registering a device with Connect Agent version 7.0.
You need the following before starting the procedure:
Device meets minimum hardware, OS, and software requirements as described in Connect Agent.
Connect Agent 7.0 or higher. Connect Agent 7.x and the registration process that goes with it are available only if you can see the new UI for the registration and the Device-Project Pairing Token tab in Settings.
Internet connectivity with the device.
JFrog Connect account created and a project defined as described in Create JFrog Connect Account.
Tip: All input parameters in Connect, such as project name, group, device, access tokens, etc., are case sensitive.
To register a device, complete the following steps:
The Project-Device pairing token will be linked to the project that is in the main filter. In the Connect web UI, go to the project filter and choose the project to which the device will be paired.
In the Connect web UI, click Register Device on the top left.
In the Device Registration popup, choose whether the wget command should run as a root or non-root user on your device.
Generate the device-project pairing token.
(Optional) Enter values for the optional parameters. If you do not enter the values now, you can enter them later in the Devices page of the web UI.
Review the command generated at the bottom and copy it to your clipboard.
Open the command line terminal on your device, paste the command from your clipboard, and run it.
In Step 4 above, you can enter values for the optional parameters listed below. If you do not set them in the registration command, you can set them in the Devices page of the UI after the registration has been completed.
Device Name: Sets a device name when the device is registered. You can enter a fixed name (e.g., BlueDevice014) or you can use a parameter like “$HOSTNAME”. If you don’t enter a device name, the device will be given the default name New Device followed by a number, for example, New Device 14.
Group: Assigns the device to a specific group at registration time. The group must exist already.
Application Name: The Connect Agent will be called the name that you enter.
Application Version: If you entered an application name, you must also enter a version.
After you enter the registration command, you may need to wait several seconds until the new device appears on the Devices page. If the device does not appear, try the steps below.
Check the network connection of your device.
Ensure that systemd or SysV is installed.
If you are using SysV, ensure that the systemd directory does not exist: /etc/systemd/system.
Run the installation command as a root user.
See the Troubleshooting page for common issues and fixes.
Learn about methods of device registration at scale.
