Versions Compared

Old Version 2

changes.mady.by.user Nina Cardillo

Saved on

compared with

New Version 3

changes.mady.by.user Nina Cardillo

Saved on

Key

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

You can update or re-image your SmartServer software using the SmartServer console and a USB flash drive.  This is one of three methods of updating your SmartServer software as described in Updating or Re-imaging the SmartServer.  The method described on this page is the easiest if you want to delete all of your data and re-image your SmartServer at the same time.  You can only perform an update when the two versions are compatible. All SmartServer software versions prior to version 2.40.507 are not compatible with newer releases. To update releases prior to 2.40.507, re-image the software.

...

  1. Prior to re-imaging, if you are using any custom applications or services on the SmartServer, verify you have backup copies of your custom applications and services.  The re-imaging process will delete any custom applications and services.

  2. Download the SmartServer software image to your computer. The latest update is at the following location: 

    https://downloads.echelon.com/support/downloads/software/smartserver/iot/SmartServer_IoT_Update.armv7l.zip

  3. If you downgrade from SmartServer 4.0 and higher to SmartServer 3.6 or prior, then you will need to remove the certificates before re-imaging for certificates to work. Ignore this step for all other upgrades and downgrades. 
    1. Run the script prep_for_3.x.sh before you perform a re-image. 

      1. If this step is not done prior to the re-image, then the re-image will fail (typically the Ready LED will flash red). In this case, run the Removing SmartServer 4.0 and higher certificates instructions below and reboot the SmartServer.  Use these same commands if you are doing this step on SmartServer 4.0, (AP-11364)

        Code Block
        titleRemoving SmartServer 4.0 and higher certificates
        sudo cd to /var/apollo/data/certs
sudo chmod 755 prep_for_3.x.sh
sudo ./prep_for_3.x.sh


  4. Insert a USB flash drive with at least 2GB of available space into a USB connector on your computer.  

    Warning

    Warning: Prior to SmartServer 2.8, you cannot attach a USB flash drive and a USB network interface, such as the U60, into a SmartServer at the same time. To use both at the same time, plug a powered USB hub into one of the SmartServer USB connectors, and then plug the USB flash drive and all USB network interfaces into the external USB hub. To update the SmartServer software from a USB flash drive without using an external USB hub, first unplug all the USB network interfaces from the SmartServer, and then plug in the USB flash drive. Remove the USB flash drive once the update or re-image process is complete, and then plug in the USB network interfaces.  This warning does not apply if you are using SmartServer 2.8 or newer.


  5. If your USB flash drive is not formatted with a FAT32 file system, then reformat the drive with a FAT32 file system. 

  6. Extract the contents of the update image you downloaded in step 1 to the top-level of your USB flash drive. Do not place the files in a folder on the flash drive.

  7. Eject the flash drive from your computer to flush any cached updates to your drive.

  8. Write down or take a picture of the SmartServer password that is printed on the back of the SmartServer.

  9. Remove the USB flash drive from your computer and insert it into one of the USB connectors on the SmartServer. 

  10. Connect to the SmartServer console as described in Connecting to Your SmartServer.

  11. Verify that you have the expected firmware version USB drive image by entering the following command:

    cat /media/usb0/versions.txt 

    If you see a "No such file or directory" error, then enter the following command to mount the drive:

    sudo mount -o fmask=0022,dmask=0022 /dev/sda1 /media/usb0

  12. From the console widow (SSH or serial console using com[n] 115200 bps), do the following:

    1. To update the SmartServer: 
               sudo /media/usb0/upgrade.sh  
       
    2. To re-image the SmartServer: 
               sudo /media/usb0/re-image.sh 

    3. Enter the [sudo] password when prompted.

  13. If your new SmartServer image requires an active maintenance license, the update script will display the following error message: "This image requires an active maintenance license for installation. Add a new maintenance license to extend the maintenance period for this SmartServer."  See Manage Licenses for more information.

  14. The SmartServer initiates a reboot after a 1 minute delay, and then performs the upgrade or re-image.  During the process, the SmartServer displays status information on your console window, and the LEDs on the SmartServer will blink intermittently.  The SmartServer may display error messages during the update process.  These are benign and you can ignore them if the update completes and the SmartServer software version number is updated.

  15. The SmartServer automatically reboots when the update or re-image is completed. The SmartServer is fully up and running when you can log into the CMS /wiki/spaces/TEMP/pages/44041710. 

    Info
    titleReady LED

    With SmartServer release 3.2 and newer, you can monitor the SmartServer Ready LED for system status. 


  16. After the reboot, unmount and remove the flash drive using the following command to unmount the drive prior to removing it:

    sudo umount /media/usb0    

    Info

    If you update your SmartServer, then the serial number and password do not change. If you re-image your SmartServer, then the internal flash memory is wiped clean, the SmartServer's password is reset to its default (printed on the back of your SmartServer) and the serial number is automatically reapplied to the new image. To change the password, see Managing Passwords in Securing Your SmartServer.


  17. Clear your browser cached data after you update or re-image the SmartServer. For information on how to clear cached data, refer to the links below:

...