nshimaza / cppagent-ir800

Build and package MTConnect Agent for IOx app running on Cisco IR809/829 routers

MTConnect Agent on IR800 IOx

This Git repo provides procedure and Dockerfiles to build an IOx application running open source C++ MTConnect Agent on Cisco 829 / 809 Industrial Integrated Services Routers. This demonstrates how you can build and package IOx apps for IR 809 or 829.

Building process consists of following steps.

1. Build MTConnect Agent executable using Cisco provided Docker image.
2. Extract the built executable from the image.
3. Build Docker image for runtime.
4. Convert the runtime image to IOx application.

Prepare your environment

Before you start, you need to have ioxclient installed.

ioxclient is a developer tool used for manipulating IOx environment. It will be used for creating IOx application from a Docker image. You can download ioxclient from DevNet IOx resource download page.

Cisco provides Docker image tailored for IOx application. It can be used both for build environment and runtime environment. The image is distributed via devhub.cisco.com.

Consult to Cisco DevNet site for more detail.

Build runtime Docker image

The Dockerfile under runtime folder builds cppagent binary and Docker image for runtime for you. Execute following commands.

$ cd runtime
$ docker build -t cppagent-ir800 .

The Dockerfile under runtime is a multi-stage Dockerfile. The first stage pulls all dependency for building cppagent and compile it. The second stage copies the cppagent binary from the first image then setup dependency only necessary for runtime.

You will get a Docker image tagged with "cppagent-ir800". The image contains agent executable and start-up shell script. The agent executable is located at /usr/local/bin/agent. Startup shell script is located at user/local/bin/start_agent.sh. start_agent.sh can be a startup script for IOx app.

Convert Docker image to IOx app

Once a Docker image for runtime has been built, you can convert it to IOx application package.

Navigate to the directory app and execute following command.

$ cd ../app
$ ioxclient docker package cppagent-ir800 .

You will get packaget.tar which is IOx application package installable to IR809 or IR829.

Build environment

Dockerfile under build folder creates a build environment for cppagent. It pulls source Docker image for IOx app and all dependencies for building cppagent then compile it. You can leverage this environment for developing your own version of cppagent IOx app.

You don't have to create this image just to get runtime image. Dockerfile under runtime folder does it for you automatically.