background image

GFK-2993F  39

 

For public disclosure

 

 

5.3  Collect Enrollment and Configuration Information 

Before enrolling and configuring a Field Agent, it is often useful to first collect all of the enrollment information (URLs, Field 
Agent serial numbers) and configuration information (Time Series Ingestion URL, Zone ID, etc.) into a single place to 
reference through the process. It is recommended to fill out as much of this table as possible before proceeding and referencing 
it in subsequent steps. 
 

Resource

 

Where To Find It

 

Value 

EdgeManager URL 

(Certificate Enrollment URL) 

Response e-mail from Field Agent Registration 

 

UAA URL 

EdgeManager Settings page 

 

OAuth Enrollment URL 

(if not using Certificate 
enrollment) 

EdgeManager Settings page 

 

Device Name 

User Selected 

 

Device ID 

User Selected, although typically the Device 
Serial Number printed on the Field Agent 

 

Predix Machine Web 
Console URL 

Section 

Log into the Web Console

 

based on Field 

Agent type and user-selected IP address 

 

Network Proxy and Port  
(if required) 

User-specified based on target network 

 

Data Source IP address and 
Port (OPC UA Server, 
Modbus TCP Slave, etc.) 

User- specified based on target network 

 

Data tag names and 
corresponding variable 
names or register addresses 

User- specified based on target network 

 

Data subscription name(s) 

User-specified based on target network. Data 
tags may be divided into multiple subscriptions. 

 

Time Series Ingestion URL 

Response e-mail from Time Series database 
activation request 

Default US-West URL: 

wss://gateway-predix-data-services.run.aws-
usw02-pr.ice.predix.io/v1/stream/messages 

 

Default US-East URL: 

wss://gateway-predix-data-services.run.asv-
pr.ice.predix.io/v1/stream/messages 

Time Series Zone ID 

Response e-mail from Time Series database 
activation request 

 

 

5.4  Start the Field Agent 

 

After providing the Mini Field Agent or the controller with Embedded Field Agent with power, the Field Agent will begin to 
boot. The green 

ON 

LED (for MFA) or 

FAOK

 LED (for EFA) will begin blinking when Predix Machine is starting, which 

is a process that can take approximately one minute. For the MFA, the green 

ON 

LED will turn solid once Predix Machine 

is running. For the CPE400, the 

FAOK

 LED will blink faster once Predix Machine is running, and the Display will 

indicate a FA Status of “Not Connected”. Once Predix Machine is running, the Web Console is accessible for configuring 
and enrolling the Field Agent. 
 
For the Virtual Field Agent, power on the Virtual Machine. There is no associated LED. Instead, when the Field Agent is 
up you should be able to access the Web Console. 
 

 

Summary of Contents for Mini Field Agent

Page 1: ...GFK 2993F Field Agents User Guide July 2017 For public disclosure...

Page 2: ...rvice Office or an authorized GE Sales Representative Revised June 2017 Issued Aug 2016 2016 2017 General Electric Company Indicates a trademark of General Electric Company and or its subsidiaries All...

Page 3: ...if not strictly observed could result in personal injury or death Caution Indicates a procedure or condition that if not strictly observed could result in damage to or destruction of equipment Attent...

Page 4: ...toll free 800 option is unavailable Technical Support Email support ip ge com Customer Care Email customercare ip ge com Primary language of support English Europe the Middle East and Africa Online T...

Page 5: ...2 3 2 MFA Included Items 26 2 3 3 MFA Accessories 26 2 4 Agency Certifications and Standards 27 2 4 1 Federal Communications Commission FCC 28 2 5 Replacement and Spares 29 2 5 1 Replacement Procedure...

Page 6: ...Information and Trigger Enrollment 59 5 10 1 4 1 Using Certificate Enrollment 60 5 10 1 4 2 Using OAuth Authentication Code Enrollment 62 5 10 1 5 Verify the Field Agent is Online in EdgeManager 63 5...

Page 7: ...Machine Adapter 82 6 2 5 3 Using the Modbus TCP Machine Adapter 83 6 2 5 4 Using Store and Forward When Internet Connectivity is Disrupted and Restored 84 6 2 6 Reconfigure the Field Agent 85 6 2 6 1...

Page 8: ...ada or European Union per catalog number ICMFA001US0 ICMFA001EU0 Field Agent as a standalone appliance for connecting to external data sources Includes optional Wi Fi hotspot for provisioning and opti...

Page 9: ...K 2224 TCP IP Ethernet Communications for PACSystems User s Manual GFK 2225 TCP IP Ethernet Communications for PACSystems Station Manager Manual GFK 2571 PACSystems RX3i PROFINET Controller Manual GFK...

Page 10: ...eak fix model and implement predictive analytics to minimize unplanned downtime GE has developed a family of Field Agent devices to address the challenges of communicating equipment data A Field Agent...

Page 11: ...he Field Agent ecosystem enables end users ease of developing Predix solutions using the MFA platform The following figure depicts the typical installation of a MFA The section Configure the Network p...

Page 12: ...ps RS 232 One RS 232 Serial Port pluggable screw terminal Maximum cable distance is 15m Maximum communication rate is 115 2 kbps RS 485 One RS 485 Serial Port pluggable screw terminal Maximum cable di...

Page 13: ...ational Vibration IEC 600068 2 6 10 57Hz 0 012 ppk displacement 57 500HZ 2 0g acceleration Operational Shock IEC 60068 2 27 15g 11ms sine wave Mean Time Between Failures ICMFA000000 415 750 hours 47 4...

Page 14: ...ered data in the event of temporary loss of communications to the cloud Therefore the Store and Forward configuration files for the MFA and EFA are different 1 5 1 Mark VIe IS420UCSCH1A CPU w Field Ag...

Page 15: ...nux OS Updates and checking status and running commands While the VFA is essentially configured the same way as an MFA or VFA there are different Application and Configuration templates provided for t...

Page 16: ...attery may present a risk of fire or explosion Warning Battery may explode if mistreated Do not recharge disassemble heat above 100 C 212 F or incinerate The MFA module has an optional cellular modem...

Page 17: ...ACC001 MFA Panel Mounting Kit is required to use the Panel Mount option After mounting the MFA connect it to the facility network using standard Ethernet cables The LAN interface should be connected t...

Page 18: ...IN Rail mounting clip as displayed in the following figure For DIN Rail mounting pull the clip down and lock it in place Place the unit on the DIN rail and then push the clip up to secure it The optio...

Page 19: ...attach the ICMFAACC001 panel mount plate to the side of the MFA module using the four M3 screws included with the mounting kit Attach the panel mount plate in the orientation as displayed in the foll...

Page 20: ...four sides of the MFA module with details for connections Front View Top View Cellular Antenna Connections on applicable models MicroSD slot for GE internal use only Local Field I O DIN Rail Mounting...

Page 21: ...s an IEC 60320 C14 inlet plug for attachment of the AC power cord The ICMFAACC002 may be adapted to local power by using a desktop computer style AC power cord with an IEC 60320 C13 connector on one e...

Page 22: ...H 2 CAN_L RS 485 Serial 3 Ground 4 A RX 5 B CTS 6 Y TX 7 Z RTS RS 232 Serial 1 TX 2 RX 3 GND 4 RTS 5 CTS 2 1 1 6 Network Configuration Note Refer to the section MFA Interface Details for a figure that...

Page 23: ...the MFA is in Configuration Mode ACT LED Blinking orange indicates that data is being received from a configured Machine Adapter Cloud LED Blinking blue indicates Predix Machine is not connected to t...

Page 24: ...n Mode a Wi Fi hotspot is enabled that can be used to enroll the Mini Field Agent in Predix EdgeManager and read device diagnostics using an iPhone app While in Configuration Mode the green ON LED fad...

Page 25: ...fter which the Field Agent will reboot Once the green ON LED is solid it will be possible to log into the Predix Machine Web Console and configure the Field Agent CauCau tion On the first boot followi...

Page 26: ...wing items are included with the MFA not ordered separately Accessory Item Description Wi Fi Antenna Cable Assembly Wi Fi models only Taoglas GW 11 A153 dipole antenna with Taoglas CAB 628 IPEX MHF1 t...

Page 27: ...ion Certification Body under authority of Federal Communications Commission FCC and Industry Canada IC for intentional transmitters European Radio Equipment European Restriction of Hazardous Substance...

Page 28: ...public disclosure 2 4 1 Federal Communications Commission FCC Caution Changes or modifications not expressly approved by the party responsible for compliance could void the user s authority to operat...

Page 29: ...United States most areas have adopted the National Electrical Code standard and specify that all wiring conform to its requirements In other countries different codes will apply For maximum safety to...

Page 30: ...entative Prior to ordering a replacement part Identify the part e g ICMFA000000 AAAA Determine if the part is under warranty While ordering be sure to include the complete part number and revision let...

Page 31: ...GFK 2993F 31 For public disclosure Notes...

Page 32: ...nformation about the UCSC hardware please see GEH 6721_Vol_II Mark VIe and Mark VIeS Control Systems Volume II General purpose Applications 3 1 1 UCSC EFA Network Configuration The UCSC EFA uses the I...

Page 33: ...nd Description 5 10 seconds Toggle Configuration Mode Enable or Disable access to the Web Console If the Web Console is disabled then this will enable access to the Web Console for one hour If the Web...

