Avalanche Site Edition

Transcription

1 Avalanche Site Edition Version 4.8 avse ug Revised 03/20/2009

2 ii Copyright 2008 by Wavelink Corporation All rights reserved. Wavelink Corporation 6985 South Union Park Avenue, Suite 335 Midvale, Utah Telephone: (801) Fax: (801) Website: 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.

3 Table of Contents 1 Table of Contents Chapter 1: Installing Avalanche SE 7 Installation Requirements Before You Begin Installing Avalanche SE Importing Avalanche Manager Backup Files Migrated Components Activating Avalanche SE Overview of Nodelocking Activating Avalanche SE Licenses Activating Automatically Activating Manually Importing a License Activating Remote Control and CE Secure Licenses Chapter 2: Avalanche SE Console 15 Launching the Avalanche SE Console Understanding Avalanche SE Console Tool Bar Quick Start Tab Alerts Tab Navigation Window/Profile Selection Understanding Edit Mode Changing Console Preferences Enable Checking for Updates Customizing Console Display Enabling Auto Assign Options Enabling Audit Logging Viewing Logged Activity Specifying the Backup Drive Location Configuring HTTP Proxy Connections Changing Report Settings Configuring Enterprise Server Settings Viewing the Enterprise Server Status Purging Statistics Performing a Dump Heap Viewing the InfoRail Status Avalanche SE Reporting Tool Using the Support Generator Using the Enabler Installation Tool Chapter 3: Managing User Accounts 33 Creating User Accounts Creating User Groups

4 2 Wavelink Avalanche SE Assigning Regional Permissions Assigning Profile Permissions Assigning Authorized Users Assigning Authorized Users to Locations Assigning Authorized Users to Profiles Configuring Integrated Logon Changing Passwords Removing User Accounts Chapter 4: Managing Locations and Sites 45 Creating Sites Viewing Mobile Devices Within Sites Pinging Mobile Devices within Sites Sending Messages to Sites Editing Site Properties Additional Site Functions Manually Assigning Profiles Monitoring the Mobile Device Server Stopping the Server Starting the Server Viewing Server Properties Reinitializing the Mobile Device dserver Monitoring Server Status Chapter 5: Managing Network Profiles 53 Creating Network Profiles Configuring Network Profile General Settings Enabling a Network Profile Managing IP Address Pools Viewing Where Network Profiles Are Applied Adding Network Profile Authorized Users Network Profile Selection Criteria Configuring Epoch Settings Creating Epochs Wireless Settings Encryption Methods Authentication Methods Network Profile Configuration Descriptions Network Profile General Settings Selection Criteria Settings Epochs Configuration Settings Network Settings Tab Wireless Settings Tab Chapter 6: Managing the Mobile Device Server 69 Configuring Mobile Device Server General Settings

5 Table of Contents 3 Configuring Mobile Device Server Log Files Suppressing Mobile Device Server Statistics Configuring User Files Viewing Where Mobile Device Server Profiles Are Applied Mobile Device Server Profile Authorized Users Releasing Licenses Setting the Terminal ID Configuring Device Connections Setting COM Ports Enabling the RAPI Gateway Configuring Connection Settings Enabling Encryption Enabling Authentication Enabling Secondary Server Support Configuring Server Updates Scheduling Server Updates Configuring Update Restrictions Viewing Mobile Device Server Licensing Messages Reinitializing the Mobile Device dserver Chapter 7: Managing Software Profiles 87 Creating Software Profiles Adding Software Profiles Adding Software Profiles Using the Wizard Editing Software Profiles Enabling Software Profiles Software Profile Selection Criteria Viewing Where Software Profiles Are Applied Software Profile Authorized Users Managing Software Packages Installing Software Packages Installing an Avalanche Software Package Building New Software Packages Installing CAB or MSI Packages Copying a Software Package Configuring Software Packages Settings Configuring Software Packages Copying Software Packages Enabling Software Packages Moving Software Packages Configuring Software Packages for Delayed Installation Software Profile Settings and Tables Software Profile List Software Profile General Settings Installed Software Packages Package Activation

