Menu

Install the client APK

Once you've familiarized yourself with the Knox E-FOTA Advanced portal console, and you've registered a device to the Knox E-FOTA Advanced service, you can proceed to install the Knox E-FOTA Advanced client APK on the device.

This section describes how to install the client APK on a device.

Introduction

NOTE—In cases where the IT admin doesn't have the device ID information, for example the IMEI or serial number, proceed to enroll the device using an app configuration (JSON) file. For more details, see Install using an app configuration file.

The Knox E-FOTA Advanced client APK is an agent that allows Knox E-FOTA Advanced to manage the device. It functions as an agent that connects the device to the Knox E-FOTA Advanced server.

During the trial period, the IT admin installs the APK. When Knox E-FOTA Advanced is deployed commercially, the IT admin notifies the device user to download and install the APK.

Install the client app

There are two ways you can install the client APK:

Install the client APK to a single device

To install the client APK on a device, follow the steps below:

  1. On the device, download the Knox E-FOTA Advanced client APK.
  2. Tap Download > Open File > Install.

  3. Tap Open.

Once the Knox E-FOTA Advanced client app is launched on a registered device, the corresponding firmware files are uploaded to the Knox E-FOTA Advanced portal. The admin receives an email notification when the new firmware files are ready.

You've successfully installed the Knox E-FOTA client APK to a single device. You can now manage the device with Knox E-FOTA.

Install the client APK to a group of devices using Knox Configure

To push the Knox E-FOTA Advanced client APK to a group of devices, you can use Knox Configure. If you haven't already, set up your Knox Configure account.

When you've set up your Knox Configure account, follow the steps below.

Create a new profile

  1. Launch the Knox Configure Portal through the SamsungKnox.com dashboard.
  2. On the left, select Profiles.
  3. Click CREATE A PROFILE.

  4. Select the device you'd like to customize: Select PHONE OR TABLET.

    NOTE—Knox E-FOTA Advanced doesn't currently support wearable devices with Tizen OS.
  5. Select the Knox Configure edition for the profile: Setup Edition or Dynamic Edition.

    When you have made your choice, click Select.

  6. Enter the following Profile Information:

    NOTE—The Knox Configure portal does not support these special characters (# / $ * % ^ & \ ( ) + ? { } [ ]). Do not use these characters when creating a device profile.
  7. Click Next.

Upload the Knox E-FOTA client APK

The Applications and Widgets screen displays applications and widgets that have been uploaded to your Knox Configure account.

To upload the Knox E-FOTA Advanced client app to the Knox Configure console:

  1. Click Add Application.

  2. Click Upload Application.

  3. Click Browse to select a APK file. Enter the following information:
    • Description—(Optional) Provide additional details about the app.
    • Activate Knox license—(Optional) Choose whether to activate the license after completing the profile.

  4. Click Confirm to upload the APK file to the Knox Configure console.

Add the client app to the new profile

To add the Knox E-FOTA Advanced client app to the new profile:

  1. Select the Knox E-FOTA Advanced client APK.

  2. Click Next.

Configure the profile

The Configuration screen allows IT admins to apply custom configurations to Knox Configure devices. For Knox E-FOTA Advanced, we'll configure the profile to launch the Knox E-FOTA Advanced client app automatically after it's been configured.

  1. Select Normal Mode.
  2. On the left, click Applications & content.
  3. Under Customize Applications for Configuration:
    • Select the Software Management APK under Download application during configuration.

  4. Click Next.

You can review the profile and configuration summary in the Profile summary page. Once you've confirmed all the required information is correct, click Submit and assign devices to the profile.

Assign devices to the profile

If you haven't yet, ensure you have registered your devices in Knox Configure. To assign devices to the profile:

  1. Select the check box of the target device(s).
  2. Click Actions > Assign devices.
  3. Click Select a License.

Select a license to apply to this profile. Note that only active licenses are compatible with this profile display. If you haven't yet, ensure you obtain a valid license for Knox Configure.

NOTE—Remote install and auto launch is supported by some MDMs such as Knox Configure Dynamic. To learn more about which MDMs are supported, visit the Knox Configure landing page.

Install the client APK using an app config file

In cases where the IT admin doesn't have the device ID information, for example the IMEI or serial number, you can enroll devices to the Knox E-FOTA Advanced server without first registering devices in advance.

To do this, install the client APK using an app configuration file:

Download the APK on the device

  1. Download the APK on the device from: https://s3.eu-west-2.amazonaws.com/samsungefota-apk/samsungefotaclient.apk.
  2. Click Download > Open File > Install.
  3. When the APK has downloaded, click Done.

Download the application configuration file

  1. On the admin PC, download the app configuration JSON file from: https://s3.eu-west-2.amazonaws.com/samsungefota-apk/swmb2b.json.
  2. Open the .json file.
  3. For domainName, enter your unique domain name.
    • To find your domain name and PIN, log in to the Knox E-FOTA Advanced portal. Then go to AdminDomains to view the domain list.

  4. For domainPIN, enter your unique domain PIN.
    • To find your domain PIN, log in to the Knox E-FOTA Advanced portal. Then go to AdminDomains.
    {
       "dmUrl":"https://samsungefota.com/dm",
       "dmPort":"443",
       "domainName":"Enter your domain name",
       "domainPin":"Enter your domain PIN"
    }

Encrypt the application configuration file

NOTE—Before you begin, ensure you have the Java Development Kit (JDK) installed.
  1. On the admin PC, download the cryptool JAR file for encryption: https://s3.eu-west-2.amazonaws.com/samsungefota-apk/cryptool.jar.
  2. Save the cryptool file (.jar) in the same folder as the configuration file (.json).
  3. Using the command prompt, navigate to the folder location and enter the following command to encrypt the app configuration file:
    java –jar cryptool.jar –e swmb2b.json

To decrypt the .json file for editing, enter the following command:

java –jar cryptool.jar –d swmb2b.json

Copy the application configuration file to the device

  1. Find the My files app.
  2. Tap the more icon and then tap Settings.

  3. Under File management, enable Show hidden files.

  4. Paste the application configuration file to the following device directory: My files > SD card > .swm
  5. Launch the APK client app to activate it.

Knox Configure and some MDMs will auto launch the APK client app. If your MDM does not, you may need to manually launch the APK client app to activate the device enrollment.

Tutorial Progress

You've completed 4/5 steps of this tutorial, Next step.

Share it: