background image

GFK-2993F  55

 

For public disclosure

 

 

5.9  Configure EdgeManager Access 

EdgeManager provides a single point of entry for deploying and monitoring devices remotely. You can also administer your 
apps and configuration files at both a device and fleet level, which helps you keep your device software current and up to 
date. For the EdgeManager to perform Device and Fleet Management operations on Field Agents and connected hardware, 
each Field Agent must enroll with EdgeManager. 
 

Note  

If you don’t already have an EdgeManager instance or you weren’t provided with one, please contact your supplier 

or customer support to get started. 

 
 

The Administrator logs into the EdgeManager and creates one of the following: 

 

• 

Two user accounts - one with the Operator role and the other with the Technician role 

• 

One user account with both the Operator and Technician roles 

 

5.9.1  Create Accounts for Operator and Technician Roles 

 

Each customer is provided their own EdgeManager space and their own User Authentication and Authorization (UAA) 
service that allows customers to define which users in their organization have access to EdgeManager and what operations 
each user can perform. Each customer 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 different roles are needed. The Operator role must be assigned to the 
individual responsible for creating device instances in EdgeManager with the appropriate Device Name, Device ID, and 
Device Model according to how the Field Agents should be identified. The Technician role must be assigned to the individual 
responsible for performing the enrollment activity in the Web Console of each Field Agent. If desired, both of these roles can 
be assigned to the same individual’s user account. 

 

To create the account or accounts needed, the Administrator must log into EdgeManager, navigate to the User Manager tab, 
and click the Create button. After entering the new account’s username, e-mail address, and initial password, the 
Administrator must select the roles to be assigned to this account by checking the corresponding check boxes. The roles to be 
assigned can be any combination of Administrator, Operator, and/or Technician. The Administrator must then press the Create 
button to create the account, and provide the user account information including initial password to the individual assigned to 
the account. Upon first login, the user will be forced to change their password. 

 

 

 

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: