GFK-2993F 74
For public disclosure
6.1.4 Application Management
In addition to configuring existing Predix Machine OSGi bundles to perform activities like sending Time Series data to the
Predix Cloud, Field Agents can have their application capabilities expanded by adding and running new applications. These
application bundles can be managed both from EdgeManager for multiple Field Agents and from the Predix Machine Web
Console for an individual Field Agent. In both cases, a default set of application bundles must be obtained as a starting place
for making additions. The default collection of application files is referred to as the Application Template. Application
Templates for the various Field Agent types can be found below.
Embedded Field Agent
Predix Machine application bundles can be obtained from the following location:
https://digitalsupport.ge.com/communities/en_US/Download/IC695CPE400-Embedded-Field-Agent-EFA-Application-Templates
Mini Field Agent
Predix Machine application bundles can be obtained from the following location:
https://digitalsupport.ge.com/communities/en_US/Download/ICMFA000000-Mini-Field-Agent-MFA-Application-Templates
Virtual Field Agent
Predix Machine application bundles can be obtained from the following location:
https://digitalsupport.ge.com/communities/en_US/Download/ICVFA000000-Virtual-Field-Agent-VFA-Application-Templates
6.1.4.1
EdgeManager Application Management
In order to make a group of application bundles available in EdgeManager to deploy to one or more Field Agents, the entire
outer “machine” directory must be compressed into a zip file such that decompression will result in a “machine” directory
with all contents contained within. Refer to the section,
Compression Utilities
for more information.
The machine zip file must then be uploaded to EdgeManager in the Repository tab. With the Repository tab selected, perform
the following steps:
1.
Press the Upload button on the Repository tab to make the Upload dialog appear
2.
In the Name field, enter a name for 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 File field, click the Choose File button, browse to the machine zip file and select it
8.
Press the Upload button on the Upload form to commit the application zip file to the EdgeManager Repository
Once an application is uploaded to the EdgeManager Repository, it can be deployed to one or more Field Agents from the
Device Manager or Operations pages. Add one or more Field Agents or groups of Field Agents to the Selected Items list and
press the Deploy Software button. Select the Application to deploy and press the Schedule button. Select the date and time for
the update to occur and press the Submit button. If an Application deployment is scheduled to occur immediately for an
Offline Field Agent, or at a date or time that the Field Agent becomes Offline, then the Application will be
deployed the next time the Field Agent connects and becomes Online.
Each Field Agent maintains a history of each Application deployment performed including the deployment status. This
history can be seen by navigating to the device page for the Field Agent and selecting the Software tab. Application
deployment failures for Online Field Agents can be diagnosed by reading the Execution Logs that can be downloaded for
each deployment. Additional error messages may be logged to the Predix Machine log file which can be read from the OSGi
Log Service in the Field Agent’s Predix Machine Web Console or by downloading the Predix Machine log file using the
Predix Machine: Get Log
command.
6.1.4.2
Predix Machine Web Console Application Management
Once the Configuration and Application Templates files have been deployed to a Field Agent from the EdgeManager
Repository, one additional Predix Machine Web Console service is enabled that simplifies the process of adding or removing
application bundles on an individual Field Agent. This service can be used to develop and debug new application bundles
before they are packaged into a machine zip file, uploaded to the EdgeManager Repository, and deployed to one or more
Field Agents.
Summary of Contents for Embedded Field Agent
Page 1: ...GFK 2993F Field Agents User Guide July 2017 For public disclosure ...
Page 31: ...GFK 2993F 31 For public disclosure Notes ...
Page 50: ...GFK 2993F 50 For public disclosure 2 Verify that the Field Agent Updater page displays ...
Page 60: ...GFK 2993F 60 For public disclosure 5 10 1 4 1 Using Certificate Enrollment ...
Page 62: ...GFK 2993F 62 For public disclosure 5 10 1 4 2 Using OAuth Authentication Code Enrollment ...
Page 65: ...GFK 2993F 65 For public disclosure Notes ...
Page 67: ...GFK 2993F 67 For public disclosure ...
Page 86: ...GFK 2993F 86 For public disclosure Notes ...
Page 87: ...For public disclosure ...
