Installation

Edge Agent on Ubuntu is distributed as a debian package, similar to many other packages on Ubuntu. The most popular tool for installing debian packages is `apt`. The following sections provide instructions for installing Edge Agent from a downloaded .deb file from the public apt repository on dig-grid-artifactory.apps.ge.com, and for setting up your own apt repository and updating Edge Agent from there.
Note: `apt` is a large and complex tool built on top of `dpkg`, which is itself a complex program with many configuration options and security considerations. The following information is not intended to be exhaustive, and users should read the documentation for `apt`, `dpkg`, and associated tools. Relevant manual pages include (but are not limited to): apt, dpkg, and sources.list. Run man <page> in your terminal to view an entry.
Note: Before installing Edge Agent, ensure your Ubuntu system is up-to-date by running the following commands:
sudo apt update
sudo apt upgrade

Install From Predix apt Repository

Note: This option is currently unavailable.
The 'apt' tool checks a package's signature before installing it. To verify the signature you must first register the key GE Digital uses to sign packages with 'apt'. You can obtain and install it with the following command: 
curl https://dig-grid-artifactory.apps.ge.com/artifactory/api/gpg/key/public | sudo apt-key add -
Add authentication for Artifactory to 'apt'. Get your personal Artifactory API key for your Artifactory Account. Create a file called /etc/apt/auth.conf.d/artifactory with the following contents:
machine artifactory.predix.io
login <YOUR SSO>
password <YOUR ARTIFACTORY API KEY>
Run the following command to add the predix.io repository to your system:
sudo add-apt-repository \
     "deb [arch=$(dpkg --print-architecture)] https://dig-grid-artifactory.apps.ge.com/artifactory/PREDIX-DEBIAN-EXT \
     $(lsb_release -cs) \
     main"
Run 
apt update; apt install predix-edge-agent
as root to install Edge Agent.

Install From a Custom apt Repository

Repositories can be served over a variety of network protocols, such as HTTPS, FTP, or SSH (see man sources.list for details on the supported protocols). However, setting any of these services is beyond the scope of this document. The Debian wiki has a page describing apt repository, including links to documentation on the set up an maintenance of 'apt' repositories: https://wiki.debian.org/DebianRepository.

Install From Downloaded Package

Download the Debian package from https://dig-grid-artifactory.apps.ge.com/ui/native/predix-edge-agent-deb/pool/ to your device running Ubuntu. Run the command apt install /path/to/predix-edge-agent.deb (substituting the actual path to the downloaded .deb file) as root to install it. Edge Agent should now be ready for enrollment with Edge Manager.
Note: Please be sure to download the latest version with the appropriate architecture for your system.
Note: To update Edge Agent, download the newer .deb file and follow these instructions again.

Accessing Artifactory Downloads

To access Artifactory downloads, you will require a GE SSO (single sign-on) username and approval to access Artifactory.

Request a GE SSO

Use the following steps to obtain a GE SSO if you do not already have one.

  1. Complete the Your GE SSO Account request form. All fields marked with a checkmark are required.
  2. Click Submit.
Note: The only non-alphanumeric characters allowed in your GE SSO are an underscore (_) and a period (.). Using any other non-alphanumeric characters for your username will result in an invalid authentication in Artifactory.

Request Artifactory Access

Once you have an SSO, use the following steps to request access to Artifactory.
  1. Complete the Edge Artifactory Access Requests form.
  2. Click Submit.