Echelon i.LON® SmartServer ReadMe
Release 4.02
(4.02.055), November 2008
Copyright © 1998 –
2008 Echelon® Corporation
All Rights Reserved
This document describes i.LON SmartServer Release 4.02 (4.02.055). This release (or newer) may be included with i.LON SmartServers manufactured after October 2008 and you can apply i.LON SmartServer Service Pack 2A to update Release 4 (4.00.136) and Release 4.01 (4.01.012) SmartServer installations to Release 4.02 (4.02.055). See Release Identification to determine what release you have, and Problems Fixed in Release 4.02 for details on what is fixed in this release. Warning: The SR2 DVD may be included with SmartServers running SR1 firmware. See Release Identification to determine if you need to update your SmartServer firmware.
This document contains important information not included in the i.LON Smart Server User's Guide or in the i.LON SmartServer help files. Additional information and updates, including service packs and critical updates, may be available at www.echelon.com/ilon. The latest service packs and updates may not be included with your SmartServer DVD, and may not be loaded in your SmartServer hardware. See Echelon’s Knowledge Base at www.echelon.com/support for answers to frequently asked questions.
To provide full functionality, the i.LON SmartServer configuration software must be used with Microsoft Internet Explorer 7 or newer. Microsoft Internet Explorer 7 (IE7) is included on the SmartServer DVD and is also available from www.microsoft.com. If you are using the SmartServer with an LNS® Server or the LonMaker® Integration Tool, you must be using the latest Echelon LNS Turbo and LonMaker service packs and updates. The latest LNS and LonMaker service packs and updates at the time of the i.LON SmartServer release are included on the i.LON SmartServer DVD and are also available from www.echelon.com/downloads.
5.1 Installing or Upgrading to Release 4.02
5.2 Modifying/Repairing SmartServer Products Upgraded from Release 4.02.054 to Release 4.02.055
5.3 Upgrading LNS Turbo Server Release 3.24
6 Problems Fixed in Release 4.02
7 Limitations and Known Problems
7.1 Alarm Notifier Summary Web Page
7.2 Modbus Data Point Limitation
8.1 i.LON SmartServer User’s Guide
8.2 i.LON SmartServer Hardware Guide
8.3 i.LON SmartServer Programmer’s Reference
8.4 i.LON SmartServer Power Line Repeating Network Management Guide
8.5 i.LON SmartServer Programming Tools User’s Guide
This ReadMe document applies to i.LON SmartServer Release 4.02 (SR2A and SP2A). To verify that you have this release on your computer, follow one of the following procedures:
· For Windows Vista, click the Start button, type Programs and Features in the Search box, press ENTER to open Programs and Features, and then click Echelon i.LON SmartServer Software. If the Version column is not displayed, right click the list header, select More, and then select Version to add the Version column. The version number of Release 4 Service Release 2A and Service Pack 2A is 4.02.055, the version number of Release 4 Service Release 1 was 4.01.012, and the original SmartServer Release 4 was version 4.00.136.
· For Windows XP, open Add or Remove Programs in Windows Control Panel, and then click Echelon i.LON SmartServer Software. Click the Click Here for Support Information link. The version number of Release 4 Service Release 2A and Service Pack 2A is 4.02.055, the version number of Release 4 Service Release 1 was 4.01.012, and the original SmartServer Release 4 was version 4.00.136.
To verify that you have SR2A loaded on your SmartServer, check the Firmware Version property in the Setup - System Info Web page as described in the i.LON SmartServer User’s Guide in Chapter 3, Viewing System Information and Performance, or by typing show in the console application. If you have SR2A on your SmartServer, the firmware version number will be 4.02.055.
Release 4.02 fixes the problems listed in Problems Fixed in Release 4.02. The following table summarizes the i.LON SmartServer release history:
|
Name |
Number |
Date |
|
i.LON SmartServer |
4.00.136 |
January 2008 |
|
i.LON SmartServer SR1 |
4.01.012 |
March 2008 |
|
i.LON SmartServer SR2A and SP2A |
4.02.055 |
November 2008 |
The following are minimum requirements for the computer running the i.LON SmartServer software:
· Pentium III 1.3 GHz or faster (Pentium IV 1.5 GHz or faster if running Echelon Enterprise Services).
· 768 MB RAM minimum (1 GB if running Echelon Enterprise Services).
· 100 MB free hard disk space (270 MB if running Echelon Enterprise Services).
· DVD-ROM drive.
· Super VGA (1024 × 768) or higher-resolution display with 256 colors.
· Mouse or compatible pointing device.
The following are minimum software requirements for computers running the i.LON SmartServer software:
· Microsoft Windows Vista or Microsoft Windows XP. Install the latest service pack available from Microsoft for your version of Windows.
· Minimum screen resolution of 1024x768 with large or small fonts; or 800x600 with small fonts only.
· If you are using the LonMaker Integration Tool, LonMaker 3.1 with Service Pack 3, Update 1 or newer is required.
· If you are using an LNS tool other than the LonMaker Integration Tool and you are not using the Echelon Enterprise Services, then LNS 3, Service Pack 8, Update 2 or newer is required.
· If you are running Echelon Enterprise Services SR2A on your computer, LNS Turbo Server Release 3.24 or later is required. If you are running earlier versions of Echelon Enterprise Services (Echelon Enterprise Services Release 4 or 4.01 [SR1]), LNS Turbo Server Release 3.20 or later is required.
· Microsoft Internet Explorer 6 or newer. The SmartServer Web pages support Internet Explorer 6; however, there may be a significant delay when loading the SmartServer Web pages if the navigation pane contains more than 2,000 entries. You can install Internet Explorer 7 from the i.LON SmartServer DVD to optimize the performance of the SmartServer Web pages.
· Terminal emulator such as Windows HyperTerminal. If you are using Windows Vista, you must install a terminal emulation application on your computer since Windows HyperTerminal is not included with Windows Vista. You can license Windows HyperTerminal from Hilgraeve; install puTTy, which is included on the root directory of the i.LON SmartServer DVD and the i.LON SmartServer Programming Tools DVD; or download and install another free terminal emulator to your computer.
You can install i.LON SmartServer Service Release 2A (Release 4.02), you can upgrade i.LON SmartServer Release 4 or Release 4.01 to Release 4.02, or you can modify or repair SmartServer products upgraded from Service Release 2 to Service Release 2A. If you are using an LNS Server, you can also upgrade to LNS Service Pack 4A by installing the service pack over any earlier version of the LNS Turbo Server, including an LNS Turbo Server with Service Pack 4 installed.
If you have already installed i.LON SmartServer Service Pack 2 or Service Release 2 (Release 4.02.054), you do not have to reinstall or upgrade the i.LON SmartServer Enterprise Services.
You can install Service Release 2A or you can upgrade i.LON SmartServer Release 4 or Release 4.01 to Release 4.02 by installing i.LON SmartServer Service Release 2A or Service Pack 2A. Service Pack 2A is available as a free download at www.echelon.com/ilon. To install Release 4.02 or upgrade a Release 4 or 4.01 installation to Release 4.02, follow these steps:
1. If you are installing from the Echelon i.LON SmartServer SR2A DVD, insert the DVD into your DVD drive. If your computer does not have a DVD drive, insert the Echelon i.LON SmartServer SR2A DVD on a network accessible computer that has a DVD drive and copy the files on the DVD to shared network drive. If the i.LON SmartServer SR2A setup application does not launch immediately, open the setup.exe file on the root directory of the Echelon i.LON SmartServer SR2A DVD. The i.LON SmartServer SR2A setup application main menu appears.
2. To install i.LON SmartServer Service Pack 2A, download the service pack from www.echelon.com/ilon and store the service pack file in a local folder on your computer. Open the service pack file and then click the Unzip button in the next dialog. The i.LON SmartServer SP2A setup application main menu appears.
3. Click Install Products. The Install Products dialog appears.
4. Click Echelon i.LON SmartServer SR2A Software. The Echelon i.LON SmartServer SR2A Software installer appears.
5. Follow the steps of the installation wizard. The installation will automatically upgrade the existing Echelon i.LON SmartServer Software Release 4 or Release 4.01 installation on your computer to Echelon i.LON SmartServer Software Service Release 2A (Release 4.02).
6. Open the i.LON SmartServer images folder. To do this, click Start, point to Programs, point to Echelon i.LON SmartServer Software, and the select i.LON SmartServer Images Folder. Alternatively, you can browse to the file path of the i.LON SmartServer image folder, which is iLon100\images\iLon100 4.02 in your LonWorks folder.
7. Copy the following folders and files in the iLon100\images\iLon100 4.02 folder on your computer to the root directory of the SmartServer flash disk: lonWorks, modules, web, and iLonSystem.
Note: Do not copy the config folder or the WebParams.dat file in the iLon100\images\iLon100 4.02 directory to your SmartServer. This prevents the following:
· Deletion of network configuration data if you did not change the name of the network from the default Net.
· Duplication of network configuration data if you are running the SmartServer in Standalone mode.
· Overwriting the root/config/systemhealth.conf file, which determines how the SmartServer’s system health is monitored.
· Overwriting the root/config/software/lspa.xml file, which contains the current LonScanner Protocol Analyzer settings that you may have specified in the Setup – Security Web page.
· Overwriting any pre-defined type translator rule XML files in the root/config/software/translatorRules folder that you may have modified
· Overwriting any pre-defined template XML files in the root/config/template folder that you may have modified.
· Overwriting any Web page restrictions you may have created with the i.LON Web Server Security and Parameters program.
8. Copy the startup.scr file in the iLon100\images\iLon100 4.02\config folder on your computer to the root/config directory of the SmartServer flash disk.
9. Copy the following files from the backup to the SmartServer flask disk, if necessary:
· web/index.htm (if you modified the SmartServer home page or added a link to your custom SmartServer Web pages to it.
· web/images/[app/ || tree/]<image>.gif (if you wrote over any of the SmartServer’s built-in images, which is not supported).
10. Reboot your SmartServer using the SmartServer Web pages or the SmartServer console application.
· To reboot your SmartServer using the SmartServer Web pages, right‑click the local SmartServer, point to Setup, and then click Reboot on the shortcut menu. The Setup – Reboot dialog opens. Click Reboot to start the reboot.
· To reboot your SmartServer using the SmartServer console application, enter the reboot command.
You can upgrade i.LON SmartServer Release 4.02.054 (from SmartServer Service Pack 2 or Service Release 2) to Release 4.02 by following the procedure in Upgrading to Release 4.02. If you upgrade Echelon i.LON SmartServer Software, Echelon i.LON SmartServer Enterprise Services, or Echelon i.LON Vision from SmartServer Service Pack 2 or Service Release 2 (Release 4.02.054) to Service Pack or Service Release 2A (Release 4.02.55) and then modify or repair the application in the Add or Remove Programs tool, the Release 4.02.054 software is restored. In this case, you need to reinstall the Service Pack 2A or Service Release 2A (Release 4.02.55) version to upgrade the application again.
You can upgrade i.LON SmartServer Release 4.02.054 (from SmartServer Service Pack 2 or Service Release 2) to Release 4.02 by following the procedure in the Echelon i.LON SmartServer Enterprise Services ReadMe document, including the step to install LNS Server/Turbo Edition SP4A. If you upgrade LNS Turbo Server Release 3.24 from Service Release 2 (4.02.054) to Service Release 2A (4.02.55), both versions are listed in the Add or Remove Programs tool. In this case, you can delete the Service Release 2 (4.02.054) version.
The following table summarizes problems fixed in i.LON SmartServer Release 4.02. The EPR column lists Echelon internal problem tracking numbers.
|
EPR |
Description |
|
47975 |
If you change the interface of a device without changing the program ID, you may see network variables from the original device interface in the SmartServer navigation pane. |
|
48528 |
If you attempt to delete a device from the SmartServer navigation pane, but the delete operation fails on the LNS Server, the SmartServer navigation pane does not show the correct data. |
|
48644 |
You cannot disable the sidebar, menu, or copyright frames in the i.LON Vision Frameset object. |
|
49001 |
You cannot properly size popup dialogs in custom SmartServer Web pages. |
|
49112 |
You cannot copy many external network variables of similar devices from the LNS navigation pane to the SmartServer. |
|
49221 |
The Scheduler Web interface may not function properly if the host computer is located in a western time zone. |
|
49304 |
You cannot open custom Web pages on another SmartServer in the application frame of custom Web pages on your local SmartServer. |
|
49492 |
The value of the nvoTimeDate data point on the Real-Time Clock is 00-00-00 00:00:00. |
|
49619 |
The Scheduler may not execute events if exceptions created from the Calendar are used and all scheduler instances have been deleted and recreated without first rebooting the SmartServer. |
|
49716 |
You cannot create more than 49 exceptions in a single Scheduler. |
|
50268 |
Deleting a public exception from the Calendar does not remove its references from all Schedulers. |
|
50334 |
The Real-Time Clock stops functioning properly if there is more than one Real‑Time Clock functional block in the SmartServer navigation pane. The Digital Output application stops functioning properly if there are more than two Digital Output functional blocks in the SmartServer navigation pane. |
|
50902 |
You cannot change the OnNet/OffNet network management mode if you are using the SmartServer in power line repeating mode. |
|
50903 |
After you reboot or restart a SmartServer, date-based Event Schedulers (i.e. Schedulers that schedule events for specific dates) do not work if several schedulers are defined and the last one has no date-based events. |
This section describes known limitations and problems for the i.LON SmartServer Release 4.02 software. Numbers in parentheses at the end of the descriptions are Echelon's internal problem tracking IDs.
The Alarm Notifier: Summary Web page keeps obsolete active alarm entries after comments are changed. Workaround: Refresh the Web interface or navigate to another page and back (50425)
The maximum number of Modbus data points per channel is 500. (50185)
This section describes the changes made to the i.LON SmartServer documentation for Release 4.02.
· Enhanced LNS synchronization instructions throughout document.
· Added new sections in Chapter 3 describing how to deploy a pre-configured SmartServer on a single network, deploy a pre-configured SmartServer on multiple networks, and deploy a network configuration on multiple SmartServers.
· Added new Creating External Data Points from Device Templates section in Chapter 4 describing how to use device templates to quickly create a large number of external data points on the SmartServer.
· Added new sections in Chapter 5 detailing LNS Auto, LNS Manual, and Standalone modes.
· Updated Chapter 7 describing the enhanced Web interface for the Scheduler application. Describes new procedures for creating exceptions and one-time exceptions, and includes updated sunrise/sundown events example.
· Updated Custom JavaScript Object section in Chapter 12 describing how to write to structures, enumerations, and non-integral or floating point scalar data points, and how to use custom arguments in a custom JavaScript object.
· Added new Using the NLS Text Object section in Chapter 12 describing how to use the NLS Text object and the i.LON SmartServer Programming Tool to translate custom SmartServer Web pages into multiple languages.
· Added new Opening SmartServer Applications from Custom Web Pages section in Chapter 12 describing how to access the SmartServer’s built-in Web pages from custom SmartServer Web pages.
· Added new Chapter 13 that describes how to use the SmartServer with the LonMaker tool.
· Added new section in Chapter 1 describing how to connect a Multi-Tech MTCBA-G-F4 Modem to the RS-232 port on the SmartServer.
· Updated steps for instantiating and initializing the SmartServer Web service for C# and Visual Basic in Chapter 20.
· Added new Chapter 22 that provides C# and Visual Basic programming examples for reading and writing data points, commissioning external devices, and configuring the SmartServer using the System Service methods in the SmartServer’s iLON100_System.wsdl.
· Updated Chapter 4 describing the enhanced Web interface for the Scheduler application. Describes new procedures for creating exceptions and one-time exceptions, and includes updated sunrise/sundown events example.
· Changed title from i.LON SmartServer Freely Programmable Modules User's Guide to i.LON SmartServer Programming Tools User’s Guide.
· Added new Checking for Data Point Property Updates section in Chapter 5 that describes how to call the NotifyOnAllUpdates() method in the constructor of your FPM so that the Changed() method checks whether data point properties have been updated, including value, status, time of last update, and priority.
· Updated code samples for using FPM driver methods in Chapter 5 and Appendix A.
· Updated Debugging FPMs section in Chapter 5 that describes new procedures for using System Mode debugging with WindRiver Workbench.
· New Deploying FPM Drivers section in Chapter 6 that describes how FPM drivers are displayed in the SmartServer Web interface.
· Updated Creating Custom FPM Configuration Web Pages section in Chapter 6 describing the NLS Text object, which is automatically added to custom FPM Web pages created with the i.LON SmartServer Programming Tool.
· Added new NotifyOnAllUpdates() section in Appendix A that describes the NotifyOnAllUpdates() method, which you can use to modify the Changed() method so that it checks whether any data point property has been updated.
· Added new RS-232 and RS-485 methods documented in Appendix A.
Echelon, LON, LonWorks, i.LON, LNS, and LonMaker are registered trademarks of Echelon Corporation in the U.S. and other countries.