How to use Custom Tags in Nectus

,

How to use Custom Tags in Nectus

 

Step 1: Login to the Nectus portal with a valid credentials. Go to Settings -> General Settings -> Tags.

Graphical user interface, text, application, email Description automatically generated

Step 2: After clicking the Tags option, it will open a Tags modal with five tabs – SNMP Devices, Interfaces, WMI Servers, IP Monitors, Sites.

In this article, we’ll choose the IP Monitors and create 3 tags.

Graphical user interface, application Description automatically generated

Step 3: After clicking the Create button, we’ll get the Add IP Monitor Custom Tag Modal. Provide name and pick the input type from available three options: Type-In, Single Select, Multi Select.

Graphical user interface, application Description automatically generated

Step 3a: Type-in option allows the user to type the value of the tag as per their need in text form.

Step 3b: Single Select option allows the user select only one tag value at the time of assignment.

Graphical user interface, text, application, email Description automatically generated

Step 3c: Multi Select option allows the user select one or more value at the time of assignment.

Graphical user interface, text, application, email, website Description automatically generated

Step 4: Here, for the demo purposes, we had created 3 tags as shown below.

Graphical user interface, text, application, email Description automatically generated

Step 5: Now, let’s define values for custom tags in the existing IP Monitor. Right-click on selected IP and go to the Properties.

Graphical user interface, text, application Description automatically generated

Step 6: Select the Tags tab from the Edit IP Monitor modal and fill the Tags Values accordingly.

Graphical user interface, application Description automatically generated

 

How to monitor the status of Windows Processes

,

How to monitor the status of Windows Processes.

Quick Start Guide

Step 1: Login to the Nectus portal, Add the WMI Account for accessing the Windows Machine. Go to Settings -> General Settings -> WMI Integration.

Click on the Add button in the WMI Integration Modal.

Graphical user interface, text, application, email Description automatically generated

Step 2: Provide Windows Domain/Server information with user credentials and click on the Test button.

Graphical user interface, application Description automatically generated

Step 2a: With the valid credentials and connectivity, we should get the success message as displayed in the test modal.

Graphical user interface, text, application, chat or text message Description automatically generated

Step 3: Now, let’s create a WMI group and add the Windows Server into that group.

Go to WMI Servers and right click to Add a Group.

Graphical user interface, text, application Description automatically generated

Step 4: Give a valid name, enable the monitoring to select the appropriate Monitoring and ICMP profiles.

Step 4a: We can also create a new monitoring profile by clicking the “+” icon.

Check the required boxes based on your monitoring requirements.

For any processes alerting, Go to Processes Tab, then select alert option to check the process state.

Step 4b: Add the process information by clicking the options button.

Consecutive Reading options helps monitor whether process is running or not running for defined range [1-256] consecutive times.

It helps to reduce the false alerts.

Add the process name in the text box by pressing “+” button.

Graphical user interface, text, application, email Description automatically generated

Graphical user interface, text, application, email Description automatically generated

Step 5: Now, add the WMI Server information which has to be monitored.

Right click on the created group and select the Add New WMI Server option.

Step 6: Provide a valid name, IP address, select the appropriate WMI Monitoring Profile Group and WMI Account for access.

Click on the Test button to test the server access.

Graphical user interface, text, application, email Description automatically generated

Step 7: Now we had enabled the monitoring for the Windows processes on Nectus.

Whenever the condition satisfies, then alerts get generated. We can view the alerts under Alerts -> Alert log.

We’ll also get the alerts in email form by enabling email alerts option with proper SMTP configuration.

Graphical user interface, text, application Description automatically generated

Graphical user interface, application Description automatically generated

Congrats, now we have successfully created a monitoring profile to monitor the process in a Windows Server.

 

How to use Nectus API Interface

,

How to use Nectus API Interface

Quick Start Guide

Step 1: Log in to Nectus Portal. On the home page, select General Settings -> Miscellaneous.

 

 

 

Step 2: Next, we have to generate a new client ID and client secret for creating the token. Go to API Accounts and click on Create.

 

 

Step 3: Check the Enable box, enter the Client ID & Secret in the text box, and select the necessary access level (Read-Write or Read-Only) for the modules.

Here, we have given the Client ID as API_USER_1 and Client Secret as Nectus123. Click on the Ok button to create it.

 

 

Step 4: Each API Account with the Client’s information obtains a unique ID and gets listed.

We also have the Edit button to modify and the Delete button to remove the existing accounts with ID. Click on the Ok button to close the miscellaneous modal.

 

 

