# WAGO Edge Controller

- Link: https://www.agilicus.com/anyx-guide/wago-edge-controller/
- Published: 2024-07-24T23:09:26+00:00
- Author: Don Bowman

1. [Home](https://www.agilicus.com/)
 2. WAGO Edge Controller

![wago](https://www.agilicus.com/www/313d816d-wago-842x1024.png)

# WAGO Edge Controller

The [WAGO Edge Controller](https://www.wago.com/ca-en/plcs-controllers/compact-controller-100/p/751-9301)
is a flexible and open control platform for many embedded and industrial applications.
It provides an excellent vantage point to run the Agilicus Connector.

## WAGO Edge Controller

![WAGO CC100](https://www.agilicus.com/www/c44b859c-mfg_751-9401-1024x1024.jpg)

The [WAGO Edge Controller](https://www.wago.com/ca-en/plcs-controllers/compact-controller-100/p/751-9301)
is a flexible and open control platform for many embedded and industrial applications.
It provides an excellent vantage point to run the Agilicus Connector.

The below instructions were tested on firmware 04.04.03(26) on the following devices:

WAGO Compact Controller CC100 751-9301

WAGO Controller PFC200 750-8212

There are two deployment methods available on the platform:

 1. Native Install. The Agilicus Connector runs as part of the baremetal Host Linux
    distribution
 2. Docker Install. The WAGO Edge Controller runs a container runtime

Since the Agilicus Connector has no local state other than the encryption keys, 
there is no specific preference as to which method to choose. If you are using Service
Forwarders inbound to the device, you will likely want the native install to enable
Machine to Machine communication from a local network.

### Preparation

### NOTE

❗

Agilicus AnyX uses modern cryptography which requires proper time. Please ensure
NTP is configured.

## Requirements

In order to deploy the Agilicus Connector successfully the following steps should
be undertaken

 * Verify that sufficient (~200MB) disk space or expanded storage is available (
   Typical 1.1GB onboard eMMC available)
 * Enable SSH terminal access via Web UI
 * Configure and Sync NTP based time
 * Have WAN access with DNS resolution and network segmentation permitting the Controller
   to reach the Agilicus AnyX cloud IP address over TLS

Confirm SSH is Enabled:

![WAGO Edge Controller: Seamlessly connect OT to IT with AnyX. Visualize real-time
data, manage devices, and gain insights for industrial automation. Explore secure,
scalable edge computing solutions for your WAGO PLC.](https://www.agilicus.com/www/
454eb14e-2024-07-24_15-33.png)

Confirm that your Controller has access to a local or remote NTP Server in order
to maintain accurate time

![WAGO Edge Controller: Flexible and scalable industrial computing platform for 
edge applications, featuring modular design and seamless integration with AnyX.](
https://www.agilicus.com/www/31d25b4e-2024-07-24_15-35.png)

# Option 1. Native Install

The WAGO Edge Controller natively supports the Agilicus Connector. Install the connector
as usual, selecting ‘Linux’, and paste the given command into an administrative (
root) shell via SSH.

![WAGO Edge Controller: Secure and scalable industrial IoT solution for data processing
and cloud connectivity. Visualize WAGO Edge Controller overview showcasing its integration
with AnyX for secure remote access and data management. Learn how WAGO and AnyX 
enable efficient edge computing for your industrial applications.](https://www.agilicus.
com/www/9266b326-2024-07-25_10-13.png)

The results will look as below:

    ```wp-elements-3
    INFO[2024-07-25T00:52:33+02:00] Starting connector - version v0.264.16
    INFO[2024-07-25T00:52:36+02:00] Check if the agilicus connector is already running as a service. If so stop it
    INFO[2024-07-25T00:52:37+02:00] Create file /usr/bin/agilicus-agent-wrapper.sh
    INFO[2024-07-25T00:52:37+02:00] Create file /etc/init.d/agilicus-agent
    INFO[2024-07-25T00:52:37+02:00] Will install to /agilicus-agent-wrapper.sh -> {/usr/bin/agilicus-agent-wrapper.sh -rwxr-xr-x <nil>}
    INFO[2024-07-25T00:52:37+02:00] Will install to /agilicus-agent-bb.sh -> {/etc/init.d/agilicus-agent -r-xr-xr-x <nil>}
    INFO[2024-07-25T00:52:37+02:00] Will install to /agilicus-agent-wrapper-bb.sh -> {/usr/bin/agilicus-wrap -r-xr-xr-x <nil>}
    INFO[2024-07-25T00:52:37+02:00] Create a directory at /opt/agilicus/agent/tufmetadata/latest
    INFO[2024-07-25T00:53:29+02:00] Create a user and group named Agilicus to run the agilicus-agent service
    INFO[2024-07-25T00:53:29+02:00] Copy executable to /opt/agilicus/agent
    INFO[2024-07-25T00:53:29+02:00] Set permissions to Agilicus on /opt/agilicus/agent
    INFO[2024-07-25T00:53:29+02:00] Create symlink from /usr/bin/agilicus-agent to /opt/agilicus/agent/agilicus-agent-arm
    INFO[2024-07-25T00:53:30+02:00] creating connector instance
    INFO[2024-07-25T00:53:31+02:00] Join a connector cluster
    INFO[2024-07-25T00:53:31+02:00] Start agilicus-agent service
    INFO[2024-07-25T00:53:31+02:00]
    INFO[2024-07-25T00:53:31+02:00] Installation Complete
    INFO[2024-07-25T00:53:31+02:00]
    ```

You can verify the Agilicus Connector instance status in the Connector Overview 
interface.

![WAGO Edge Controller: Unleashing Industrial IoT Potential - Visualize WAGO Edge
Controller and its connectivity options for seamless industrial IoT integration.
Learn how AnyViz enhances WAGO controllers for efficient data management and edge
computing solutions.](https://www.agilicus.com/www/76f67855-2024-07-24_16-04.png)

# Option 2. Docker Install

### NOTE

❗

Currently the docker installation support is restricted to 64bit ARMv8 architecture.
Support for the 32bit ARMv7 is pending, we recommend Option 1 for these models. 
Contact us if you are unsure which architecture your controller uses.

### Additional Requirements

As a primer, make sure to consult the WAGO documentation for the latest supported
hardware and configurations of Docker.

If using Docker, make sure you understand the requirements of installing and running
Docker service on the controllers with the WAGO Quickstart Guide on Docker available
here:

[https://www.wago.community/t/how-to-getting-started-with-docker/95](https://www.wago.community/t/how-to-getting-started-with-docker/95)

 * Verify that the WAGO Controller model supports Docker
 * Deploy and Enable Docker via Web UI

Confirm Docker is enabled on the device by logging into the Web Interface:

![WAGO Edge Controller: Open source industrial automation platform for IoT and edge
computing, connecting PLCs, sensors, and cloud services. Featuring a modular design
and real-time data processing.](https://www.agilicus.com/www/bfd172a6-2024-07-24_15-
31.png)

SSH to the Controller with the admin credentials and elevate your session to root
privileges:

![WAGO Edge Controller: Industrial IoT solution for data processing, visualization,
and control at the network edge. Integrate seamlessly with AnyX for secure remote
access and management.](https://www.agilicus.com/www/44e78d84-2024-07-24_15-37.png)

Verify that docker is installed:

![WAGO Edge Controller: Industrial IoT solution for data acquisition, processing,
and control at the edge. Visualize the WAGO Edge Controller with AnyViz Cloud, showcasing
seamless integration for efficient industrial automation.](https://www.agilicus.
com/www/5153d937-2024-07-24_15-38.png)

## Create and Deploy AnyX Connector

Navigate to your Agilicus AnyX Admin page for your organisation and create a new
connector instance under Resources -> Connectors -> New

Once created, proceed with Installation and select the Docker tab in the installation
menu:

![WAGO Edge Controller: Comprehensive guide and architecture diagram showcasing 
AnyX integration for secure and scalable industrial IoT solutions. Learn about WAGO
PLC features, edge computing capabilities, and seamless connectivity.](https://www.
agilicus.com/www/17465d96-2024-07-24_15-44.png)

Copy the text block by clicking on the blue “Copy” icon.

Paste the text block in your Controller SSH Session:

![WAGO Edge Controller: Industrial IoT Solution for Edge Computing, PLC Control,
and Data Processing. Integrate WAGO Edge Controllers into your IIoT infrastructure
for real-time automation and enhanced data analytics.](https://www.agilicus.com/
www/5655d58f-2024-07-24_15-47.png)

Verify that docker is now running an ‘agilicus-connector’ container

![WAGO Edge Controller: Flexible and Scalable Industrial Automation Solution](https://
www.agilicus.com/www/3d7dc23c-2024-07-24_15-54.png)

Verify in the Agilicus AnyX admin interface that the connector instance is up and
communicating with the cloud platform. The Instance dialog should display the WAGO
controller hostname and a status of GOOD:

![WAGO Edge Controller: Unleashing Industrial IoT Potential - Visualize WAGO Edge
Controller and its connectivity options for seamless industrial IoT integration.
Learn how AnyViz enhances WAGO controllers for efficient data management and edge
computing solutions.](https://www.agilicus.com/www/76f67855-2024-07-24_16-04.png)

## Troubleshooting

If the docker installation fails or the container fails to start, running docker
logs will provide a lengthy and verbose output of the installation and initialisation
process of the container.

![WAGO Edge Controller: Industrial IoT Solution for Automation and Data Processing
at the Edge. Image shows the WAGO Edge Controller with various input/output modules,
highlighting its compact design and connectivity options for industrial applications.
Learn more about WAGO Edge Controllers at Agilicus.](https://www.agilicus.com/www/
c20befec-2024-07-24_16-07.png)
