Wavelink Avalanche User manual
Avalanche Remote Control
User Guide
Version 4.1
Copyright © 2012 by Wavelink Corporation. All rights reserved.
Wavelink Corporation
10808 South River Front Parkway, Suite 200
South Jordan, Utah 84095
Telephone: (801) 316‐9000
Fax: (801) 316‐9099
Email: customerservice@wavelink.com
Web site: http:\\www.wavelink.com
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 Wavelink Corporation. 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. Wavelink grants to the user a non‐transferable and nonexclusive
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 Wavelink. 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 Wavelink . The user agrees to maintain Wavelink’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. Wavelink reserves the right to make changes
to any software or product to improve reliability, function, or design. The information in this document is bound by the terms of the end user
license agreement.
ii
Table of Contents
Chapter 1: Introduction 1
Remote Control Components 1
About This Guide 2
Chapter 2: Installing Avalanche Remote Control 3
System Requirements 3
Installing the Remote Control Server on Windows 4
Installing the Remote Control Server on Linux 5
Installing and Configuring the Client 6
Installing the Remote Control Skins Editor 6
Chapter 3: Licensing 8
Types of Licenses 8
Activating Remote Control Licenses 9
Activating Demo Mode 10
Chapter 4: Using the RemoteControl Console 11
Changing the Username and Password 12
Synchronizing with the Avalanche License Server 12
Configuring Server Options 12
Configuring Skin Settings for the Server 14
Managing Cell Carriers 15
Backing Up and Restoring the Remote Control Database 15
Viewing System Information 16
Configuring Connection Profiles 16
Chapter 5: Configuring the Remote Control Client 18
Editing the Remote Control Package 18
Configuring Client Settings from the Mobile Device 21
Clearing Client Settings 22
Using a Mobile Device Profile for Remote Control Settings 23
Chapter 6: Connecting to Mobile Devices 26
Connecting to a Mobile Device 26
Closing Remote Control Sessions 27
Standard Viewer Tasks 28
Accessing the File System 29
Creating New Folders 30
Copying Files to the PC 30
Copying Files to the Mobile Device 30
Manipulating Files on the Device 31
Pasting Text 31
Using the Registry Viewer 32
Creating New Registry Keys 32
iii
Creating Key Values 32
Viewing Binary Data 33
Modifying Key Values 33
Editing Binary Data 34
Deleting Key Values 35
Exporting Registries 35
Comparing Registries 35
Using the Process Manager 36
Accessing the Log File 37
Viewing and Clearing Log Files 37
Configuring Logging 38
Viewing Device Information 39
Configuring Display and Capture Options 40
Setting Video Mode 41
Configuring Display Refresh Rates 41
Sizing the Mobile Device Display 42
Toggling Statistics 43
Using Device Skins 43
Recording Videos 44
Performing Screen Captures 45
Using Device Tools 46
Web Viewer Tasks 47
The Device Tab 48
Using the File Explorer 49
Using the Registry Explorer 50
Using the Process Manager 50
Viewing Device Information 51
Chapter 7: Managing Device Skins 52
Downloading Skins 52
Accessing the Skins Editor 54
Creating and Editing Skins 55
Importing Images 57
Configuring Skin Information 58
Creating Key States 59
Configuring Key Actions 60
Packaging Skins 61
Applying Skins 62
Ports List 64
Wavelink Contact Information 65
iv
Chapter 1: Introduction 1
Chapter 1: Introduction
Remote Control allows you to connect to, view, and control mobile devices from the
Avalanche Console. With Remote Control, an administrator can remotely diagnose and fix
both applications and device settings, or provide guidance for a device user. This reduces
mobile device down-time and increases productivity. Remote Control can also be used for
presenting software to an audience, rapid data entry, or automated software testing.
This section contains the following information:
• Remote Control Components
• About This Guide
Remote Control Components
Remote Control has the following components:
• Remote Control Server. The Remote Control Server facilitates network connections for
Remote Control. You can configure server connection settings and set up the SMS e-mail
gateway from the Remote Control Console.
• Remote Control Client. The client portion of Remote Control is deployed to a mobile
device as an Avalanche package and runs automatically when you start-up or reboot the
device.Once you download the Remote Control package to the mobile device, you can
configure a limited number of client settings from the device.
• Remote Control Standard Viewer. The Standard Viewer allows you to interact with a
remote device you are connected to. The Standard Viewer is accessed through the
Avalanche Java Console.
• Remote Control Web Viewer. The Remote Control Web Viewer allows you to interact
with a remote device through a web browser. The Remote Control Web Viewer is accessed
through the Avalanche Web Console.
NOTE: You cannot connect to the same device with both the Web Viewer and the Standard
Viewer at the same time.
• Remote Control Console. The Remote Control Console allows you to configure server
settings.
• Skins Editor. The Skins Editor allows you to import device skin images you download or
create and then assign keymaps to the skins. When a skin is associated with a connection,
an image of the device is displayed along with the screen, and you can click on device
buttons to perform tasks.
Chapter 1: Introduction 2
About This Guide
This guide assumes that the user is familiar with Avalanche and the wireless hardware in use.
This document uses the following typographical conventions:
Courier
New
The Courier New font is used for any keyboard commands, filenames, and file
paths. It is also used for any information you need to type in text boxes.
Examples:
Navigate to C:\deploy.
Press CTRL+ALT+DELETE.
Bold Any time this document refers to an option, such as options in a dialog box, that
option appears in the Bold text style.
Example:
Click File > Open.
Italics Any time this document refers to the titles of dialog boxes, that section appears in
the Italics text style.
Example:
The Infrastructure Profiles dialog box appears.
Chapter 2: Installing Avalanche Remote Control 3
Chapter 2: Installing Avalanche Remote Control
Remote Control comes as two separate files: the Remote Control Server installation file (.exe)
and the Remote Control software package (.ava). The installation file installs the Remote
Control server on a local computer. The Remote Control software package contains the client
software that needs to be installed on the mobile device. The software package must be added
to an Avalanche profile before it can be configured and deployed to the device.
This section provides the following installation information:
• System Requirements
• Installing the Remote Control Server on Windows
• Installing the Remote Control Server on Linux
• Installing and Configuring the Client
• Installing the Remote Control Skins Editor
NOTE: Use of Remote Desktop or other terminal services in conjunction with Wavelink
Avalanche Remote Control is not recommended.
System Requirements
There are two sets of requirements necessary to install and run Avalanche Remote Control: for
installing the Remote Control Server and for installing the Remote Control Client. You must
have Avalanche 5.2 or later (either Mobility Center or Site Edition) installed in order to use
Remote Control 4.1. Wavelink recommends installing Remote Control local to the Enterprise
Server database.
Client System Requirements
• Avalanche Enabler 3.50-12 or later versions
• Windows CE (4.2 or later), PocketPC 2003, Windows Mobile (5.0 or later), Windows XP or
Windows XP embedded devices, or Windows 7
• 200 KB of disk space
• 200 KB of Flash memory
Chapter 2: Installing Avalanche Remote Control 4
Server System Requirements
OS Windows XP Professional 32 bit
Windows Vista 32 or 64 bit
Windows 2003 Server 32 bit
Windows 2008 Server 32 or 64 bit
Windows 2008 Server R2 32 or 64 bit
Windows 7 32 or 64 bit
Linux 2.4 or 2.6 kernel
(Red Hat 7.3 or Red Hat Enterprise 4 are recommended)
1-1000 Simultaneous Connections
CPU Single Core at 2.8 GHz or greater
RAM (minimum)
(recommended)
2 GB
3 GB (using a 32-bit OS) or 4 GB (using a 64-bit OS)
Disk Space (minimum)
(recommended)
4 GB
8 GB
Installing the Remote Control Server on Windows
The Remote Control Server installation file installs the Remote Control Server. The Remote
Control software package and Client are installed separately.
NOTE: Previous versions of Remote Control should be removed before Remote Control 4.1
is installed.
To install the Remote Control Server:
1 Obtain the Remote Control Server installation file and save it on the system where you
want to install the Remote Control Server.
2 Double-click the Remote Control Server installation file.
A Welcome dialog box appears.
3 Click Next.
The Remote Control Server Password screen appears.
Chapter 2: Installing Avalanche Remote Control 5
4 Provide a username and password to use to access the Remote Control Console and click
Next.
The License Agreement screen appears.
5 Agree to the terms of the license and click Next.
The Select Destination Location screen appears.
6 Click Next to accept the default installation folder, or click Browse to navigate to a folder of
your choice. After you select an installation folder, click Next to continue the installation
process.
The Select Start Menu Folder screen appears.
7 Click Browse to navigate to and select the folder where you want to create Remote Control
shortcuts in the Start menu.
8 Click Next.
The Ready to Install screen appears.
9 Click Install to begin the installation.
The Remote Control Setup Wizard installs Remote Control.
If Remote Control is not installed local to the Avalanche Enterprise Server, you must
configure Remote Control to access the license server. For information on configuring the
Remote Control Server, see Synchronizing with the Avalanche License Server on page 12.
10 To close the installation wizard, click Finish.
Installing the Remote Control Server on Linux
The Remote Control Server installation file installs the Remote Control Server. The Remote
Control software package and Client are installed separately.
To install the Remote Control Server:
1 Modify the firewall to allow Remote Control traffic. For information on Remote Control
port usage, see Ports List on page 64.
2 Create a directory where Remote Control will be installed.
3 Extract the Remote Control tar file to the directory with the following command:
-tar -xvf [filename].tar
where [filename] is the name of the Remote Control tar file.
Chapter 2: Installing Avalanche Remote Control 6
4 Navigate to the Remote Control directory that was created in the installation
directory.
5 To start the server, type ./wlrcserv.sh
The service will run as long as the window is open. For instructions on configuring
Remote Control, see Using the Remote Control Console on page 11.
Installing and Configuring the Client
To install the Remote Control client on the mobile device, add the package to a new or existing
Avalanche software profile. After the package has been added to a profile, you can enable,
configure, and deploy it to mobile devices. For details about creating and deploying software
profiles or adding software packages in Avalanche SE or MC, see the Avalanche user guide.
When you configure the software package, you have options to configure skin and logging
options, a password to connect to the device, notification policies, and connection options
such as the server address and client preconnect. For more information on configuring the
Client from Avalanche, see Editing the Remote Control Package on page 18.
Installing the Remote Control Skins Editor
The Remote Control Skin Editor installation file installs the utility to edit Remote Control skins.
To install the Remote Control Skins Editor:
1 Obtain the Remote Control Skins editor installation file and save it on the system where
you want to install.
2 Double-click the installation file.
A Welcome dialog box appears.
3 Click Next.
The License Agreement screen appears.
4 Agree to the terms of the license and click Next.
The Select Destination Location screen appears.
5 Click Next to accept the default installation folder, or click Browse to navigate to a folder of
your choice. After you select an installation folder, click Next to continue the installation
process.
The Select Start Menu Folder screen appears.
Chapter 2: Installing Avalanche Remote Control 7
6 Click Browse to navigate to and select the folder where you want to create Remote Control
shortcuts in the Start menu.
7 Click Next.
The Ready to Install screen appears.
8 Click Install to begin the installation.
The Remote Control Setup Wizard installs the Skins Editor.
9 To close the installation wizard, click Finish.
Chapter 3: Licensing 8
Chapter 3: Licensing
Remote Control requires one license for each mobile device it manages. You can access and
configure the Remote Control Console without a license, but you will not be able to
communicate with a mobile device.
Licensing for Remote Control is handled through Avalanche. The Avalanche License Server is
responsible for supplying licenses to Remote Control mobile devices. Before you can use
Remote Control, you must activate your Remote Control licenses through Avalanche and
provide Remote Control with the address of the License Server.
This section provides the following licensing information:
• Types of Licenses
• Activating Remote Control Licenses
• Activating Demo Mode
NOTE: For information on configuring Remote Control to contact the license server, see
Synchronizing with the Avalanche License Server on page 12.
Types of Licenses
Remote Control requires a license for each mobile device it manages. When a Mobile Device
Server detects a new wireless device, a license request is sent to the License Server. The
License Server then sends a license to the Mobile Device Server to be distributed. The license
file is unique to the server and cannot be transferred to another server. Once the device
receives the license, Remote Control can connect to that device. If a license expires or is
released, the license returns to the pool of licenses at the License Server until it is requested by
another server.
NOTE: The License Server uses TCP port 7221. For the License Server to function properly,
this port must be open and not blocked by a firewall.
There are two types of licenses available with Remote Control: base and maintenance. Base
licenses are required to manage devices when using any variety of Remote Control version 4
(4.x). You will also need maintenance licenses if you have upgraded beyond version 4.1. For
example, if you upgraded to 4.5, you would need a 4.x base license and a maintenance license
for each device you want to manage.
Base licenses do not expire. Maintenance licenses are valid through a specific date. For users’
convenience, some licenses may come with a license start date. You can activate these licenses
Chapter 3: Licensing 9
and they will appear in the Licensing dialog box, but the License Server will not be able to
distribute them until the date specified.
NOTE: To obtain Remote Control licenses, please contact Wavelink Customer Service.
Activating Remote Control Licenses
In order to use your licenses for Remote Control, you need to activate them through the
Avalanche Console.
To activate Remote Control:
1 Obtain the Avalanche product licensing code from Wavelink.
NOTE: You receive this information in an e-mail from Wavelink upon purchasing Remote
Control.
2 From the Avalanche Java Console, click Tools > Manage Licensing.
The Licensing dialog box appears.
Licensing dialog box
3 Click Add a License.
The Add a License dialog box appears.
4 Click Activate a License.
The Activate a License dialog box appears.
5 Type the Product License in the text box and click Activate.
Avalanche connects with a secure Wavelink Web site and your license is verified. The
licenses appear in the Licensing dialog box.
Chapter 3: Licensing 10
Activating Demo Mode
If you are installing Remote Control for demonstration purposes, you can run the product in
demo mode. When you activate Demo Mode in Avalanche, you activate all the demo licenses
for that installation. Demo mode includes 2 base licenses for Remote Control.
To activate demo mode:
1 Access the Licensing dialog box from the Avalanche Console by clicking Tools > Manage
Licensing.
The Licensing dialog box appears.
2 Click Demo Licenses.
Avalanche and Remote Control will run in demo mode. Once demo mode has been
activated on one Console, no other Console connecting to the Enterprise Server will be able
to activate demo mode.
Chapter 4: Using the RemoteControl Console 11
Chapter 4: Using the RemoteControl Console
The Remote Control Console allows you to configure options for connecting to Avalanche,
configuring the client, downloading and using skins, and viewing system information. Access
to the Remote Control Console is limited by Avalanche user permissions. Only an Avalanche
Administrator user will be able to view all of the options.
Some Avalanche server information must be configured before you can connect a device or
manage package options. When you finish installing Remote Control, the installation process
will automatically launch a browser window, or you can navigate to the Remote Control
Console using the browser's address bar.
Once you have completed the initial configuration, you can configure the following options
from the Remote Control Console:
• Changing the Username and Password
• Synchronizing with the Avalanche License Server
• Configuring Server Options
• Configuring Skin Settings for the Server
• Managing Cell Carriers
• Backing Up and Restoring the Remote Control Database
• Viewing System Information
• Configuring Connection Profiles
To log in to the RemoteControl Console:
1 From the computer where the Remote Control server is installed, click
Start > Programs > Remote Control 4.1 > Server Setup.
-Or-
From the Avalanche Console, select the software profile that has the Remote Control
package. When you click to configure the package, the Configure Software Package dialog
box appears. Select Server Configuration from the list and click Launch Config.
2 Log in using the username and password configured during installation.
The Remote Control Console appears.
Chapter 4: Using the RemoteControl Console 12
Changing the Username and Password
The Remote Control Administrator user account is required to log in when you first configure
the server from a web browser. The default username is admin and the default password is
admin. Wavelink recommends you change at least one of these. You must log in using the
account (or an Administrator Avalanche account) in order to change it.
After you have completed the initial configuration of Remote Control and provided the
database address and password, use your Avalanche username and password to log in to
Remote Control. Avalanche user permissions will be enforced. Only an Avalanche
Administrator will be able to view the Setup or System menus.
To change the RemoteControl Administrator username and password:
1 From the Remote Control Console, click Password in the System Menu.
2 Type the new username and password in the text boxes. When you change the password,
you must type it a second time in the Retype Password text box to confirm that it is
correct.
3 Click Save.
Synchronizing with the Avalanche License Server
Remote Control must connect to the Avalanche license server in order to distribute licenses.
The port 7221 should be unblocked between the Remote Control server and the Avalanche
license server. The Avalanche license server is usually installed at the same location as the
enterprise server. Configure the Avalanche server address for Remote Control after the server
is installed from the Remote Control Console.
You can check to ensure the Remote Control server can contact the Avalanche license server
from the Remote Control Console.
To configure the license server information from a web browser:
1 From the Remote Control Console, click Licensing in the System Menu.
2 Type the address of the Avalanche server in the License Server text box. The default Port
for the license server is 7221.
3 Click Verify to check if Remote Control can contact the license server.
4 Click Save.
Configuring Server Options
The Remote Control web page allows you to configure the schedule that Remote Control uses
to sync with Avalanche and the Wavelink skins repository. It also allows you to configure the
Chapter 4: Using the RemoteControl Console 13
e-mail gateway for Remote Control, the mail server (either POP3 or SMTP) credentials and log
setting, the device timeout settings, and the VNC settings.
The Server Setup page has the following options:
Wavelink Sync tab
Enable Sync Enables or disables the Remote Control synchronization with the
Wavelink skins repository.
Schedule Schedules when Remote Control syncs with the Wavelink skins
repository. The default value means that Remote Control will sync
daily at 1 AM. Use a cron expression format.
Skins Repository The address for the Wavelink skins repository.
Wide Area tab
Host The DNS name of the mail server.
Mail From The address that will appear in the From field of the e-mail.
POP3 Host The DNS name of the POP3 host.
User The user name for the POP3 server.
Password The password for the POP3 server.
Pop Before
SMTP
When this is enabled, Remote Control will try to use the POP3 server
before it attempts SMTP.
User The user name for the SMTP server.
Password The password for the SMTP server.
Port The port used by the SMTP server.
Use Auth Determines if authentication credentials are sent to the outgoing mail
server.
Debug Mail
Session
Enables or disables a Remote Control log for sending mail.
Timeouts tab
TCP How long to wait (in milliseconds) before the TCP connection request
times out.
Chapter 4: Using the RemoteControl Console 14
Send
UDP Requests
If the server will attempt to use UDP to request the device to connect.
UDP How long to wait (in milliseconds) before the UDP connection request
times out.
SMS How long to wait (in milliseconds) before the SMS connection request
times out.
Web Session The length of time (in seconds) before the connection to the Remote
Control Console will time out.
VNC tab
Quality The quality of the Remote Control display. This is on a scale of 1-100,
where 100 is the best quality and 1 is the worst quality.
Device Refresh How often the device screen is refreshed during a Remote Control
session.
Viewer Refresh How often the viewer screen is refreshed during a Remote Control
session.
Alt Server tab
Use Alternate
Server
Specifies that the Remote Control Console should be launched using a
local server address. This option only needs to be enabled when the
server address in the Client Settings is a publicly available IP address.
(For example, if the device is using a WWAN address.)
Server Address Specifies the local Remote Control server address to use for launching
the Remote Control Console.
To configure server options from the RemoteControl web page:
1 Launch the Remote Control Console using the username configured during installation.
2 Click Server Setup in the System Menu.
3 Configure the settings as needed.
4 Click Save.
Configuring SkinSettings for the Server
The Remote Control web page allows you to enable automatic skin synchronization, view
available skins, or download skins from the Wavelink server.
To enable automatic skin synchronization:
1 From the Remote Control Console, click Skins in the System Menu.
Chapter 4: Using the RemoteControl Console 15
2 Click the Auto Sync tab.
3 Select Yes from the drop-down menu and click Update.
To view the skins available on your computer:
1 From the Remote Control Console, click Skins in the System Menu.
2 Click the Available tab.
3 Select the brand name to view all skins for that brand, or click Expand in the top right
corner to view all skins for all brands.
To download skins:
1 From the Remote Control Console, click Skins in the System Menu.
2 Click the Download tab.
3 Select the brand name to view all skins for that brand, or click Expand in the top right
corner to view all skins for all brands. When you find the skin you want, click Download.
Managing Cell Carriers
If you are using an e-mail gateway for SMS messages, select a default cellular provider for the
messages to be sent through. If your carrier is not in the list, you can add it.
NOTE: If you have some devices that use a different carrier, you can configure the carrier
on a per-device basis from the Remote Control Client.
To select your cellular provider for SMS messages:
1 From the Remote Control Console, click Carriers in the System Menu.
2 Use the Default drop-down menu to select your provider.
3 If your carrier is not in the list, click Add New.
4 Type the Name, Email Address, and the Max Length of the text message in the text boxes
and click Update. The carrier will be added to the list.
NOTE: For examples of the e-mail address format, you can view the details of carriers that
have already been configured.
Backing Up and Restoring the RemoteControl Database
Remote Control maintains its own database of device information separate from the Avalanche
databases. The Remote Control web page allows you to back up and restore the
Remote Control database. Database backups can be exported to another system for storage or
for redundancy.
Chapter 4: Using the RemoteControl Console 16
To back up the Remote Control database:
1 From the Remote Control Console, click Backup in the System Menu.
2 Click Backup.
3 A backup is created locally.
To restore a RemoteControl database backup:
1 From the Remote Control Console, click Backup in the System Menu.
2 In the Restore area, select the backup that you want to restore. Click Restore.
To export or import a backup file:
1 From the Remote Control Console, click Backup in the System Menu.
2 If you want to export a backup file to store it somewhere else, select the backup file from
the list and click Download. When you are prompted to save or open the file, save it to the
desired location.
-Or-
If you want to import a backup file that was stored somewhere else, click Browse. Use the
dialog box to navigate to and select the file. Click Upload. The file will be added to the list
of available backups.
Viewing System Information
The System Info section on the Remote Control web page allows you to view the server run
time, a list of connected devices, the license server information, and local resources.
To view the system information:
1 From the Remote Control web page, click System Info in the System Menu.
2 Select the tabs across the top to view different information.
Configuring Connection Profiles
Connection profiles allow you to define the skin displayed when a user connects to a device
using Remote Control. They are configured from the Remote Control Console.
The following options are available when configuring a connection profile:
Name The name of the connection profile.
Table of contents
