Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Many issues are resolved by updating to the latest SmartServer software. Review the SmartServer release notes before upgrading or re-imaging to a different software version. For issues that require diagnostics, this section provides some helpful hints to troubleshoot various issues that you may experience with the SmartServer.

...

To find the SmartServer IP address, connect your laptop to the SmartServer console port and run ifconfig. See Finding the SmartServer IP Address in the Connect to Your SmartServer section for more details. See Finding the SmartServer IP Address.

...

Note
titleU60 and U70 USB 2.0 Ferrite Bead filter

If you experience problems with the U60 or U70, then add a USB 2.0 ferrite bead clamp onto the USB cable to reduce LON channel noise (similar to one used for the SmartPhone, see link below). 

https://www.usbfirewire.com/parts/rr-fh0-500b.html

See the steps below for more information and diagnostics. 

  1. Verify that the U60 or U70 is up using one of the following methods:
    1. Use the LON Configuration page to see if the U60/U70 appears under LON interfaces.
      1. Use the console/SSH command ifconfig and check the lon#. There should be one lon# per U60/U70.

    2. If the U60 or U70 do not appear, then perform the following:
      1. Verify whether these devices are plugged in.
      2. Check for USB noise by looking for EMI? in the SmartServers.

        1. For SmartServer release 4.0 and higher (most of the important logs are now in the /var/log/syslog): 
          1. Go to the System Configuration Web page and click on the Logs button which will download the file to your PC (usually downloads folder).
          2. Extract the *.tgz - on windows you can use 7-zip to extract the files.
            1. During the extraction process you may see a Confirm File Replace dialog pop up. If you see this dialog click the Auto Rename button.
          3. Extract the *.tar file.
            1. During the extraction process you may see a Confirm File Replace dialog pop up. If you see this dialog click the Auto Rename button.
            2. As some of the files in the *.tgz are symbolic links which may not be supported by Windows, wait until the progress bar is completely green and the click the Close button.
            3. Look for EMI? in  /var/log/syslog, using console/SSH. 

              Code Block
              sudo grep "EMI?" /var/log/syslog


        2.  For Smartserver 3.6 and prior releases:
          1.  Look at /var/log sys.log, kern.log, and error files using the commands below. If you see EMI? in the log files, then you need to add a filter, like a USB 2.0 ferrite bead clamp onto the U60/U70 USB cable.

            Code Block
            titleConsole/ssh commands to look for looking for EMI?
            sudo grep "EMI?" /var/log/kern.log
            
            sudo grep "EMI?" /var/log/error
            
            sudo grep "EMI?" /var/log/syslog


      3. Reboot the SmartServer.

        If the U60/U70 continuously stops working after power cycles, then perform the following:
        1. For SmartServer 3.6 only, enter the following SSH command (this command may allow the U60/U70 to come up, but it is not a fix):

          Code Block
           sudo /sbin/apollo-usbreset start


        2. For all SmartServer versions, add a USB 2.0 ferrite bead clamp onto the U60/U70 USB cable.

    3. Verify that the LTE and LTX services are running.
      1. For SmartServer release 4.0 and higher:
        1. Check if LTE and LTX services are running. The LTE and LTX may get restarted if you import or make changes to an XIF file or re-import Resource File Set XML file.
        2. Check the current status of these services using the following ssh commands. The example below shows the U60 working.

          Code Block
          $ sudo smartserverctl status
          alarm                              ACTIVE              1h 4min
          bacnet                             ACTIVE              1h 4min
          core                               ACTIVE              1h 4min
          datapoint-connection-manager       ACTIVE              1h 4min
          datapoint-controller               ACTIVE              1h 4min
          datapoint-get                      ACTIVE              1h 4min
          enocean-driver                     ACTIVE              1h 4min
          formatter                          ACTIVE              1h 4min
          housekeeper                        ACTIVE              1h 4min
          iap-controller                     ACTIVE              1h 4min
          init                               ACTIVE              1h 4min
          lim                                ACTIVE              1h 4min
          loader                             ACTIVE              1h 4min
          logger                             ACTIVE              1h 4min
          lon                                ACTIVE              1h 4min
          lte                                ACTIVE              1h 4min
          ltx                                ACTIVE              1h 4min
          lwd                                ACTIVE              1h 4min
          modbus                             ACTIVE              1h 4min
          monitoring                         ACTIVE              1h 4min
          mosquitto                          ACTIVE              1h 4min
          node-red                           ACTIVE              1h 4min
          pyro4-ns                           ACTIVE              1h 4min
          query                              ACTIVE              1h 4min
          reboot-manager                     ACTIVE              1h 4min
          resource-publisher                 ACTIVE              1h 4min
          scheduler                          ACTIVE              1h 4min
          secmount                           ACTIVE              1h 4min
          services                           ACTIVE              1h 4min
          smartserver                        ACTIVE              1h 4min
          storage-manager                    ACTIVE              1h 4min
          apollo@smartserver-17qam88:~$


        3. You can also restart these services as they may get out of sync (for example, you may have deleted a device in the CMS, but it did not get cleared from MQTT) using the following command: 

          Code Block
          sudo smartserverctl restart lon


      2. For SmartServer 3.6 and prior releases:
        1. Check if lon:echlte and lon:echltx services are running. The LTE and LTX may get restarted if you import or make changes to an XIF file or re-import Resource File Set XML file.
        2. Check the current status of these services using the following ssh commands. The example below shows the U60 working.

          Code Block
          sudo supervisorctl status
          
          
          ~$ sudo supervisorctl status
          apollo-init                      EXITED    Dec 19 06:29 AM
          core:echhousekeeper              RUNNING   pid 1159, uptime 4:21:35
          core:echlim                      RUNNING   pid 1163, uptime 4:21:35
          echbacnet                        RUNNING   pid 1155, uptime 4:21:35
          echmodbus                        RUNNING   pid 1240, uptime 4:21:34
          echopcua-server                  STOPPED   Not started
          lon:echlte                       RUNNING   pid 3627, uptime 4:19:57
          lon:echltx                       RUNNING   pid 3626, uptime 4:19:57
          ready                            EXITED    Dec 19 06:29 AM
          services:echalarm                RUNNING   pid 1208, uptime 4:21:35
          services:echapollo-rp-launch     RUNNING   pid 1236, uptime 4:21:34
          services:echconnection           RUNNING   pid 1214, uptime 4:21:35
          services:echdatapointcontrol     RUNNING   pid 1216, uptime 4:21:35
          services:echdatapointget         RUNNING   pid 1227, uptime 4:21:35
          services:echformatter            RUNNING   pid 1229, uptime 4:21:35
          services:echiap-controller       RUNNING   pid 1239, uptime 4:21:34
          services:echloader               RUNNING   pid 1185, uptime 4:21:35
          services:echlogger               RUNNING   pid 1170, uptime 4:21:35
          services:echmonitoring           RUNNING   pid 1174, uptime 4:21:35
          services:echquery                RUNNING   pid 1180, uptime 4:21:35
          services:echscheduler            RUNNING   pid 1237, uptime 4:21:34


        3. You can also restart these services as they may get out of sync (for example, you may have deleted a device in the CMS, but it did not get cleared from MQTT) using the following command: 


          Code Block
          sudo supervisorctl restart lon:


          Note

          Be sure to include the : at the end of the command.


  2.  Use NodeUtil to see if device status "s" works.

    1. Using NodeUtil: Make sure that an RNI is set up for the U60 or U70. Next make sure you set up a RNI in the PC Windows Control panel > LonWorks Interfaces applet. 

      1. Start NodeUtil (e.g., nodeutil -dx.default.215) using a DOS command prompt.

      2. Add the device neuron Id (from the CMS Device Widget) to NodeUtil using the "a" add command. Next click "g" followed by return and then "s".

    2. If NodeUtil device status works
      1. Make sure the device is configured for the correct domain Id.
        1. Press "d" for domain in nodeUtil which will show you the device's domain ids. You can look at the SmartServer Configuration Page LON Tab for the current domain id.
      2. If correct domain ids, then try restarting the LON drivers as shown above. 

