Docker Installation

Install Docker and Compose

curl -fsSL https://get.docker.com -o ~/get-docker.sh
sudo sh ~/get-docker.sh

sudo groupadd docker

sudo usermod -aG docker "$USER"
newgrp docker
sudo systemctl enable --now docker

Select Latest Image

Docker Hub Images

Export the latest image tag to FOCAS_TGT environment variable.
Docker-compose will use this variable to pull the correct image.

For x86 Linux architecture use:

export FOCAS_TGT=linux64-d538eef

For ARM Linux architecture use:

export FOCAS_TGT=arm-d538eef

Clone Repository

mkdir ~/fanuc
cd ~/fanuc

git clone --recurse-submodules -j8 \
	https://github.com/Ladder99/fanuc-driver.git

If you are working with the develop branch then you’ll want to check that branch out.

cd fanuc-driver
git checkout develop
cd base-driver
git checkout develop

Prepare Volumes

Below commands copy the basic configuration files for Fanuc Driver, Mosquitto, and MTConnect Agent.

cd ~/fanuc/fanuc-driver/examples

mkdir -p ../../volumes/fanuc-driver
cp docker/nlog.config ../../volumes/fanuc-driver/nlog.config
cp docker/config.system.yml ../../volumes/fanuc-driver/config.system.yml
cp docker/config.user.yml ../../volumes/fanuc-driver/config.user.yml
cp docker/config.machines.yml ../../volumes/fanuc-driver/config.machines.yml

mkdir -p ../../volumes/mosquitto/config
mkdir -p ../../volumes/mosquitto/data
mkdir -p ../../volumes/mosquitto/log
cp mosquitto.conf ../../volumes/mosquitto/config/mosquitto.conf

mkdir -p ../../volumes/agent/config
mkdir -p ../../volumes/agent/data
mkdir -p ../../volumes/agent/log
cp docker/agent.cfg ../../volumes/agent/config/agent.cfg
cp docker/devices_template.xml ../../volumes/agent/config/devices.xml

Start Profile

Available profiles:

Image	Profiles	Description
Portainer	`all`, `admin`	Visual Docker management.
Dozzle	`all`, `admin`	Docker log concentrator.
Influx	`all`, `influx`	Time series database.
Agent Unoffical	`all`, `mtc_2203`	Unnoficial MTConnect Agent v2.2.0.3.
Agent Official	`all`, `mtc`	Official MTConnect Agent latest.
Mosquitto	`all`, `mtc`, `mqtt`	MQTT broker.
Fanuc Driver	`all`, `influx`, `mqtt`, `spb`, `mtc_2203`, `mtc`, `fanuc`	Fanuc Focas adapter.

If you are using the Fanuc Driver in combination with Ladder99 MTConnect Historian then stand up the fanuc profile.
If you want to output data to InfluxDb, MQTT, or as SparkplugB then select the appropriate profile, in addition to admin.

cd ~/fanuc/fanuc-driver/examples

profile=fanuc

docker compose --project-name fanuc --file compose.yml --profile $profile --verbose pull
docker compose --project-name fanuc --file compose.yml --profile $profile --verbose create
docker compose --project-name fanuc --file compose.yml --profile $profile --verbose start

Building an Image

Clean Environment

docker container stop fanuc_driver
docker container stop agent
docker container rm fanuc_driver
docker container rm agent
docker container prune

docker rmi $(docker images --format '{{.Repository}}:{{.Tag}}' | grep '\(ladder99\|mtconnect\)/agent\|ladder99/fanuc-driver')
docker image prune

sudo rm -rf ~/fanuc

Clone Repository
Prepare Build

For x86 Linux architecture use:

cd ~/fanuc/fanuc-driver

# set vars for build
os=LINUX64
image=ladder99/fanuc-driver
commit=$(git rev-parse --short HEAD)
tag=linux64-$commit

For ARM Linux architecture use:

cd ~/fanuc/fanuc-driver

# set vars for build
os=ARM
image=ladder99/fanuc-driver
commit=$(git rev-parse --short HEAD)
tag=arm-$commit

Build Image

# build driver container
docker build \
	-f Dockerfile.$os \
  --tag=$image:$tag .

# the architecture you are on (linux64,arm)
# set the driver image tag
#export FOCAS_TGT=$( docker images ladder99/fanuc-driver | tail -n +2 | awk 'NR==1{print $1":"$2}' )
export FOCAS_TGT=$tag

Push Image

docker login

docker push ladder99/fanuc-driver:$FOCAS_TGT

Prepare Volumes
Start Profile