Get Started with Predix Edge Technician Console

About Predix Edge Technician Console

Predix Edge Technician Console is an on-premise, local edge management UI to manage edge devices that may or may not have connectivity to the cloud. Predix Edge Technician Console provides the following capabilities:

  • Device setup and management
    • Configure the network time protocol
    • Configure network settings including DNS
    • Upload and apply host OS updates
  • Application Management
    • Upload and deploy packages
    • View application status
    • Start, stop, and delete applications on the device
    • Apply configurations to packages
    • View application details
  • Security
    • Predix Edge Technician Console uses OAuth-based user authentication and authorization
    • Certificate-based device enrollment
  • User management (Admin and Technician roles)
  • Full journal logging
    • Query specific logs
    • Preview logs
    • Download logs

Supported Browsers

Predix Edge Technician Console has been tested for support on these browsers:

BrowserVersion
ChromeLast two versions
FirefoxLast two versions

Downloading and Running Predix Edge Technician Console

About This Task

Predix Edge Technician Console is bundled with Predix Edge and requires Predix Edge to run.

Procedure

  1. Install Predix Edge for your operating system.
  2. SSH into to the Predix Edge image and sign into Predix Edge using the default credentials:
    • user: root
    • password: root
  3. To access Predix Edge Technician Console, find the assigned IP address of Predix Edge. If you are using the Developer image of Predix Edge, enter the following command:
    ifconfig | grep inet
    The IP address is displayed in the inet addr field in the "enp" section.

    If you are using the Production image of Predix Edge, SSH is disabled, so you cannot access Predix Edge internally. To find the assigned DCHP address, you can use nmap to scan the IP range of the gateway to see what IP address is assigned to Predix Edge. To do this:

    1. Download nmap from https://nmap.org/download.html. and install it on the host machine.
    2. Enter the following command:
      nmap ip_address_of_gateway/24
      
      For example:
      nmap 172.16.200.1/24
      This scans all IP addresses on the subnet (0 to 255 on the last digit).

      On VMWare Fusion, if you select Share with my Mac, the IP address of the gateway is the inet address of the vmnet8 device.

      Note: If you created a custom network, use that device instead.

      On ESXi server, use the server address.

Accessing Predix Edge Technician Console

Use a Web browser to sign into Predix Edge Technician Console.

Before You Begin

Predix Edge OS must be running to access the Predix Edge Technician Console.

Procedure

  1. Open a Web browser and navigate to https://<predix_edge_OS-ip-address>
    Note:

    Since the Web Console uses a self-signed certificate, the browser warns that the connection is not private. You can proceed.

    On Chrome, click Advanced, proceed to_______(unsafe).

    On Firefox, select Advanced > Add Exception > Confirm Certificate Exception.

  2. Enter your user name and password. If this is your first time logging into the Predix Edge Technician Console, use the following default credentials:
    • User name – admin
    • Password – admin
    1. If this is your first time logging in, you are prompted to changed your password.
      Enter:
      • Old password – Enter your current password.
      • New Password – Enter the new password.
      • Re-enter New Password – Re-enter the new password.
      To unmask the passwords, click Show Passwords.
      Note: Your password must:
      • Be at least eight characters long and not more than 15 characters long
      • Contain at least two uppercase letters
      • Contain at least one lowercase letter
      • Contain at least two numbers
      • Contain at least one special character
      • Not contain the user name
      • Not contain spaces
    2. Click Reset Password.
      After you reset the password, you have to sign into Predix Edge Technician Console again, using your new password.
    You are signed into Predix Edge Technician Console, where the Device Status page is displayed. If you have not yet set up the device, some information is not displayed.

Configuring Predix Edge Technician Console

If you do not want to use the default settings for Predix Edge Technician Console, you can configure certain settings by creating and deploying your own settings.json file.

About This Task

Predix Edge Technician Console includes default configurations, so it is not necessary to create and deploy your own settings.json file unless you want to change certain default values.

When Predix Edge Technician Console starts, it checks for a settings.json file. If one exists, Predix Edge Technician Console parses the file and overwrites the default configuration parameters. If the file does not exist, Predix Edge Technician Console uses its default configuration parameters.

Note: If you deploy a settings.json file, Predix Edge Technician Console continues to use the values set in that file until a new settings.json file is deployed, even if the default configuration values for Predix Edge Technician Console change on the backend.

Procedure

  1. Create a file and name it settings.json.
  2. Configure the parameters in JSON format, and save the file.
    The following is an example settings.json file:
    {
        "maxOSUpdateFileSizeMB":  500,
        "maxStagingAggregateSizeMB":  1000,
        "modelName":  "Predix Edge Device",
       "sessionTimeoutSeconds": 600
    }
    The following table contains information about the configurable parameters.
    ParameterDescriptionDefault Value
    sessionTimeoutSeconds
    Maximum time Predix Edge Technician Console can be idle before the user is logged out.
    • Default value is 900 seconds (15 minutes)
    • Minimum value is 300 seconds (5 minutes)
    • Maximum value is 3600 seconds (one hour)
    900
    modelName
    Device models name that appears on the Device Status page.Predix Edge Device
    maxStagingAggregateSizeMB
    Maximum allocation, in megabytes, that can be used for all staged config packages, prior to applying them to applications.1000
    maxOSUpdateFileSizeMB
    Maximum file size of the OS update image that you can upload to Predix Edge Technician Console.500
  3. Deploy the configuration package.
    You can deploy the configuration using Predix Edge Technician Console or Predix Edge Manager.
    Note: When you apply a new configuration, Predix Edge Technician Console restarts and you are signed out. You will need to sign into Predix Edge Technician Console again.

Device Status

Use the Predix Edge Technician Console Device Status page to view information about the device, monitor the device, and edit settings.

When you sign into Predix Edge Technician Console, the Device Status page is displayed. This page displays information about the device and also allows you to perform certain actions.

Table 1. Device Information
Details
  • Last Restart – Date and time the device was last restarted.
  • Model – Device model.
  • Processor – Processor installed on the device.
  • Number of Cores – Number of cores installed on the device.
  • Polling Interval – The time interval set to synchronize how often the edge devices communicate with Edge Manager in the cloud.
  • Operating System – The operating system running on the device.
  • Last Updated – Displays the date the host operating system was last updated.
Device
  • ID – The device ID.
  • Container Enabled – Displays whether or not the device is container-enabled.
Date/TimeDisplays the current time and time zone for the device, for example, UTC.
Summary
Network

This section displays information about the network settings, including DNS domain information and proxy settings.

Click Edit to set up the device, or to change the network configuration settings.

Time Service

Configure the time servers to which the device will synchronize its time.

Click Edit to configure the time service.

Enrollment InfoDisplays enrollment status for the device.
  • Enrolled – Status of device enrollment (yes, it is enrolled; no, it is not yet enrolled).
  • Enrollment Type
  • Edge Manager URL – If the enrollment type is certificate, the Predix Edge Manager certificate enrollment URL is displayed.
Network AdaptersDisplays information about the network LAN adapters, including MAC address, IP address, subnet mask, and default gateway.

Click Edit to configure the network and proxy settings.