6 4 Wavelink Avalanche SE Package Tracking Package Selection Criteria Package Distribution Chapter 8: Managing Mobile Devices 107 Mobile Device Inventory Tab Managing Device Filters Creating Device Filters Applying Device Filters Deleting Device Filters Displaying Devices Viewing Mobile Device Details Configuring Mobile Device Properties Viewing Properties Understanding Wireless Properties Understanding Real Time Properties Creating User Defined Properties Creating Device Side Properties Editing Properties Deleting Properties Software Inventory Controlling the Mobile Device Pinging Mobile Devices Sending Messages Updating the Mobile Device Deleting Mobile Devices RAPI Gateways Using Remote Control Launching the Session Monitor Launching the Wavelink Communicator Device Statistics Chapter 9: Managing Mobile Device Groups 125 Creating Mobile Device Groups Creating Static Mobile Device Groups Adding Devices to Static Mobile Device Groups Removing Devices from Static Mobile Device Groups Creating Dynamic Mobile Device Groups Adding Mobile Device Group Authorized Users Pinging Mobile Devices within Mobile Device Groups Sending Messages to Mobile Device Groups Editing Properties for Mobile Device Groups Additional Mobile Device Group Functions Chapter 10: Managing Alerts 133 Managing Alert Profiles

7 Table of Contents 5 Creating Alert Profiles Enabling Alert Profiles Viewing Where Alert Profiles Are Applied Configuring Alert Profiles Alert Profile Authorized Users Removing Alert Profiles Creating Contact Lists Importing E mail Addresses Removing Contacts Creating Proxy Pools Deleting Proxies Using the Alert Browser Acknowledging Alerts Clearing Alerts Customizing Alert Browser Functionality Alert Profile Descriptions Alert Profile List Alert Profile General Settings Chapter 11: Managing Update Profiles 147 Adding Update Profiles Configuring Update Profile General Settings Viewing Where Update Profiles Are Applied Adding Update Profiles Authorized Users Scheduling Exclusion Windows Editing Exclusion Windows Applying Selection Criteria Chapter 12: Using Scan to Configure 153 Configuring Barcode Profiles Adding Barcode Profiles Configuring Network Settings Creating Custom Properties Adding Custom Properties Editing Custom Properties Deleting Custom Properties Editing Barcode Profiles Deleting Barcode Profiles Printing Barcodes Scanning Barcodes Chapter 13: Performing System Backups 163 Backing Up the System Restoring the System Removing Completed Tasks

8 6 Wavelink Avalanche SE Chapter 14: Selection Criteria 169 Building Selection Criteria Building Custom Properties Selection Variables Operators Appendix A: Port Information 183 Enterprise Server Ports Mobile Device Server Ports Remote Control Ports Appendix B: Avalanche SE Services 185 Services List Wavelink Authentication Service AMC Apache Tomcat Wavelink Alerts Wavelink Avalanche Service Manager Wavelink Avalanche Agent Wavelink Avalanche Enterprise Service Wavelink Deployment Wavelink Information Router Wavelink License Server Chapter 15: Glossary 187 Index 193