Step 5: Now, we have to create the API token with the help of the generated Client ID & Client Secret.

Here, we are using the POSTMAN Application for the sake of the demo. Use the below query and headers to get the access token.

API URL: https://<servername>/token/get

Request Type: GET

Headers: Authorization – client_id=API_USER_1 client_secret=Nectus123

 

 

Step 6: Click the Send button to obtain the Status Code with 200 Ok with the token details in the response body.

 

 

 

Step 7: Now, we can use the generated access token for all Nectus API’s.

Let’s try with some API Request.

API URL: https://<servername>/IPMonitor/restAPI/getStatusIPv4Monitor

Request Type: GET

Headers: Authorization – token=<generated-access-token>

After clicking the Send button, we obtain the list of IPv4Monitor groups with the associated IP address and status.

Congrats! We have successfully used the Nectus API interface to access the monitoring data points which will ease the third-party integration with other systems.

 

How to Add and Configure IP Monitors

,

Step 1: Login to Nectus portal. Then, click on IP Monitors.

Step 2: Right Click on IP Monitors and select Add Group to create a new monitoring group.

Step 3: Provide a unique name to the group and check the “Enable monitoring” option.

If monitoring requires custom ICMP monitoring timers then select optional Custom ICMP Monitoring Profile.

Choose the appropriate Polling Agent (Default is Main Polling Agent) and provide optional physical address.

Click on Ok to create a new IP monitor group.

Step 4: Now, the new group gets added under IP Monitors. The square icon indicates the status and since no device is added in the group, it’s shown in grey color.

Step 5: Right click on the IP Monitor Group to add a new IP Monitor into the group.

Step 6: Under the General Info Tab, provide a valid IP, name and optional physical address.

Then, click on Ok button to Add IP Monitor.

Graphical user interface, text, application Description automatically generated

Graphical user interface, application Description automatically generated with medium confidence

Step 7: To test the reachabilty of IP Monitor, we can use Ping this IPv4 Monitor option. It performs a live ICMP ping test to the IP Monitor.

Graphical user interface, text, application, chat or text message Description automatically generated

Step 8: It also provides the options to repeat the test and continue ping tests.

Graphical user interface, text, application Description automatically generated

Step 9: To get the current device monitoring information, go to View IPv4 Monitor Info.

Step 10: The General Info provides the basic details about the device.

Alerts tab contains all the monitoring alerts. All alerts can be exported in *.csv format for further drill down. Click on eye icon in each row to get more information about the alert.

Graphical user interface, text, application, email Description automatically generated

Step 11: Right click on the device and Graphs to get a plot based on UP/DOWN state, latencies etc.

Graphical user interface, text, application, chat or text message Description automatically generated

Step 12: We can share the polled data from Nectus in several ways.

Step 13: We can share the access to graph using Generate Direct Access URL.

Graphical user interface, text, application, email Description automatically generated

Step 14: Further, we can also export all data points in a *.csv form using Export All option.

Graphical user interface, table Description automatically generated

Step 15: We can select multiple devices using CTRL + Left Click. Right click on any one to get the available options.

Step 16: Select the Graphs option to obtain the consolidated view of the plots for the selected devices.

Graphical user interface, application Description automatically generated

Step 17: To edit the added devices, right click on the device and choose properties.

Graphical user interface, text, application, chat or text message Description automatically generated

Graphical user interface, text, application Description automatically generated

Step 18: Bulk import through a *.csv file can be performed and sample file can be downloaded from Import from CSV modal for quick reference.

Graphical user interface, text, application, email Description automatically generated

Step 19: Post the data import completion, skim through the device information, and select them to save into the database for the monitoring.

Graphical user interface, text, application, email Description automatically generated

Step 20: Additionally, we can select Delete IPv4 Monitor to delete the devices from monitoring.

Graphical user interface, text, application, chat or text message Description automatically generated

Graphical user interface, text, application, email Description automatically generated

Congrats! We have successfully explored the lifecycle management of devices for ICMP monitoring using IP Monitor.

 

How to Perform Nectus Software Upgrade

,

 

