Deploying EMS via SOTI

System Requirements

  • Windows machine for SOTI Package Studio (Windows VM for Mac users)
  • SOTI MobiControl account/environment
  • SOTI Package Studio
  • EMS Files/Applications
  • Android devices enrolled to SOTI

Getting Started

  1. Log into SOTI MobiControl
  2. Select hamburger in top left, click on Packages
  3. Download Package Studio
  4. Save to your desired destination on your machine
  5. Launch Package Studio-9

Building Packages using SOTI Package Studio

  1. New Package Project

    1. Click on File
    2. Then select Create New Package Project (Shortcut = CTRL + N) New Package Project Create New Package Project Create

       

  2. Project Name

    1. This will be the identifier for your package
    2. Each component (e.g. APKs, Files, scripts, etc) should have it’s own package
    3. Best Practice: Naming convention should leverage “EMS
      1. Examples:
        1. EMS - Launcher v3_0_12 052020
        2. EMS - Auth
        3. EMS - Support Agent
  3. Platform
    1. Select Android
  4. Set OS Version Range
    1. Minimum for EMS is 5.0
  5. Comments
    1. This field is optional
  6. Vendor

    1. Enter BlueFletch
    2. Click Next New Package Project Name

       

  7. New Package Wizard - Add Scripts

    1. Notes:
      1. Only the EMS - Launcher App Package should require a script
      2. The checkboxes are only recursors to the scripts being added to the package. You will add the scripts themselves in step 10
      3. These options (pre-install, post-install, etc) can be used to have the device execute necessary processes to successfully manage package deployments (For more information, please see SOTI Scripting Documentation) New Package Project Name

         

  8. New Package Wizard - Add Files or Folders

    1. Reference the Grouping SOTI Packages section below to determine which files or applications are needed and ensure the correct destination on device is set
    2. Adding a Files

      1. Click on "Add ..". to open the Selection box and choose "Add Files ..." New Package Add File New Package File Upload

         

      2. Choose the File you wish to add from the appropriate location New Package File Upload

         

      3. Once selected, input the destination for the file on the device New Package Copy Rules

         

      4. Set the Copy Rule to Replace the file on the device if it is older or if file does not exist on the device New Package Project Name

         

    3. Adding an APK

      1. Click on "Add ..." to open the Selection box and choose "Add Android APK ..." New Package Add File

         

      2. Choose the APK you wish to add from the appropriate location New Package File Upload

         

      3. Deselect Automatically Run Activity after Install New Package Add APK

         

    4. Once all necessary files or APKs have been added to the package, click Next and you'll be taken to teh Size Settings screen

  9. New Package Wizard - Size Settings

    1. Do not alter default settings
    2. Press Finish New Package Size Settings

       

    3. "Build Package Now" pop up should appear New Package Size Settings

       

    4. If a script is NOT required, then select "Build Package Now"

      1. Make note of the destination path in Output Window for the “Package Saved at:” location New Package Build Output

         

    5. If a script IS required, select "close" and move to step 10.

  10. Finalizing Custom Scripting

    1. Navigate to the desired script type from the tree navigation on the left-hand pane and double click the type (e.g. "Post-Install") New Package Script

       

    2. Add a new line under the header (the header includes the bottom-most line of semicolons) and paste the script text from the Grouping Packages section).
      New Package Script

       

    3. Save changes to the script using ctrl +s or from the File dropdown.

  11. Build Package

    1. On Menu, select Project (drop down)
    2. Select “Build Package” or press F7 New Package Script

       

    3. Make note of the destination path in Output Window for the “Package Saved at:” location

  12. Repeat steps 1-11 for each of the Packages in the Grouping Packages section below

Uploading Package Builds to SOTI MobiControl

  1. After all packages have been created, navigate browser to SOTI MobiControl
  2. Select hamburger in top left, click on Packages Uploading Packages

     

  3. Click ‘New Package’ in the top, right area of the screen

     

  4. Select ‘Android Plus’ as Platform Uploading Packages

     

  5. Click ‘Browse File’ on popup Uploading Packages

     

  6. Open the .pcg file from the /built folder noted in step 11 of the previous section Uploading Packages

     

  7. Click Upload Uploading Packages

     

  8. Repeat steps 1-7 for all Packages built in MobiControl Studio based on the Groupings below

Grouping Packages - In Order of Installation

