Product Documentation

Adding Devices and Viewing Device Details

Sep 01, 2015
The XenMobile console server repository database stores a list of mobile devices. Each mobile device is defined by a unique serial number and/or International Mobile Station Equipment Identity (IMEI)/Mobile Equipment Identifier (MEID) identification. To populate the XenMobile console with your devices, you can add the devices manually or you can import a list of devices from a file. See Device Provisioning File Formats.
On the Devices page in the console, you'll find a table listing each of the devices, along with the following information: Status (Device not jailbroken, Device not managed, Active Sync Gateway unavailable, no deployment failure), Mode, (MDM, MAM), User name, Device platform, Operating system version, Device model, Last access, and Inactivity days.
Note: The preceding headings are the defaults. You can customize what is shown in the table by clicking the down arrow on the last heading and then clicking from the many possible headings you want to see in the table or clearing those you do not want to see.

Customize table headings

You can add a new device manually by clicking Add, or you can import a provisioning file by clicking Import. To update the table, click Refresh.

To add devices manually

  1. In the XenMobile console, click Manage > Devices and then click Add. The Add Device page appears.
  2. In Select platform, click either iOS, Android, or Symbian.
  3. Enter the following information:
    1. iOS: Enter the Serial Number.
    2. Android: Enter the Serial Number and IMEI/MEID.
    3. Symbian: Enter the IMEI/MEID.
  4. Click Add. The Devices table appears with the device added to the bottom of the list.
  5. In the list, select the device you added and then in the menu that appears, click Edit to view and confirm the device details.


    Select device


    Note: When you select the check box next to a device, the options menu appears above the device list; when you click anywhere else in the list, the options menu appears on the right side of the listing.

    Device detail edit menu

  6. Under General Identifiers, confirm the information displayed (the exact parameter list varies by platform type): Serial Number, IMEI/MEID, ActiveSync ID, WiFi MAC Address, Bluetooth MAC Address, Device Ownership: Corporate or BYOD.

  7. Under Security, confirm the information that appears (the exact parameter list varies by platform type): Strong ID, Full Wipe of Device, Selective Wipe of Device, Lock Device, Device Unlock, Device Disown, Activation Lock Bypass, Device Clear Restrictions.
  8. Click Next to add properties.
  9. On the Properties page, click Add to view a list of the properties that you can provision for the device. The list of available properties appears.

  10. In the list, click the property to be provisioned and then set its value. For example, you can select the property Activation lock enabled and can set the value to either Yes or No.
  11. After configuring a property, click Done.
  12. Repeat steps 9 through 11 for each of the properties you want to provision and then click Next.
    Note: As you add properties, they are all listed under Properties. When you return to the Properties page at a later time, the properties are separated into different categories.

    The Assigned Policies section and the sections that follow all contain summary information for the device.
    • Assigned Policies: Displays the number of assigned policies including the number of deployed, pending, and failed policies. The name, type and last deployed information also appear for each policy.
    • Apps: Displays the number of apps as of the last inventory that includes the number of installed, pending, and failed apps.
      • For Installed, the following information appears: Name, Ownership, Version, Author, Size, Installed, Identifier, and Type.
      • For Pending and Failed apps, the following information appears: Name, Last deployed, Identifier, and Type.
    • Actions: Displays the number of actions, which includes the number of deployed, pending, and failed actions. Each action displays the name and last deployed information.
    • Delivery Groups: Displays the number of success, pending, and failed delivery groups. The Delivery Groups and time information appears for each action. In addition, more detailed information appears for the Delivery Group, including Status, Action, Owner and Date.
    • iOS Profiles (iOS devices only): Displays the last iOS profile inventory, including Name, Type, Organization and Description.
    • Certificates: Displays the number of valid certificates and expired or revoked certificates, including the Type, Provider, Issuer, Serial number, Valid from, and Valid to information.
    • Connections: Displays the first connection status and the last connection status. For each connection, the User name, Penultimate authentication and Last authentication appear.
    • TouchDown (Android devices only): Displays the last device authentication and the last user authenticated information. Each applicable Policy name and Policy value appear.
  13. Click Save.

To import devices from a provisioning file

You can import a file supplied by mobile operators or device manufacturers, or you can create your own device provisioning file. See Device Provisioning File Formats.
  1. In the menu above the Devices table, click Import. The Import Provisioning File dialog box appears.

    Import device from file

  2. Select the file to import by clicking Browse and then navigating to the file's location.
  3. Click Import. The imported files are added to the Devices table.

To edit devices

  1. Select the device you want to edit, and then click Edit. The Device Details page appears.
  2. Under General Identifiers, the only field you can change is Device Ownership, which you can set to Corporate or BYOD.
  3. Click Next. The Properties page appears.
  4. On the Properties page, add, edit, or delete properties as appropriate.
    • To edit a property, click the property, modify its settings, and then click Done or Cancel.
    • To delete a property, hover over the listing and then click the X on the right-hand side. The item is deleted immediately.
  5. Click Next. The page that appears next depends on the selected device. For some devices you see User Properties, and for others you see Assigned Properties.
  6. If you see User Properties, add, edit, or delete user properties as follows; otherwise the remaining pages contain summary information for the device. For a description of these pages, see To add devices manually.


    Device user properties


    Note: The upper portion of the User Properties page cannot be edited.
    • To add a user property, click Add.
      • In the list, click the property you want to add, enter the value for the property, and then click Done or Cancel. Repeat this step for each property you want to add.
    • To edit a property, click the property, modify its settings, and then click Done or Cancel.
    • To delete a property, hover over the listing and then click the X on the right-hand side. The item is deleted immediately.
  7. Click Next on each of the following pages to view summary information.
  8. On the final page, click Save to save the changes to the device.

To send a notification to devices

You can send notifications to devices from the Devices page. For more information about notifications, see To create or update notification templates in XenMobile

  1. Select the device or devices to which you want to send a notification.
  2. Click Notify. The Notification dialog box appears. Recipients lists all the devices that are to receive the notification.

    Device notification

  3. Configure the following information:
    1. Templates: In the list click the type of notification you want to send.

      The Subject and Message fields are filled with the text configured for the template that you chose except for Ad Hoc.

    2. Channels: Select how to send the message. The default is SMTP and SMS.

      You can click the SMTP and SMS tabs to see the message format for each.

    3. Sender: Enter an optional sender.
    4. Subject: Enter a subject for an Ad Hoc message.
    5. Message: Enter the message for an Ad Hoc message.
  4. Click Notify.

To delete devices

  1. In the Devices table, select the device or devices you want to delete.
  2. Click Delete. A confirmation dialog box appears. Click Delete again.
    Important: You cannot undo this operation.