In NetBrain Integrated Edition 10.0, NetBrain began to deliver our device driver updates exclusively through the NetBrain Customer Portal to ensure a more secure delivery mechanism for our customers. Starting in NetBrain 10.0a, NetBrain is also delivering our core service patches through the NetBrain Customer Portal update feature as well.
Some NetBrain systems in the field may have some undetected configuration issues that will prevent successful application of these patches using the automation now built into NetBrain Integrated Edition 10.1. This tool to help minimize the number of manual verifications that are required by the NetBrain Support and Customer Teams prior to the first patching operation. The tool discussed in this Knowledge Base article will help verify the following areas of system readiness:
- NetBrain Knowledge Cloud Proxy service configuration
- Service Monitor Agent Service Configuration
- Connectivity between WebAPI Server and Service Monitor Agent across all services
Validate that NetBrain Service Monitor is Fully Operational
- Log into the NetBrain End User interface with an account that has administrator (sysadmin) privileges.
- At the end user interface desktop, click on the domain name in the upper-right corner of the desktop, then click Domain/System Health, then finally click Service Monitor.
Image - Domain Details pane
In a few moments, a new browser tab will be opened displaying the NetBrain Service Monitor interface. The NetBrain Service Monitor displays the current running status of the NetBrain service suite along with some critical operational metrics.
- In the NetBrain Service Monitor interface, confirm that in the lower half of the screen, all available Servers are listed.
Image - Service Monitor Server List (Two-Server)
If any of the Service Name boxes for each of the servers is any other color than GREEN, this is an indication of a failure of potential service communication or stopped service and needs immediate correction. Open a support case with NetBrain Technical Support in our Customer Portal.
The number of servers displayed is dependent on the size of the NetBrain system deployed. Typical environments for customers with less than 2000 discovered nodes would be a "Two-Server" system comprised of (1) Linux Database and (1) Windows Application server. For larger systems (> 2000 discovered nodes), we would expect a minimum of (1) Linux Database and (3) Windows Application servers
- Click on each of the green boxes associated with each server. This provides the current running details of the services along with chart based metrics. Confirm that each Metric of the service has Value and Chart data visible, where applicable.
If any service is not properly displaying Value or Chart data, this is an indication of a potential failure of service communication and needs immediate correction. Open a support case with NetBrain Technical Support in our Customer Portal.
Validate RabbitMQ Port 15672 Connectivity
- Using Remote Desktop (or equivalent), connect to the primary NetBrain Windows WebAPI server with an adminsitrator account.
- Open your internet browser of choice (Chrome, Firefox, Edge, etc.), then navigate to the the following URL: http(s)://<NetBrainLinuxDatabaseIP>:15672
Image - RabbitMQ Login Screen
- Verify that the RabbitMQ login interface is displayed. This confirms that we will have successful port connectivity between the WebAPI server and the RabbitMQ service that runs on the Linux Database virtual machine.
Note: If the NetBrain deployment has multiple Linux Database machines deployed (HA Configuration), repeat steps 2 & 3 with each Linux Database IP Address.
If the RabbitMQ login interface displays a white screen or generates an error, port 15672 communication may be blocked between the NetBrain WebAPI Server and the NetBrain Linux Database Server. Please attempt to verify if there are any firewalls in place preventing communication, then open a support case with NetBrain Technical Support in our Customer Portal.
Executing the Auto-Update Verification Tool
- Open a Command Prompt with the "Run as Administrator" privilege.
- Navigate to the NetBrain python directory:
cd C:\Program Files\NetBrain\KCProxy\python
- Execute the Auto-Update Verification tool with the following command:
If the au_check.py python script fails to execute or generates any python related errors open a support case with NetBrain Technical Support in our Customer Portal.
Interpreting the Auto-Update Verification Tool Results
- Once execution is complete, press ENTER to exit the verification tool.
- NetBrain has made it easy to verify that all operations have successfully completed with a simple GREEN, YELLOW, RED color scheme for the logging statements that are output:
GREEN - Success
YELLOW - Warning
RED - Failure
Both YELLOW and RED logging statements are indications that there is corrective action that must be taken by the NetBrain admin. The Auto-Update Verification Tool will output some suggested potential corrective actions. If you are unsure how to proceed, open a support case with NetBrain Technical Support in our Customer Portal.
Validating that a critical Service API key for communication is correct
Validating that each NetBrain Server and Service is accessible using Service Monitor
Validating that the NetBrain Auto-Update Services Group is working across all NetBrain Servers