PowerPrecision Console Install & Setup

PowerPrecision Console 1.0

Overview

PowerPrecision Console (PPC) server runs on a Windows-based server or desktop. The PPC client runs on supported Zebra devices. This section provides instructions for install and setup for both components.

See System Requirements.

Important: An SSL Certificate is required from a third party certificate authority (CA), such as Verisign or Thawte. Any self-signed certificate or one issued by a non-third party CA will not work. The .pfx certificate must contain the complete certificate chain, including intermediate certificates.

Server Install & Setup

After server installation, further network and certificate setup is required to allow communication between the server and devices via DNS and firewall. Instructions for server installation and setup:

  1. Server Installation. Double-click on the .EXE and follow the steps to complete installation.

  2. DNS (Domain Name Server) Setup. The PPC server runs in a domain, for example name.company.com. To run PPC, an entry in the DNS server is required to add the server IP address. The DNS server and PPC server are required to be on the same network. Contact your local IT Administrator to configure the domain to IP address mapping.

  3. Server SSL Certificate. An SSL certificate is required for secured connections. Steps to generate the certificate:
    A. Zebra recommends the certificate to be procured in .p7b format and the certificate private key to be a .key file. If the certificates are in different format, use a SSL certificate converter tool to convert to the proper format.
    B. Download OpenSSL tool and install on the server.
    C. Create an empty directory named "generated_certs" to contain the .pfx certificate.
    D. Copy the following certificate files to "generated_certs" folder: primary certificate (e.g. "ssl_certificate.p7b"), private key (e.g. "ppc_private_key.key"), and intermediate CA certificate (e.g. "IntermediateCA.cer"). The intermediate CA certificate is optional - use if required in the certificate chain.
    E. Open a command prompt. Execute the following command to generate "ssl_certificate.cer":
    openssl pkcs7 -print_certs -in ssl_certificate.p7b -out ssl_certificate.cer
    F. At the command prompt, execute the following command:
    openssl pkcs12 -export -in ssl_certificate.cer -inkey ppc_private_key.key -out ssl_certificate.pfx -certfile IntermediateCA.cer
    Where "-certfile IntermediateCA.cer" is optional.
    G. When prompted, enter the certificate password to export "ssl_certificate.pfx".
    H. Copy the SSL certificate "ssl_certificate.pfx" with domain name “name.company.com” to the following folders:

    • Zebra Technologies\PowerPrecision Console\Server\PowerPrecision Console Server
    • Zebra Technologies\PowerPrecision Console\Server\WebUI
  4. Server Setup. From default folder “\Power Precision Console\Release\Server\WebUI”, open the .env file. Set the following variables:

    SERVER=”https://name.company.com:8080/ppcdata" 
    PORT=”8080”
    SSL_CERT = <ssl_certificate.pfx>
    SSL_CERT_PASSWORD = <*****>
    PORT_HTPS=<port_number> 
    

    Replace all values in the angled brackets <> to the appropriate value or string and remove the brackets.

    For SERVER, replace “name.company.com” and the port number 8080 with the appropriate server name and port number (if changed).
    For PORT, change this to the appropriate desired value if necessary. This value must match the "server.port" value specified in "application.properties" file, discussed in the next step.
    For SSL_CERT, replace the string with the name of the SSL certificate.
    For SSL_CERT_PASSWORD, replace the string with the SSL certificate password.
    For PORT_HTTPS, this is optional and required only if port 8443 is not used by default for HTTPS. Specify the alternative port used for HTTPS.

    In default folder “\Power Precision Console\Server\PowerPrecisionConsoleServer\config”, open “application.properties.” Set the following properties:

    server.dns=<name.company.com> 
    server.idDesc=<store location> 
    server.port=<8080> 
    
    # SSL certificates 
    server.ssl.key-store:<ssl_certificate.pfx>  
    server.ssl.key-store-password:<password>
    
    # export data
    data.export.Path=<C:\\ppcData\\>
    

    Replace all values in the angled brackets <> to the appropriate value or string and remove the brackets.

    The "export data" section specifies the file path for data to be exported from an automatic data backup or manual report export. Only the hard drive letter is configurable, ie. D:\ppcData\, and write permissions are required for the specified hard drive. A monthly data backup is automatically generated on a daily basis starting one month after install. Historical data is accumulated for the month and exported in .CSV format.

    In the "SSL certificates" section, if a hashtag exists in the password line, it must be removed to uncomment out the password line. Enter in the appropriate SSL password following the colon.

    Note: If port 8080 is not available on the server, any other available port can be used in replacement. Some network policies might block incoming and outgoing ports - it is required to open the configured ports in the network firewall as described in the next section “Open inbound/outbound ports on the firewall”

  5. Open Inbound/Outbound Ports on the Firewall. The appropriate ports are required to be opened for inbound/outbound network traffic flow through the firewall for communication between the server and devices, specified in the .env file. The method to open the ports depends on the firewall software used by the network administrator. By default the ports are:

    • Inbound ports: TCP ports 8080 and 8443
    • Outbound port: TCP port 8080
  6. Run the PPC Server Software. Start the server services by launching the desktop shortcut icon "START_PPC_SERVICE". Open the supported browser. Enter the default server URL: https://name.company.com:8443/ppcui

    Where "name.company.com" is replaced with the appropriate information.

    Default login credentials (case-sensitive) for super admin user are:

    • User: SAdmin
    • Password: admin

    Zebra recommends to change the password immediately for the super admin user to avoid unauthorized access. Tap on "SAdmin" user at the top right of the Admin View and select "Change password".

  7. Server certificate validation. Use an SSL Tool (such as ssltools.com) to aid in diagnostics and validate the certificate chain.
    A. Open ssltools.com in the browser.
    B. Enter the Web UI URL, for example https://name.company.com:8443/ppcui
    C. Click the Scan button. A successful result returns green checks for each step. See Figure 1 below.
    D. Enter the backend URL for your server, for example https://name.company.com:8080/ppcdata
    E. Click the Scan button. A successful result returns green checks for each step: img Figure 1. SSLTools.com results

