Step 1: Download and install the agent app

First, obtain access to Knox E-FOTA On-Premises from a Samsung reseller. Once your account is granted access, it's time to install the Knox E-FOTA On-Premises agent app. Contact a Samsung technical support engineer to get new agent app versions.

There are three ways to install the agent on your devices:

• Upload the package through the Knox E-FOTA On-Premises portal
  
  IMPORTANT — Package uploading is only supported if the Knox E-FOTA agent is already installed and running on your devices.
• Manually install the package
• Install the client through your EMM

Upload the package through the Knox E-FOTA On-Premises portal

If you want to automatically install the agent on your devices, do as follows:

1. Log in to the Knox E-FOTA On-Premises admin console. Ensure you're in the correct workspace by verifying the workspace name in the upper-right corner of the console.
2. Click your account icon.
3. In the menu that's shown, click Settings.
4. The navigation sidebar pane refreshes with a new set of tabs. Click Agent.

5. Click ACTIONS > Upload Agent.

   

6. A popup is displayed prompting you to upload an agent file. Click BROWSE to launch your PC's file explorer and select the file. Then, click UPLOAD.

   

The Agent screen is then refreshed with the new agent information. Click Actions > Start Deployment to allow the devices in your workspace to download and install the new Knox E-FOTA On-Premises agent app.

Manually install the package

Alternatively, you can manually install the package on a device. This method is recommended if you want to test the agent before deploying it to the full device fleet.

Before you begin, ensure you have the following prepared:

• A PC running Windows 10
• Your organization's server, connected to the internet through Wi-Fi or a mobile network
• A device secured by Samsung Knox, connected to the internet through Wi-Fi or a mobile network

Create a configuration file

On your PC, you first need to create a file called efota_config. In a text editor of your choice, enter the URL of your on-premises server and save it. Ensure that the file is not saved with a file extension.

The on-premises server URL is defined by your organization and is used to access the Knox E-FOTA On-Premises web console. If you're not sure what this URL is, contact the Samsung installation engineer who configured your Knox E-FOTA On-Premises instance.

For example, the URL might be in one of the following formats:

• https://example-sec.fota.net:6443/admin/
• http://181.107.61.233:6380/admin/

Copy the configuration file to the device

There are two ways to get the configuration file on your device:

• Use your EMM to push the file to your device's Downloads folder, or
• Use your PC's file explorer to manually copy the file to your device's Downloads

Then, connect your device to the PC through USB. In your PC's file explorer, locate the efota_config file and copy it to your device's Downloads folder. Ensure the Knox E-FOTA On-Premises APK you received from your local Samsung representative is also included in the Downloads folder.

Install the Knox E-FOTA On-Premises app

On the device, navigate to your Downloads folder and tap the Knox E-FOTA On-Premises APK to install it. After it's installed, tap the app icon to launch it.