Emerson PACEdge, User Manual

Page 1: ...PACEdge User Manual GFK 3178B Nov 2020 PACEdge USER MANUAL ...

Page 2: ...5 PACEdge Architecture Details 8 5 1 PACEdge Software Services 8 5 1 1 Necessary Platform Components 9 5 1 2 Administration Components 9 5 1 3 Application Development Components 10 5 2 PACEdge Communication and Data Flow 11 5 2 1 Internal Communication Between PACEdge Applications 12 5 3 Data Storage and Backup 12 Section 6 PACEdge Usage Examples 13 6 1 Earthquake Monitor 13 6 1 1 Example Descript...

Page 3: ...RED Dashboard Performance Indication 23 Section 8 Saving and Restoring User Data 25 8 1 Exporting and Importing Flows in Node RED 25 8 1 1 Export Flow 25 8 1 2 Import Flow 25 8 2 Exporting and Importing Views in Grafana 26 8 2 1 Export Flow 26 8 2 2 Import Flow 26 Section 9 PACEdge Software Recovery 27 9 1 PACEdge Software Recovery Procedure 27 9 2 PACEdge Software Backup Procedure 29 Section 10 T...

Page 4: ...ring installation operation and maintenance The information is supplied for informational purposes only and Emerson makes no warranty as to the accuracy of the information included herein Changes modifications and or improvements to equipment and specifications are made periodically and these changes may or may not be reflected herein It is understood that Emerson may make changes modifications or...

Page 5: ...rface to decrease your development time and increase your deployable footprint 1 1 Revision History Rev Date Description B Nov 2020 Added Section 7 2 Node RED Dashboard Performance Indication A Sep 2020 Initial release 1 2 Minimum HW Requirements PACEdge is a Ubuntu based operating system that is virtually hardware independent PACEdge is available as a pre installed software package on select Emer...

Page 6: ...rted 1 Connect Ethernet cable to the first Ethernet port which is o on RXi2 LP LAN port next to the USB port o on RXi2 BP ETH0 port 2 Connect the 24V 25 power 3 Setup User PC Ethernet port IP address to be statically assigned as follows o IPv4 Static IP 192 168 3 10 or similar in the same subnet o Netmask 255 255 255 0 4 Power up the PACEdge unit and wait until it boots 5 Open the browser of choic...

Page 7: ...ser License Agreement Shortcuts to all of the available development tools with web interfaces will be shown on the PACEdge Landing Page Figure 2 Figure 2 PACEdge Landing Page Start exploring PACEdge for instance click on Node RED log in with o user admin o password edgestack Start exploring example flows or creating your own flows For additional examples consult Section 6 PACEdge Usage Examples of...

Page 8: ...t Ethernet port 192 168 3 100 DHCP assigned IP on any Ethernet port RXi2 LP LAN port next to the USB port RXi2 BP ETH0 port 1 Follow the Ethernet Port and IP address guidance above 2 Attach Ethernet cable to an appropriate Ethernet port Optionally attach a USB keyboard to any of the USB ports Optionally attach a display to the DP port Note DisplayPort DP connection is well suited for conversion to...

Page 9: ...that states that the identity of the device could not be confirmed 3 Click on Advanced and Accept to proceed 2 The first time you connect a warning message will appear that states that the identity of the device could not be confirmed 3 Click on Advanced and Accept to proceed 2 Change your password during your first login when prompted 4 Read and accept the Emerson End User License Agreement 4 Log...

Page 10: ... Linux based software but designed to be user friendly with a graphical user interface Cockpit for all basic configuration tasks To access Cockpit open browser and type in the IP address of PACEdge This will bring you to the home page where you can click on the Cockpit icon 4 2 1 System Configuration Changes via Cockpit Cockpit supports most system configuration tasks such as Changing OS Cockpit p...

Page 11: ...PACEdge User Manual Section 4 GFK 3178B Nov 2020 Quick Start Guide 7 Figure 4 Cockpit Screen For further Cockpit details and documentation please consult online resources ...

Page 12: ...PHP MQTT Brk external Data Logic Analytics Communication Visualization Database System App Management Misc System Comm and Security Features PACEdge was designed using Docker architecture in which each application is running in its own Docker container Figure 6 Given that containers are designed to be easily replaceable they do not retain an internal state between reboots unless specifically desig...

Page 13: ...tatus and management options user management options as well as different logs for troubleshooting Since Cockpit is meant to manage Linux operating system tasks it runs on Linux as a native application and not in a Docker Container Cockpit can be accessed via browser at ip_address_of_PACEdge 9090 cockpites For more details about Cockpit please refer to www cockpit project org 5 1 2 2 Portainer PAC...

Page 14: ...se InfluxDB Grafana is implemented in a Docker Container and can be accessed via browser at ip_address_of_PACEdge grafana For more details about Grafana please refer to www grafana com 5 1 3 3 MQTT PACEdge implements two MQTT brokers one is meant to be used for PACEdge internal communication between Docker containers and the second one for external communication Node RED does have MQTT nodes pre i...

Page 15: ... services such as the Internet but are not directly accessible from outside Some services such as Traefik and external MQTT broker do have open ports 80 443 1883 which enable these services to be reached from the outside External Ethernet ports and their IP addresses can be easily managed via Cockpit or other standard Linux tools Figure 7 PACEdge Network Communication Paths External Network ex 192...

Page 16: ...QTT communication parameters Server mqtt internal ipc Port 1883 External MQTT communication parameters When using MQTT broker in the same PACEdge unit o Server MQTT o Port 1883 When using MQTT broker in the other PACEdge unit attached via Ethernet o Server xx xx xx xx 1883 where xx xx xx xx is an IP address of the remote unit such as 192 168 2 90 o Port 1883 5 3 Data Storage and Backup PACEdge sof...

Page 17: ...e latest earthquake reports extracts location and magnitude values stores data in InfluxDB and also displays it via Node RED Dashboard 6 1 2 Prerequisites Connectivity to the Internet 6 1 3 Example Installation 1 Open Node RED 2 Click on the menu icon upper right corner and choose Import 3 Click on Examples 4 Expand node red contrib Emerson 5 Select Earthquake and click Import 6 The example will a...

Page 18: ... Click the Deploy button each time for the changes to take effect 7 To observe the status and progress of Node RED flow open the Debug window by clicking on the bug icon To clear previous debug messages click on the trashcan icon 8 Now we are ready to start Click on the blue square button left of the Start Button icon to start the flow 9 In the Debug window on the right side of the screen you will...

Page 19: ...s to get csv file with earthquake data o The next block is edit CSV node which parses the CSV file and outputs JavaScript object listing all data items earthquake location and strength o JavaScript Object then goes to multiple nodes Multiple Function nodes extract data of interest from the JavaScript object and forward it to InfluxDB and different Dashboard chart nodes These chart nodes are what y...

Page 20: ... to it and read from it 6 2 2 Prerequisites If new to Node RED completion of the Earthquake Monitor example is highly recommended as it shows some Node RED usage basics and tips 6 2 3 Example Installation 1 Open Node RED 2 Click on the menu icon upper right corner and choose Import 3 Click on Examples 4 Expand node red contrib emerson 5 Select InfluxDB and click Import 6 An example will appear as ...

Page 21: ...test This name is entered in the InfluxDB nodes Database field but also needs to match in function node create DB Therefore if you would like to change the database name you need to change it in the function node as well 6 To read entries from InfluxDB click on the inject button within Query flow In the debug window you will see a list of values 7 If you want to modify query parameters edit the fu...

Page 22: ...nternal MQTT communication is designed to be used internally between PACEdge components while external MQTT Broker can be accessed from other devices via Ethernet 2 Once flows are deployed they will start publishing messages to both internal and external MQTT brokers and the specified Topic once a second Receiving flows are configured to listen to specified Topics and once a new message is publish...

Page 23: ...lation 1 Open Node RED 2 Click on the menu icon upper right corner and choose Import 3 Click on Examples 4 Expand node red contrib emerson 5 Select MySQL and click Import 6 An example will appear as a new flow within Node RED Figure 13 New Flow within Node RED 6 4 4 Example Walk Through 1 To start with access to the MySQL database needs to be authorized by providing a user name and password To do ...

Page 24: ...function s Insert Value 9 Finally click on the Inject button of the last flow This will send a query to the database and return your entries 6 5 Grafana Use Example 6 5 1 Example Description This example shows how to configure Grafana to display data that is stored in InfluxDB 6 5 2 Prerequisites Requires running InfluxDB Example as described in Section 6 2 6 5 3 Example Installation Open Grafana ...