9 Chapter 1: Installing Avalanche SE 7 Chapter 1: Installing Avalanche SE Avalanche SE is designed to operate on a wide variety of network configurations. However, system requirements must be met to ensure optimal performance. Review requirements before installing. This chapter provides information about the following: Installation Requirements Confirm that no firewalls (WinXP or external) will block any of the required ports for communication. (Refer to Appendix A for a list of ports required to run Avalanche SE). Importing Avalanche Manager Backup Files Activating Avalanche SE Installation Requirements The following table lists the installation requirements for Avalanche SE. Item Requirement OS Windows 2000 Server (SP 4), Windows 2000 Professional (SP 4), Windows 2003 Server (SP 2 or later), Windows XP (SP 2 or later) Processor Intel Pentium 4 Processor at 2.8 GHz (or equivalent) Hard Drive 5 GB for Console 10 GB for Mobile Device Server RAM 1 GB for Console and Mobile Device Server MISC Administrator login rights Partition/Disk NTFS file system JSE Runtime Environment 5.0 (automatically installed by the Avalanche installer if not already on your system Shared file folder on the host system where the administrator has full control. Administrative rights on the system. RAPI Active Sync or later ActiveSync support connection Serial port for serial connection

10 8 Wavelink Avalanche SE Before You Begin Review the following before beginning the Avalanche SE installation: Confirm that any previous versions of Avalanche, Mobile Manager, Mobile Manager Enterprise, and PostgreSQL have been completely uninstalled, their directories removed and the Windows Services deleted. Confirm that no firewalls (WinXP or external) will block any of the required ports for communication. (Refer to Appendix A for a list of ports required to run Avalanche SE). Installing Avalanche SE When you install Avalanche SE (as a replacement for Avalanche Manager Site) you automatically create one local Location (My Location) on the machine to which you are installing Avalanche SE. A Mobile Device Server automatically installs to the local location. The Avalanche install includes the following: PostgreSQL database Localized Java update License Server To install Avalanche SE: 1 Download the Avalanche SE install. 2 Double click the file to start the installation process. NOTE At any time, you can cancel the installation process by clicking either Cancel Setup or Exit Setup. The Introduction dialog box appears. 3 Click Next to continue the installation process. The License Agreement dialog box appears.

11 Chapter 1: Installing Avalanche SE 9 4 If you agree with the terms in the License Agreement, click Yes. NOTE If you do not click Yes, you will not be able to complete the installation process. The Organization Name dialog box appears. 5 Enter the name of your organization and click Next. 6 This name will appear in the Avalanche SE Console, branding this version for your company. The Choose Destination Location dialog box appears. 7 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. Avalanche SE is installed on your system. The Setup program configures several internal components to run on your system. Once the installation is complete, you are immediately prompted to activate this installation of Avalanche SE for your network. For more information about activating Avalanche SE, refer to Activating Avalanche SE on page 11. Importing Avalanche Manager Backup Files Once you have installed Avalanche SE, you can import Avalanche Manager backup files (.abk files) using the Import Data tool. The import tool only works with Avalanche Manager 3.6 backup files. To import data from previous versions of Avalanche Manager, you must migrate to Avalanche Manager 3.6 and create the backup file from there. The import tool imports Network Profiles, Software Collections, Mobile Device Groups and the client database from the backup file into Avalanche SE. When you import a backup file, the information merges with any other information you have already configured in Avalanche SE. Once you complete the import, you need to perform a Universal Deployment to alert the Mobile Device Server of the changes.

12 10 Wavelink Avalanche SE For information about creating the Avalanche Manager backup file, refer to the Wavelink Avalanche Manager User Guide. To import a backup file: 1 Launch the Avalanche SE Console. (Start menu > All Programs > Avalanche SE >Avalanche SE Console) 2 From the File Menu, select Import > Site Backup File. The Import Data dialog box appears. 3 Navigate to the location of the.abk file and select Open. A status dialog box appears as the file imports to the My Enterprise level. When the import is complete, the Import Result dialog box appears indicating whether the import was successful. 4 Click OK to close the dialog box. The data from the backup file is imported to Avalanche SE and the database. Migrated Components The following table lists the Avalanche Manager data that is migrated to Avalanche SE. Avalanche Manager Component Migrated to: Enterprise License Enterprise License License file (wavelink.lic) License file (wavelink.lic) The License file in Avalanche Manager will only be applied to the local Mobile Device Server and will not appear in the license server. Contact Wavelink Customer Service at for more information. Network Profile Network Profile Network Profiles will appear in the Network Profiles tab. Any profiles that were enabled in Avalanche Manager will be deployed and active immediately. Table 1-1: Components Migrated from Avalanche Manager to Avalanche SE

13 Chapter 1: Installing Avalanche SE 11 Software Collections Software Profiles Software Profiles will appear in the Software Profiles tab with the same names and settings as were configured in Avalanche Manager. Mobile Device Groups Mobile Device Groups Static Device Groups will not automatically contain mobile devices for the group. You will need to add matching devices to the group from the Properties dialog box for that mobile device group. The eserver will contact the Mobile Device Server and pull the devices that match the static group into the group. Mobile Device Inventory Mobile Device Inventory Table 1-1: Components Migrated from Avalanche Manager to Avalanche SE Activating Avalanche SE This section provides the following information about activating your Avalanche SE license: Overview of Nodelocking Activating Avalanche SE Licenses Activating Remote Control and CE Secure Licenses NOTE You do not need a license to configure and deploy Telnet Client packages. The Telnet Client is pre licensed to communicate with Avalanche SE allowing you to deploy Telnet Client packages and configurations to your mobile devices without purchasing a license. Overview of Nodelocking After you install Avalanche SE, you are asked to license it with a valid license code. This code uses a technique called nodelocking, in which Avalanche SE is licensed only for a specific computer, or node, on your network. A node is defined as several specific system attributes that, in combination, uniquely distinguish it from any other system in your organization.

14 12 Wavelink Avalanche SE Once a license for Avalanche SE is activated and associated with a specific node (nodelocked) you cannot move that license to another node. If you want to move the license, you need to contact Wavelink Customer Service. Activating Avalanche SE Licenses When you activate Avalanche SE licenses, a license file called wavelink.lic is installed on your system, which provides the information the product needs to operate. There are four methods of activating Avalanche SE licenses: Activating Automatically Activating Manually Importing a License After you install Avalanche SE, the Wavelink Activation dialog box appears automatically. If you want to activate Avalanche SE immediately, you can perform one of the activation methods from this location. For each type of product license, you will need to enter a license code. If you do not want to activate Avalanche SE immediately, you can return to the Wavelink Activation dialog box at a later time by selecting Start > Programs > Wavelink Avalanche SE > Activate. Activating Automatically If Avalanche SE resides on a system that has Internet access, you can use the automatic license activation. When you use the automatic activation method, Avalanche SE connects with a secure Wavelink web site to verify your license. A nodelock and a license file are sent to your host system. The license file called wavelink.lic is installed on your system, which provides the information the product needs to operate. To activate Avalanche SE: 1 Obtain the Avalanche SE product licensing code from Wavelink. NOTE You receive this information in an e mail from Wavelink upon purchasing Avalanche SE.

15 Chapter 1: Installing Avalanche SE 13 2 Access the Wavelink Activation dialog box by clicking Start > Programs > Wavelink Avalanche SE > Activate. 3 Type your license number for this installation in the Product License text box. 4 Click Activate. Avalanche SE connects with a secure Wavelink Web site, your license and nodelock are verified, and a license file is sent to your host system. A new dialog box appears, displaying your licensing information and asking if you want to save the information for this installation. 5 Click Yes to accept the license file and activate your installation. The Wavelink licensing process ties Avalanche SE to a specific computer on your network. If a situation requires you to re install Avalanche SE on a different system, please contact Wavelink Customer Service to unlock your license from that system. Once the license is unlocked, you can re install the product on a new system. Activating Manually If the server is not connected to the Internet or if you have problems with the automatic activation, you can activate your license manually. To activate your license manually you will need the following information: Node lock for the system. You can get this information from the Wavelink Activation dialog box. Product license code. This information comes from the e mail you receive from Wavelink upon purchasing Avalanche SE. To manually activate a license: 1 Obtain the information needed for the product license. 2 Open a Web browser and navigate to activation. 3 Enter the Hardware Node Lock and the License code in the text boxes. 4 Click Activate button to activate license.

16 14 Wavelink Avalanche SE The Wavelink activation server verifies the information you entered and provides you a link to download the wavelink.lic file if your node lock and license key are valid. 5 Click on the link and change Save As type to All Files. 6 Download the file to desired location. 7 Move wavelink.lic file to system with where Avalanche SE is installed. 8 Follow the steps to import a license into your Avalanche SE installation. Importing a License If you already have a license file for Avalanche SE or if you have received a wavelink.lic file using the manual activation method, you can activate the file by importing it. You have the option of importing multiple license files or consolidating several files. To import a license: 1 Access the Wavelink Activation dialog box by clicking Start > All Programs > Wavelink Avalanche SE > Activate. 2 Click Browse and navigate to the location of the wavelink.lic file. 3 Select the wavelink.lic file and click Yes. 4 In the Wavelink Activation dialog box, click Close. Activating Remote Control and CE Secure Licenses You can use any of the four activation methods to activate both Remote Control and CE Secure licenses. However, you need to obtain the correct product license for the specific program you want to activate. To obtain both Remote Control and CE Secure product licenses, contact Wavelink Customer Service. Refer to Activating Automatically on page 12, Activating Manually on page 13 and Importing a License on page 14 for steps to activate licenses.

17 Chapter 2: Avalanche SE Console 15 Chapter 2: Avalanche SE Console You interact with your wireless network primarily using the Avalanche SE Console. This section contains the following topics: Launching the Avalanche SE Console Understanding Avalanche SE Console Understanding Edit Mode Changing Console Preferences Configuring Enterprise Server Settings Viewing the InfoRail Status Avalanche SE Reporting Tool Using the Support Generator Using the Enabler Installation Tool Launching the Avalanche SE Console Launch the Avalanche SE Console from the Programs menu or from a shortcut. To start the Avalanche SE Console: 1 From the Start menu, select Programs > Wavelink Avalanche SE > Avalanche SE Console. The Wavelink Avalanche Mobility Center Login dialog box appears. 2 Enter your Login and Password. Avalanche SE is installed with a default user login of amcadmin and password of admin. Wavelink recommends you create a new password for this admin account once you log in. For information about changing passwords, refer to Chapter 3: Managing User Accounts on page 33.

18 16 Wavelink Avalanche SE 3 From the Login Domain drop down list, select your domain. 4 From the Server drop down list, select your host (the enterprise server). 5 Click Connect. The EServer Login dialog box appears. This dialog box indicates the progress of the Console as it attempts to contact the Enterprise Server. The Console will wait indefinitely for the Enterprise Server to respond. If your Console cannot contact the Enterprise Server, you may cancel the login. If the login fails due to credential authorization issues, a dialog will appear indicating such. When your console contacts the Enterprise Server and your credentials are valid, the Avalanche SE Console appears. If there are updates available, a dialog box will appear asking if you want to download the updates. You can download the updates or save the updates for the next time you launch the console. Understanding Avalanche SE Console The Avalanche SE Console consists of various tools to manage your wireless network. These tools are located in the Navigation Window, which also provides a tree view of the your enterprise, location, and mobile device groups. In addition, the Console contains tabs and tool bar options that provide you information regarding wireless network configuration and activity. The Avalanche SE Console consists of the following areas: Tool Bar Quick Start Tab Alerts Tab Navigation Window/Profile Selection

19 Chapter 2: Avalanche SE Console 17 Tool Bar The following table provides information about each Tool Bar button. Click this button to log out of the Avalanche SE Console and log in as a different user. Click this button to log out of the Avalanche SE Console. You will not be prompted to log in as another user. Click this icon to open the User Management dialog box. You can edit your list of users and permissions in this dialog box. Click this icon to open the Task Scheduler to perform backups. Click this icon to open the Contact Manager dialog box. This allows you to edit the e mail addresses associated with alert profiles. Click this icon to open the Proxy Pool Manager dialog box. This allows you to edit your proxies associated with alert profiles. Click this icon to open the Scan to Config dialog box. This allows you to create new barcode profiles, edit network settings associated with barcodes and to print barcodes. Click this icon to launch the Avalanche SE Report Console. Quick Start Tab When you first launch the console, the Quick Start tab displays. This tab provides quick links to tasks you will perform to configure your enterprise. Each task is accompanied by a brief description which you can view by clicking the plus button. For detailed information and steps about each tasks, refer to the online help or the appropriate section in the documentation. The Quick Start is divided into the following sections:

20 18 Wavelink Avalanche SE Add Network Profiles. Use the prompts to create and begin configuring a network profile. FOr details about configuration options, refer to Chapter 5: Managing Network Profiles on page 53 for details. Add Device Software. Use the Add Device Software Wizard to guide you through creating a software profile or adding software packages. For details about using the wizard, refer to Chapter 7: Managing Software Profiles on page 87 for details. Tools (including Scan to Configure, Install Enablers and Check for Updates). Help and Support. Provides links to the Avalanche SE Help, Wavelink Support, and launches the Support Generator. For details about using the Support Generator, refer to Using the Support Generator on page 30. If you do not want to display the Quick Start, you can disable the tab by selecting View > Quick Start. You can also disable the Show Quick Start on Startup check box located on the Quick Start tab. This ensures the Quick Start does not appear each time you launch the console. Alerts Tab The Alerts Tab displays alerts that occur on your wireless network in a table format. The table displays the following information about each alert: Ack Alert Date Description Indicates whether you have acknowledged the alert. Indicates the type of alert. Provides the time and date of the alert. Provides a detailed description of the alert. Navigation Window/Profile Selection The Navigation Window is a repository for profiles that may be configured and applied to your mobile devices. Profiles determine all aspects of device configuration, such as device network connectivity and software load. The Navigation Window also provides the My Enterprise view, which is a folder containing the mobile devices. From the Navigation Window, you can access the following Profile Sets:

21 Chapter 2: Avalanche SE Console 19 Mobile Device Server Profiles. Mobile Device Server profiles manage software and network settings for mobile devices. Alert Profiles. Alert profiles manage network alerts by allowing you to configure what type of network events are captured and where alerts are sent when those events occur. Network Profiles. Network profiles manage network settings for mobile devices on an enterprise wide level. Software Profiles. Software profiles contain the tools to build software packages and install the packages on the Mobile Device Server. Update Profiles. Update profiles manage specific times when mobile devices are not authorized to contact the Mobile Device Server. Mobile Device Groups. Mobile device groups are collections of mobile devices that allow you to manage multiple devices simultaneously, using the same tools available for managing individual mobile devices. My Location and Sites. My Location contains one Device Server that communicates with wireless devices. Sites are groups of mobile devices. You can use the Search text box to locate profiles and sites in the console. Type in the name of the mobile device group or profile in the text box above the tree view. Click Search. The highlight will move to the first entry that matches the text you entered. The search is not case sensitive.if there are multiple matches, click Search until you reach the correct entry.

22 20 Wavelink Avalanche SE Understanding Edit Mode Before you can edit profiles, you must enter edit mode. To use edit mode, you employ the following icons located in the toolbar: Click Edit to enable edit mode when working with any profiles. This button because available when you create a new profile or select a profile in from the list. It also becomes available when working with properties and assigning profiles to a location. Click Cancel to erase any changes you made in edit mode. When you click Cancel, you will exit edit mode. Click Save to save configuration changes. Consider the following directives regarding the use of Edit Mode: Edit mode is required to edit profiles, Location Properties, and Site Properties. You must select a profile, create a profile or highlight a location under My Enterprise to enable the Edit button. When you enter Edit Mode, the Navigation Window will not be available until you exit Edit Mode. If you add a new profile, you will need to click Edit Mode before you can continue configuration. Changing Console Preferences You can customize features of the Avalanche SE Console from the Tools menu and Preferences dialog box. This section provides information about the following console preferences tasks: Enable Checking for Updates Customizing Console Display

23 Chapter 2: Avalanche SE Console 21 Enabling Auto Assign Options Enabling Audit Logging Viewing Logged Activity Specifying the Backup Drive Location Configuring HTTP Proxy Connections Using the Support Generator Enable Checking for Updates You can enable the Console to check for Avalanche updates each time it starts up. This option is enabled by default. When you enable the option, a dialog box, displaying any devices whose Enablers are have updates available, appears each time you launch the console. The Enabler information is based on the information the device reported the last time it checked in. From the dialog box, you can click the Download link next to the device whose Enabler you want to update. The link will direct you to the Wavelink web page containing the update. You can also access the update dialog box from the Help menu or from the Quick Start tab. To enable checks: 1 From the Tools menu, select Preferences. The Preferences dialog box appears. 2 In Startup Settings, enable the Check for updates on startup option. 3 Click OK to save your changes and close the Preferences dialog box. 4 The next time the Console is launched, it will check for additional software updates. Customizing Console Display You can configure the appearance of the Avalanche SE Console, including display size, position and default page view from the Preferences dialog box.

24 22 Wavelink Avalanche SE You can also configure the manner in which the Alert Browser manages alerts. To customize the console display: 1 From the Tools menu, select Preferences. The Preferences dialog box appears. 2 In Console Display Settings, configure the width, height, position and the frame positions for the Avalanche SE Console. 3 In Alert Browser Settings, use the text boxes to configure how many days an alert remains in the Alert Browser, the maximum number of alerts that can appear in the Alert Browser, and the maximum number of alerts to store. NOTE Alerts are stored in the database on the Enterprise Server. 4 Click OK to close the Preferences dialog box. The Avalanche SE Console updates to reflect your changes. Enabling Auto Assign Options To enable auto-options: 1 From the Tools menu, select Preferences. The Preferences dialog box appears. 2 Select Enterprise Server from the list box. 3 Enable the Auto Assign Profiles option to automatically assign all profiles and profile changes to My Enterprise. 4 Click OK to close the Preferences dialog box. Enabling Audit Logging When you enable audit logging, you can specify what types of events you want the Console to log including:

25 Chapter 2: Avalanche SE Console 23 Logon/Logoff. If you select this option, the console will track users that log on to Avalanche SE and the times the user logs on and off. Profile Applied. If you select this option, the Console will track every profile that is applied to the Location. Profile Modification. If you select this option, the Console tracks profiles that are modified and the modification that is made. The log file is stored in the default Avalanche SE location. To enable audit logging: 1 From the Tools menu, select Preferences. The Preferences dialog box appears. 2 Select Enterprise Server from the list box. 3 In Audit Log, activate the Enable Audit Logging checkbox. 4 Enable the events you want to record. 5 Click OK to close the Preferences dialog box. Viewing Logged Activity If you enable audit logging for the Console, you can view the activity from the Console Activity Log. The log provides information based on the logging preferences you set for audit logging. You can view the date and time of the Console activity, the user activity, and description of the changes that occurred. To view the Console activity: From the Tools menu, select Console Activity Log. Specifying the Backup Drive Location You can specify where you want to store any backups of Avalanche SE. The location must be a qualified path for the eserver. If you do not want to specify a path, the backups will be stored to the default location, C:\Program Files\Wavelink\AvalancheSE\backup. For information about backing up your system, refer to the Backing Up and Restoring Avalanche SE document located on the Wavelink web site.

26 24 Wavelink Avalanche SE To specify a location: 1 From the Tools menu, select Preferences. The Preferences dialog box appears. 2 Select Enterprise Server from the list box. 3 In the Backup/Restore section, enter the path where you want to save system backups. 4 Click OK to close the Preferences dialog box. Configuring HTTP Proxy Connections If you are using an HTTP proxy for external Web site location connections, you must configure HTTP proxy settings to enable the city search performed during the Avalanche SE installation process. To configure HTTP proxy settings: 1 From the Tools menu, select Preferences. The Preferences dialog box appears. 2 Select HTTP Proxy from the list box. 3 Enable the Use HTTP Proxy Server checkbox. 4 In the Host text box, type either the IP address or host name of the proxy. 5 Optionally, enter a port number in the Port text box. If no port is entered, the port will default to port If you are using Basic Authentication for the HTTP proxy, type the User Name and Password in the appropriate text boxes. Otherwise, leave these boxes blank. 7 Click OK to save your changes. The next time you create a server deployment package, the proxy server settings configured in this dialog box will be used. 8 To disable the use of a proxy, disable the Use a Proxy Server checkbox in the Preferences dialog box.

27 Chapter 2: Avalanche SE Console 25 When you disable the proxy server and save the change, all proxy settings are removed from the database. Changing Report Settings The Reporting Tool installation package contains the components to run the Reporting Tool and Apache Tomcat installation. Apache Tomcat provides an environment for the Java code to run in cooperation with a Web server. However, if you are already running a Tomcat server, you can redirect Avalanche SE to the host and port from which it is running. You may need to do this if you have more than one network card of if there were problems installing the Reporting Tool. To change report settings: 1 From the Tools menu, select Preferences. The Preferences dialog box appears. 2 Select Reporting from the list box. 3 Enter the Host address of the Tomcat Server. 4 Enter the Port number. 5 Click OK to close the dialog box. Configuring Enterprise Server Settings From the Tools menu, you can access and configure the following settings for the Enterprise Server: Viewing the Enterprise Server Status Purging Statistics Performing a Dump Heap Viewing the Enterprise Server Status You can view the status of the Enterprise Server in the eserver Console dialog box. The eserver Status lists the status (parameters and values) of the eserver. Click Refresh Status to receive the latest information from the eserver.

28 26 Wavelink Avalanche SE The following list describes the parameters and values displayed in the eserver Status: Version. Indicates the version of the eserver. Build Number. Indicates the build number of the eserver. Installation Path. Displays the installation location of the eserver. Start Time. Displays the last time the eserver was started. Current Time. Displays the current time. Uptime. Indicates how long the eserver has been running since the last start time. Messages Received. Displays the total number of messages the eserver has received. Messages Sent. Indicates the total number of messages the eserver has sent. Spillover Enabled. Indicates whether the memory spillover function is enabled (YES or NO). Spillover Threshold. Indicates the memory level before spillover takes effect. Spillover Release. Indicates the number of seconds before the spillover is released. Blackout Mode. Indicates if blackout mode is enabled. Off indicates that blackout mode is not currently in use. Mobile Device Server indicates that the server is in are in blackout mode. Priority C0 C2 Backlog indicate the number of messages coming from consoles with C0 being the highest priority and C2 being the lowest priority. Priority A0 A2 Backlog indicate the number of messages coming from the Mobile Device Server with priority A0 being the highest priority and A2 being the lowest priority.

29 Chapter 2: Avalanche SE Console 27 To view the status:: 1 From the Tools menu, select Manage eserver. The eserver Console dialog box appears. 2 In the eserver Status you can view the status of each property. 3 Click OK to save your settings. Purging Statistics To prevent database and Enterprise Server inflation, you can configure the Enterprise Server to purge logged statistics. You can configure the following: Purge Time: Set the time of day you when you want to remove the statistics. This allows you to control the timing of the activity occurring on the Enterprise Server. Number of Days to Keep: Set the number of days you want to keep the statistics before removing them. Wavelink recommends setting the days to keep statistics fairly low as the statistics accumulate quickly and the purging process could take a very long time if there are too many statistics. The maximum number of days you can set is 30. To configure purge settings: 1 From the Tools menu, select Manage eserver. The eserver Console dialog box appears. 2 In the Purging Statistics section, configure the days you want to keep the statistics and the time you want the statistics to be removed. 3 Click OK to save your settings. Performing a Dump Heap If the memory level starts to affect the performance of your Enterprise Server, you can perform a dump heap. This will dump all the live objects and classes into a file located in the default installation location. Before you perform the dump, you can also verify the thread information which can help you decide if the dump is necessary.

30 28 Wavelink Avalanche SE To perform a dump heap: 1 From the Tools menu, select Manage eserver. The eserver Console dialog box appears. 2 In the eserver Diagnostics section, click Thread Information. A dialog box appears containing the thread information. You can print this information or close the dialog box. 3 Once you have determined you want to perform the dump heap, click Dump Heap. A message appears indicating the name and the size of the dump file. 4 Click OK to exit the eserver Console. Viewing the InfoRail Status The Inforail Router coordinates communication between Wavelink Avalanche processes. The InfoRail Router Status dialog box provides information such as the version of the router, how long it has been up, the IP address etc., in the InfoRail Router Status dialog box. From this dialog box you can print or refresh the status. You can not change any of the parameters listed. To view the InfoRail status: 1 From the Tools menu, select InfoRail Router Status. The dialog box appears.

31 Chapter 2: Avalanche SE Console 29 Figure 2-1. InfoRail Router Status 2 To print the status page, click Print. 3 To refresh the statistics, click Refresh. Avalanche SE Reporting Tool Avalanche SE features the Wavelink Avalanche SE Report Console, a reporting tool that allows you to build reports based on your location, sites or device groups. Before you can connect to the Report Console, you must install the reporting utility. Contact Wavelink Customer Service to obtain the installation package. For more information about using the reporting tool, refer to the Wavelink Avalanche Reporting Tool Reference Guide.

32 30 Wavelink Avalanche SE To connect to the Avalanche SE Report Console: 1 Install the Report Console utility. 2 Click the reporting tool icon in the toolbar. Your web browser will connect to the Report Console. Using the Support Generator The Support Generator creates a.zip file that contains Avalanche SE log files and additional information you provide when you run the Support Generator. The log files complied in the.zip file include: EConsole.log EServer.log Inforail.log LicenseServer.log The Support Generator.zip files are saved to the installation location of Avalanche SE. The default location is C:\Program Files\Wavelink\AvalancheSE\SUPPORT. Once you create a.zip file, you can send the file to Wavelink Customer Service. Customer Service uses the.zip file to quickly diagnose the problem and provide a solution. To use the Support Generator: 1 From the Quick Start tab, click Support Generator. The Avalanche SE Support Generator dialog box appears. 2 From the drop down list, select the area of Avalanche SE where the problem is occurring. 3 In the Processor text box, enter your processor type. 4 In the Installed RAM text box, enter the amount of RAM you have installed.