*Step 1: Before you start

1. Before proceeding with advanced troubleshooting steps, please be sure you’ve completed the initial network diagnostics.
   Click the appropriate link below based on your connection type:
   • Cellular LTE Connection
     • Non-ETB LTE Modem - Start Here
     • ETB Provided LTE Modem - Start Here
   • Site Provided Connection
     • On-Site Network (Non-LTE) - Start Here
2. Ensure you have Required hardware and software available
   • Tools or keys necessary to access the ETB EMS Karbon PC and switch
   • Have a laptop with an ethernet port -OR- a USB ethernet adapter
     • Ensure you have admin access to change your IP address settings, if special permission is required, please obtain this in advance.
   • Microsoft Teams on a device with a camera (laptop, tablet, cell phone)
   • Working ethernet cable

Step 2: Connect to Karbon PC

1. Plug laptop into the ethernet switch connected to LAN 2 of the ETB EMS.
2. Configure IPv4 ethernet properties using either the PowerShell script or Manual process:

   • PowerShell Script Process

     • Download the attached ETB NVTIP script.
     • Right click the downloaded file and choose "Run with PowerShell".
       If you are unable to run the script due to lack of permissions or another error, continue to the Manual Process.
     • At the User Account Control pop-up asking to allow the app to make changes, click "Yes".
     • Look for "Ethernet adapters found:" and locate the number in front of the Ethernet connection that is connected to the EMS.
       If you only have one Ethernet port there should only be one option, "1 Ethernet".
     • At "Enter the number of the adapter to configure:" type the appropriate Ethernet number then press Enter.
     • After a few seconds you will see some IP Address information then a message. Be sure to leave this screen open.

   • Manual Process

     • The instructions can be found under the "Change TCP/IP Settings" heading in this Microsoft document.
       Be sure to take note of your current settings for reversing the changes after troubleshooting is complete.
       • IP address: 10.0.0.60
       • Subnet mask: 255.255.255.0
       • Default gateway: 10.0.0.1
       • DNS info 8.8.8.8
3. Once the IPv4 settings have been configured, open a web browser and enter the following in the address field to access the Network Validation Tool
   • http://10.0.0.1:8080
4. Once the page loads continue to Step 3
   • If the page fails to load, plug the laptop directly into LAN 2 on the Karbon PC and test again
     • Page Opens
       • If the page loads without changing laptop settings, there may be an issue with the connection from LAN 2 to the switch that may be fixed with an ethernet cable replacement
     • Page Doesn't Open
       • Test-NetConnection instructions

Step 3: Network Troubleshooting

Network Status Tool

Once you are able to successfully access http://10.0.0.1:8080, you will see an Energy Toolbase web page.

1. If the tool is not already open, click "Network Status Tool" at the top of the page.
2. Click "Run Tests" at the bottom of the page
   
3. You will see a "Test is in progress..." notification. Wait for it to complete and do not close or refresh the page.
   
4. Once completed, you will get a report summary. A successful test will look similar to this screenshot:
   

Handling Test Failures

• For Internet Test failures, disconnect from the EMS, revert your IP settings back to their default configuration, then plug in then re-attempt initial network diagnostics.
• For Port Test failures, take note of the port(s) that failed to verify under "Failed Tests" then reach out to the site's network administrator to have them enable traffic through the firewall.
  • For more information regarding the ports that should be enabled see our Site Internet Configuration documentation.
• For Socket Test failures, do not close the page and contact ETB Support.
  • If you are unable to contact ETB Support while the page is open, please note the exact Failure message(s) and take a screenshot of the page for later reference.

Connected LAN Devices

This will show the devices the EMS "sees" on the network. Devices shown will vary depending upon site configuration. 
If no devices show, this could be an indication of a wiring or configuration issue with a meter(s) and/or a BESS Controller. 

Download Report

You may be asked to provide a Network Status Report for ETB analysis.
After running the test, the report can be obtained as a .CSV file by clicking "Download Report" at the top of the page.

Troubleshooting Complete

• If you used the PowerShell Script to change your IPv4 settings, type 2 in the PowerShell window then hit Enter to revert your IPv4 settings back to their default configuration.
• If you used the Manual process to change your IPv4 settings, manually revert your settings back to their original configuration.
   

Test-NetConnection Checking

Script Process

1. Download the ETB TestNetConnection script below.
2. Right click the downloaded file and choose "Run with PowerShell".
   If you are unable to run the script due to lack of permissions or another error, continue to the Manual Process.
3. The script will run and display the list of ports that pass or fail the test connection

Manual Process

1. Open PowerShell by right clicking the program then choosing "Run as administrator" then clicking "Yes" at the pop-up window.
2. In PowerShell type the following command followed by the port number you are testing (in place of the "X").
   A list of the ports that need to be checked can be found in our Site Internet Configuration documentation.

Test-NetConnection www.portquiz.net -Port X

Handling Test-NetConnection Failures

For relevant port failures, take note of the failed ports then reach out to the site's network administrator to have them enable traffic through the firewall.

FAQ

If the testing above fails or you need further assistance, contact ops@energytoolbase.com or the ETB Tech Support line, (866) 415-1445.

Scripts