Zerotouch Installation

note zerotouch installation is available for manufacturing connect edge version 3 5 2 and later zerotouch provisioning allows you to pre define a manufacturing connect edge configuration and use it to deploy edge devices on site with no additional human input this provides you an efficient and reliable strategy to install hundreds or thousands of edge devices it also enables a simple experience for on site users there are three stages for zerotouch prepare a bootable usb drive that can be used to install manufacturing connect edge the usb drive includes the manufacturing connect edge installer and your custom zerotouch configurations use the usb drive within your production / assembly facility to install manufacturing connect edge on hundreds or thousands of edge devices the zerotouch configurations will also be copied from the usb drive into the edge device after installation, ship the edge devices to your users on site on site users can boot up the edge device manufacturing connect edge will start running, and the zerotouch configurations will be automatically applied before you begin you will need the following img file of the version of manufacturing connect edge you want to install you can request it from your account executive the edge zerotouch command line interface (cli) tool for generating zerotouch files you can request it from your account executive a linux computer for running the edge zerotouch tool ubuntu 20 04 or above is recommended it also needs docker installed internet connection is also needed for signing a signing key, as an input into the edge zerotouch tool, for signing the zerotouch files you can request this key from customer support a usb drive prepare usb installer with zerotouch c onfiguration complete the following steps to prepare a bootable usb drive that will be used to install manufacturing connect edge the usb drive includes the manufacturing connect edge installer and your custom zerotouch configurations step 1 create bootable usb with manufacturing connect edge img file burn the manufacturing connect edge img file onto a usb drive that you will be using for the installation you can use free tools like balena etcher and rufus later, you will copy the zerotouch files into the usb drive as well step 2 create zerotouch files this step will help you to create the zerotouch files that will be used during installation step 2a define config file you will need to create a config file to define all the docker applications that you would like to be installed on the edge device as part of the zerotouch provisioning process the config file will be in json format when creating the file, keep the following in mind run cmd allows you to define a "docker run" command for your application the parameters {{ apikey}} and {{ imagename}} , if defined, will be automatically populated at run time {{ apikey}} will be automatically populated with a rest api token of the manufacturing connect edge this allows your application to access the manufacturing connect edge's rest api {{ imagename}} will be automatically populated with the value defined for "name" refer to the following sample file { "images" \[ { "name" "hello world", "run cmd" "docker run e apikey={{ apikey}} {{ imagename}}" }, { "name" "eclipse mosquitto", "run cmd" "docker run d p 1883 1883 p 9001 9001 e apikey={{ apikey}} {{ imagename}}" }, { "name" "mongo", "run cmd" "docker run d e \\"webapi\ apikey\\"=\\"{{ apikey}}\\" {{ imagename}}" } ] } step 2b use edge zerotouch cli tool to generate zerotouch file after creating the config file, you will use the edge zerotouch tool to generate the zerotouch file this zerotouch file will later be copied into the usb key to be used during the installation process the edge zerotouch tool needs to be run inside a linux environment that has docker installed and a connection to internet command to generate zerotouch archive /edge zerotouch amd64 linux generate cfg=files/cfg sample json sign key=${signing apikey} sample output of command info\[02 14|23 06 27] using config file cfg=files/cfg sample json info\[02 14|23 06 27] output directory is not specified info\[02 14|23 06 27] using output directory output=/tmp/zerotouch info\[02 14|23 06 40] done! sample output of file and directory structure the final file will have the following format zerotouch 1 0 0 tar gz the file is an archive that includes the docker images for your applications it also includes a signature that will be used for authenticity verification during the installation process example of what's inside the archive $ tree /tmp/zerotouch /tmp/zerotouch ├── eclipse mosquitto tar ├── hello world tar ├── manifest sig ├── manifest yaml └── mongo tar step 3 copy zerotouch file into usb copy the file zerotouch 1 0 0 tar gz into the usb drive under the folder zerotouch preboot the usb drive is now ready to be used to install manufacturing connect edge on a device install manufacturing connect edge from usb with zerotouch config within your production or assembly facility, use the usb drive (prepared above) to install manufacturing connect edge on hundreds or thousands of edge devices the installer will also copy the custom zerotouch configurations from the usb drive into the edge device after installation, the edge device is powered off and ready to be shipped for on site deployment to install manufacturing connect edge from the usb insert the usb drive into the device you want to install manufacturing connect edge power on the device after the device initiates the installer, respond to the questions in the terminal user interface (tui) welcome to operating system installer are you installing over serial (for advanced users)? yes/no enter no , and then press enter the zerotouch preboot message displays press enter for ok select install operating system , and then select ok use the arrow keys to navigate to selections from the select partition and install dialog box, select the correct installation location, navigate to ok , and press enter confirm the selected location and select yes confirm that the selected device will be erased during the formatting process select yes select yes to power off the device the device is now ready to be shipped for deployment on site bootup at the site of deployment, you can boot up the manufacturing connect edge device manufacturing connect edge will start running the terminal window displays the url that must be used to access the device using the web ui if several urls are displayed, use the first one see access the manufacturing connect edge web ui docid 9y0 n74s8m5x4gynbfb9u the manufacturing connect for more information on first boot, the zerotouch configurations will be automatically applied the container applications specified in the zerotouch config will start running note after the first boot, any docker images and associated containers specified in the zerotouch configuration file may take some time to display in the manufacturing connect edge ui