Step 1. Download latest Nectus release from Nectus Support Portal (https://support.nectus5.com)

Table

Description automatically generated

 

 

Step 2.    Unzip Nectus distribution archive Nectus xxxxx.zip to any folder on Nectus Server.

 

For upgrade you should have two files:

Graphical user interface, text, application

Description automatically generated

 

 

Step 3. Right-click on “Nectus Setup” and select “Run as administrator”.

 

 

 

Step 4. The Nectus Installer window opens. Click Next.

 

Graphical user interface, text, application, Word

Description automatically generated

 

 

 

Step 5. The License Agreement window opens. Click “I Agree”.

 

 

 

Step 6. The Upgrade window opens. Select the “Upgrade” mode.

 

Note: “Upgrade” mode (the default mode) preserves the database and all data in it.
!!! “Remove” mode will delete the existing database and all data will be erased!!!!

Click “Install”.

 

 

 

 

Step 7. The installation begins by saving resources.

 

 

 

 

Step 8. The old software components are uninstalled.

If desired, click on “Show details”.

 

 

Step 9. Show details lists the steps the installer is performing.

 

 

Step 10. When the old software components have been removed, the new version will be installed.

 

 

 

Step 11. The installation completes. Click Next.

 

 

Step 12. The “Completing Setup” window opens.

 

 

 

 

How to Control Access Rights to Network Devices in Nectus

, ,

In this article, we will show how to control the access rights to specific network devices visible in Nectus.

We will create a user group “Texas Admins” that have access only to specific subset of SNMP devices “Texas Network Devices” in Nectus database.

Step 1.  Create a custom SNMP device view “Texas Network Devices” in Inventory -> Views -> SNMP Device Views

Step 2. The SNMP Devices Views window opens. Click on Create.

Step 3. The Add SNMP Devices View window opens. Give the view a name “Texas Network Devices”.

Select desired devices in the window on the right (Available SNMP devices).

When all are selected, click on the Left Arrow key to move the selected devices from the Available window to the Selected window.

We selected nine devices.

Step 4. Selected devices move into the Selected SNMP Devices window. Click Save.

 

Step 5. Looking in the SNMP Devices Views window, we see that the view “Texas Network Devices” has been created and has nine devices.

 

 

Step 6. Create Admin User group “Texas Admins”  in Settings->  Admin Accounts

 

.

 

Step 7. Navigate to Settings Admin Accounts.

 

Step 8. The Admin Accounts window opens. Select User Groups, and click Create.

 

Step 9. The Add Users Group window opens. Enter the Group Name (Texas Admins), select the Access Right (Read Only), click Views.

 

Step 10. Select desired View “Texas Network Devices” that members  of this Admin group can see.

 

Step 11. Click OK.

Step 12.  Create User in “Texas Admins” Group.

Step 13. In the Admin Accounts window, click on User List and click Create.

Step 14. The Add User Account window opens.

Fill in the fields (First Name, Last Name, Email/Username).

Create and confirm password. Assign to group (Texas Admins). Click OK.

 

 

Step 15. In Admin Accounts window, verify that new user (Mike Fletcher) now appears with Group Texas Admins.

 

Step 16. In the Admin Accounts window, click User Groups and click on Texas Admins.

Verify the assigned view for SNMP Devices Views is Texas Network Devices.

 

Step 17. Logout and log back in as Mike Fletcher.

 

In the Inventory window under SNMP Devices you should only see the 9 devices assigned to “Texas Network Devices”.

 

 

 

How to configure HTTP Application monitoring in Nectus

How to configure HTTP Application monitoring in Nectus

Step 1: Login to Nectus portal. In the home page, click on Applications. Under Applications, we’ll get HTTP, TCP, UDP options.

Step2: First, right click on the HTTP and select on the Add Group.

Step 3: Now, provide unique Group name and check the Enable monitoring & Alerting options.

Click on Ok to create the new application group.

Step 4: Again, right click on the created group and select the Add New Application.

Step 5: Now, provide a valid URL, name, and select the appropriate group, distributed polling agent. Additionally, GPS latitude and longitude gets autogenerated from the given address.

Step 6: Next, click on the Metrics tab, then select the required metrics which has to be monitored. In our case, we are monitoring all the key metrics of HTTP application. Further, we can also edit the global alert template by clicking the Global Alert Template icon. Lastly, click Ok button to add new HTTP application.

Step 6(a): Set the alert template using available variables. Click on the Send Test Email to get the sample email with select subject and email body patterns. Then, click Ok button to apply and close the window.

Step 7: Now, let’s create the type of method [GET, PUT, POST, PATCH, etc.] to monitor in the added HTTP Application. Right click on the HTTP Application (User Info) -> Select HTTP Method

Step 8: Provide the unique and valid name, HTTP method with Path URL. Click on Test button to check

Step 8(a): We have got the Test Success message

Step 9: Next, right click on the created method and select View HTTP Method Info to get the performance information.

Step 10: This window provides the overall performance graphs and status of the URL method.

Step 11: To get the specific metrics graphs, Right click on created method -> Graphs -> Availability Graph, Connection Time Graph, etc.

Step 12: Graphical View based on the selected metrics.

Step 13: Alternatively, we can also enable the HTTP application monitoring metrics from Monitoring -> Application Monitoring Settings -> HTTP.

Congrats! We have successfully enabled the application monitoring for HTTP apps.

 

Configuring SNMP OID for Memory utilization Monitoring

,

Configuring SNMP OID for Memory Utilization Monitoring

  1. In this article we look at how to configure the SNMP OID for memory utilization monitoring of specific device. If you do not know the OID for a device, contact the device manufacturer and request the OID for the function required.

Procedure

Step 1. Right-click on the device that required RAM utilization monitoring and select View Device Info.

Step 2. The View Device Info window opens. Click on SNMP OID.

Step 3. The SNMP OID window opens. Examine the entries for “platform specific oid memory utilization.” In this case two OID entries have been made. Depending on the manufacturer, one or two entries will be entered.

Step 4. If there are no entries, then SNMP OID need to be entered to enable the memory utilization monitoring.

Step 5. To enter platform specific OID for memory utilization, click on the text.

Step 6. The SNMP OID (memory utilization) window appears.

The manufacturer will tell you how the device reports memory utilization. If the device reports Memory Utilization Percent directly, the OID is entered in that box and provisioning is done. If the device reports separate values for total, free or used, then the OID information for each count need to be entered. Nectus will perform the calculation to arrive at Memory Utilization.

For example, when the device reports Memory Utilization Percent directly, the OID is entered in the first box and provisioning is complete.

In this case, the device reports Memory Used and Memory Free, so the OID for Memory Used is entered in the Memory Used space and the OID for Memory Free is entered in the Memory Free space. Nectus will compute utilization as Memory Used / (Memory Used + Memory Free) * 100.

In this case, the device reports Memory Free and Memory Total, so the OID for Memory Free is entered in the Memory Free space, and the OID for Memory Total is entered in the Memory Total space. Nectus will compute utilization as Memory Free / Memory Total * 100.

Step 7. Click on the OK button. Nectus will provision the OID information, unless an error is discovered.

In this case Nectus is reporting that Used and Free Memory OIDs are required.

We re-enter the OID information as Memory Used and Memory Free, and click OK.

Step 8. The OID assignments are accepted and displayed on the View Device window.

Testing

  1. Testing: Testing the assignments can be done by examining the utilization display or retrieving the OID contents.

Step 1. Click View Device General to see the results of configuration.

RAM percent utilization is working.

Step 2. Testing: Click on the dial to see a graph of the measurement over time.

Step 3. Testing: To retrieve current value of OID select SNMP OID tab and click on “TEST” for OID of interest.

Step 4. Change SNMP Walk to GET.

Step 5. Click Start.

Step 6. Current value of the OID will be displayed.

How to install additional polling agent

,

Step 1: Login to Nectus Portal in the home page. Select Settings -> Global Monitoring Settings.

Step 2: Next, select Distributed Agents to get the list of configured agents. Click on Create button to create a new poller agent.

]

