This tour will show you what app information and controls are available within Manager
The app details are displayed after selecting a single device. By default three tabs will be displayed: Performance, Settings and Support, as well as Configure Tab Layout. The Compliance tab is only available if the Manager SDK is embedded into your app. We’ll go over what is available in each tab.
1 – Performance
The performance tab is where all the information recorded from the app about it’s performance is stored and displayed. The display is visual and shows the last data received from the device. Within MokiTouch 2 the app is gathering this information every 5 minutes and sends it in a bundle to Manager every hour the app is open. If you have embedded the Manager SDK into your app the frequency this information is gathered can be modified. Here is the returned information.
- Connectivity – Shows the network and IP address the device was connected to. If it was not connected there will be a No Connection message displayed
- Connectivity Status – Shows the WiFi connection strength or if the device is connected via cellular
- App Uptime – Shows the continuous time the app has been open. If the app is still running in the background the timer is still ticking
- Location – Shows the location of the device. As will all mobile devices, location is more accurate from a WiFi signal as opposed to a cellular connection. Also, location services have to be turned on on the device and within the app. You can zoom in and out or even pop the map up larger
- Battery Status – Shows the percentage the battery was at during the last ping
- Plugged In Status – Shows whether the device was plugged in or not during this time
- CPU Load – Shows the CPU load of the device. iOS devices typically run higher because they are not on a 100% scale, frequently they will send back usage stats in the high one hundred percents
- Memory Use – How much memory the device was using during that time. If you are using caching then memory usage might be high
- Capacity – The storage capacity of the device
- App Uptime – Shows the continuous time the app has been open, as mentioned above
- Device Uptime – The time the device has been running continuously
- OS Version – The OS version the device is running
- App Version – The version of the app. Helpful in troubleshooting issues
- SDK Version – The Manager SDK version embedded into this version of the app. Helpful in troubleshooting issues
- Processes – How many processes are running on the device with a link to view what those processes are. A developer tool to help troubleshoot issues people are having with the app
- Showing – The point in time that all the information above was captured
- Status Bar – This bar will show the earliest date this app has data stored. The timeline is clickable. Once clicked in the keyboard’s arrow keys can help you move along the timeline from record to record. All information contained on the Status Bar is retrieved from the device logs and is not live information.
- App Crash – When Moki is able to connect with the app again and get crash reports a mark will appear. If the app is configured for stack trace errors Moki will display the stack trace underneath the check boxes
- App Launch – Whenever the app is launched this icon will be displayed
- Lost Connectivity – If the device loses it’s connection to WiFi or cellular networks
- Network Change – If the device changes WiFi networks or cellular networks
- Location – If the device has reported a new location. This happens frequently on cellular networks as location is based on cell towers
2 – Settings
Managing app settings is one of the most exciting parts of the Manager platform. Whether you have embedded the SDK into your app or you are using one of Moki’s apps, such as MokiTouch 2, the Settings tab is where app settings are controlled and where we can create settings templates. Creating settings templates will allow for a quick deployment to all your devices at once. There are several sections we’ll want to cover to give you a full understanding of how settings work, editing device settings, creating saved settings, applying saved settings, managing saved settings.
Editing Device Settings
Settings can be edited on a single device or on multiple devices, see the following two sections for applying settings to groups of devices. To edit the device settings select the device and the Settings tab, then click the Edit Device Settings button.
You’ll see two new buttons appear on the right, Cancel and Save. Edit the settings as desired and hit Save. If your app is open you’ll more than likely see your changes take place almost instantly.
To see a detailed article on a particular app’s settings see the following articles:
If attempting to go to settings and you get the following message: “The application has not been setup on this device yet” it means that the app has been unenrolled in Manager and needs to be enrolled again.
Creating Saved Settings Templates
Saved Settings templates are the quickest way to apply changes to your fleet of devices. In order to create a template you first have a device enrolled. Templates are specific to iOS or Android so you’ll need to have the type of device enrolled you are creating a template for. We’ll give some step by step instructions for creating the settings templates.
- Select a device
- Click on the Settings tab
- Click on the Apply Saved Settings drop down
- Select Manage Saved Settings
- Click the Add New button
- Give the template a name and update settings. You’ll notice that all the settings from the selected device are the starting point for the template. This is why you must select the device running the desired platform as well as version number.
- Hit Save when you’re finished creating your template
Applying Saved Settings
Saved Settings can be applied to a single device or up to 500 devices at once. These can be done on demand or they can be scheduled for later (see Apps Tour 4 – Actions Tab). Once your devices are selected you’ll see the Apply Saved Settings drop down option. Click on the drop down and you’ll see your available templates in the list. Select the one you want and you should get an Apply button. Click Apply and the settings will be sent to your devices.
You may have noticed that your settings template had a version number added to the end. This is normal and is a way to help you identify which templates can be applied to which devices. Let me explain. Every version of the app gets assigned a settings version number (version number). The settings applied to the device have to match the available settings on the device, hence the version number. If you attempt to apply a template from a different version you will be asked to Convert the Template. This is covered in the next section called Managing Saved Settings. You’ll also be told to convert a template if you try applying an iOS template to an Android device and visa versa.
If you have iOS and Android devices selected and you are able to push the settings template to all of them you need to be aware that the settings will push, but because the settings aren’t the same they will be messed up and things won’t run smoothly. Please be sure to use the filters on the left to get the correct devices selected.
Managing Saved Settings
Updates are frequently needed to keep content fresh and up to date if you’re using a kiosk type app. Usually their are only a couple elements that need to change, such as content or links to pages. Also templates are only as good as the version of the app they were created for. Because of these reasons you have the ability to manage manage your saved settings by clicking on the Apply Saved Settings drop down and selecting Manage Saved Settings at the bottom. Select the template from the drop down list that you wish to edit. You’ll get the following options.
- Edit – Allows the template to be edited. Changes to the template do not effect devices in the field until the template is applied (following the instructions in the previous section)
- Cancel – Exits the selected Saved Setting
- Delete – Deletes the selected template. This is helpful to keep your template list clean. When all devices have been moved to the current template it would be wise to remove old templates
- Copy – Makes a copy of this template and adds it to the template list. You’ll be asked what you want to rename the template to and will need to his Save on that same screen or the copy will not be created
- Convert to [new version] – Will convert an old settings version to the newest available settings version in the account. This option will only be displayed when a new version of the app has been enrolled in your account
3 – Support
- Device nickname – This is the name that is displayed in manager. It can be changed by placing your mouse over the name and clicking in the box, then change it and hit Enter. When an iOS device is first enrolled it will reflect the name of the device (unless you have changed the name in the iOS device settings it will be iPad). If the nickname is changed, Manager will always show the nickname, even if the name has changed within the iOS device settings.
- Network Scan – Apps with the Manager SDK embedded into them have the option to enable a Network Scan to endpoints of their choosing. The results of these scans will return here, the most recent being displayed and previous ones shown by dragging the timeline to the left. The Network Scan is designed to let you know the health of your network, speed, port accessibility and if your app can connect to critical endpoints for your app’s functionality to work correctly. There are four fields that are checked (shown below). The time it took the app to reach these endpoints is only displayed locally on the tablet. To access on MokiTouch 2 see this article on Network Check. A high response time is about 400 ms, usually indicating a cell network was used. A fail will typically happen at 500 ms.
- Gateway – Checks a site outside of the typical traffic and outside of Moki. If using MokiTouch 2 a Fail does not mean the app won’t work. If using your own app this may not be the case
- DNS – Check against your desired DNS service. By default Moki apps use Google DNS lookup in their checks. A Fail does not mean the app won’t work. If using your own app this may not be the case
- Pings – This pings Manager to make sure that it can reach Manager for things like settings and returning statistics
- Valid IP – Checks if the device is giving a valid IP address from the internet provider
- Screenshots – List the number of screenshots taken on that device. If there are any there will be a number as well as a View link. Screenshots must be requested from the Action Bar, see Apps Tour 3.3 – Action Bar for more info. There is a pop-up after the View button is clicked that shows you the 20 most recent screenshots on the device as well as gives the following options.
- Image Details – The name of the screenshot will always be the device name, the date and the time the screenshot was taken
- Rotate Image – Allows you to change the screenshot orientation. By cookies we store the last way the image was displayed
- Image – The image will display here in whatever orientation it came back from the device with. The screenshot should be displayed in the orientation it took in order to see the full image. Images can be saved out to your computer through the normal browser saving options, typically right click on the image with your mouse and hit Save Image
- Next and Previous – Up to 20 screenshots are stored and you can go from left to right.
- Device Information – Information varies depending on the platform of the device as well as it’s cellular data plan
- Device Name – For iOS it will be the name displayed in the About section of the settings. For Android devices it is the last 6 characters of the MAC address. This is because Android devices don’t have names so we create one to display and differentiate the different devices in Manager.
- Model – This is the model of the device, i.e. iPad, iPhone, GT-P5113 etc.
- Platform – Whether it is an iOS or Android device
- Capacity – Total storage capacity of the device, typically displayed in GB
- Available Capacity – Total storage capacity remaining on the device
- Product Name – This is the type of device it is for iOS. For Android it is information contained in the About section relating to the kernel
- Serial Number * – The serial number of the device
- Battery Level – This is the battery level that was returned the last time the device successfully checked-in. It is not an up-to-date monitoring of the battery level
- Location – Displays the location coordinates of the device if location is available as well as a link to view it on a map. Location services have to have been accepted when prompted in the app or turned on in the settings to retrieve this information
- OS Version – The OS version the device is running
- Cellular Technology – Displays if there is cellular technology available or not
- Phone Number – Displays a phone number if there is one
- Build Version – Contains the build version for reference. For Android devices this is taken from the about section
- IMEI/MEID – This is the IMEI number for a cell enabled device
- Network Information – Information varies depending on the platform of the device as well as it’s cellular data plan
- Bluetooth MAC* – The bluetooth MAC address of the iOS device
- ICCID – The ICCID number of a cell enabled device
- SIM Carrier Network* – The cell provider for the iOS device
- SIMMCC – The MobileCountryCode of the cell enabled device
- SIMMNC – The MobileNetworkCode of the cell enabled device
- WiFi MAC – The WiFi MAC of the device
- WiFi SSID – The WiFi SSID for the device, commonly referred to as the WiFi’s network name
*Specific to iOS devices
4 – Compliance
The Compliance tab is only available on apps that have embedded the Compliance portion of the Manager SDK. Compliance settings are managed on the front end through Developer Tools in your Account Settings. Based on the settings selected the device will be scanned and a score returned. This runs in the background of the app and doesn’t have a user facing option so the user will never know this is being performed. Tests can be run at any time from the Action Bar, discussed in the next tour. Only the last scan is displayed along with the results, score, description and remedy. As mentioned in Manager Tour 10.1 – Account Settings, the scores are predetermined by PCI guidelines.
- Total Risk Score – There is no determined maximum or minimum amount. This number is the sum of the failed items from the scan and is derived from the values determined in the Developer Tools section of Account Settings
- Date – The date and time the scan took plate
- Failed – The number of items that failed the scan. This is a clickable field that will extend the details of the section
- Score – This is the value of the item scanned
- Description – A brief description of the fail and why it is a security risk
- Remedy – The suggested remedy for the scanned item listed
- Warned – The number of items that received a warning. This is a clickable field that will extend the details of the section displaying the Score, Description and Remedy
- Passed – The number of items that passed the scan. This is a clickable field that will extend the details of the section displaying the Score, Description and Remedy
5 – Configure Tab Layout
The Configure Tab Layout button allows you to change the order of the tabs or remove ones that you don’t want to see. These changes are cookie based and only effect the current user on the current browser. You can show or hide any or all of the tabs. When you are done, hit Save.
Thank you for reading this tour of Manager. To find more tours on different features of Manager, please visit https://support.moki.com
Next Tour » Apps Tour 3.3 – Actions Bar