Page 25: ... InfluxDB 4 Click on Save Test on the bottom you should get the message Data source is working with green background 5 Click on Explore on the left sidebar 6 Click on Select Measurement and select test in the drop down list 7 Below will pop up a graph 8 Create your Dashboard with the desired view configuration ...

Page 26: ... test was done by using two PACEdge devices one configured to act as OPC UA Server and the other one as OPC UA Client The server was setup to generate a large number of variables and to have them updated at the specified rate The client was using two ways of getting variable updates 1 using Listen Node RED node and 2 using variable Read Node RED node In addition once variables had been received tw...

Page 27: ... Performance variables sec Client Functions LP RXi2 BP R1505 CPU OPC UA Listen basic Dashboard 200 700 OPC UA Listen basic Dashboard InfluxDB basic Grafana 100 400 7 2 Node RED Dashboard Performance Indication Test Description PACEdge with OPC UA Client reads variables stores them in InfluxDB and finally displays the data in 20 Node RED Dashboard graphs which are updated every second In parallel t...

Page 28: ...PACEdge User Manual Section 7 GFK 3178B Nov 2020 Performing PACEdge Updates 24 Figure 16 Dashboard Update Rate ...

Page 29: ...e 3 emersonedgestack vxx_influxdb 4 emersonedgestack vxx_mysql 5 emersonedgestack vxx_nodered 6 emersonedgestack vxx_portainer Alternatively Node RED flows and Grafana views can be stored exported and later installed imported from each application natively 8 1 Exporting and Importing Flows in Node RED 8 1 1 Export Flow While in Node RED application Click on the menu icon on the right side of the s...

Page 30: ...t on your client system not PACEdge 8 2 2 Import Flow While in Grafana application Navigate to Create icon on the left side and select the Import option Click on Upload JSON File Select your desired Grafan view file xxx json and click on open Select the InfluxDB database from the drop down menu Note If there is no valid InfluxDB database there then most likely Grafana was not configured yet to con...

Page 31: ...wn USB stick minimum 8 GB size to download the applicable PACEdge Software Recovery Emerson System Installation image from the Emerson support site Important Performing a factory reset will overwrite all data and disk partitions Make sure to backup your critical data before proceeding Procedure 1 Backup all important data from your current PACEdge system onto a USB stick or another device on the n...

Page 32: ...CEdge Screen 7 Next you will be asked to confirm on which disk this PACEdge needs to be reinstalled It should be the first entry dev sda Mark it with the space bar and hit enter to proceed Figure 19 Designating Disk Space 8 The installation process will take up to 10 minutes When it has finished installation the following screen will appear Figure 20 Successful Installation 9 Once finished please ...

Page 33: ... on the USB Stick you booted from Please use a USB Stick with appropriate free space to capture the archives 10GB min As the archives are packed the backup procedure can take quite a while depending on the performance of your hardware 30min or more is normal NOTE Backup will only work for preinstalled systems or systems installed with the EmersonSystemInstallation package You can restore the backu...

Page 34: ...ful to provide an exported Syslog file To do that please log in via a terminal window and execute journalctl log 10 2 PACEdge Files On Emerson IPCs with preinstalled PACEdge you will find the PACEdge Files in the Admin s home directory home admin PackEdgeSoftwareInstall Version These files can be used by expert users to adapt and modify the PACEdge Docker environment to their needs and to stop and...

Page 35: ... are running emerson nodered OK emerson portainer OK emerson traefik OK emerson grafana OK emerson nginx OK emerson chronograf OK emerson mysql OK emerson mqtt OK emerson mqtt internal ipc OK emerson influxdb OK Check if Cockpit is started and running cockpit socket OK Check if node red palettes are installed correctly To be done Check if WEB interfaces are accessible nodered 1880 OK grafana 3000 ...

Page 36: ...n PACEdge This command will delete all containers and data is stored within the containers but persistent data will remain in external volumes This command is useful if you want to exclude an application from the PACEdge configuration see the following command 10 6 config compose sh The script config compose sh let you select the PACEdge applications you want to run By default all applications are...

Page 37: ...turns customercare cn mas emerson com Technical Support support mas apac emerson com Any escalation request should be sent to mas sfdcescalation emerson com Note If the product is purchased through an Authorized Channel Partner please contact the seller directly for any support Emerson reserves the right to modify or improve the designs or specifications of the products mentioned in this manual at...