Step 3: Now, provide a valid and unique name to the agent. Here, the Distributed Agent Name is “Regional USA Polling“. Select the enabled checkbox and click on Ok to create the poller object in the main server.

Note: Once the agent installation is complete, the RED changes to GREEN.

Additionally, the status of configured agent can also be checked on home page near the search icon.

Now, let’s start the installation on the Additional Polling Agent Server.

Step 4: After the download is complete, double click on the exe file. Installer window opens up. Click on Next to proceed with the installation.

Step 5: Go through the License Agreement carefully and then click on the Agree button.

Step 6: Select Additional Polling Agent in the Installation Type window and click on the Next button.

Step 7: Select the relevant options. Click on the Next button.

Step 8: Select the destination folder. Make sure, a minimum of 2GB of disk space is available in the selected drive. Click on the Next button.

Step 9: Next, provide the same name in the Additional Agent Name as in step 3. Fill the main polling agent IP address in the textbox and click on the Next button.

Step 10: Warning: Ensure that we open 10167 and 10168 ports between the new and main agent. If not, below error message will pop up.

Step 11: Then, key in a password to integrate the agent with the main server database.

Step 12: Log in to the main server and go to C:\Program Files\Nectus\Web\Apache24\htdocs\protected\config\ path and open database.ini file.

Step 13: Copy the password of vconsole username and paste it on the additional agent installer password textbox and click on the Install button.

Step 14: Once the installation completes, click on Next to proceed further.

Step 15: Finally, click on the Finish button and close the window.

