Device Staging

StageNow 5.21

Introduction

This guide describes how to use StageNow to select and process a StageNow barcode, NFC tag or binary (.bin) file from a USB or SD card storage, which configures target device(s) as desired for an organization and/or persists a settings Profile on the device(s) for later consumption (following an Enterprise Reset, for example).

IMPORTANT: Use this guide only after one or more Profiles have been created.

Also see:


Stage a Device

I. Select a Staging Profile

To select a profile with which to stage the device:

  1. On the host computer, select the StageNow icon from the Start menu to open the Workstation Tool. The Staging Operator home screen appears. See Home Screen for field descriptions.

    image

  2. Select a profile with which to stage the device(s).


II. Select Staging Medium

Barcode, NFC or USB/SD Staging

This method of staging writes the configuration information from the selected profile into barcodes, NFC tags or USB/SD card storage. Staging is initiated when the output is read by the client device(s).

  1. Select the desired medium (Barcode or NFC) tab:

    image

  2. Optional: In the "My Comments" field, enter comments or special instructions to be displayed to the staging operator when staging begins.

  3. Select the desired output type (if applicable) or choose "Select All" to select all supported output types.

  4. Select Stage to generate a PDF of the staging material.

    <img alt="image" style="height:350px" src=""/>
    

    image

III. Stage the Device(s)

On the target device, tap on the StageNow icon to launch the StageNow Client.

Note: The StageNow Client requires the DataWedge profile to read barcode data. However restoring DataWedge discards the current StageNow configuration. If StageNow cannot scan barcodes after restoring DataWedge, exit and re-launch the StageNow Client on the device.

image

The application lists the available staging methods.

image

Note: MC40 devices do not support NFC.


Barcode Staging

To deploy the selected profile to the device through staging barcodes:

  1. The Barcode Staging option is always on. Scan the barcode(s) printed from the StageNow Workstation Tool.

    image

  2. The screen indicates the barcodes scanned via a check mark, and the barcodes left to scan. Continue scanning all staging barcodes. Upon successful deployment, the device displays the following screen:

    image

  3. If errors occur during deployment, the pop-up shown below is displayed. Select "Yes" to view logs for troubleshooting.

    image


NFC Staging

To prepare for NFC staging, the StageNow Workstation tool is used to create a .bin file that contains the staging instructions. The .bin file can be created from a new or existing device-settings Profile using instructions above. For more information about creating .bin files, see the Staging Profiles guide.

Requirements

  • Zebra device(s) equipped with an NFC reader
  • A Zebra device emulating an NFC card

Emulation Process

After the .bin file is created, Zebra recommends NFC card emulation for staging. A summary of the process is below, followed by a link to the full instructions.

  1. Push the .bin file to a Zebra device.
  2. Open the .bin file using the StageNow app's Card Emulation feature.
  3. Tap that device (which is now emulating an NFC Card) onto one or more Zebra devices to be staged.
  4. Observe staging and check for errors.

Go to the full NFC Card Emulation instructions.


Staging with NFC tag

  1. On the device to be staged, open the StageNow Client and confirm that NFC Staging is enabled: image

  2. Touch the device to the fully programmed NFC tag. After a moment, the following screens appear: image

  3. Follow prompts to complete staging deployment.

NFC Staging is complete.

For devices NOT equipped with an NFC reader, use the USB / SD Card Staging instructions below to stage from a .bin file.


USB / SD Card Staging

StageNow allows the .bin file(s) generated during the NFC Staging process to be used for staging a device from a USB drive or SD card.

To automatically stage a device from a USB drive or SD card:

  1. Generate .bin file(s) using the NFC Profile Staging procedures.
  2. Create a folder called /Stagenow on a USB drive or SD card.
  3. Copy the .bin file(s) to the new folder's root level.
  4. Attach (or insert) the storage device and boot the (new or enterprise-reset) device to be staged.
IMPORTANT NOTES:
  • On devices with MX 9.0, any .bin file causes Setup Wizard bypass.
  • On devices with MX 9.1 and later, a security check ensures that bypass occurs only if the StageNow Profile was created using MX 9.1 or later.
  • Devices with MX 9.1 (or later) automatically skip the Android Set-up Wizard and begin staging when a .bin file is found. About SUW bypass limitations.

Note: Staging Profiles stored on an SD card take precedence over USB.

To manually stage a device from a file on the device:

  1. Generate .bin file(s) using the NFC Profile Staging procedures.
  2. Copy the .bin file(s) to any location on the device.
  3. Launch the StageNow client and tap the "Browse" button.
  4. Navigate to and tap the .bin file copied in Step 2 to begin staging.

See more USB staging info.


StageNow Errors

Client Menu

In the StageNow app, tap the at the top right of the window, then tap "Last Staging Error" from the menu.

image

Last Staging Error

If staging fails, a screen similar to the image below appears. To troubleshoot, review the log to determine the cause of the error by selecting "Yes" from the staging failure screen. To view the log later, select "Last Staging Error" from the StageNow Client menu.

image

HINT: To identify the error(s) in the log, refer to the characteristic-error or parm-error in the log contents.

Note: The Last Staging Error screen displays content only if there are errors in the staging operation. If the staging operation is successful, this screen is empty.


Log Path

To configure the log file path, select the menu icon and select Log Path.

image

The Log Path window opens.

image

Enter the new path and select Done to update the path, or cancel to retain the existing path.


View Client Info

Select View Client Info to view software version information for the device.

image

Use this screen to determine whether the device has full or partial StageNow feature functionality.

  • Full Functionality - the OSx Version is the same as the MXMF Version.

  • Partial Functionality - the OSx Version is less than the MXMF Version. See the Feature Compatibility section of the specific Setting Types to determine if the device supports that feature.

  • No Functionality - no OSx Version.


Staging Wait Conditions

The following pop-up screens can appear during staging, indicating the device is performing an operation and that staging will complete when it is done.


Initializing

Following a device reboot, Zebra components such as the MX Framework can require as much as two minutes to initialize and prepare for staging. If staging is initiated during this time, the StageNow Client indicates displays a pop-up similar to the image below:

image


Acquiring IP

A delay can sometimes occur if staging requires an IP address, such as during "scan-and-dock," when the operator scans a barcode and places the device in an Ethernet cradle. Staging pauses until the device acquires the IP address and performs network operations such as downloading a file from the StageNow staging server. Under such scenarios, a pop-up appears similar to the image below:

image


Downloading

The pop-up shown below indicates that the client is processing a staging profile that contains a command to download content from a staging server. This usually indicates that an OS update package is downloading.

image