Page 34: ...PACSystems RX7i RX3i CPU Reference Manual GFK 2222Y or later 3 2 1 CPE400 EFA Network Configuration The CPE400 EFA uses the EFA Port found on the bottom of the CPE400 to connect to the Predix Cloud I...

Page 35: ...Cancel FA Settings Display Menu Menu Item Description EFA Status Shows the current state of the Field Agent as follows Off The Field Agent is Off Starting The Field Agent is starting Not Connected The...

Page 36: ...GFK 2993F 36 For public disclosure 3 3 GE EFA Orderable Items Catalog Number Description ICCP4MGMT1YR Annual Device Management Fee ICPREDIXSERVICES Predix Services as Consumed...

Page 37: ...e vmx file to make sure the pcislotnumbers correspond to the ens numbers shown in the table above If changes are made make sure that there are no duplicate pcislotnumbers they may need to be changed f...

Page 38: ...ud it is still required that you enroll your Field Agent 8 If you plan to stream data to the cloud a Create Configuration See Configuring Data Collection and Sending Data to the Cloud b Deploy Configu...

Page 39: ...sponding variable names or register addresses User specified based on target network Data subscription name s User specified based on target network Data tags may be divided into multiple subscription...

Page 40: ...and running and the Web Console will be available However if the FA OK LED is blinking at a 1 Hz Rate then it could mean either that Predix is still starting and so the Web Console will NOT be availa...

Page 41: ...re all Field Agent settings including Web Console password to factory default values 9 Verify that the Log Service page displays which indicates a successful login Note that while the underlying Predi...

Page 42: ...0 N A N A VFA DHCP 172 16 101 150 subnet mask 255 255 240 0 172 16 201 150 subnet mask 255 255 240 0 By default the Mini Field Agent s WAN interface is set to acquire an IP address from a DHCP server...

Page 43: ...dress enter the desired IP address and network mask and click the Save button When the IP Address is changed the Web Console session will end after the Save button is pressed and a new session will ne...

Page 44: ...e proxy server s address and port in the form proxy port in the Proxy Settings textbox and press the Save button To verify the Field Agent can successfully use the newly configured network proxy to re...

Page 45: ...Agent Sales Catalog 5 6 3 1 Enabling the Cellular Modem From the Web Console navigate to the Technician Console Network Configuration page Select Cellular Modem for the cloud connection interface and...

Page 46: ...e 5 6 3 3 View the Cellular Status Cellular modem diagnostics including signal strength network connectivity usage statistics and SIM card information are available from the Technician Console Cellula...

Page 47: ...es Database 5 7 1 Using NTP Time Synchronization By default time synchronization is configured to use the time windows com NTP Server If a valid network path to the Internet exists time will be synchr...

Page 48: ...s time synchronization method will only work with HTTPS URLs that do not require a network proxy in order to reach them If the new HTTPS URL was successfully configured after pressing the Save button...

Page 49: ...es a daily continuous integration process to verify that updates remain compatible with all Field Agent hardware and Predix software before they become available to installed Field Agents Encryption a...

Page 50: ...GFK 2993F 50 For public disclosure 2 Verify that the Field Agent Updater page displays...

Page 51: ...ni Field Agent MFA Firmware Image Embedded Field Agent https digitalsupport ge com communities en_US Download IC695CPE400 Embedded Field Agent EFA Firmware Image Virtual Field Agent https digitalsuppo...

Page 52: ...iguration but the Update URL is only reachable by bypassing this proxy server then check Bypass Proxy Server 3 Click the Test Connection button to verify the Field Agent is capable of reaching the Upd...

Page 53: ...xy server then check Bypass Proxy Server 3 Click the Test Connection button to verify the Field Agent is capable of reaching the Update URL using the current network settings 4 Under Automatic Cloud U...

Page 54: ...s for upgrading from one major version of Predix Machine to another Upgrading a Field Agent from one major version of Predix Machine to another for example from Predix Machine 16 2 to 17 1 is a one ti...

Page 55: ...ustomer is assigned at least one predefined account with the Administrator role which can be used for adding new users and assigning permissions In order to enroll a Field Agent with EdgeManager two d...

Page 56: ...Field Agent device representation with the desired Device Name Device ID assigns a technician and selects the enrollment type 2 The Technician obtains enrollment information from the Operator 3 The T...

Page 57: ...e Field Agent s Web Console The Device ID can consist of lower case characters and numbers Any upper case characters entered during device creation will be converted to lower case The Device Model is...

Page 58: ...EdgeManager EdgeManager Enrollment URL is available in EdgeManager ontheSettings menu pick User Authentication and Authorization UAA URL is available in EdgeManager ontheSettings menu The following i...

