Product Documentation

Herramienta XenMobile Analyzer

Feb 14, 2017

XenMobile Analyzer is a cloud-based tool that you can use to diagnose and troubleshoot XenMobile-related issues with installation and other features. The tool checks for device or user enrollment and authentication issues within your XenMobile environment.

To enable the checks, you need to configure the tool to point to your XenMobile server and you need to provide information, such as server deployment type, mobile platform, authentication type, and user credentials for testing. The tool then connects to the server and scans your environment for configuration issues. If XenMobile Analyzer discovers issues, the tool provides recommendations to correct the issues.

XenMobile Analyzer Key Features
  • Offers a secure, cloud-based micro-service to troubleshoot all XenMobile-related issues.
  • Provides accurate recommendations when there are XenMobile configuration issues.
  • Reduces support calls and accelerates the troubleshooting of XenMobile environments.
  • Offers zero-day support for XenMobile server releases.
  • Enables iOS custom enrollment: custom port support for XenMobile (on ports other than 8443).
  • Displays a certificate acceptance dialog box for untrusted or incomplete server certificates.
  • Automatically detects two-factor authentication scenarios.
  • Secure Web tests for reachability to intranet sites.
  • Secure Mail Auto Discovery service checks.
  • ShareFile single sign-on (SSO) checks.
  • Enables custom port support for NetScaler.
  • Supports non-EN browsers.

Prerequisites

Product Supported Version
XenMobile Server 10.3.0 and above
NetScaler Gateway 10.5 and above
Client Enrollment Simulation iOS and Android

 

You use your MyCitrix credentials to access the tool from https://xenmobiletools.citrix.com.  On the XenMobile Management Tools page that opens, to start the XenMobile Analyzer, click Analyze and Troubleshoot my XenMobile Environment.

localized image

XenMobile Analyzer contains five main steps designed to lead you through the triage process and to reduce the number of support tickets, which can lower costs for everyone. 

The steps are as follows:

1. Environment Check - This step guides you in setting up tests to check your setup for issues. The step also provides recommendations and solutions on device, user enrollment, and authentication issues.

localized image

2. Advanced Diagnostics - This step provides information on using Citrix Insight Services to find further issues that the environment check may have missed.

localized image

3. Secure Mail Readiness - This step directs you to download the XenMobile Exchange ActiveSync Test application, which helps to troubleshoot the ActiveSync servers for their readiness to be deployed with a XenMobile environment.

localized image

4. Server Connectivity Checks - This step instructs you to test the connectivity of your servers.

5. Contact Citrix Support - This step links you to the site where you can create a Citrix Support case if you are still having issues.

localized image

The following sections describe each step in more detail. 

Performing an Environment Check

1. Log on to the XenMobile Analyzer and then click Step 1: Environment Checks

2. Click Get Started.

localized image

3. Click Add Test Environment.

localized image

4. In the new Add Test Environment dialog box, do the following:

In the above screenshot, please note that Worx Home is now called Secure Hub.

localized image

a. Provide a unique name for the test that will help identify the test in the future.

b. In the FQDN, UPN login, Email or URL Invitation field, enter the information that will be used to access the server.

c. In XMS Instance, if you use a custom instance, you can provide that value.

d. In Choose Platform, select either iOS or Android as the platform for testing.

e. If you expand Advanced Deployment Options, in the Deployment Mode list, you can select your XenMobile deployment mode. Available options are Enterprise (MDM + MAM)App Management (MAM), or Device Managment (MDM).

In the above screenshot, please note that Worx Home is now called Secure Hub.

localized image

5. Click Continue.

localized image

In the above screenshot, please note that WorxWeb is now called Secure Web, and WorxMail is now Secure Mail.

6. You can choose application level tests to run. You can choose one or more of the following tests.

a. Secure Web micro VPN Connectivity with intranet sites. Provide an intranet URL. The tool will test for the reachability of the URL. This will detect if there are any connectivity issues that could potentially occur in the Secure Web app while trying to reach intranet URLs.

b. Secure Mail ADS. Provide a user email ID. This will be used to test the autodiscovery of the Microsoft Exchange Server in your XenMobile environment. It will detect if there are any issues related to Secure Mail Auto Discovery.

c. ShareFile SSO. If selected, XenMobile Analyzer will test if the ShareFile DNS resolution happens successfully and if ShareFile single sign-on (SSO) works with the provided user credentials.

7. Click Continue.

localized image

8. Depending on your server setup, you may see different fields available to enter User Credentials. The possible fields are Username alone, Username and Password, or Username, Password, and Enrollment PIN.

9. After entering this information, click Save & Run to start the tests.

A progress notification appears. You can leave the progress dialog box open or close the dialog box and the tests will continue to run.

Tests that have passed appear in green. Tests that fail appear as red.

localized image

8. At any point after closing the progress dialog box, you can return to the Test Environments List page and then click the View Report icon to see test results.

The Results page displays Test Details, Recommendations, and Results.

localized image
localized image

In the above screenshot, please note that WorxWeb is now called Secure Web, WorxNotes is Secure Notes, WorxTasks is Secure Tasks, and WorxStore is XenMobile Store.

If any recommendations have Citrix Knowledge Base articles associated with them, the articles are listed on this page.

9. Click the Results tab to display the individual Category and Tests that the tool performed, with their results.

a. To download the report, click Download Report.

b. To return to the list of test environments, click Test Environments.

c.  To rerun the same test, click Run Again.

d. If you want to re-run another test, go back to Test Environments, select the test, and click Start Test.

e. To go to the next step of XenMobile Analyzer, click Next Step.

localized image

10. From the Test Environments page, you can copy and edit tests. To do so, select a test, and then click Duplicate and Edit. A copy of the selected test will be created and the Add Test Environment dialog will open, allowing you to modify the new test.

localized image
localized image
localized image
localized image

Performing XenMobile Analyzer Steps 2 Through 5

You interact with the Environment Check step of the XenMobile Analyzer directly to perform tests, whereas Steps 2 through 5 are informative. Each of these steps provides information concerning other support tools you can use to ensure that your XenMobile environment is set up correctly. 

  • Step 2 - Advanced Diagnostics: This step instructs you to collect information on your environment and then upload the information to Citrix Insight Services. The tool analyzes your data and provides a personalized report with recommended resolutions.
  • Step 3 - Secure Mail Readiness: This step directs you to download and run the XenMobile Exchange ActiveSync Test application. The application troubleshoots ActiveSync servers for their readiness to be deployed with XenMobile environments. After the application runs, you can view reports or share them with others.
  • Step 4 - Server Connectivity Checks: This step provides you with instructions for checking your connections to XenMobile, Authentication, and ShareFile servers.
  • Step 5 - Contact Citrix Support: If all else fails, you can create a support ticket with Citrix Support.

Known Issues

The following issues are known concerning XenMobile Analyzer:

  • The number of apps listed might vary based on the client if the Platform Restriction Policy is set on XenMobile Server.
  • When performing the Secure Web Intranet Connectivity checks, entering multiple URLs in the text box is not supported.
  • The shared devices authentication feature of Secure Hub is not supported.
  • Secure Web tests only check the connectivity to the URLs entered and not the authentication to the corresponding sites.
  • For PIN based authentication modes, if you select the Secure Mail ADS test, you are prompted for a password to perform the test. The password is not for enrollment or authentication.

Fixed Issues

The following issues with XenMobile Analyzer have been fixed:

  • When performing a check using enrollment invitation, the test passes but the enrollment invitation is not redeemed.