BEST PRACTICE TIPS : Limit packages to no more than one application at a time so that the packages can be easily updated without having to re-create multi-app packages.

  1. EMS - Launcher Config Package
    1. Click Add Files
    2. Select customized Launcher.json file from local machine and set destination on device to %sdcard%\Download\ems\
      1. Make sure the Launcher config is titled launcher.json when being added to the Package
    3. Installing a logo: Select desired Icon and wallpaper png images from local machine and set destination on device to %sdcard%\Download\ems\
  2. EMS - Sitelist Package
    1. Click Add Files
      1. Select the Sitelist.csv from appropriate storage location and set destination on device to %sdcard%\Download\ems\
  3. EMS - Messaging Package
    1. Add Files > Add Android APK
      1. Select the EMS Messaging APK from appropriate storage location
      2. Deselect Automatically Run Activity after Install
  4. EMS - Device Locator Package
    1. Add Files > Add Android APK
      1. Select the Device Locator APK from appropriate storage location
      2. Deselect Automatically Run Activity after Install
  5. EMS - Support Analytics Package
    1. Add Files > Add Android APK
      1. Select the Support Agent APK from appropriate storage location
      2. Deselect Automatically Run Activity after Install
  6. EMS - Auth App Package
    1. Add Files > Add Android APK
      1. Select the Auth APK from appropriate storage location
      2. Deselect Automatically Run Activity after Install
  7. EMS - Launcher App Package
    1. Add Files > Add Android APK
      1. Select the Launcher APK from appropriate storage location
      2. Deselect Automatically Run Activity after Install
    2. Scripts The following scripts will initialize Support Agent and Enterprise Launcher after they have been installed.
      1. Post Install
        1. sendintent -a "intent:#Intent;action=android.intent.action.MAIN;component=com.bluefletch.ems.emm.support/com.bluefletch.ems.emm.support.features.ui.hidden.SilentInitActivity;end;"
        2. sendintent -a "intent:#Intent;action=android.intent.action.MAIN;component=com.bluefletch.ems.emm.launcher/com.bluefletch.ems.emm.launcher.Launcher;end;"

Create Profile to Deploy Packages

Once all Packages have been created per the groupings above, a Profile needs to be created for deploying the all of the packages to enrolled devices.

  1. Navigate back to SOTI MobiControl Cloud
  2. Select hamburger in top left, click on Profiles Create Profile

     

  3. Click ‘New Profile’ in the top, right area of the screen Create Profile

     

  4. Select Android Plus as Platform Create Profile

     

  5. General Tab

    1. Profile Name

      1. Apply a profile name that correlates to the packages being added
        • e.g. BlueFletch EMS Suite
        • Best Practice Tip - If you have plan to deploy sets of packages that differ by attributes such as location or role, you can use the profile name to reflect those differences for ease of management. Create Profile

           

    2. Description

      1. Best Practice - This is good opportunity to utilize information such as “Pilot”, “POC”, or specify test groups, etc. Gives the admin the ability to recognize the purpose of the specific profile
      2. Ensure packages get added to the Profile in the same order as listed above Create Profile

         

  6. Configurations Tab

    1. If not already set via a separate profile, ensure Restrictions > Feature Control configuration “Disable Verify Apps” is checked.
      1. E.g. Profile > Configurations > Restrictions > Feature Control > scroll down to Security > check Disable Verify Apps Enforcement Create Profile Create Profile

         

  7. Packages Tab

    1. Select Add
    2. Click the check box next to all Packages uploaded in section “Uploading Packages to SOTI MobiControl” above.
    3. Select OK.
    4. Using the up/down arrows, ensure the order of Packages matches the Grouping listed above. Create Profile

       

  8. Click ‘Save and Assign’

    1. Select to the Device Group containing device(s) for testing of EMS Suite.
    2. Click Assign Create Profile

       

  9. Wait for device(s) to receive assignments from SOTI.

Remotely Wiping a Device (Enterprise Reset)

BlueFletch Enterprise Launcher disables the ability to Enterprise Reset Zebra devices unless in Local Admin mode. To remotely wipe a device you must first enable the InvokeEnterpriseReset parameter on device. Then you can follow these steps to execute a remote wipe of the device(s).

  1. Create a .xml file and title it AllowEnterpriseReset.xml
    1. Enter the follow into the file:

       

      <wap-provisioningdoc> <characteristic version="8.1" type="SettingsMgr"> <parm name="InvokeEnterpriseReset" value="1" /> </characteristic>

       

    2. Save the file
  2. Create a new SOTI Package
  3. Check Post-Install Script box to add to project
  4. Add Files:
    1. Select AllowEnterpriseReset.xml and set destination to /sdcard/Download
  5. Add a script to the Post-Install Script file:
    1. mxconfig /sdcard/Download/AllowEnterpriseReset.xml
  6. Build package and add to the appropriate Profile
  7. Deploy Profile