Client Install & Setup

Install PPC client on the supported Zebra devices to register the device, upload device battery data and display end-of-life (EOL) battery alerts. The device must be connected to the same network as the server. The server address needs to be configured on the PPC client to communicate with the PPC Server. PPC client install and setup can be accomplished either manually or remotely with Zebra's StageNow or an EMM (Enterprise Mobility Management).

Installation

Steps for client installation:

  1. Download PPCClient.zip from Zebra Support and Downloads. Extract the files and folders.
  2. Install PowerPrecisionConsole.apk.
    • For Android Marshmallow and Nougat devices, install the .APK located in folder PPCClient\Client\M_N.
    • For Android Oreo devices, install the .APK located in folder PPCClient\Client\O.
  3. When prompted, enable the “Apps that can draw over other apps” overlay permission.
  4. For remote configuration using StageNow or an EMM (using XML or Managed Config), install PPCClientMgr.apk located in PPCClient\PluginCSP

Configuration

Configure the server address and port either manually or remotely. For information on using CSP for remote configuration deployment, refer to MX documentation.

Manual Configuration

Steps for manual configuration:

  1. Open PowerPrecision Console Client.
  2. If prompted, enable the “Apps that can draw over other apps” overlay permission.
  3. Tap the hamburger menu at the top right, then tap Settings.
  4. Tap Server URL. Enter in the server URL, for example: name.company.com:8080/ppcdata
    Where "name.company.com:8080" is replaced with the appropriate domain name and port number.
    Note: the URL must not contain "https://".
  5. Tap OK to save the changes and return to the main screen. PPC Client registers with the server and uploads battery data.

Remote Configuration Deployment

Steps for remote configuration with StageNow and CSP Plug-in, with the option of deployment through Enterprise Mobile Management (EMM):
  1. Download PPC Client software from Zebra Support and Downloads. Extract the files.

  2. Compress two files distributed as part of the PPC Client software into a single .zip file:

    • com.zebra.ppcclientmgr.dsd
    • PPCClientMgr.apk (PPC Client CSP Manager Plug-in)
  3. Open StageNow.

  4. Import the CSP Plugin Library.
    A. In the StageNow home screen, click “CSP Library” from the left menu.
    B. Upload the .zip file to the CSP Library by clicking “Choose File” then browsing to the .zip file, or by dragging and dropping the .zip file.
    C. Once successfully uploaded, the CSP Library is listed in the Plugin tab.
    img Figure 2. Import plugin into CSP Library

  5. Create a new setting.
    A. In the StageNow home screen, click “All Settings” from the left menu. Click “Create Setting” button at the top right.
    img Figure 3. Import into CSP Library
    B. For the “Setting Type”, select “com.zebra.ppclientmgr." Enter a name for the setting. Enter the server URL e.g. ppc.zebra.com:8080/ppcdata. Select the desired option to determine whether or not to allow the end user to edit the setting. Select the MX version for the device.
    img Figure 4. Create New Setting
    C. Tap Save. The new setting is listed in the Settings screen.

  6. Create profile.
    A. In the StageNow home screen, click “Create New Profile” from the left menu.
    B. Make sure the proper MX version is selected.
    C. Select “XpertMode." Click Create.
    D. Enter the profile name. Click Start.
    E. In the Settings list, click the add (+) sign next to “com.zebra.ppcclientmgr”. This adds to the Config tab on the right side. Click on Add button.
    img Figure 5. Add CSP to profile
    F. In the StageNow Config section, click “Re-use Saved Setting” tab. The screen is populated with the information from the setting created in step 5. img Figure 6. Re-use saved setting
    G. Click Continue.
    H. In the Review section, review the settings and make modifications if needed. Click “Complete Profile."
    I. In the Publish section, select the desired barcode type. img Figure 7. Generate StageNow barcode
    J. Click Test. A window opens with the generated StageNow barcode in .pdf format.

  7. For EMM Staging, continue to section "Steps for EMM Staging" below.

  8. Open the StageNow client on the device.

  9. Scan the barcode with the StageNow client to configure the PPC Client.

For more information refer to StageNow download and StageNow documentation.

Steps for EMM Staging (optional):

  1. Follow the steps above for "Remote Configuration Deployment with StageNow and CSP Plugin" up to step 6.
  2. Select the "Export option for EMM" to export the .xml file. Save the .xml file. img Figure 8. Export for EMM
  3. Push the .xml settings via EMM to the device for PPC Client configuration.


See Also