Page 59: ...r Authentication Code based on the option selected when the device was added in EdgeManager 5 10 1 4 Enter Enrollment Information and Trigger Enrollment Enter the enrollment information into the Predi...

Page 60: ...GFK 2993F 60 For public disclosure 5 10 1 4 1 Using Certificate Enrollment...

Page 61: ...certificate and sends the corresponding Certificate Signing Request CSR to the Predix Cloud to be signed and for enrollment to complete This process can take up to 30 seconds to complete before an en...

Page 62: ...GFK 2993F 62 For public disclosure 5 10 1 4 2 Using OAuth Authentication Code Enrollment...

Page 63: ...e displayed in the Predix Cloud Enrollment page If enrollment succeeds a success message will be displayed in the Predix Cloud Enrollment page and the enrollment fields will become hidden 5 10 1 5 Ver...

Page 64: ...instructions in section Configuration Mode 2 Open the Field Agent Manager app and login to the EdgeManager tenancy with a user who has both Operator and Technician credentials To add a new tenant sele...

Page 65: ...GFK 2993F 65 For public disclosure Notes...

Page 66: ...Status section the reachability status is repeated along with a date and time of the communication with the Field Agent Under the Resource Usage section the processor utilization memory utilization an...

Page 67: ...GFK 2993F 67 For public disclosure...

Page 68: ...e Set Polling Interval Updates the rate at which Predix Machine contacts the Predix Cloud to report status and retrieve operations to run Yes Yes Predix Machine Upload Configurations Uploads the Predi...

Page 69: ...lable Available N A 6 1 2 3 When might a Factory Reset be required A factory reset may be required in the following scenarios Reset the IP address to default Reset the Predix Machine Web Console usern...

Page 70: ...Predix Machine configuration files that are not applied to the Field Agent by default This list can be found in the configuration install install sh script inside the Configuration Template com ge ds...

Page 71: ...on level settings and do not include extra file attributes Note Some compression utilities always include extra file attributes with no setting to disable this behavior These utilities may create zip...

Page 72: ...s have been deployed to a Field Agent from the EdgeManager Repository two additional Predix Machine Web Console services are enabled that simplify the process of adjusting the configuration of an indi...

Page 73: ...GFK 2993F 73 For public disclosure To adjust any of the parameters in a given configuration file click the row corresponding to the bundle to be updated edit the parameters and press the Save button...

Page 74: ...or the application 3 In the Type field select Application 4 In the Version field enter a version number in the form x y z 5 Optionally enter a Vendor name 6 Optionally enter a Description 7 In the Fil...

Page 75: ...should be started immediately check the Start Bundle check box If the list of available packages should be refreshed automatically when the bundle is installed or updated click the Refresh Packages ch...

Page 76: ...r and the Time Series database See GFK 3019 Field Agent Machine Adapters User Guide for the list of required ports to be opened for each supported Machine Adapter See GFK 3009 Field Agents Secure Depl...

Page 77: ...er of variables subscription and sometimes even the total number of variables allowed to be exposed over OPC UA For instance the UCSC currently only allows at most 5 subscriptions 250 variables subscr...

Page 78: ...posed in the OPC UA server with the namespace index number before the colon and the variable name after the colon The Name element contains the tag name as it will appear in the Predix Cloud The name...

Page 79: ...hose value is either true the default or false This controls whether the Machine Adapter interprets the first 16 bits of a 32 bit data type to be the low or high word of the 32 bit value first32BitLow...

Page 80: ...triver send 0 config file com ge dspmicro hoover spillway destination WS Sender Service 4 Verify the Hoover Spillway is configured to enable the Store and Forward service which buffers data while the...

Page 81: ...ent When using different PublishInterval settings for different subscriptions the fastest PublishInterval in use should be used to determine the maximum numbers of configured and published variables 6...

Page 82: ...0 000 Given Network Bandwidth Upstream 40 MB sec Downstream 21 MB sec 2000 2999 450 300 900 150 3000 450 450 1 200 150 Note For ICMFA000000 AAxx only multiply the MFA values in the above table by 0 66...

Page 83: ...d and Published 4 ByteVariables EFA Max Configured and Published 4 Byte Variables 1000 1999 100 100 2000 2999 200 200 3000 3999 300 300 4000 4999 400 400 5000 500 500 Note All variables read from the...

Page 84: ...e The time required to forward this stored data depends on the available upload bandwidth Note On the MFA the StoreForward database is not retained when power is lost or when restarted The StoreForwar...

Page 85: ...dix Machine Get Log command and reading the log file for warnings and errors On Field Agents running Predix Machine 17 x the Predix Machine Get Available Logs command can be used to retrieve a list of...

Page 86: ...GFK 2993F 86 For public disclosure Notes...

Page 87: ...For public disclosure...

Reviews: