STAGENOW Client 2.2 Software Release Notes Page 1
STAGENOW Client Software Release Notes Version 2.2 December 2015 Page 2
No part of this publication may be reproduced or used in any form, or by any electrical or mechanical means, without permission in writing from Zebra. This includes electronic or mechanical means, such as photocopying, recording, or information storage and retrieval systems. The material in this manual is subject to change without notice. The software is provided strictly on an as is basis. All software, including firmware, furnished to the user is on a licensed basis. Zebra grants to the user a non-transferable and non-exclusive license to use each software or firmware program delivered hereunder (licensed program). Except as noted below, such license may not be assigned, sublicensed, or otherwise transferred by the user without prior written consent of Zebra. No right to copy a licensed program in whole or in part is granted, except as permitted under copyright law. The user shall not modify, merge, or incorporate any form or portion of a licensed program with other program material, create a derivative work from a licensed program, or use a licensed program in a network without written permission from Zebra. The user agrees to maintain Zebra s copyright notice on the licensed programs delivered hereunder, and to include the same on any authorized copies it makes, in whole or in part. The user agrees not to decompile, disassemble, decode, or reverse engineer any licensed program delivered to the user or any portion thereof. Zebra reserves the right to make changes to any software or product to improve reliability, unction, or design. Zebra does not assume any product liability arising out of, or in connection with, the application or use of any product, circuit, or application described herein. No license is granted, either expressly or by implication, estoppel, or otherwise under any Zebra Technologies Corp. intellectual property rights. An implied license only exists for equipment, circuits, and subsystems contained in Zebra products. Zebra and the Zebra head graphic are registered trademarks of ZIH Corp. The Symbol logo is a registered trademark of Symbol Technologies, Inc., a Zebra Technologies company. Portions of this software are based in part on the work of the Independent JPEG Group. Zebra Technologies Corporation Lincolnshire, IL U.S.A. http://www.zebra.com Page 3
Table of Contents Table of Contents... 4 About This Guide... 5 Overview... 6 StageNow Client Pre-requisites... 6 Compatibility:... 6 Features... 7 Known Issues and Workarounds... 8 Identified Issues StageNow Client... 8 Page 4
About This Guide This guide captures high level feature description, known issues and workarounds of StageNow Client version 2.2 for android devices. Please refer User Guide (accessible through Help Menu in the StageNow tool) and use StageNow_and_MX_upgrade profile to update client and MX on the device using older version of StageNow on the device or user may choose to use RD if StageNow client is not available (on JellyBean devices). Page 5
Overview The StageNow solution targets customers need for a software tool that allows out of the box device Staging and configuration. Essentially, the process by which an EMC device is configured and desired firmware / software is deployed on to the device, preparing it for a desired production use. We tried to simplify the staging experience with the user interface and new modalities of staging. The main scope of this document is to let you know all the known issues. Please read them carefully. StageNow Client Pre-requisites 1) MX Framework 4.3 or higher 2) Android JellyBean OS or higher 3) DataWedge Software 2.2.9 or higher Compatibility: Supported Devices with OS Jelly bean or higher on which MX framework is supported. S.no Device OS OSx version MX Testing 1 TC8000 KK 4.4 5.0.1.4 Compliance 2 MC67NA KK 4.5 5.0.1.4 Compliance 3 TC75 KK 4.4 5.0.1.4 Compliance 4 TC55 KK 4.4 5.0.1.4 Full 5 MC40 KK 4.5 5.0.1.4 Full 6 MC92 KK 4.5 5.0.1.4 Compliance 7 MC40 JB 3.5 4.4.3.3 Compliance 8 TC55 JB 3.2 4.4.3.3 Compliance 9 TC70(RB) KK 4.4 5.0.1.4 Compliance 10 TC70(NRB) KK 4.1 4.4.3.3 Compliance 11 MC18N0 KK 4.5 5.0.1.4 Compliance Page 6
Features StageNow Client software on android devices is an application to capture the configuration content generated from any Staging content generation tools including StageNow Tool using DSD documents. StageNow Client V2 supports staging of device using Barcode, Audio and NFC tags, communicates with MX framework on the device to apply configuration settings. StageNow client can capture 1D/2D barcodes depending on the device s capability and DataWedge configuration. Make sure the modalities are turned ON before attempting to stage the device. Barcode modality is always ON for convenience. Note: Staging Client depends on the MX framework to apply any configuration, make sure to have latest version (4.3 or higher) on the device before staging the device. Existing version of MX framework and functionality level is shown in the StageNow Client under Client Info. Note: JellyBean and non-rebranded KitKat devices can be brought to StageNow ready state by using RD client on the device. Or StageNow client and MX can be upgraded to the latest version by using StageNow_and_MX_upgrade profile. Please see StageNow tool documentation to know more about RD staging feature. Note: Because StageNow client depends on the DataWedge to scan barcodes, make sure that the DataWedge is included in the white-listed applications when the white-listing is enabled in Access manager setting. Page 7
Known Issues and Workarounds Identified Issues StageNow Client Description Success of the Audio staging depends on the environmental conditions, please explore the Audio staging help in the tool and Client to know more about the audio staging expectations. Audio staging uses Microphone to collect data, it can block any other application from using the same, at the same time, if some other application is already using the microphone, StageNow will not be able to acquire the data. For this reason Audio staging modality will be disabled. NA NA Notes and Workaround Indefinite wait loop is seen when the Audio staging modality is toggled ON/OFF repeatedly Exit the StageNow client app by selecting the ForceStop option (in setting >>apps >> StageNow) and re-launch StageNow. Audio staging not working on TC55 KK with built in Microphone Looks like there is some issue with the builtin microphone, connecting the external Mic could solve the problem. SN client will keep the device ON when the SN client is in the foreground It s as designed to make the job of a staging operator easy to see the status of staging multiple device at a time. This could drain the battery if the StageNow is left in the foreground after staging. Close StageNow client as soon as Staging is done. Page 8
Wi-Fi Setting with EAP TLS WEP 104 is not created properly on the device NFC Staging fails if bin file size is more than one KB This is an issue with the NFC data writer application, we will make another release of this software to address this problem. Uninstalling a.pfx certificate is not removing the certificate from list Back key not working when SN is background and user navigates in other screens (ex: settings, Wi- Fi config etc.) In some rare instances, NFC modality is not functional when NFC is not enabled in the settings Barcode scanning will not work after applying the Encrypt Mgr setting on a Jellybean devices. Avoid navigating to other apps when Audio staging is in progress. StageNow will enable NFC when the modality is enabled, if we don t here sound when we tap NFC, Turn OFF and Turn ON NFC from the home screen. It is observed that the camera stops working after Encrypt manager setting is applied. Because of which the barcode scanning will not work in StageNow client. Workaround 1: Enterprise reset would solve the problem. Workaround 2: a) Open StageNow profile in the DataWedge software on the device, b) Change the scanner to Serial SSI c) Reboot Device. d) Open DataWedge, Edit StageNow profile, Change the scanner back to Camera. Barcode scanner will not work on the first press if time there is no delay of 2 sec from the moment the page is loaded We would need a delay of 2 sec from the moment the page is activated to be able to launch the scanner with the first press of scanner button. The second launch of barcode scanner will work normally. On disabling all Cameras on TC55 devices makes the StageNow client incapable of scanning barcodes from thereafter. Log path to be changed if the stage logs are not seen DataWedge profile for StageNow TC55 is using Camera to read barcodes. Do not disable all cameras on TC55, or use NFC or Audio to stage the device to enable the cameras again. If the StageNow logs are not seen under Log Settings >> View Current Logs there Page 9
could be some issue with the log path write permissions. Change the log path under log settings to a writable location. StageNow will disappear from the device if Verify all app signatures flag is enabled in the Access manager setting. This is an access security feature provided by MXMS. When this check is enabled, system will verify all apps including MX framework and StageNow client and disable application which are not with the registered signatures. User need to be careful while enabling this feature, if they want to enable, enable StageNow application signature as well, else StageNow client application will not be shown in the device. Zebra Technologies Corporation Lincolnshire, IL U.S.A. http://www.zebra.com Zebra and the stylized Zebra head are trademarks of ZIH Corp., registered in many jurisdictions worldwide. All other trademarks are the property of their respective owners. 2015 ZIH Corp and/or its affiliates. All rights reserved. Page 10