Quickstart Guide
Installation and Deployments

Docker Installation

7min
you can use docker to install manufacturing connect edge note you can't upgrade the manufacturing connect edge docker version using a software update file (upd) you can follow the docker recommended approach for docker image upgrade and volume management before you begin install docker engine 19 03+ https //docs docker com/get docker/ on an intel 64 bit machine on the intel 64 bit machine, have administrative permissions to execute docker commands ensure the docker engine is configured to run a docker image with a root user obtain access to a manufacturing connect edge service account json file, which you can get from mfgconnect\@litmus io to use docker to install manufacturing connect edge, you will need to do the following step 1 launch a manufacturing connect edge docker image step 2 log in to manufacturing connect edge to jump to a specific section, refer to the table of contents on the right side and click the corresponding step step 1 launch a manufacturing connect edge docker image to launch a manufacturing connect edge docker image 1\ request and download the service account json file by sending an email to mfgconnect\@litmus io 2\ open a command prompt terminal (ctrl+r) on the intel 64 bit machine 3\ execute the following linux command to download the latest manufacturing connect edge docker image cat \<file name> json | docker login u json key password stdin https //us docker pkg dev the \<file name> json parameter is the service account file requested from step 1 example if the json file is named abc123 json, execute cat abc123 json | docker login u json key password stdin https //us docker pkg dev refer to google's setting up authentication service account key https //cloud google com/artifact registry/docs/docker/authentication#json key for more information note if the docker container (that will be initialized from the docker image from step 3) will be configured with cpu/ram limits, allocate at least 2 4 cpus and 4 8 gb ram scale up as needed 4\ execute the following command to initialize the manufacturing connect edge docker container from the downloaded docker image from step 3 docker run name mce d cap add=net admin p 8443 443 v vol1 /var us docker pkg dev/litmus customer facing/imce build/mce\ latest refer to the command parameters \ name mce parameter can be changed with a different name than mce cap add=net admin parameter should not be changed as net admin is required p 8443 443 parameter can be changed with a different port than 8443 internal port 443 can be mapped to any other external port other than 8443 as desired the command v vol1 /var will mount all container data to a volume called vol1 you can name the volume to your preference note the sysctl net ipv4 ping group range="0 2147483647" parameter is not always required however, host system limitations may cause ping errors while using utilities if this occurs, add this parameter before running the container 5\ from the docker terminal window, it will display the ip address to access the manufacturing connect edge device through the web ui enter the ip address into an internet browser url bar to access the manufacturing connect edge device step 2 log in to manufacturing connect edge see access the manufacturing connect edge web ui docid\ o3ekdp0z j7ithaal0mwi for details on logging in