...

Code Block
titleSmartServer 3.6 and prior releases
sudo supervisorctl status


BACnet Client – real BACnet devices and you use the SmartServer CMS to read and write to BACnet devices.

Verify that BACnet is enabled.

...

  1.  Once you enable repeating static/dynamic, you cannot revert to non-repeating. Doing so requires that you perform a database reset using the System Configuration page that deletes all of your settings and devices. Once repeating is enabled, you can change between static and dynamic. 

    Info

    You typically will enable dynamic repeating to cause the SmartServer to set up repeating chains based on power line communication. In most cases, you will use dynamic repeating so that the SmartServer periodically checks the network and sets up the best repeating path based on current channel impairments. 


    Note

    After you change the power line communications setting in the SmartServer LON Configuration page and press the Power Line Communications Update button, you need to reboot the SmartServer.


    1. Devices appear red in the CMS – if you are using repeating (static or dynamic), then you can use the DCI console commands to see the devices' current state and repeater chains. If the CMS Devices widget shows red devices, but the dcxshowdevices shows that devices are up, then use the CMS Devices widget to test the device. This test will determine whether communication is truly down.

    2. Check the SmartServer Configuration Page LON Tab to see if the U70 is working.
      1. If U70 is not working you many need to upgrade the U70 software (and SmartServer software), and add a filter. See CENELEC note above for upgrading U70 software, and U60 and U70 USB 2.0 Ferrite Bead filter note. for filter details.
        1. Even there is no issue with the U70, you may want to add these enhancements to prevent future issues.
    3. Using NodeUtil – when power line repeating is enabled, NodeUtil can only be used to communicate edge devices, which can be reached directly by the SmartServer. NodeUtil cannot be used to communicate to edge devices that require a repeater since there is no way to specify a repeater path with NodeUtil.


    4. Using LonScanner – LonScanner can only see traffic locally; therefore, you will only see traffic that the SmartServer can hear. LonScanner sees packets that go to devices that the SmartServer can communicate directly to (1 hop). For devices that require repeaters (2 or more hops), in most cases, LonScanner will not show the packets in between repeaters and the destination device. 

...