As mentioned earlier, the additional poller status automatically converts to GREEN after successful installation.

Congrats! We have successfully installed the additional polling agent and integrated it with the main server.

 

Nectus not impacted by Log4J (CVE-2021-44228) Vulnerability

Nectus doesn’t use Apache LOG4J in any of its modules and is not impacted by recent Log4J (CVE-2021-44228) vulnerability.

 

 

How to Manually Generate a Process Dump using Process Explorer

Problem

There may be times where a process dump file (or files) are required to troubleshoot a specific problem. The steps in this document walk through the process of generating a dump file using Process Explorer for IBM Support analysis. While the example used covers the tm1sd.exe process, the same steps can be followed for any process on the operating system. NOTE: You may follow a very similar approach using only Windows Task Manager, however Windows Task Manager will not allow you to choose a dump file location. This step is important if your application consumes a lot of memory and you do not have enough disk space on your Windows drive (C:).

Resolving The Problem

  1. Download Process Explorer
  2. Locate your Process Explorer executable, procexp64.exe.
  3. Right-click the process and select run as an Administrator.
  4. When Process Explorer has opened, look for the process/executable name in the Process column.
    • If more than one process with the same process/executable name exists, hover over the executable and review the Services parameter and confirm that the details match what you are expecting.
  5. Once the correct process has been found, right-click the process and select Create Dump > Create Full Dump
  6. When prompted, specify the directory where you wish to write the dump file to.
    • Ensure that the disk you are writing to has enough space to write the file.
    • The file will be close to the size of the memory used by the process.
  7. After you click the Save button, it can take a few minutes for the file to finish writing to disk.
    • During this time the process will freeze until the dump has been written.
  8. The resulting dump file should be compressed and provided to IBM Support for review.

How to enable VMware Monitoring in Nectus

Enable Monitoring of VMware Using Nectus

Step 1. Navigate to Settings → General Settings → VMware VCenter Integration .

Step 2. VMware – vCenters window opens.

Step 3. Left-click Create New Group.

Step 4. The Add VCenter Group window opens.

Step 5. Name the Group (MyvCenter). Check Enable Monitoring. Click OK.

Step 6. Group Name appears in VMware – vCenters window.

Step 7. In VMware – vCenters window, click on vCenter Servers.

Step 8. Click Add.

Step 9. In the Add vCenter Server window, Enter Server name, IP address, Username and Password. Check that correct group is selected. Click Test.

Step 10. Test Connection tests OK (see message Test Connection OK). Click OK in lower right corner of window.

Step 11. Server shows in list of servers in VMware – vCenters window. Click Close.

Step 12. In Nectus main menu, on the left, click on VMware vCenter. A drop-down menu appears.

Step 13. Expand the list of ESX Hosts or Datastores to verify import. It may take up to 15 min for all objects to be discovered and loaded to Nectus.

How to Enable Meraki API Integration in Nectus

How to Enable Meraki Integration in Nectus

  1. Obtain the Meraki API key.

Follow the procedure in the Meraki document to generate the API key. The document may be found at https://documentation.meraki.com. Keep this key secure.

The key is an alphanumeric string of 40 characters.

Sample API key: dfg5fffc2def3g34345mn7888u8wz9565df45

  1. Enable Meraki integration in Nectus.

Step 1. In the Main Menu, go to Settings → General Settings → Third Party Integration -> Meraki Integration.

 

Step 2. The Meraki Integration window opens.

Step 3. Check Enable Meraki API Integration box. Copy and paste API key into window. Click Test.

Step 4. When test is successful, click OK.

 

Step 5. On left side of main window, click Meraki, right click on All Meraki Devices, select Reload Data From Meraki.

 

The Reload Data from Meraki window opens, letting you know that the reload is in progress. Close this window.

Step 7. After a few minutes, the list of Meraki devices will appear.

How to discover/add a single device in Nectus (1.64.xx)

How to discover/add a single device in Nectus

Step 1

In the main window, click on “Tools”, and in the drop-down box, select “Manual Network Discovery”

Step 2

The Discovery Start Window opens

Step 3

In the Discovery Start Window, change “Full Discovery” to “Partial Discovery”.

Step 4

Enter IP address and click “Start”

Step 5

The Start Discovery window asks, “Start Discovery, are you sure?” Click “OK”.

Step 6

Close the Discovery Start window by clicking on “Close” in the lower right-hand side.

Step 7

To check that discovery ran to completion, go to the Main Window and click on “Logs” and then select “Discovery Log”.

Step 8

The Discovery Log opens. Here we see that our discovery (ID 4) ran to completion in 0 minutes and 23 seconds.

 

