Nimsoft Unified Management Portal NimsoftMobile Guide 2.0
Document Revision History Document Version Date Changes x.x xx/xx/2012 Initial version for xxxxxxxxxxxx
Legal Notices Copyright 2012, Nimsoft Corporation Warranty The material contained in this document is provided "as is," and is subject to being changed, without notice, in future editions. Further, to the maximum extent permitted by applicable law, Nimsoft Corporation disclaims all warranties, either express or implied, with regard to this manual and any information contained herein, including but not limited to the implied warranties of merchantability and fitness for a particular purpose. Nimsoft Corporation shall not be liable for errors or for incidental or consequential damages in connection with the furnishing, use, or performance of this document or of any information contained herein. Should Nimsoft Corporation and the user have a separate written agreement with warranty terms covering the material in this document that conflict with these terms, the warranty terms in the separate agreement shall control. Technology Licenses The hardware and/or software described in this document are furnished under a license and may be used or copied only in accordance with the terms of such license. No part of this manual may be reproduced in any form or by any means (including electronic storage and retrieval or translation into a foreign language) without prior agreement and written consent from Nimsoft Corporation as governed by United States and international copyright laws. Restricted Rights Legend If software is for use in the performance of a U.S. Government prime contract or subcontract, Software is delivered and licensed as "Commercial computer software" as defined in DFAR 252.227-7014 (June 1995), or as a "commercial item" as defined in FAR 2.101(a) or as "Restricted computer software" as defined in FAR 52.227-19 (June 1987) or any equivalent agency regulation or contract clause. Use, duplication or disclosure of Software is subject to Nimsoft Corporation s standard commercial license terms, and non-dod Departments and Agencies of the U.S. Government will receive no greater than Restricted Rights as defined in FAR 52.227-19(c)(1-2) (June 1987). U.S. Government users will receive no greater than Limited Rights as defined in FAR 52.227-14 (June 1987) or DFAR 252.227-7015 (b)(2) (November 1995), as applicable in any technical data. Trademarks Adobe, Acrobat, Acrobat Reader, and Acrobat Exchange are registered trademarks of Adobe Systems Incorporated. Intel and Pentium are U.S. registered trademarks of Intel Corporation. Java(TM) is a U.S. trademark of Sun Microsystems, Inc. Microsoft and Windows are U.S. registered trademarks of Microsoft Corporation. Netscape(TM) is a U.S. trademark of Netscape Communications Corporation. Oracle is a U.S. registered trademark of Oracle Corporation, Redwood City, California. UNIX is a registered trademark of the Open Group. ipad, ipod, ipod touch, itunes, and itunes App Store are all registered trademarks, registered servicemarks or servicemarks of Apple, Inc. in the United States and other jurisdictions. ios is a registered trademark of Cisco in the United States and other jurisdictions, and is used under license by Apple, Inc. Android(TM) is a trademark of Google Inc.
Contact Nimsoft For your convenience, Nimsoft provides a single site where you can access information about Nimsoft products. At http://support.nimsoft.com/, you can access the following: Online and telephone contact information for technical assistance and customer services Information about user communities and forums Product and documentation downloads Nimsoft Support policies and guidelines Other helpful resources appropriate for your product Provide Feedback If you have comments or questions about Nimsoft product documentation, you can send a message to support@nimsoft.com.
Contents Chapter 1: Introduction 7 Features... 7 System Architecture... 8 Server Component... 8 App for iphone... 8 App for Android... 9 Chapter 2: Server Component Installation 11 Install with UMP... 11 Install Only the Server Component... 11 Chapter 3: App Installation 13 Install the App for iphone... 14 Install the App for Android... 15 Chapter 4: Using NimsoftMobile 17 Log in to NimsoftMobile... 17 Building Dashboards for NimsoftMobile... 17 Contents 5
Chapter 1: Introduction NimsoftMobile is a Nimsoft Monitor application for mobile devices. The application is similar to the Nimsoft Unified Monitoring Portal (UMP). NimsoftMobile consists of: Software installed on a Nimsoft server A client app installed on an ios - or Android -compatible device This guide provides information about installing and using NimsoftMobile. This section contains the following topics: Features (see page 7) System Architecture (see page 8) Features With NimsoftMobile you can: Alarm Console View a list of alarms, updated in real time and sorted by either time or priority Toggle between a summary view and alarm detail view Accept, assign, unassign, and acknowledge alarms Dashboards Select and display custom dashboards with these widgets: Charts Text Alarms Gauges Drill down to individual alarms from the dashboard widgets Reports Navigate a hierarchy of reports Display any report generated by an HTML-based system Zoom in or out on the reports display screen Chapter 1: Introduction 7
System Architecture Preferences Change these settings: Server URL Username Password System Architecture NimsoftMobile consists of a server component and an App for iphone or App for Android. Server Component The server component is a Tomcat/WASP web application written in Java. It provides secure Web Service calls to perform such tasks as: Retrieving the lists of alarms, dashboards, and reports Retrieving detail for alarms, dashboards, and reports Acknowledging, accepting, assigning, and unassigning alarms The Java Web Service interfaces with UDM to retrieve the data listed above. It then organizes the data in XML packets and returns it to the caller. All Web Service calls are made through typical URL-type requests to the web server. For example: http://192.168.1.1:8080/mobile/webservice?command=<command>&<options...> App for iphone The App for iphone is a native ios-compatible application written in Objective-C. It acts as a mobile user interface to the data supplied by the server component. As a native ios-compatible application, the App for iphone is distributed through the itunes App Store, downloaded either directly from the ios-compatible device, or through itunes and then synchronized with the device. The app is delivered as a single file. The app manages a preferences file once it is installed on the ios-compatible device. 8 NimsoftMobile Guide
System Architecture App for Android The App for Android is a native Android-compatible application written in Java. It acts as a mobile user interface to the data supplied by the server component. The App for Android is available from the Downloads page at the Nimsoft support site http://support.nimsoft.com/. You can download it directly from the Android-compatible device. The app is delivered as a single file. The app manages a preferences file once it is installed on the Android-compatible device. Chapter 1: Introduction 9
Chapter 2: Server Component Installation The server component can be installed when you install UMP or can be installed separately. This section contains the following topics: Install with UMP (see page 11) Install Only the Server Component (see page 11) Install with UMP To install the server component with UMP, run the UMP installer and select the Mobile web service check box. For more information, see the Nimsoft Unified Monitoring Portal Installation Guide. Install Only the Server Component To install only the server component, download the ump_mobile package and install it like any other package from the Nimsoft Internet Archive (the Archive page at the Nimsoft support site). For instructions on downloading and installing packages, see the section "Downloading Probe packages from the Nimsoft Internet Archive" in the Nimsoft Infrastructure Manager guide, available from the Downloads page at the Nimsoft support site http://support.nimsoft.com/. Chapter 2: Server Component Installation 11
Chapter 3: App Installation This section tells you how to install the App for iphone and the App for Android, and how to log into NimsoftMobile. This section contains the following topics: Install the App for iphone (see page 14) Install the App for Android (see page 15) Chapter 3: App Installation 13
Install the App for iphone Install the App for iphone This section tells you how to install the App for iphone by downloading it to itunes. 1. Lanch itunes on your computer. 2. Click on itunes Store in the navigation pane on the left of the screen. 3. Enter nimsoft in the search bar. You see the following: 14 NimsoftMobile Guide
Install the App for Android 4. Click the FREE button. itunes displays a pop-up window that asks for your itunes password. 5. Enter your itunes password. itunes downloads the application. This should take less than a minute. 6. Once the NimsoftMobile App for iphone is downloaded, synchronize your device with itunes. NimsoftMobile appears on your ios-compatible device once the synchronization is complete. You should now be able to launch the Unified Monitoring Portal and log in to NimsoftMobile, provided the mobile device can access the network. If the mobile device cannot access the network, you may need to use the built-in VPN on the device to access the Nimsoft server. Logging events are written to the wasp.log file. Install the App for Android This section tells you how to install the App for Android by downloading it from the Nimsoft support site http://support.nimsoft.com/. 1. From your Android-compatible device, log into the Nimsoft support site http://support.nimsoft.com/ and navigate to the Downloads page. 2. Download the NimsoftMobile App for Android to the device and open the file. You should now be able to launch the Unified Monitoring Portal and log in to NimsoftMobile, provided the mobile device can access the network. If the mobile device cannot access the network, you may need to use the built-in VPN on the device to access the Nimsoft server. Logging events are written to the wasp.log file. Chapter 3: App Installation 15
Chapter 4: Using NimsoftMobile This section contains information about using NimsoftMobile. This section contains the following topics: Log in to NimsoftMobile (see page 17) Building Dashboards for NimsoftMobile (see page 17) Log in to NimsoftMobile When you first launch NimsoftMobile, you see the login screen. 1. Enter the host name or IP address:port number of your Nimsoft server. This is the same IP address and port number that you use to access UMP. 2. Enter your user name and password. These are the same user name and password you use to log into UMP. 3. Click LOGIN. This logs you into the server securely and displays the Alarm Console. Building Dashboards for NimsoftMobile For smaller devices, NimsoftMobile renders dashboards as a single column. For the ipad and for Android devices where the width of the display screen is greater than 540 pixels or the height is greater than 960 pixels, multiple dashboard columns can be displayed. The following approaches will improve the viewing of dashboards with NimsoftMobile: Only use these widgets: charts, text, alarms, and gauges. For smaller devices, arrange dashboard widgets in a single column; table columns appear as rows Use captions to add titles to widgets; use the Caption Text field in the Properties pane to name objects to ensure the caption and object appear together. Use a maximum of four labels on the x-axis of charts to avoid overlapping labels. When using alarm widgets, filter on host name. To do so, click Select Alarm Filter in the Alarm Properties pane, choose Host Name, and enter a value. Chapter 4: Using NimsoftMobile 17