MindConnect Software Agent - Manual - MindConnect Software Agent - MindConnect Software Agent is a pure software solution to connect industrial data sources with Insights Hub. It allows connecting with Insights Hub, collect local data and send it encrypted to Insights Hub. - MindConnect Software Agent
Portfolio
Insights Hub
Product
MindConnect Software Agent
Language
en-US (original)
Introduction
Overview of MindConnect Software Agent
System Manual
Prerequisites
Features
General Features Overview
Protocols Feature Overview
User Interface
Insights Hub MindConnect Software Agent Plugin User Interface
Insights Hub User interface of MindConnect Software Agent Plugin
Datasource Configuration
Agent Settings
Advanced Mappings
Firmware Update
Command history
Diagnostics
MindConnect Software Agent Plugin new UI features
MindConnect Software Agent Web User Interface
MindConnect Software Agent Web User Interface
Navigation menu
Overview area
Supported browser languages
User Roles and Scopes
User Roles and Scopes for MindConnect Software Agent
Onboarding and Configuring MindConnect Software Agent
Overview
Overview of Onboarding MindConnect Software Agent
Prerequisites
Onboarding Procedure
Logging in to Insights Hub
Logging in to Insights Hub
Creating an asset for MindConnect Software Agent
Creating an asset for MindConnect Software Agent
Procedure
Result
Downloading setup file of MindConnect Software Agent
Downloading the setup file for MindConnect Software Agent
Procedure to download setup file
Installing MindConnect Software Agent
Installing MindConnect Software Agent in Windows
Installing MindConnect Software Agent in Windows
Procedure to install MindConnect Software Agent
Procedure after installing the firmware
Procedure to uninstall the MindConnect Software Agent
Installing MindConnect Software Agent in Docker
Installing MindConnect Software Agent in Docker
Prerequisites
Procedure to Install MCSA Linux installer
Result
Onboarding MindConnect Software Agent
Onboarding the MindConnect Software Agent
Procedure to access the web server URL and onboard the device
Serial number
Onboard with file
Onboard with JSON content
Configuration status
Configuring data in Asset Manager
Configuring data in Asset Manager
Configuring data in Asset Manager for MindConnect Software Agent
Creating an aspect and variables
Creating an aspect and variables for MindConnect Software Agent
Procedure
Result
Creating a type in Asset Manager
Creating a type in Asset Manager for MindConnect Software Agent
Requirements
Procedure
Result
Adding Datasource and Datapoints
Adding Datasource
Adding a data source for MindConnect Software Agent
Requirement
Procedure
Result
Cloning of Datasource
Adding Datapoints
Adding data points for MindConnect Software Agent
Requirement
Procedure
Result
Cloning of Datapoints
Configuring Network and Diagnostic settings
Configuring Network Settings
Configuring Network settings
Network settings
DHCP Network settings
Procedure
Network routing
Network routes example
Configuring Diagnostic Settings
Configuring Dagnostic settings
Diagnostic Settings
Auto Log Upload
Log Levels
Upload Logs Now
Configuring Buffer Mechanism
Configuring Buffer Mechanism
Ping support
Ping support for MindConnect Software Agent
Overview
Enable ping
Ping a device
Mapping an aspect to a datasource
Mapping an aspect to a data source for MindConnect Software Agent
Requirement
Map a variable to a data point by using in-cell mapping functionality
Map a variable to a data point from "Advance Mappings" or "Datapoint Mapping" option
Result
Import Journey
Browsing datapoint of a datasource
Browsing datapoint of a data source for MindConnect Software Agent
Supported protocols for Browsing
Prerequisite
Procedure
Result
Importing datasource configurations with datapoint mapping
Importing datasource configurations with datapoint mapping for MindConnect Software Agent
Prerequisites
Procedure
Result
Limitations of Import feature
Configuring MindConnect Software Agent using API
Configuring MindConnect Software Agent using API
AgentManagement API
Protocol configurations
Getting Configuration Details of Protocols
Managing MindConnect Software Agent
Local web server
Settings in MindConnect Software Agent
Settings in MindConnect Software Agent
Diagnosis settings
Log files upload
Change settings status
System settings
Change system time
File Transfer (Drop a file copy for File transfer)
Prerequisites
Firewall
Diagnosing MindConnect Software Agent
Diagnosing MindConnect Software Agent
Diagnosis tab
Diagnosis messages
Diagnosis files
Network analysis
Cloud connection check
Cloud connection check status
Device Maintenance
Device Maintenance
Maintenance area
Firmware update
Manual firmware update
Firmware update status
Factory reset
Start factory reset
Factory reset status
Asset Manager Plugin
Firmware update for MindConnect Software Agent
Firmware update in Asset Manager for MindConnect Software Agent
Firmware update in Asset Manager for MindConnect Software Agent
Cancelling an Online Firmware update
Firmware update for selected or multiple devices
Automatic firmware update of MindConnect Software Agent
Automatic firmware update of MindConnect Software Agent
Remote functions
Remote restart of MindConnect Software Agent
Remote restart for MindConnect Software Agent
Send commands for MindConnect Software Agent
Send commands for MindConnect Software Agent
User interface
Commanding Device via API
Getting deviceId
Getting datasourceId and datapointId
Using MindConnect Software Agent's Hyper-V VM
Using MindConnect Software Agent's Hyper-V VM
Opening the VM
Autostart
System restart
System shutdown
Troubleshooting
Black screen is shown
System gets stuck during start-up
MindConnect Software Agent's VM is shut down, before the restart of Windows host
Managing or maintaining the virtual machines or instances
Managing or maintaining the virtual machines or instances
Procedure to create multiple virtual machines or instances
Result
Procedure to modify multiple virtual machines or instances
Result
Procedure to repair multiple virtual machines or instances
Result
Procedure to removing multiple virtual machines or instances
Result
Configuring MindConnect Software Agent in Docker
Configuring MindConnect Software Agent in Docker
MCSA configuration
MCSA configuration main menu
Add new MCSA Docker container
Container name
HTTP port
MQTT port
MindConnect databus port
WinCC OA PMON port
WinCC OA data port
WinCC OA event port
WinCC OA SNMP port
CodeMeter port
File transfer folder
Confirmation
Manual Container Creation for MCSA Docker
Creating an MCSA Docker Container with Docker Compose
Creating an MCSA Container for Kubernetes
Show running container info
Show all containers
Start Docker container
Stop Docker container
Delete Docker container
Troubleshooting
Troubleshooting
Log files
Overview
Concatenating log file archive parts
Linux
Windows
Configuring protocols
Overview of supported protocols
Overview of supported protocols for MindConnect Software Agent
On data change
On data change behaviors
On data change data acquisition dependent on configured reading cycle
On data change data acquisition independent from configured reading cycle
Protocol specific on data change behavior
S7 protocol
Overview of S7 protocol for MindConnect Software Agent
S7 data point parameter
Requirements for S7-1200 and S7-1500
Address format examples
DB15.DBX6.3
IW10
Overview
Area Types
Area Number
Data Types
Offset
String
OPC UA protocol
Overview of OPC UA protocol for MindConnect Software Agent
OPC UA datasource parameter
OPC UA data point parameter
OPC UA Data Access Specification
Examples NodeId
Datatypes Conversion
OPC UA Event Type
OPC UA Event Types
Create custom event type via API
OPCUA Browsing
Limitations
Type Conversion
Performance of OPCUA Browsing
Modbus TCP protocol
Overview of Modbus TCP protocol for MindConnect Software Agent
Modbus TCP data source parameter
Modbus TCP data point parameter
Using Modbus register addresses directly
SYSTEM protocol
Overview of SYSTEM protocol for MindConnect Software Agent
SYSTEM protocol data point parameter
Application information
CPU information
Disk information
KERNEL information
Memory information
Network information
Rockwell protocol
Overview of Rockwell protocol for MindConnect Software Agent
Rockwell data source parameter
Rockwell data point parameter
S7+ protocol
Overview of S7+ protocol for MindConnect Software Agent
S7+ data point parameter
Fanuc Focas protocol
Overview of Fanuc Focas protocol for MindConnect Software Agent
Fanuc Focas data point parameter
Sinumerik protocol
Overview of Sinumerik protocol for MindConnect Software Agent
Sinumerik data point parameter
IEC61850 protocol
Overview of IEC61850 protocol for MindConnect Software Agent
IEC61850 data point parameter
MTConnect protocol
Overview of MTConnect protocol for MindConnect Software Agent
MTConnect data point parameter
BACnet protocol
Overview of BACnet protocol for MindConnect Software Agent
Parameters
BACnet – Datapoint
Custom protocol
Custom Datasource Protocol
Prerequisites
Appendix
Data center locations
Data center locations
Quality code settings
Using quality code
Using quality code
Quality codes OPC UA and S7 protocol
Quality codes OPC UA and S7 protocol
Quality codes Modbus protocol
Quality codes Modbus protocol
Quality codes SYSTEM protocol
Quality codes SYSTEM protocol
Quality codes Rockwell protocol
Quality codes Rockwell protocol
Quality codes S7+, Fanuc Focas, Sinumerik, IEC61850 and MTConnect
Quality codes S7+, Fanuc Focas, Sinumerik, IEC61850 and MTConnect
Offline buffer
Offline buffer
Firewall Settings
Firewall Settings
Firewall/Proxy rules for MindConnect Software Agent
List of abbreviations
List of abbreviations
MindConnect EthernetIP - CIP Communication path (route parameters) settings
MindConnect EthernetIP - CIP Communication path (route parameters) settings
MindConnect EthernetIP - CIP Communication path (route parameters) settings
Case 1-Accessing data inside an Allen- Bradley PLC
Case 1 – Accessing data inside an Allen- Bradley PLC
Case 2-Accessing the Allen- Bradley PLC via integrated Ethernet port
Case 2 – Accessing the Allen- Bradley PLC via integrated Ethernet port
Case 3-Accessing the Allen- Bradley PLC via the ControlNet Interface
Case 3 – Accessing the Allen- Bradley PLC via the ControlNet interface
MindConnect General Security Principles
MindConnect General Security Principles
Onboarding agent (example, MindConnect Software Agent)
Registering an agent (example, MindConnect Software Agent)
Accepting the registration (example, MindConnect Software Agent)
Validity of the credentials
API communication agent (e.g. MindConnect Software Agent)
Firmware management
Differentiating MCSA between Windows and Linux
Differentiating MCSA between Windows and Linux
Datasource protocols
System protocol
kernel
memory
network
disk
MindConnect Software Agent in Docker Host system
DHCP Network settings
Samba Installation
Package manager configuration
Adding a new user for Samba share
Installing Samba
Adding user to Samba
Samba Configuration
System login Configuration initialization
MindConnect Software Agent in HyperV Host system
MindConnect Software Agent in HyperV Host system
Hyper-V not enabled on IPC
Hyper-V not enabled on PC
Windows Hyper-V is switched off
Known restrictions of MindConnect Software Agent
Known restrictions of MindConnect Software Agent
Local UI
One browser window/tab only
Diagnosis messages are shown twice
Date and Time picker is not shown to select new system time
Onboarding
Encrypted onboarding key
Re-onboarding
Firmware update
Update status does not change
Multi MindConnect Software Agent VMs Installation
Multi MindConnect Software Agent VM installation
MSI package cannot be found
Installing new MindConnect Software Agent version
Default values for datasource Import and Export
Default values for datasource Import and Export
Glossary
Glossary
Aspect
Asset
Asset Identifier
Asset Manager
Asset type
Components
Data point
Data source
Event
Last Connection
MindConnect Element
Industrial IoT
Industrial IoT Launchpad
Online/Offline Mode in Asset Manager
Insights Hub Monitor
Organization
Request
Rule
Settings
Time series