Quick Start Guide

This Quick Start Guide provides instructions for Longitude installation and initial configuration and use.  Additional instructions are available in the Longitude User Guide,
and in the Longitude Video Tutorials.  If you experience any problems installing or configuring Longitude, please contact Heroix support by email at:
support@heroix.com

 

Contents
  1. Requirements
  2. Installation
  3. Longitude Web UI
  4. Licensing
  5. Monitoring
  6. Events
  7. Alerts
  8. Reports

Requirements

Before Installing Longitude

Antivirus Installation Advisory:

Antivirus software may interfere with the installation of the database used by the Longitude Management Console. Before installing Longitude we recommend temporarily disabling any antivirus software on the server on which you will install Longitude. After installation, the antivirus software may be enabled, but exclude the Longitude directories and processes from antivirus scans.

Heroix Longitude Server Hardware Requirements:

Minimum hardware requirements (maximum 50 managed devices)

  • Windows 2008, Windows 2012, or Windows 2016
  • 2+ GHz Processor
  • 2 GB Main memory
  • 30 GB free disk space

Recommended hardware

  • Windows 2008, Windows 2012, or Windows 2016
  • 2x 2+ GHz Processors
  • 6 GB Main memory
  • Less than 250 managed devices: 80 GB free disk space
  • More than 250 managed devices: 150 GB free disk space

Remote Agent recommended hardware
(maximum 250 managed devices per agent):

  • Windows 2008, Windows 2012, or Windows 2016
  • Red Hat Linux or SUSE Linux (note – not supported on SUSE Linux with 64 bit extensions)
  • 2+ GHz Processor
  • 4 GB Main memory

Software Requirements:

Windows 2008, 2012, or 2016

Domain: Longitude is designed to operate in a Windows domain.

Workgroups: Workgroup installations can be used for evaluation purposes only. After installation, you will be able to collect data only for the machine you installed Heroix Longitude on. To collect data for additional machines, consult the Troubleshooting Help.

Browser Support:

  • Internet Explorer® 9 or higher **
  • Mozilla Firefox® 3.0 or higher
  • Chrome 12 or higher
  • Safari® 5.05 or higher

**Longitude is not supported in IE Compatibility View. To disable compatibility view for Longitude, go to Tools >> Compatibility View Settings, and make sure the Longitude server is not in the list of sites that have been added to Compatibility View and that “Display intranet sites in Compatibility View” is not checked.

Installation

You will be asked to provide the following information during the Longitude Installation:

Initial Longitude Account and Email Address

Longitude Account and Email Address

The account you create in this screen is the initial Longitude administrative account, and will be used to log in to the Longitude Web UI. This account is internal to Longitude, and is used by Longitude to access its backend database. The username and password should:

  • Not start with a number
  • Not contain a MAXDB reserved keyword such as DBA or DBM.

You will be able to create additional accounts after installation, but you should retain the initial username and password created during installation for support purposes.

The email address specified in this screen will be used by Longitude as the contact address for administrative messages – e.g. this email address will be alerted if the Longitude license is about to expire. This address may be changed after installation.

Windows domain account

Windows Domain Account

The account specified in this screen will be used as the service account for data collection from Windows computers. In most cases, you will want to specify a domain administrator account so that Longitude will have permission to collect performance data from Windows servers in the same domain as the Longitude Management Console.

The installation will attempt to verify that the account has administrative permission, and that the password is correct. If it cannot verify the account, you will receive an error message, but will be allowed to proceed with the installation. In this case, or in the case that the Windows account information is left blank, the installation will use the Local System account for Windows data collection.

You can change the Windows account specified during installation through the Windows Services Applet (services.msc) by changing the service account assigned to the Heroix Longitude Statistics Server Service.

Installation Directories

The installation will ask for two installation locations. The first is for the Longitude product files – this will require approximately 1 Gb of space, and will default to c:\Program Files\Longitude.

Longitude Product Installation directory

The second location is where the Longitude database will be installed – the default directory is the same as the product files default (c:\Program Files\Longitude). The database has a minimum size of 3 Gb, and the install can be configured to use as much as 30 Gb. As Longitude archives data over time, the database will extend to accomodate the additional data – please ensure that the drive you specify here has at least enough space for the installation, and optimally additional free space for the database to extend.

Longitude Database Installation directory

Database Size

The installation will create a partition size for the database based on the number of servers being monitored, with 3GB allocated for every 100 servers up to a maximum partition size of 30GB for 1000 servers. If you expect to collect a large number of Event records (i.e. Windows Event Log, Syslog, SNMP Traps), enter double the number of servers you will be monitoring in this field. Longitude will create additional database partitions as needed up to a maximum of 11 partitions.

