Quick Start Guide 3.0
For more information about JAGUAR SX and BYTESPHERE software products, please visit our Web site at www.bytesphere.com
or contact us at:
ByteSphere Technologies LLC 955 Massachusetts Avenue, #141 Cambridge, MA 02139 USA www.bytesphere.com ByteSphere Technologies LLC software is a registered trademark and the other product names are the trademarks of ByteSphere Technologies LLC for its proprietary computer software. No material describing suchsoftware may be produced or distributed without the written permission of the owners of the trademark and license rights in the software and the copyrights inthe published materials.
The SOFTWARE and documentation are provided with RESTRICTED RIGHTS. Use, duplication, or disclosure by the Government is subject to restrictions as set forthin subdivision (c) (1) (ii) of The Rights in Technical Data and Computer Softwareclause at 52.227-7013. Contractor/manufacturer is ByteSphere
Technologies LLC, 955 Massachusetts Avenue, #141, Cambridge, MA 02139 Jaguar uses several free and open-source 3rd party libraries. They include, but are not limited to, West Hawk SNMP library, Bouncy-Castle Encryption, MySQL JDBC connector, H2 Embedded Database
General notice: Other product names mentioned herein are used for identiﬁcation purposes only and may be trademarks of their respective companies.
Windows is a registered trademark of Microsoft Corporation.
JAGUAR SX Guide Copyright © 2007-2010 by ByteSphere Technologies LLC - All rights reserved.
No part of this publication may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, photocopying, recording, or otherwise, without the prior written permission of the publisher.
| Table of Contents
Contents Introduction . . . . . . . . . . . . . . . . . . . . . 5 What is Jaguar? . . . . . . . . . . . . . . . 5 Why use Jaguar? . . . . . . . . . . . . . . . 5 Supported Platforms . . . . . . . . . . . . . . . . . 5 Licensing . . . . . . . . . . . . . . . . . . . . . . . 5 Installation . . . . . . . . . . . . . . . . . . . . . . 6 MonitorEngine Installation . . . . . . . . . . . 6 Console Installation . . . . . . . . . . . . . . 12 Console First Run . . . . . . . . . . . . . . . 12 Launching Discovery . . . . . . . . . . . . . 15
Introduction What is Jaguar? Jaguar is a highly extensible monitoring system capable of monitoring very large numbers of devices and technologies, and also can be easily integrated into most existing monitoring systems. It collects data by using a combination of pull and push methods. The latest release of Jaguar, v3, has been mainly focused on ease of installation and use.
Why use Jaguar? Jaguar can quickly give you an accurate view of what is occuring in your IT environment. Within minutes it will discover your IT assets and start monitoring, alerting you of any possible problems. Using Jaguar will save your business time and money and should pay for itself very quickly. Jaguar is one of the most highly extensible monitoring platforms available today, and can be tailored to fit just about anyone’s needs. Our fantastic support staff will also aid you in integrating new technologies into the monitoring platform, free of charge.
Supported Platforms Jaguar is a Java based monitoring solution that runs on just about any platform (e.g. Windows, Linux variants, MacOSX (intel platforms), Solaris Sparc 64bit). A minimum of the Java 6u1 JRE is required in order to run. 64-bit machines should run the 64-bit version of the JRE.
Licensing Jaguar is licensed per “monitor”. The more things it monitors, the more monitor licenses are needed. To purchase licenses for more monitors, please contact our sales department: http://www.bytesphere.com/contact.html
Installation IMPORTANT: The installer must be run as root or with administrator priviledges. There are two parts to installation. First, the installation of the monitorengine, which will actually install the monitoring service and components. Second is the console installation.
MonitorEngine Installation There are several installation media, one for each type of operating system. Choose the correct one for your environment. If running 64-bit windows, make sure you install the 64-bit installer. If running in command line with no access to console (e.g. unix), execute it with the -c command line switch (e.g. ./monitorengine_unix_3_0.sh -c ). Once the installation is started, the following welcome screen should appear. Click NEXT.
Read through the EULA, and if you agree, click NEXT.
Choose the location to install. Click NEXT.
NOTE: We recommend the following: (for Windows: C:\jaguar, for Unix: /opt/jaguar)
Next you must choose discovery parameters. You do not have to do this here but it will allow you to get a head start on monitoring your network. Click NEXT.
Enter your SNMP community strings. The engine needs this to talk to the devices on your network. If you do not know them just accept the defaults. Click NEXT.
H2 embedded database is selected by default. Click NEXT.
The admin username = bytesphere, password = bytesphere!
Enter your SMTP information so the engine can send email alerts. Click NEXT.
NET-SNMP ProcFix support allows the engine to restart broken processes or execute scripts on hosts running NET-SNMP agents. Click NEXT.
If for some reason you do not want ProcFix support to work, choose “false”.
Install as a service and startup automatically. Click NEXT.
Please wait while it is installed...
This last step requires you to place the license.jaguar.key file in the directory just created by the install. Once that is complete, Click NEXT.
Congratulations! The engine should now be installed and running in the background. Next we need to install the console so we can see what is happenning.
Console Installation Console installation is comprised of: 1) unzipping an archive, 2) executing a file, and then 3) following a wizard. There are several ZIP files, one for each type of operating system. Choose the correct one for your environment. Unzip into the directory of your choice. To start the console: Windows: Unix: MAC:
Double-click on the jaguar-sx.exe file Assign execute permissions (i.e. chmod 755 bin/jaguar-sx), then run it (i.e. ./jaguar-sx) Double-click on the jaguar-sx.app file
NOTE: The console does not need to be installed on the same machine that the engine was installed on. This guide will assume that installation is done locally. For more assistance, please contact support.
Console First Run First, enter the language. Click NEXT.
Enter the database configuration. Unless you have been told otherwise, Click NEXT.
Finally, create the administrative user for this console. Click NEXT.
Now you should be at the login screen. Enter the credentials you just specified and Click Login
Congratulations Again! If everything went well, you should be in the console.
Launching Discovery A network discovery must be performed in order to tell Jaguar what to monitor. This should be the first thing done once you first enter the console.
Find the Discover Panel, located at the bottom of the Jaguar Tab. Click the “Play” button highlighted in the red square.
Next, enter the discovery parameters into the dialog box, and click “OK”.
At this point, the engine should be discovering the subnet(s) you specified. In a couple minutes, the devices will be polled and you will start collecting data that can be used for reporting and analysis.
ByteSphere Technologies LLC 955 Massachusetts Avenue, #141 Cambridge, MA 02139 USA www.bytesphere.com