Vmware Airwatch Advanced Remote Management Guide: Installing, Configuring, and Using The Remote Management Service V4.2
Vmware Airwatch Advanced Remote Management Guide: Installing, Configuring, and Using The Remote Management Service V4.2
Management Guide
Installing, configuring, and using the Remote Management Service
v4.2
AirWatch v9.2
Have documentation feedback? Submit a Documentation Feedback support ticket using the Support Wizard on
support.air-watch.com.
Copyright © 2018 VMware, Inc. All rights reserved. This product is protected by copyright and intellectual property laws in the United States and other countries as well as by
international treaties. VMware products are covered by one or more patents listed at http://www.vmware.com/go/patents.
VMware is a registered trademark or trademark of VMware, Inc. in the United States and other jurisdictions. All other marks and names mentioned herein may be trademarks of their
respective companies.
1
Table of Contents
Chapter 1: Overview 4
Introduction to Advanced Remote Management 5
Advanced Remote Management Components 5
Typical Deployment 7
Security Zones and Ports 8
Advanced Remote Management Supported Platforms 9
Advanced Remote Management Requirements 9
Upgrade to a New Version 14
2
Troubleshooting, Generate Certificates 34
Troubleshooting, Remote Management Not Available - Device Registration Issues 34
Troubleshooting, Issues Connecting to Devices 35
Troubleshooting, Modify Database Record for Multi-Node Configuration 36
Create the Remote Management CN from the AirWatch Database 36
3
Chapter 1:
Overview
Introduction to Advanced Remote Management 5
Advanced Remote Management Components 5
Typical Deployment 7
Security Zones and Ports 8
Advanced Remote Management Supported Platforms 9
Advanced Remote Management Requirements 9
Upgrade to a New Version 14
4
Chapter 1: Overview
Database
The database handles system and tenant configuration, operations, and logging such as the accrual of historical device
enrollment data.
Core Services
The Core Services component provides service discovery and auxiliary services for the ARM solution through Web
services and Windows services. These services include the following.
l Management Entity (ME) – Windows service that provides an in-memory datastore for admin and management Web service, which provides
the operational end point to the system.
l AetherPal Tool Controller Service (ACS) – Acts as a gateway service that maintains a consistent socket connection between the Admin Web
Portal and the Connection Proctor. It is instrumental in supporting HTML5 Web portal.
l Service Coordinator (SVC) – This Windows service is responsible for coordinating communication between various elements within the
system. It provides the communication to the database and is responsible for the discovery of all other Remote Management Tool services.
All ARM Tool services register with this service. Service coordinator service is installed on an Application (App) Server.
l Data Tier Proxy (DTP) – This Windows service works with the Service Coordinator. It serves as the gateway for all services to reach the
Service Coordinator service to communicate with Remote Management Tool databases. Data Tier Proxy service is installed on the App Server.
l Data Access Proxy (DAP) – This Web service is responsible for a proper communication of all Web services. It serves a similar purpose as the
Data Tier Proxy service and is installed on the App server.
5
Chapter 1: Overview
Portal Services
The Portal Services component handles the administrative and management services for ARM. The Management
Website is installed as part of the portal services component and consists of the following.
l Anchor Web Service – provides a single point of entry for all devices for enrollment and authentication services during a session. The Anchor
service comprises of the following components.
o Device Registration: Before enrollment, devices are required to register themselves with this service.
o Software Update: Devices connect to this service to request client updates. If an update is available, the service provides the appropriate
client download link. This component also manages various client packages in the system.
o Device Management: When the enrolled device detects a change, this service provides an interface with which to update its parameters
in the ARM Tool such as MDN.
o Admin Anchor: Provides the administration component for the Anchor service.
T10 Interface
The T10 interface is the part of the Management website under Portal Services that defines an integration portal between
AirWatch and the ARM server.
The T10 interface uses Representational State Transfer (REST) communication with a JavaScript Object Notation (JSON)
payload. The T10 interface allows AirWatch to make a mobile device eligibility call.
The T10 interface can also start a remote support session using the ARM tool and delete the device from the ARM
system.
Application Services
Messaging Entity (MSG) is a core Windows service that provides the means for the ARM tool to send out SMS messages
to the device via API or direct communication with a messaging gateway, such as Google Cloud Messaging (GCM), or any
proprietary SMSC aggregator.
Connection Proctor
The Connection Proctor component uses the Windows Connection Proctor service to manage device connections to the
ARM server. The component also simultaneously handles multiple requests for sessions.
6
Chapter 1: Overview
Typical Deployment
Most users typically deploy the Advanced Remote Management (ARM) server in an enterprise network to facilitate the
communication between the various components.
7
Chapter 1: Overview
Internal Ports
The chart below summarizes what ports are utilized by which services.
Port # Incoming Components/Services Outgoing Components/Services
53/389/636 Active Directory (AD) Data Tier Proxy (DTP)
Directory Services (DS) Service Coordinator (SVC)
Domain Name Service (DNS) Aetherpal Tool Controller (ACS)
80 or 8080 Management Services Data Access Proxy (DAP)
(depending upon your (configurable) Management Entity (ME)
configuration)
8
Chapter 1: Overview
Public Ports
Incoming web traffic for Admin/Anchor and the Connection Proctor require that the following ports be open.
443 – Admin/Anchor (ADM/ANC)
8446 – Connection Proctor (CP)
Note: If devices and the CP server are located internally and can access these services, then these ports do not need
to be publicly available.
l Android devices with the AirWatch Agent v7.0 and greater installed.
You must also download the required Advanced Remote Management CAB or APK from Accessing Other Documents on
page 38.
General Requirements
For SaaS customers, the general requirements are the only requirements that must be met.
Requirements Minimum
Supported Latest version of Google Chrome, Safari, Internet Explorer, or Edge.
Browsers
AirWatch version AirWatch v9.0.2+ with the AirWatch Rugged EMM Bundle.
Ensure that your version of AirWatch includes these features by contacting your account
representative.
9
Chapter 1: Overview
Requirement Description
Portal Admin User Create a user with the following settings.
l First name: Portal.
l Create a password that the user cannot change and which does not
expire.
Hardware Requirements
Hardware Minimum
Remote Management Server
CPUs 2.4 GHz Processors, 4 Logical Processors,
2 CPU 2 Core 2x2 or 4 Physical depending on machine type
VM vs Physical.
Memory 16 GB
Hard Drive IOPS 15,000 SAS minimum
Hard Drive Space 100 GB for OS drive
Remote Management Database Server
CPUs 2.4 GHz Processors, 4 Logical Processors,
2 CPU 2 Core 2x2 or 4 Physical depending on machine type
VM vs Physical.
Memory 16 GB
Hard Drive IOPS 15,000 SAS minimum
Hard Drive Space 200 GB for databases
200 GB for backups and logs
Remote Device Maximum
Given a single server deployment with the above minimum specifications, the maximum number of concurrent remote
device sessions is 250.
Software Requirements
Ensure that you meet the following on-premises installation requirements.
10
Chapter 1: Overview
Requirements
Remote Management Server
Operating Microsoft Windows Server 2012 R2. Windows Server 2016 is not supported.
System
Software Microsoft .NET Framework 4.6.2
Microsoft Report Viewer 2010 Redistributable Package.
Multi-Node Configuration: the Microsoft Report Viewer 2010 Redistributable Package must be
installed where Portal Services are installed.
n TCP Activation.
11
Chapter 1: Overview
Requirements
Remote Management Database
Operating l Microsoft Windows Server 2012 R2. Windows Server 2016 is not supported.
System
l MS SQL Server 2012 Standard, or
MS SQL Server 2014 Standard, or
MS SQL Server 2014 Enterprise.
MS SQL Server 2016 is not supported.
l Bulkadmin.
l Dbcreator.
User l Dbowner.
Mapping
l Dbbackupoperator.
l SQLAgent dependent.
l serverGroup dependent.
Network Requirements
12
Chapter 1: Overview
controlplane.aetherpal.internal
admin.
l If the ARM Server is behind a load balancer, then the host record must point to the
internal Virtual IP (VIP) for the load balanced pool.
l If the ARM server is not behind a load balancer, then the host record must point to the
ARM Server IP address.
Service Coordinator l Record type: SRV. l Priority: 0
Service Records
l Domain: l Weight: 0
controlplane.aetherpal.internal
l Port number: 8870
l Service: _svc.
l Host Offering this service:
l Protocol: _tcp. admin.controlplane.aetherpal.internal
13
Chapter 1: Overview
2. Run the new installer. The installer prompts you to remove the currently-installed components, excluding the
database.
3. Agree to allow the installer to remove the installed components. Once complete, the installer prompts you to install
new versions of the same components.
14
Chapter 2:
Load Balancer Integration
Load Balancer Overview 16
Integrate a Load Balancer to Your Deployment 16
Multi-Node Options Summary 16
15
Chapter 2: Load Balancer Integration
For a summarized list of required options for multi-node implementation, see Multi-Node Options Summary on page 16.
l The Host Record for the Domain Name Service must point to the internal virtual IP (VIP) for the load balanced pool.
For more information, see the Domain Name Service table in Advanced Remote Management Requirements on page
9.
l Modify each [FQDN] record in the [ApAdmin].[dbo].[Server] table in the database to point to the
"admin.controlplane.aetherpal.internal" IP instead of the external VIP.
16
Chapter 3:
Install and Configure Advanced Remote
Management
Advanced Remote Management Installation Overview 18
Generate the Advanced Remote Management Certificates 18
Configure the Advanced Remote Management Installer 19
Install PowerShell Scripts 21
Install the Advanced Remote Management Server
Components 22
Import Device Profiles with the Resource Pack Utility 24
Configure the AirWatch Console 25
Configure End User Devices 25
17
Chapter 3: Install and Configure Advanced Remote Management
2. The Configure step creates an install.config file which contains the configuration settings for the different
components of the Advanced Remote Management server.
3. The Install step uses that install.config file to install the components onto the server.
2. Extract all contents from the installer package ZIP file into c:\temp of the ARM server. Do not move the files around
inside the temp folder as the installer needs all the files in their extracted locations. Do not rename or move the temp
folder.
3. Run the Remote Management Certificate Generator which is included in the installer package.
l Be certain to use the correct version of the tool according to the version of AirWatch you are using.
AirWatch Version Certificate Generator Tool Version
Pre 9.2 RemoteManagementCertificateGenerator_Before_9_2
9.2 and after RemoteManagementCertificateGenerator_9_2
l This tool must be run on a machine with the same locale settings as the database server to ensure the same date
format is set in the SQL script.
5. Navigate to Groups & Settings > All Settings > System > Advanced > Site URLs, scroll down to the External Remote
Management section, and copy the string in the Remote Management CN field.
l If the Remote Management CN field has a null value, then you must manually Create the Remote Management
CN from the AirWatch Database on page 36.
18
Chapter 3: Install and Configure Advanced Remote Management
Setting Value
Certificate Type Remote Management.
Deployment On-premises.
Certificate Common Name Paste the Remote Management CN copied from step 5 above.
8. Set Password for the certificates when prompted. Store this password for future use.
b. Copy this file to the c:\temp\certs folder on the Remote Management Server. This is the T10 Certificate which is
needed later.
l The T10 interface certificate contains two major certificates that enable AirWatch to communicate with the T10 portal.
These are the AirWatch portal Root and Intermediate certificates in a p7b file.
10. In the Artifacts folder, find the "Certificate Seed Script.sql". Run this script against the AirWatch Database to seed the
generated certificates into the AirWatch database.
l If you receive the error message "The conversion of a varchar data type to a datetime data type resulted in an
out-of-range value." then see Troubleshooting, Generate Certificates on page 34.
Next, proceed to Configure the Advanced Remote Management Installer.
l Phase two is comprised of running PowerShell scripts that are included with the installer package.
Configure the ARM Installer Phase One, make the config file.
1. Install the SSL certificate onto the Personal Certificate Store on the RM server.
The SSL certificate secures HTTPS binding for the management website for port 443 and allows a secure connection. This secure
connection is between the admin and Web services. Also, the SSL certificate secures the connection to the Connection Proctor
on port 8446. You must provide the SSL certificate as a wildcard or SAN certificate.
2. Start the Remote Management installer from the c:\temp folder on the RM server.
3. Select Next.
19
Chapter 3: Install and Configure Advanced Remote Management
Setting Description
Database Server Enter the server hostname, IP address, or loopback address (as it is a single server).
Name
DB Owner user Enter the user name of the internal ARM Database user that the installation automatically
name creates in the database.
DB Application user Enter the user name of the internal ARM Database user that the installation automatically
name creates in the database.
6. (Optional) Select the Advanced button to configure the Port, LDF, MDF, and NDF paths for the database. Ensure that
your Windows account has full access to these folders.
7. Select Next.
Note: The enrollment certificate is an SSL certificate that enables remote management devices to
enroll or register with the ARM server. The enrollment certificate also secures the connection to
the server.
Select Next.
20
Chapter 3: Install and Configure Advanced Remote Management
The following PowerShell script files are included in the installer package.
l Enable Permissions
l Create AD Objects
21
Chapter 3: Install and Configure Advanced Remote Management
l Core Services
l Portal Services
l Application Services
l Connection Proctor
3. Select Next.
5. Select Next.
22
Chapter 3: Install and Configure Advanced Remote Management
Setting Description
Enrollment Certificate Details
Enrollment Certificate Enter the password for the enrollment certificate added during the Configuration
Password portion.
Active Directory Authentication
User name Enter the Active Directory user name.
Password Enter the Active Directory password.
7. Select Next.
l Multi-Node – The SAN certificate must have an FQDN defined for each connection proctor server
and advanced remote management server.
o For example, presume you have 2 connection proctor servers and 2 advanced remote
management servers. The 2 ARM servers host portal services, which need TLS/SSL traffic
terminated at the load balancer. The FQDN for the SAN certificate must reflect the fully
qualified domain name, for instance, "rmstage01.awmdm.com".
o Meanwhile, for each of the 2 CP servers, TLS/SSL traffic terminates at the connection proctor,
and therefore, you must have 2 FQDNs defined in the SAN certificate, for instance,
"rmstage01.awmdm.com' and "rmstage02.awmdm.com'.
9. Select Next.
23
Chapter 3: Install and Configure Advanced Remote Management
Setting Description
CP certificate Select the ... button to browse for the SSL Certificate installed before starting the Configuration
portion.
This certificate is the same one used on the Authentication Credentials screen in the previous
step.
12. Select OK to confirm that you have opened the firewall ports.
3. Select Next.
4. If you have not reset the default password on the admin web portal, the Resource Pack prompts you to reset the
password. After completing the password fields, select Update Password. Ensure you store the password for future
use.
6. Once you have finished selecting device profiles, select the Import button. The right panel displays the ARM server
confirmation messages as it progresses through the importation of all the selected device profiles.
24
Chapter 3: Install and Configure Advanced Remote Management
2. Navigate to Settings > System > Advanced > Site URLs > External Remote Management.
https://rmstage01.awmdm.com/t10
Device Connection Name Enter the ARM server fully qualified domain name (FQDN).
For example:
https://rmstage01.awmdm.com
4. Select Save.
The ARM server is now ready to handle remote management sessions with end-user devices. Next, proceed to Configure
End User Devices.
2. Identify and download platform specific Remote Management agents that are applicable to your deployment.
3. You can push these apps to devices as an internal app through the App Management function in AirWatch or you
can utilize Product Provisioning.
For more information about App Management, see the VMware AirWatch Mobile Application Management
Guide.
For more information about Product Provisioning, see the VMware AirWatch Product Provisioning for Android
Guide and VMware AirWatch Product Provisioning for Windows Rugged Guide.
All of these guides and more can be found through Accessing Other Documents on page 38.
You are now ready to manage devices remotely. Next, proceed to Start an Advanced Remote Management Connection.
25
Chapter 4:
Using Advanced Remote Management
Start an Advanced Remote Management Connection 27
Advanced Remote Management Client Tools 27
Display Capture (Remote Control) 28
Manage Files 30
Command Line Interface 31
26
Chapter 4: Using Advanced Remote Management
2. Select the More Actions drop-down menu and select Remote Management.
3. In the Remote Support window, select Launch Session after the connection process completes.
4. The console displays a 4-digit PIN which you must direct the customer to enter into their device. This action provides
customer authorization to remotely manage their device.
Once the connection is made, the remote management client opens and the device is ready for use.
c. Command Line (Android Only) – Send commands to the remote device using the Command Line Interface (CLI).
Advanced Remote Management does not have the same functionality as Remote Management v3.0. The following
features are not currently available in ARM.
l Registry Manager
27
Chapter 4: Using Advanced Remote Management
Control the device by clicking or dragging on the displayed screen and buttons. You can send keystrokes to the device
and copy and paste information onto the device during a session.
If a user needs privacy, they can pause a remote control session.
28
Chapter 4: Using Advanced Remote Management
To use the whiteboard, select the whiteboard icon ( ) in the bottom right of the device screen view.
The whiteboard menu consists of the following items.
Shortcuts
The ARM client provides a shortcuts menu to navigate quickly to a screen or menu item on the device. The shortcuts icon
is on the bottom right, near the whiteboard icon.
Device Summary
The ARM client provides a device summary of information similar to Device Details. Use this information to diagnose
issues on a device while connected without navigating away from the ARM client.
The Device Summary pane provides at-a-glance information to use during troubleshooting. The pane displays signal
strength, battery, network status, storage, and main memory information. Display additional information not displayed
in the information by selecting the Additional Information ( ) icon.
29
Chapter 4: Using Advanced Remote Management
Manage Files
You can use the Manage Files client tool to upload files, download files, rename files, and delete files on the device.
Upload a File
You can upload a file to the device you are managing remotely.
1. In the active Advanced Remote Management (ARM) session and the Manage Files client tool activated, select the
red, circular Upload button in the bottom-right corner of the screen.
2. Select the Browse button and select a file accessible to the AirWatch Console you want to add to the device's file
system.
Download a File
You can download a file on the device with the Manage Files client tool.
1. In the active ARM session and the Manage Files client tool activated, locate the file on the device you want to
download. You may find the "breadcrumbs" style folder path at the top of the file listing a useful navigation aid.
2. Select the Download button. This button is located in the button cluster to the left of the Size column, between the
Rename and Delete icons.
3. Downloaded files are saved according to your default browser's downloaded file action.
Rename a File
You can rename a file on the remote device using the Manage Files client tool.
1. In the active ARM session and the Manage Files client tool activated, locate the file on the device you want to
rename.
2. Select the Rename button. This button is located in the button cluster to the left of the Size column. The Rename
screen displays where you can enter the new name for the file.
Delete a File
You can also delete a file from the remote device.
1. In the active ARM session and the Manage Files client tool activated, locate the file on the device you want to delete.
2. Select the Delete button. This button is located in the button cluster to the left of the Size column.
30
Chapter 4: Using Advanced Remote Management
2. Select the circled X button to the right of the Manage Files indicator.
31
Chapter 4: Using Advanced Remote Management
32
Chapter 5:
Troubleshoot Advanced Remote
Management
Troubleshooting, Generate Certificates 34
Troubleshooting, Remote Management Not Available -
Device Registration Issues 34
Troubleshooting, Issues Connecting to Devices 35
Troubleshooting, Modify Database Record for Multi-Node
Configuration 36
Create the Remote Management CN from the AirWatch
Database 36
33
Chapter 5: Troubleshoot Advanced Remote Management
References in this document to any specific service provider, manufacturer, company, product, service, setting, or
software do not constitute an endorsement or recommendation by VMware. VMware cannot be held liable for any
damages, including without limitation any direct, indirect, incidental, special, or consequential damages, expenses,
costs, profits, lost savings or earnings, lost or corrupted data, or other liability arising out of or related in any way to
information, guidance, or suggestions provided in this document.
Possible Cause: Registration failed or ARM agent may not have been deployed properly. ARM Agent may have not been
installed on the device properly or registration to ARM Server has failed.
Solution: Attempt to re-register the device. Update Resource portal to ensure ARM agent may be properly downloaded
and installed on device. An AirWatch Administrator must re-register the device.
34
Chapter 5: Troubleshoot Advanced Remote Management
Solution: Reinstall the certificate including intermediate and root certificate. Reinstall all the certificates for this client and
ensure that the root certificate is placed into the root certificate folder and the intermediate certificate is placed in
intermediate certificate folders in MMC certificate console.
Possible cause: Firewall is ON but misconfigured. If the firewall is incorrectly configured on the Remote Management
Server it may be preventing device registrations from being received.
Solution: Turn off firewall or set up exceptions. When the firewall is on and it is not correctly configured, it may be
preventing device registrations. Devices register with the Anchor web service, usually hosted on port 443 on the remote
management server. If this port is blocked on the firewall, registrations are jeopardized. Turn off the firewall and see if
registrations succeed. If they do, check the exceptions to ensure that the Anchor web service on port 443 or other port
defined for this service is in the list of exceptions.
Possible Cause: Incompatible web browser. The browser being used by Airwatch support staff is not compatible with
ARM.
Solution: Use a different web browser. Install or switch to a compatible browser. The following is a list of browsers
currently supported by the Remote Management Tool.
l Internet Explorer 11 or higher
l Google Chrome
l Safari
Possible Cause: Browser pop ups are blocked. The browser being used is blocking pop-up windows from the ARM portal.
Solution: Enable pop-ups in browser settings. Airwatch users need to update their browser settings to allow pop-ups
from the ARM portal.
35
Chapter 5: Troubleshoot Advanced Remote Management
Possible Cause(s): Certificate mismatch, ARM server issues. Client/Server certificates may be incorrectly deployed or
there may be issues with availability of ARM server and console.
Solution: Check certificates and ensure ARM server(s) are operational. Ensure that T10 interface certificate has been
properly deployed on the ARM server(s), ensure that ARM server(s) are online and operational.
3. Copy the displayed text. This text is the SQL script to run against the AirWatch Database.
4. Switch to the AirWatch Database server and open SQL Server Management Studio.
6. On the first line of the query, replace the NULL value with the GroupID for the customer type OG that you want to
use. The OG you choose must be a customer type, it cannot be of any other type including global, partner,
container, and so on.
For example,
becomes
36
Chapter 5: Troubleshoot Advanced Remote Management
37
Accessing Other Documents
38