NetFlow Configuration Examples for Cisco Routers

,

Catalyst 4500 Series Switch IOS NetFlow Configuration
——————————————————————-

switch(config)# ip flow ingress
switch(config)# ip flow ingress infer-fields
switch(config)# ip flow-export destination <Nectus IP address> 2055
switch(config)# ip flow-export source Loopback0
switch(config)# ip flow-export version 9
switch(config)# ip flow-cache timeout active 1
switch(config)# ip flow-cache timeout inactive 15

Cisco 3800 Series Router NetFlow Configuration
—————————-
Step 1. Define Flow Record format
router(config)# flow record NECTUS_NETFLOW_RECORD
router(config-flow-record)# description NetFlow record format to send to Nectus Netflow Collector
router(config-flow-record)# match ipv4 ttl
router(config-flow-record)# match ipv4 tos
router(config-flow-record)# match ipv4 protocol
router(config-flow-record)# match ipv4 source address
router(config-flow-record)# match ipv4 destination address
router(config-flow-record)# match transport source-port
router(config-flow-record)# match transport destination-port
router(config-flow-record)# match interface input
router(config-flow-record)# match flow direction
router(config-flow-record)# collect interface input
router(config-flow-record)# collect interface output
router(config-flow-record)# collect counter bytes
router(config-flow-record)# collect counter packets
router(config-flow-record)# collect timestamp absolute first
router(config-flow-record)# collect timestamp absolute last
router(config-flow-record)# collect routing source as
router(config-flow-record)# collect routing destination as

 

Step 2. Create Flow Exporter (Specify where NetFlow to be sent)
router(config)# flow exporter NECTUS_NETFLOW_EXPORTER
router(config-flow-exporter)# description Export NetFlow to Nectus
router(config-flow-exporter)# destination <Nectus IP address>
router(config-flow-exporter)# source Loopback0
router(config-flow-exporter)# transport udp 2055
router(config-flow-exporter)# export-protocol netflow-v9

 

Step 3. Create Flow Monitor (Bind Flow Record to the Flow Exporter)
router(config)# flow monitor NECTUS_NETFLOW_IPv4_MONITOR
router(config-flow-monitor)# record NECTUS_NETFLOW_RECORD
router(config-flow-monitor)# exporter NECTUS_NETFLOW_EXPORTER
router(config-flow-monitor)# cache timeout active 60

 

Step 4. Assign Flow Monitor to Selected Interfaces
Repeat this step for every interface you are interested collecting NetFlow for.
router(config)# interface TenGigE 1/1  (repeat for every interface that you need)
router(config-if)# ip flow monitor NECTUS_NETFLOW_IPv4_MONITOR input
router(config-if)# ip flow monitor NECTUS_NETFLOW_IPv4_MONITOR output

 

Step 5. Operation Validation
show flow record NECTUS_NETFLOW_RECORD
show flow monitor NECTUS_NETFLOW_IPv4_MONITOR statistics
show flow monitor NECTUS_NETFLOW_IPv4_MONITOR cache

Configuring VMware monitoring

Nectus release 1.60 includes with a new VMware monitoring module.

Nectus can monitor following VMware infrastructure elements:

  • vCenter servers
  • ESX Hosts
  • Datastores
  • Virtual Machines

Nectus can monitor and alert on following  metrics for all elements:

  • ICMP Availability and Latency
  • CPU utilization
  • RAM utilization
  • Storage free space availabilty
  • Disk Read/Write rates
  • Disk I/O Transactions rate
  • Disk Average and Max Latency
  • Network Rx/Tx throughput rates
  • VM Status (Power,  Heartbeat, Connection)

 

To set up VMware monitoring go to Inventory/VMware/vCenters (as shown in the picture).

The following page will open. On this page you can create new vCenters groups, edit their settings, delete groups. Create at least one group to be able to add vCenter servers.

After pressing “Edit” button you will see the form as shown in the picture on the right. Here you can enable/disable monitoring for entire group, select an appropriate ICMP monitoring profile, assign email and SMS lists for alerts.

Switch to the next tab of “VMware – vCenters” form to add/remove VMware vCenter servers.

The following window will appear after pressing “Add” button.

Fill out the fields here. The field “Server name” does not affect functioning and may be assigned to any value you like.

Username/Password must represent a valid VMware vCenter account.

Use “Test” button to check if the connection to vCenter may be established using the credentials provided.

After adding all desired vCenters you will see them on the list:

Managing VMware infrastructure

After configuring VMware groups and adding one or more vCenter servers the discovery of VMware infrastructure will start automatically.

