Table of Contents

Advertisement

Avalanche Remote Control
User Guide
Version 4.1

Advertisement

Table of Contents
loading

Summary of Contents for Wavelink Avalanche

  • Page 1 Avalanche Remote Control User Guide Version 4.1...
  • Page 2 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.
  • Page 3: Table Of Contents

    Table of Contents Chapter 1: Introduction Remote Control Components About This Guide Chapter 2: Installing Avalanche Remote Control 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...
  • Page 4 Using the Process Manager Viewing Device Information Chapter 7: Managing Device Skins Downloading Skins Accessing the Skins Editor Creating and Editing Skins Importing Images Configuring Skin Information Creating Key States Configuring Key Actions Packaging Skins Applying Skins Ports List Wavelink Contact Information...
  • Page 5: Chapter 1: Introduction

    • 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.
  • Page 6: About This Guide

    Chapter 1: Introduction 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 The Courier New font is used for any keyboard commands, filenames, and file paths.
  • Page 7: Chapter 2: Installing Avalanche Remote Control

    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.
  • Page 8: Installing The Remote Control Server On Windows

    Chapter 2: Installing Avalanche Remote Control Server System Requirements 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...
  • Page 9: Installing The Remote Control Server On Linux

    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...
  • Page 10: 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.
  • Page 11 Chapter 2: Installing Avalanche Remote Control Click Browse to navigate to and select the folder where you want to create Remote Control shortcuts in the Start menu. Click Next. The Ready to Install screen appears. Click Install to begin the installation.
  • Page 12: Chapter 3: Licensing

    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.
  • Page 13: Activating Remote Control Licenses

    Click Activate a License. The Activate a License dialog box appears. 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.
  • Page 14: 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.
  • Page 15: Chapter 4: Using The Remote Control 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.
  • Page 16: Changing The Username And Password

    To configure the license server information from a web browser: From the Remote Control Console, click Licensing in the System Menu. Type the address of the Avalanche server in the License Server text box. The default Port for the license server is 7221.
  • Page 17 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.
  • Page 18: Configuring Skin Settings For The Server

    Configuring Skin Settings 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: From the Remote Control Console, click Skins in the System Menu.
  • Page 19: Managing Cell Carriers

    Backing Up and Restoring the Remote Control 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...
  • Page 20: Viewing System Information

    Chapter 4: Using the Remote Control Console To back up the Remote Control database: From the Remote Control Console, click Backup in the System Menu. Click Backup. A backup is created locally. To restore a Remote Control database backup: From the Remote Control Console, click Backup in the System Menu. In the Restore area, select the backup that you want to restore.
  • Page 21 Chapter 4: Using the Remote Control Console Use as When this option is enabled, the current profile is used as the default when you default establish a connection. If you want to establish a connection using a profile other than the default profile, you can set the profile from the viewer while you are connected.
  • Page 22: Chapter 5: Configuring The Remote Control Client

    The package can also be configured so that the Client can be configured from the device after it is installed. If the device user configures the Client, the user at the Avalanche Console still has the option to clear the settings.
  • Page 23 Chapter 5: Configuring the Remote Control Client Connection Policy Select how Remote Control notifies the mobile device user that Remote Control is establishing a connection. • Silent indicates that the user will not be notified. • Notify indicates that the user will see a text window on his device letting him know that a connection has been established.
  • Page 24 Chapter 5: Configuring the Remote Control Client Allow Client Grants client configuration control to the mobile device user. This Configuration allows the user to configure the Remote Control client from the mobile device. When the mobile device user has configuration control, any changes you make in the Client Settings tab from the Remote Control Console will not deploy to the device.
  • Page 25: Configuring Client Settings From The Mobile Device

    Depending on your browser and security settings, you may be prompted to trust the Wavelink certificate. If you are prompted to select the program to use for opening the file, choose Java Web Start Launcher from the list and click OK.
  • Page 26: Clearing Client Settings

    Chapter 5: Configuring the Remote Control Client Policy Select how Remote Control notifies the mobile device user that Remote Control is establishing a connection. Silent indicates that the user will not be notified. Notify indicates that the user will see a text window on his device letting him know that a connection has been established.
  • Page 27: Using A Mobile Device Profile For Remote Control Settings

    Chapter 5: Configuring the Remote Control Client including anything that was configured on the mobile device. This option is useful if you have enabled the Allow Client Configuration option. To clear client settings: • From the Standard Viewer, click Tools > Clear Client Settings. Using a Mobile Device Profile for Remote Control Settings Configure Remote Control settings for a device by using a mobile device profile.
  • Page 28 Remote Control settings. To configure Remote Control settings using a mobile device profile: Log in to the Avalanche Web Console. From the Profiles tab, click the name of the mobile device profile you want to configure.
  • Page 29 Chapter 5: Configuring the Remote Control Client Mobile Device Profile Details In the Remote Control Settings panel, configure the options as desired. Save your changes.
  • Page 30: Chapter 6: Connecting To Mobile Devices

    If you launch the viewer from the Avalanche Web Console, the connection session will appear in the Web Viewer. If you launch from the Avalanche Java Console or the Remote Control Console, the connection session will appear in the Standard Viewer.
  • Page 31: Closing Remote Control Sessions

    If the device is not configured to preconnect, the device user can manually preconnect by opening the Remote Control Client and tapping File > Connect to Server. To connect to a device from the Avalanche Java Console: • From the Mobile Device Inventory tab, right-click the name of the device and select Remote Control from the context menu.
  • Page 32: Standard Viewer Tasks

    Remote Control connection. If you launched from the Avalanche Java Console, Remote Control will use the Standard Viewer. If you launched from the Avalanche Web Console, Remote Control will use the Web Viewer. You cannot connect to a device with both the Standard Viewer and the Web Viewer at the same time.
  • Page 33: Accessing The File System

    Remote Control connection session. Access the File Explorer by opening the Standard Viewer clicking the File System tab. You can also access the File System from the Avalanche Mobile Device Details dialog box. Click the Device Control tab and then double-click the File System icon.
  • Page 34: Creating New Folders

    Creating New Folders You can create and name directories on the device using the File Explorer. To create a new folder on the device from the Standard Viewer: Click on the File System tab. Navigate to the location where you want to create the new folder. Right-click and select New.
  • Page 35: Manipulating Files On The Device

    Locate the file that you want to copy to the mobile device and click Open. The Sending Files Status dialog box appears. The files are copied to the selected location. Once the file transfer is complete, click OK. NOTE: You can also drag files directly from the PC and drop them into the File Explorer. Manipulating Files on the Device From the File Explorer, you can run, open, view or delete files located on the mobile device.
  • Page 36: Using The Registry Viewer

    Using the Registry Viewer From the Registry Viewer tab in the Standard Viewer, you can browse and view the registry of a connected mobile device. Access the device's registry from the Standard Viewer by clicking the Registry Viewer tab. You can also access the Registry Viewer through the Mobile Device Details dialog box.
  • Page 37: Viewing Binary Data

    Right-click and from the menu that appears, select the key value you want create. The value appears in the file list box. Viewing Binary Data For any registry key, you can display the binary data for that key. To view binary data using the Standard Viewer: Open the Registry Viewer.
  • Page 38: Editing Binary Data

    • If you are modifying a String or Binary value, the Edit String dialog box appears. • If you are modifying a DWORD key value, the Edit DWORD Value dialog box appears. • If you are modifying a Multi-String value, the Edit Multi-String dialog box appears. Using the configuration options available in each dialog box, edit the key value.
  • Page 39: Deleting Key Values

    Deleting Key Values You can delete registry key values that you no longer need. To delete key values using the Standard Viewer: Click the Registry Viewer tab. Navigate to the location of the key you want to delete. Right-click the key and select Delete. A dialog box appears asking you to confirm that you want to delete this key value.
  • Page 40: Using The Process Manager

    A dialog box appears.   If you are comparing it to a saved registry, select the Existing Registry option and click OK. In the dialog box that appears, navigate to the location of the registry to which you want to compare and click Open. -Or- If you are comparing it to the registry of another device, select Another Device and click OK.
  • Page 41: Accessing The Log File

    Process Manager Select a process and right-click to Activate or Kill that process. Accessing the Log File The Remote Control logging feature stores information about the connection sessions for Remote Control. This section provides information about the following logging options: •...
  • Page 42: Configuring Logging

    To clear the log file: Click the Access Log tab. From the Edit menu, select Clear Log. -Or- Right-click within the log and select Clear Log. The Access Log tab clears. Configuring Logging Remote Control supports the following log levels: •...
  • Page 43: Viewing Device Information

    • If you want to use your updated changes, but do not want to update the configuration file, select the Use New Configuration option. • If you want to use your updated changes and update the configuration file to reflect those changes, select the Use New Configuration and Update config file option.
  • Page 44: Configuring Display And Capture Options

    Device Info Configuring Display and Capture Options When you create a Remote Control connection session, you can configure the following display and capture options: • Setting Video Mode • Configuring Display Refresh Rates • Sizing the Mobile Device Display • Toggling Statistics •...
  • Page 45: Setting Video Mode

    Setting Video Mode You can set two types of video mode depending on how you want the mobile device screen to appear and how fast you want the program to run. • Standard Mode. This mode provides the clearest, most accurate screen images. However the refresh rate is slower over wide area connections.
  • Page 46: Sizing The Mobile Device Display

    NOTE: You can also configure the refresh rate option when you configure the Client. For more information, see Editing the Remote Control Package on page 18. To configure the refresh rate: From the Standard Viewer, click File > Configure. The Configure dialog box appears. From the Refresh Rate drop-down list, select the rate at which you want the screen display to refresh.
  • Page 47: Toggling Statistics

    The Configuration Data Change dialog box appears. This dialog box indicates that you changed something from the original profile configuration. • If you want to use your updated changes, but do not want to update the device configuration file, select the Use New Configuration option. •...
  • Page 48: Recording Videos

    The Configuration Data Change dialog box appears. This dialog box indicates that you changed something from the original profile configuration. • If you want to use your updated changes, but do not want to update the configuration file, select the Use New Configuration option. •...
  • Page 49: Performing Screen Captures

    The new recording information is applied. To record the AVI file: In the Standard Viewer, click the Record toolbar icon. The Save As dialog box appears. Name the file and click Save. The Video Compression dialog box opens. Configure the compression options and click OK. From the Device tab in the Standard Viewer, perform the actions on the mobile device that you want to record.
  • Page 50: Using Device Tools

    The Configuration Data Change dialog box appears. This dialog box indicates that you changed something from the original profile configuration. • If you want to use your updated changes, but do not want to update the configuration file, select the Use New Configuration option. •...
  • Page 51: Web Viewer Tasks

    Remote Control connection. If you launched from the Avalanche Java Console, Remote Control will use the Standard Viewer. If you launched from the Avalanche Web Console, Remote Control will use the Web Viewer. You cannot connect to a device with both the Standard Viewer and the Web Viewer at the same time.
  • Page 52: The Device Tab

    Status The connection status of the device. OEM Info OEM info as reported by the device. Server Address Address for the Avalanche Mobile Device Server. Ava Term ID Terminal ID assigned to the device by Avalanche. Last Seen Last time the device was connected to.
  • Page 53: Using The File Explorer

    Control connection session. This enables you to view, copy, rename, or delete files and perform tasks on the mobile device. To use the File Explorer: From the Avalanche Web Console, navigate to the Mobile Device Details page and click File Explorer. -Or- After you have established a Remote Control session with the device, click the Files tab in the Web Viewer.
  • Page 54: Using The Registry Explorer

    Activating a process brings that process to the front of any other programs running on the mobile device. Killing a process stops the process. To use the Process Manager: • From the Avalanche Web Console, navigate to the Mobile Device Details page and click Process Manager. -Or- •...
  • Page 55: Viewing Device Information

    Remote Control will make the changes on the device as you perform the desired tasks. Viewing Device Information The Device Info tab in the Web Viewer provides information about the mobile device to which you are connected. This information includes: •...
  • Page 56: Chapter 7: Managing Device Skins

    Remote Control is only packaged with a select number of device skins. However, a variety of device skins from major manufacturers is available from the Skin Download Manager on the Wavelink web site. You also have the option of creating a new skin.
  • Page 57 Chapter 7: Managing Device Skins The Skins Download dialog box appears. Skins Download Click Connect. You will connect to the Wavelink Skin Download Manager.
  • Page 58: Accessing The Skins Editor

    Chapter 7: Managing Device Skins Skins Download Click on the name of the skin you want to download. NOTE: For each skin, there may be a number of different keyboard configurations. Be sure to select the skin with the keyboard configuration matching your device. The skin files are downloaded to the \Skins folder in the Remote Control installation directory.
  • Page 59: Creating And Editing Skins

    Chapter 7: Managing Device Skins To access the Skins Editor: • Click Start > Programs > RC Skins Editor 4.1 > Skins Editor. To view split screen: • From the View menu, select Split Device View. Split Screen Creating and Editing Skins In order to create a new skin, you must complete the following tasks: Create an image of the mobile device.
  • Page 60 Chapter 7: Managing Device Skins (Optional) Create a down image of the mobile device. Using a graphics design program, create an image of the mobile device when a key is in a down state. The down image can be the same as the main image. Create a keymap image.
  • Page 61: Importing Images

    Chapter 7: Managing Device Skins Importing Images Import the images you created of the mobile device into the Skins Editor. Imported images will be available to display in the Standard Viewer when you connect to a mobile device. You can import the following types of images: •...
  • Page 62: Configuring Skin Information

    Chapter 7: Managing Device Skins Configuring Skin Information Create a new skin file before importing skin images. The skin file contains the device information for that specific skin. Remote Control uses this information to detect the type of device it is connecting to and then displays the appropriate skin. You can configure the following types of skin information: •...
  • Page 63: Creating Key States

    Chapter 7: Managing Device Skins Once you enter information for the mobile device, you are ready to import the images of the device that you have created. Creating Key States Using key states, you can create many different actions for each mobile device key. For example, you can configure a key to send "a"...
  • Page 64: Configuring Key Actions

    Chapter 7: Managing Device Skins Configuring Key Actions You can configure key behavior for each button you created in your keymap image for the mobile device skin. The key can be configured differently depending on the state the device is in or how many times the key is pressed.
  • Page 65: Packaging Skins

    Only a certain number of skins are included with the Remote Control software package. However, you can access and import other skins with the Wavelink web site Skins Download Manager. Additionally, if you create new skins for mobile devices, you can package the skins and upload them to the Wavelink Web site for other Remote Control users to access.
  • Page 66: Applying Skins

    Click OK. Remote Control packages all the files used to create the selected skin and send the package to Wavelink. Wavelink then posts the skin on the Skins Download Manager, allowing other Remote Control users to download it. Applying Skins You can apply or change a skin from either the Web Viewer or the Standard Viewer when you are connected to a mobile device.
  • Page 67 Chapter 7: Managing Device Skins The Select a profile dialog box appears. Click the name of the connection profile with the desired skin from the list. Click Save. The skin will appear when you view the device. To apply a skin while you are connected with the Standard Viewer: From the File menu in the Standard Viewer, select Configure.
  • Page 68: Ports List

    For POP3. For Avalanche On Demand or WAN connections, this port must be forwarded from the public IP to the internal server address. This is the default port for a PostgreSQL database. If you are using a custom port for PostgreSQL or if you are using Oracle or MS...
  • Page 69: Wavelink Contact Information

    Wavelink Contact Information Wavelink Contact Information Visit our web site at www.wavelink.com. If you have comments or questions regarding this product, please contact Wavelink Customer Service. E-mail Wavelink Customer Support at: CustomerService@wavelink.com For customers within North America and Canada, call the Wavelink Technical Support line at 801-316-9000 (option 2) or 888-699-9283.

Table of Contents