Wavelink Avalanche User Manual - page 67

Summary of Avalanche

  • Page 1

    Avalanche remote control user guide version 4.1.

  • Page 2

    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 ...

  • Page 3

    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 ...

  • Page 4

    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 informati...

  • Page 5

    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. Th...

  • Page 6

    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 al...

  • Page 7

    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 ...

  • Page 8

    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 ...

  • Page 9

    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 a...

  • Page 10

    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 remo...

  • Page 11

    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 ins...

  • Page 12

    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 ...

  • Page 13

    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 lic...

  • Page 14

    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 contro...

  • Page 15

    Chapter 4: using the remote control console 11 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...

  • Page 16

    Chapter 4: using the remote control 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 chan...

  • Page 17

    Chapter 4: using the remote control 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 t...

  • Page 18

    Chapter 4: using the remote control 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 ...

  • Page 19

    Chapter 4: using the remote control 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 vie...

  • Page 20

    Chapter 4: using the remote control 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 remote control database backup: 1 from the remote control console, click backup in t...

  • Page 21

    Chapter 4: using the remote control console 17 use as default when this option is enabled, the current profile is used as the default when you 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 y...

  • Page 22

    Chapter 5: configuring the remote control client 18 chapter 5: configuring the remote control client the remote control client is configured from the avalanche console. After the package is added to a software profile, use the configuration tools in the package to modify the remote control client or...

  • Page 23

    Chapter 5: configuring the remote control client 19 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 devi...

  • Page 24

    Chapter 5: configuring the remote control client 20 allow client configuration grants client configuration control to the mobile device user. This allows the user to configure the remote control client from the mobile device. When the mobile device user has configuration control, any changes you mak...

  • Page 25

    Chapter 5: configuring the remote control client 21 note: if you do not have java installed locally, click install java in the configure column. After installing java, the configure option will be available. 3 depending on your browser and security settings, you may be prompted to trust the wavelink...

  • Page 26

    Chapter 5: configuring the remote control client 22 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 ...

  • Page 27

    Chapter 5: configuring the remote control client 23 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...

  • Page 28

    Chapter 5: configuring the remote control client 24 client sleep while connected allows the mobile device to enter sleep mode while connected to remote control. If you do not enable this option, remote control will not allow the mobile device to enter sleep mode while connected. Allow client configu...

  • Page 29

    Chapter 5: configuring the remote control client 25 mobile device profile details 4 in the remote control settings panel, configure the options as desired. 5 save your changes..

  • Page 30

    Chapter 6: connecting to mobile devices 26 chapter 6: connecting to mobile devices after you configure the client and server settings, deploy the remote control client to the mobile device. Once the mobile device has the client installed, and you have added remote control licenses through avalanche,...

  • Page 31

    Chapter 6: connecting to mobile devices 27 note: 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 invento...

  • Page 32

    28 standard viewer tasks this section provides information about using remote control once you are connected to a mobile device. The tasks detailed in this section assume you are connected to a mobile device. Note: there are two different viewer interfaces, depending on how you initiated the remote ...

  • Page 33

    29 stop record . Stops a video recording. Camera . Takes a picture of the current mobile device screen. Toggle skin . Toggles whether a skin for the device is displayed or not. Refresh . Refreshes the mobile device screen. Zoom in . Zooms in on the mobile device display. Zoom out . Zooms out on the ...

  • Page 34

    30 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: 1 click on the file system tab. 2 navigate to the location where you want to create the new folder. 3 right-click and select new . The fol...

  • Page 35

    31 4 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. 5 once the file transfer is complete, click ok . Note: you can also drag files directly from the pc and drop them into the file...

  • Page 36

    32 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 d...

  • Page 37

    33 3 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: 1 open the registry viewer. 2 navigate...

  • Page 38

    34 • 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. 4 using the configuration options availabl...

  • Page 39

    35 deleting key values you can delete registry key values that you no longer need. To delete key values using the standard viewer: 1 click the registry viewer tab. 2 navigate to the location of the key you want to delete. 3 right-click the key and select delete . A dialog box appears asking you to c...

  • Page 40

    36 a dialog box appears. 3 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 de...

  • Page 41

    37 process manager 2 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: • viewing and ...

  • Page 42

    38 to clear the log file: 1 click the access log tab. 2 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: • critical . This level writes the least information ...

  • Page 43

    39 • 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 optio...

  • Page 44

    40 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 • using device sk...

  • Page 45

    41 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 connectio...

  • Page 46

    42 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: 1 from the standard viewer, click file > configure . The configure dialog box appears. 2 from the refresh rat...

  • Page 47

    43 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. • if you wan...

  • Page 48

    44 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. • if you want to us...

  • Page 49

    45 the new recording information is applied. To record the avi file: 1 in the standard viewer, click the record toolbar icon. The save as dialog box appears. 2 name the file and click save . The video compression dialog box opens. 3 configure the compression options and click ok . 4 from the device ...

  • Page 50

    46 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. • if you want to us...

  • Page 51

    47 web viewer tasks this section provides information about using the remote control web viewer once you are connected to a mobile device. The tasks detailed in this section assume you are connected to a mobile device. For information about creating a connection session, see connecting to mobile dev...

  • Page 52

    48 the device tab the device tab in the web viewer allows you to interact with the device and view its access history and logs. You can also perform tasks such as a reboot or device sync. The tab has four panels: device description panel the device description panel on the web viewer device tab prov...

  • Page 53

    49 reboot performs a warm boot of the device. The connection session is terminated. Suspend sends the device into a suspended (sleep) state. The connection session is terminated. Text message sends an sms text message to the mobile device. Device sync sends an sms message to the device requesting it...

  • Page 54

    50 • use the add directory and delete directory options to change the file structure. Remote control will make the changes on the device as you perform the desired tasks. Using the registry explorer from the registry tab in the web viewer, you can view and edit the registry of a connected mobile dev...

  • Page 55

    51 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: • identification, including oem information and...

  • Page 56

    Chapter 7: managing device skins 52 chapter 7: managing device skins skins display an image of the mobile device in the standard viewer. To reduce the size of the software package, remote control is only packaged with a select number of device skins. However, a variety of device skins from major man...

  • Page 57

    Chapter 7: managing device skins 53 the skins download dialog box appears. Skins download 2 click connect . You will connect to the wavelink skin download manager..

  • Page 58

    Chapter 7: managing device skins 54 skins download 3 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 ...

  • Page 59

    Chapter 7: managing device skins 55 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 followin...

  • Page 60

    Chapter 7: managing device skins 56 2 (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. 3 create a keymap image. Using a graphics design program, ...

  • Page 61

    Chapter 7: managing device skins 57 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: • normal . This image ...

  • Page 62

    Chapter 7: managing device skins 58 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 appr...

  • Page 63

    Chapter 7: managing device skins 59 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 t...

  • Page 64

    Chapter 7: managing device skins 60 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. Keys can also be...

  • Page 65

    Chapter 7: managing device skins 61 • if you want the key to be a multi-click key, enable the multi click option and configure the on click 2 , on click 3 and on click 4 options using the drop-down lists. • if you want this key to toggle the state of the mobile device (for example, act as the shift ...

  • Page 66

    Chapter 7: managing device skins 62 upload skins package to wavelink 3 enter your name, company and e-mail in the appropriate text boxes. 4 add any comments about the skin you are sending in the comments text box. 5 click ok . Remote control packages all the files used to create the selected skin an...

  • Page 67

    Chapter 7: managing device skins 63 3 the select a profile dialog box appears. 4 click the name of the connection profile with the desired skin from the list. 5 click save . 6 the skin will appear when you view the device. To apply a skin while you are connected with the standard viewer: 1 from the ...

  • Page 68

    Ports list 64 ports list the following table provides information about the default ports used with remote control and avalanche. Usage port type rc server console/ viewer rc client contacting a mail server (optional) 25 1 110 2 tcp out n/a n/a device connection 3 1899 tcp in/out out in/out server c...

  • Page 69

    Wavelink contact information 65 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 americ...