Longitude Database initial size

Longitude Installation

After you confirm that you are ready to install, Longitude will install the Web UI and database. Please note that the time needed to install the database will depend on the size of the data partition selected, and the speed of the drives on the Windows server. The database installation can take several minutes.

Licensing

The Free Longitude Demo is licensed for two weeks after installation, and allows monitoring for 100 devices, 32 Hyper-V sockets and 32 VMware sockets. To purchase a license contact Heroix online or email Heroix Sales (sales@heroix.com) directly.

 

License Details

To view the details of Longitude’s license, click on the Admin button in the upper right part of the UI, and select Licensing to display the License Details window.

License Details

The upper left portion of the License window is labeled “License for”, followed by the name of the computer on which you installed Longitude. In most cases this name will be the fully qualified domain name for the computer, but this may be vary depending on your network configuration. Heroix licensing will need the name listed after “License for” to create your license.

 

Update License

To update your license, click on the Browse button, and browse to the Longitude license file, which will end with an .FZE extension. Check that the name after “License for” matches the name in the Management Station field for the key, and that the units and expiration date for the license are correct. Select the Apply New License button to activate the license. You will see a notification that the key was applied, and the license display will update with the details of the new key.

Monitoring

Longitude must first be configured to collect data for the devices you want to monitor. Monitoring can be configured using Device Discovery, which will automate monitoring for Windows, Unix, and Network Devices, or by manually configuring monitoring through the Monitor an Application window.

Device Discovery

Monitor buttons

  1. Click the Discover button in the upper left of the Web UI to open the Device Discovery Wizard.
  2. Select Windows, Unix, or Network Device as the application to discover:
    • Windows
      Automated Device Discovery
    • Unix
      Unix Discovery
    • Network Devices
      Network Discovery
  3. Select IP Address to start scan
  4. Select IP Address to end scan (note: you can only scan one class C subnet at a time)
  5. For Unix/Linux monitoring, enter a Username and Password that can connect to the servers via SSH. Root access is not required.
  6. For Network Device monitoring, enter an SNMP V1 community string. Read access is required.
    Please note:
    Monitor the Network Device Application manually to collect data using SNMP V2.
  7. Click Next
  8. When Longitude has finished scanning the requested IP range, you will be presented with a list of computers or network devices that can be monitored with the selected application:
    Discovery2
    Select the devices you would like to monitor. You will be able to monitor devices up to the number of license units you have available.
  9. Click Next
  10. The final discovery step will display the monitoring
    results, including any monitoring errors:
    Discovery3
    If there are any errors reported, you can click on the error link to determine what the error condition is and how to remedy it.
  11. After you click Done, you will see the additional computers you are monitoring:Monitoring

 

Monitor an Application Manually

  1. Click the Monitor button in the upper left of the Web UI to open the Monitor an Application Window
  2. Select the application to monitor from the drop down list.
    Select application from drop down list
  3. When you select an application, the configuration screen may display an Application Properties secion which will contain fields for additional information needed to monitor the application. Further details on specific information needed for each application can be found in the Application help link. Fields marked with a red asterisk (*) are required.
    Monitor VMware
  4. Either manually enter the computer to monitor in the Computers field, or select the button to the right of the Computers button to display of list of computers you are already monitoring.
    Computer selection
  5. Click on the Monitor button. Longitude will test data collection for the application using the supplied Application Properties, and a result window will display either that the collections succeeded, or list any errors that were found.
    Monitoring results

Events

Viewing Events

Longitude checks the data it collects for the existence of problem conditions – for example, low disk space or high CPU usage. When a problem condition is found, Longitude creates an Event containing the details of the problem. Problem conditions are displayed graphically in Status Dashboards, and the full details of the problem are available in the text in the Events display.

Status Dashboard

  1. Click on the Dashboard tab.
  2. Click on the Status button.
  3. The Dashboard home page displays an overview of the most severe problem for each dashboard.
    Dashboard home page
  4. To view the details for a dashboard, select the Dashboard in the left pane or the overview dashboard icon in the right pane.
  5. Hovering over a Widget displays details for the specific section of the underlying widget.
    Hover over dashboard
  6. Right-clicking on a widget displays available report options.
    Right click on event widget
  7. The Problem items only report displays the details of the problem condition, with the most severe problems at the top of the report. Click on the Back button to return to the Widget display.
    Summary event display

