Registration with Pre-configured Services
This method of device setup allows for manufacturing or mass setup of devices which have the same platform and OS distribution. This can support either complete image writes or a simple install of remote.it and the addition of registration file placed in a specific directory. Either method will result in the following when the device boots and connects to the internet for the first time:
- The device will be registered to the same account
- The device will be configured with the same services which were defined
This method is supported for any platforms which can install the Device Package and only supports the device to be used as connection endpoints and not as an initiator of connections.
Using a device which will be used in your production line, install the device package and test the setup of the device including services and connections before creating master device or image with the bellow procedure. This is merely to test that the installation and functionality of remote.it are as desired.
Enter a name that you will recognize for this device definition, select an appropriate platform for the device, and select "Private" for Product Scope.
Once created, it will appear in the list of products. Click the gear icon to add the service configuration.
Add the services you want to have on these devices (make sure to select the "Check to enable Service to start by default" to allow the service to be started otherwise you will need to do it manually via terminal access to the device)
Once you have added all of the services, click the checkbox for "Check to lock product and create provisioning files" to get your registration code.
If you need to add a service after locking the product, those services will be disabled by default. Therefore it is recommended that you create a new product for new devices. Previous devices will need to have the services added manually via the Desktop Application and cannot be altered via the product definition.
Click on the "i" icon next to the gear icon to display the Bulk Identification Code.
Copy this code which will be used in the step 4.
Create a file in /etc/remoteit called "registration" (no extension) with nothing in it before installing the package. This is essential in case the device is turned on with internet connection to prevent the device from registering with remote.it prematurely. And please make sure no other files in /etc/remoteit when installing the package.
sudo mkdir -p /etc/remoteit
sudo touch /etc/remoteit/registration
Install the package onto your device.
sudo apt install ./remoteit-4.14.1.armhf.rpi.deb
Write the Bulk Identification Code you retrieved in step 2 to a "registration" file.
echo YOUR-BULK-IDENTIFICATION-CODE | sudo tee /etc/remoteit/registration
You are now ready to use this device as an image for the rest of your devices. For example on a Raspberry Pi you can copy the SD card and insert it into another Raspberry Pi.
When these devices are booted with connection to the internet, they will automatically be registered into the account which created the product definition with the defined services enabled.