You do not need to add ESX hosts, Datastores and Virtual machines manually.

Wait one or two monitoring cycles (5-10 minutes) for VMware entities to appear.

 

 

The discovered entities will appear in the Inventory:

After clicking “ESX hosts” you will see the following window displaying ESX host groups:

 

You can add more groups here (see picture below) or enable monitoring for the Default group.

If you move to the tab “ESX hosts” you can see the list of discovered items:

Warning: it is not possible to delete a non-empty group.

This applies to Datastores and Virtual Machines as well.

Discovered entities will also appear in the left tree of Nectus GUI.

To move an ESX host to another group switch to Groups in VMware combo, right click on the desired host, choose “Move ESX Host to…” and select the appropriate group.

The same applies to other VMware entities: you can view properties, graphs for Datastores and Virtual machines,

move them to other groups either from the tree or from the Inventory/VMware menu.

However, creating new groups is only available at Inventory/VMware menu.

 

Managing metrics to monitor

To set up metrics to monitor select Monitoring/VMware Monitoring Settings menu.

You will see the window as shown in the picture below.

Switch between tabs of VMware devices and metric groups to enable/disable selected metrics, customize them (see picture below) or to edit alert message templates.

 

After you have configured the desired metrics, Nectus server will automatically load them and start to monitor.

How to install SSL Certificate for Nectus GUI

,

This guide explains how to generate the CSR code and install a commercial SSL certificate for Windows Apache so that you could access your Nectus GUI page securely via HTTPS.

It assumes that during Nectus installation, you selected the default location which is C:\Program Files\Nectus.

If you installed Nectus in a different folder, make sure to adjust the commands and locations given in this guide accordingly.

In general, in order to have a website accessible using secure HTTPS connection, the web server must have a pair of public and private keys configured.

The public key must be signed by a trusted Certificate Authority and added to a digital SSL certificate.

To obtain that certificate, you will need to send the certificate signing request (CSR) code to your SSL provider. Please refer to instructions below:

 

Generating CSR using OpenSSL

  1. On your Windows server, press Win+R, enter cmd and hit OK

  1. Now you will need to run a certain OpenSSL command to generate a new CSR/Key pair for your future SSL certificate.
  2. The command template is below, make sure that you adjust the highlighted fields – they must be related to your system:

“C:\Program Files\Nectus\Web\Apache24\bin\openssl” req -new -newkey rsa:2048 -nodes -keyout “C:\Program Files\Nectus\Web\Apache24\conf\yourdomain.key” -out “C:\Program Files\Nectus\Web\Apache24\conf\yourdomain.csr” -config “C:\Program Files\Nectus\Web\Apache24\conf\openssl.cnf” -subj “/CN=example.com/C=US/ST=California/L=Los Angeles/O=Yourcompany Inc./” -addext “subjectAltName = DNS:subdomain1.example.com,DNS:subdomain2.example.com,DNS:anotherexample.com

Explanations for each field:

CN= this is the field for the primary domain of your SSL

C= enter the ISO 3166-2 compliant country code here

ST= the field for the state

L= the field for the city

O= the name of your company. If you do not have a company or do not wish to indicate it, simply put NA

DNS: additional domain names (also known as SANs – Subject Alternative Names) that should be included into the certificate;

you can include multiple SANs in the CSR code, however, double-check with your SSL provider whether your SSL certificate supports SANs.

  1. Executing the command should produce the following output:

Once done, the C:\Program Files\Nectus\Web\Apache24\conf\ directory will have two new files, the file with the CSR code (.csr) and the file with the private key (.key).

We’ll leave the private key for the time being. The CSR code has to be provided to your certificate vendor — this code is the base for your commercial SSL certificate.

Please contact your SSL vendor regarding SSL certificate purchase.

 

When the SSL is issued, you should receive at least two files: SSL certificate in a .crt (or .pem, .cer) file, and the CA-bundle (also can be called intermediate CA, root CA certificates)

with extensions like .ca-bundle, .crt. Please note that Apache requires only PEM-encoded certificates, so PKCS#7 or PKCS#12 encoded SSLs won’t work.

Configuring SSL for Apache

  1. Upload those files to the C:\Program Files\Nectus\Web\Apache24\conf\ directory.
  2. Then, go to the C:\Program Files\Nectus\Web\Apache24\conf\extra folder, and open the httpd-ssl.conf file in Notepad.
  3. Find and edit the following directives and make sure that they point to the SSL certificate, Private Key, and the CA-bundle files accordingly:

SSLCertificateFile “${SRVROOT}/conf/yourdomain.crt”

SSLCertificateKeyFile “${SRVROOT}/conf/yourdomain.key”

SSLCACertificateFile “${SRVROOT}/conf/yourdomain.ca-bundle”

Note that the SSLCACertificateFile directive is commented out by default.

You need to delete the # sign at the beginning of the string to uncomment the directive.

  1. Save the configuration file
  2. Return back to the C:\Program Files\Nectus\Web\Apache24\bin folder and double-click on ApacheMonitor.exe

  1. The ApacheMonitor app will appear in the system tray at the lower right corner of your screen. Find and click it there.

  1. Hit “Restart”

  1. Now you can try accessing your Nectus GUI page in the browser via HTTPS: https://yourdomain.com

 

Configuring Linux Monitoring in Nectus

,

Configuring Linux Monitoring in Nectus

Nectus Server 1.55 adds feature to monitor some system parameters on hosts running Linux. Enabling this feature for your infrastructure requires two steps:

  • Configuring of Nectus Server;
  • Installing and configuring of Nectus remote agents on target Linux machines.

This guide describes steps for Nectus Server configs. Installing and configuring of Linux remote agents are described here.

Linux monitoring integration

Choose the following menu item from the Nectus GUI to set global Linux monitoring parameters.

This will open the next window:

  • Agent mode determines whether the agent runs in passive mode (when it waits for an incoming connection from the server and then collects the required metrics) or in active mode when the agent connects to the server pro-actively and sends the collected data.
  • Server TCP port sets the server port number for incoming connections from the agents running in active mode. If you set Agent mode to passive then this value is not used.
  • Pre-shared Key determines the secret key used to encrypt and decrypt messages between Nectus Server and the monitoring agents. You can set string of any length but recommended length is from 8 to 16 characters. The exactly same key should be set in all agents’ configuration files (parameter SERVER_PRESHARED_KEY, see details here).

Click OK to save configured parameters.

 

 

Select “Linux Monitoring Settings” from the “Monitoring” menu to configure your monitoring profiles for Linux machines.

Click “Create” to create a new monitoring profile:

In the following form enter the name of your profile and choose metrics you would like to monitor:

 

Configure the necessary metric parameters like minimal and maximal thresholds, alerting etc.

You can create any number of profiles and assign each of them to different group of Linux machines.

Linux Servers

 

Select “Linux Servers” from the “Inventory” menu to configure groups and servers to be monitored.

Click “Create new Group” in the next form:

 

Enter “Group Name” for the new group, select “Enable monitoring” and choose the desired Monitoring Profile for this server group:

Also select the appropriate alert recipients in this form.

You can create any number of monitoring groups if you need to apply different profiles or alert recipients for different server groups.

When you have finished with the groups switch to the next tab “Servers” in the same form and click “Add Server” to add a Linux server to be monitored:

In the next window enter the Hostname (optional, it will be obtained later during the monitoring process), IP address, TCP port of the remote agent’s listening socket (default 5400) and choose the appropriate Group:

You can choose different values of TCP port for different servers according to your network configuration. But note that this value must match the parameter AGENT_PORT set in the agent’s configuration file (see details here).

After clicking “OK” you will see the server in the following list and you will be able to View, Edit and Delete the server (operations are marked with a red square).

After you have added all the desired servers and installed the remote agents the process of monitoring of your Linux hosts will start automatically.

 

Device View Auto Population Rules

, ,

Device View Auto Population Rules

Device View is the logical grouping of the devices that can be used in different places within the Nectus application. In the previous versions of Nectus, the user would manually add devices into device views which may become a significant management overhead.

In Nectus version 1.55 we introduced an ability to automatically populate device views based on specific conditions such as device names, types, etc.

User can define a set of conditions which has to be true for Nectus to automatically add devices to device views.

This article will guide you through the process of defining the auto population rules for device views.

To access your SNMP Device Views go to Inventory Views SNMP Device View

 

 

To add a new Device View, click Create in the upper right hand corner of the SNMP Devices Views page.

 

Give a name to your new Device View.

 

.

Press Save button to finish creation of Device view.

 

Open again newly created device view and in the upper right-hand corner, select Edit Rules.

This will open the Devices View Auto Population Rules page.

 

Select the plus sign to add a new Auto Population Rule.

 

Add all the required Auto-population rules and press Ok button to Save.

If multiple rules are defined all the rules must be TRUE for device to be automatically added. (Logical AND).

Your rules will be processed daily at 3:00 PM.

If you would like to apply your rules immediately, press the Apply Rules button.