Events Display

  1. Click on the Dashboard tab.
  2. Click on the Events button.
  3. Longitude Event Detail display:
    Event Monitor

    • The left pane of the Events display contains icons displaying the highest severity event found for the computer.
    • The right pane displays the events found for the servers checked in the left pane – by default the display shows events for the last hour.
    • The Count column is the number of times the event has occurred in the interval being displayed – clicking on the + icon to the left of the Count displays all the events for the interval.
    • Clicking on an Event in the right pane displays the text of the event in the bottom pane.
    • The Windows Event Log, Syslog, and SNMP Traps tabs will only be displayed if these applications are being monitored.
  4. Sorting and Filtering Events:
    Event Monitor filters

    • Most of the columns in the Event Monitor can be filtered and sorted.
    • Click on the column title to sort by that column.
    • Click on the arrow to the right of a column menu to display additional filtering options.
    • The Columns filter is the same for all columns and allows you to remove columns from the display.
    • Filtering options vary depending on the context of the column, e.g.:
      Event Monitor context filter

Alerts

Configuring Alerts

When Longitude creates an Event, that event can trigger an Action. Actions can be used to execute OS commands, or to send alert messages via Email, Pager, Text Message, and/or SNMP Traps.

  1. Click on the Dashboard tab.
  2. Click on the Events button, and select the Event you want to generate an alert.
  3. Click on the Configure button – the Event selected in the previous screen will be selected in this screen. Alternately, if you know which Event you want to alert on, you can browse to the Event in the left pane.
  4. In the right pane, select the Actions button.
  5. Actions can be configured by Computer or by Computer Group. In the right pane, in the Action Filters field, click on the radio button for either Groups or Computers. The default value for both Groups and Computers is *, selecting all Computer Groups or all Computers. Please see the Longitude User Guide for more details on User Defined Groups and on using Groups in Actions.
    Computer or Computer Group alert selection
  6. In the right pane, in the Action Filters field, click on the list of computers to select individual computers, or leave the field as * to alert for this event on all computers.
  7. Some alerts will contain additional Action Filters – for example, filtering for Disk IDs or Service Names. These may be left as * to select all.
  8. Select the number of consecutive events to alert on. For example, if you are alerting on a PingCritical Event, which has a 1 minute interval, selecting a count of 3 would delay the alert for 3 minutes, but would eliminate false alerts for intermittent network problems. However, Disk Space rules have a 1 hour interval, so a count of 3 would delay alerts for 3 hours.
  9. Select the alert actions. Actions require the following additional properties:
    Email Comma separated list of recipients
    Text to pager Pager Provider and Number
    Text to phone Cell Phone Provider and Number
    SNMP Trap Specific Trap Number
    Execute Command to Execute (Windows Computers only)

    Alert displaying all available actions

  10. The Enter Times of Day and Days of the Week field sets the time when the alert is active – alerts will only be executed during the selected days and times.
  11. The Cool Off Period is the number of minutes between alert updates. Once an alert is sent, if the problem has not been resolved, additional alerts will only be sent after the Cool Off Period has expired.
  12. Click on the Apply button to create the alert action. This button will be available after one or more fields in the Select Actions section have been completed.
  13. You will receive a Notice that the Action has been successfully applied.Display with action notation
  14. After the action has been assigned, the Configure window will display a different icon for events with actions.

Reports

Viewing Reports

Longitude reports are produced by the data collected from monitoring, and from Events created through analyzing the data. Reports can either be Summary reports, comparing data across computers, or detail reports, looking at the data on a specific computer over time.

  1. Click on the Reports tab.
    Reports with notes
  2. Select an Application from the Select an application… drop down list. This list will only include applications for which Longitude is collecting data.
  3. The available reports for the selected application are listed as tabs in the right pane.
  4. Select Enterprise to produce a Summary report, or select an individual computer to produce a detail report. Summary reports will contain links to detail reports.
  5. Expand the Report Options section in the left pane for options on filtering data and changing the format of the report. The options avialable on this tab will vary depending on the selected report.
  6. Expand the Date & Time section in the left pane for controls to adjust the time period covered by the report
  7. Hovering over the graph will generate a tool tip displaying the value of the graph at that location.
  8. The left pane of the report can be collapsed or expanded through a button on the frame separating the two panes.
  9. The Print and Email buttons are only available for Graphs.
  10. The Export button will provide the numeric values for the report in comma separated format.
  11. The Scheduler button will allow you to automatically produce the report you are currently viewing. The report
    can be scheduled to be run at hourly, daily, weekly, monthly and quarterly intervals.