Avalanche Synchronization Blackout Configuration

Version 3

    Verified Product Versions

    Avalanche 6.1Avalanche 6.2

    This article is an overview of how to setup and configure Android Synchronization blackouts

     

    Avalanche 6.2 has added additional functionality to administer how Android Devices check in throughout the day.

     

    There are two main areas that will assist with this:

     

    1. The Automatic Smart Device Check-in

        Smart Devices check in everything x hours

    blackout 1.PNG

    2. A configuration file that is stored on the device called wavelink_blackout.ini. This file is stored within the \Enterprise\Usr\ folder on zebra devices.

     

    A file payload can deliver the ini file to the correct location on the device. this location is not persistent so any wipes will require the device to redownload upon first synchronization.

     

         Configuring wavelink_blackout.ini

    The wavelink_blackout.ini file is treated as a 3 tier and statement. each and statement is broken down into  {Time}And{Network}And{power}

     

         Time Duration is a time range Start and End. these two items have to appear together, if not the status will display an error message.

    Examples of Time Duration:

    blackout2.PNG

     

    The time duration format is "HH:mm",such as "12:00","08:00","8:00" is also supported. if start time equals end time, then it will not blackout. if start is after than end, such as

    "23:00" to "04:00", this means syncing will go across the day.

     

         Network Information tells the blackout operations to sync based upon Network Requirements. These requirements are as follows:

     

      1. network_wifi
        1. if this category appears, the value only can be "true", this means if WiFi is currently active, then blackout.
        2. if the category doesn't appear, it means that it doesn't care if currently activate network is wifi.
        3. if category appears with the value of "false", an error status will be set with error message

                2. network_cellular

        1. if this category appears, the value only can be "true", this means if cellular is currently active, then blackout.
        2. if the category doesn't appear, it means that it doesn't care if currently activate network is cellular.
        3. if category appears with the value of "false", an error status will be set with error message

     

       3. network_ethernet

        1. if this category appears, the value only can be "true", this means if ethernet is currently active, then blackout.
        2. if the category doesn't appear, it means that it doesn't care if currently activate network is ethernet.
        3. if category appears with the value of "false", an error status will be set with error message

     

         Network Information examples:

     

    blackout sync while network is not WiFi means other 2 options need to be set as true,which is little bit trick, the principle is set other 2 options as true if you want to blackout sync while the current activate network is not one option.

    blackout3.PNG

    blackout sync while network is network_cellular

    blackout4.PNG

    all set as true, means always blackout.

    blackout5.PNG

         Power Information tells the device only to check in when the device is as above a specific power level or if it is docked.

     

    min_battery

        1. if option is set with a integer value between 10-100,which means the current battery remain level lower than this
        2. value, the sync will be blackout
        3. if this option doesn't appear, means don't care battery
        4. if this option appears with a value not integer between 10-100, a statue will be set with error message

     

    power_charging

        1. if option is set with true, which means the sync will be blackout while device is in cradle or power plugged.
        2. if option is set with false, which means the sync will be blackout while device is not in cradle or power plugged.
        3. if option is set with a value other than "true" or "false", a status will be set with error message

     

    Power Examples:

     

    blackout while min battery is less than 50

    blackout6.PNG

    blackout while power is not charging

    blackout7.PNG

    blackout while min batter is less than 50 or not charging

    blackout8.PNG

     

         Complex configuration example:

      • blackout sync while
        • the time is between 8AM to 4PM
        • and the network is not WiFi
        • and the device is not charging

    blackout9.PNG

    This example means each of these cases will not trigger a blackout of sync capabilities:

    1. time is 07AM
    2. time is 09AM, but current network is WiFi
    3. time is 10AM, current network is cellular, but the device is charging.