Manually modifying an xml configuration file, Creating an xml file, Modifying an xml file – Echelon i.LON 100 e2 Internet Server User Manual

Page 220: Manually modifying an xml configuration file -1, Creating an xml file -1, Modifying an xml file -1, 15 manually modifying an xml configuration file, 1 creating an xml file, 2 modifying an xml file

LON 100 Internet Server Program

LON 100:

mer’s Reference

15-1

The following procedure describes how to create an XML file, and add it to the configuration
directory of the

15 Manually Modifying an XML Configuration File

You can create and manage the XML configuration files of your

LON 100 manually, or with

the

LON 100 SOAP interface. This section describes how to create an XML file and

download it into the proper directory of the

LON 100, and how to access an XML file that

has already been created, modify it, and download it back to the

LON 100.

Echelon strongly recommends that you use the SOAP interface to manage the XML
configuration files. The

LON 100 performs error-checking on all data written in a SOAP

message, so that invalid data is not written to any of the XML files. The

LON 100 will not

perform error-checking on any XML files downloaded to it via FTP, and so manually editing

the XML files may cause boot errors.
Additionally, SOAP messages can be sent to the

LON 100 while it is operating, and the

XML files affected by the SOAP messages will be updated without requiring a reboot. If you

manually edit the XML files using the procedures described in this chapter, you will need to
reboot the

LON 100.

15.1 Creating an XML File

1. Create the XML file following the guidelines provided in this manual. The documentation

for each application describes the format the XML file must be created with, and describes
the properties you must define in each XML file.
Be sure to save the file using the file names provided in this document. You should use a text

editor such as Microsoft® XML Notepad to create your XML file.

2. Use an FTP client application to open an FTP session to the

LON 100. You can connect to

the

LON 100 by specifying either its IP address or its hostname.

The default user name and password for the

LON 100 is ilon.

3. Insert the XML file in the applicable directory. Most of the XML files described in this
document belong in the /root/config/software directory. Refer to the documentation of each

application in this manual for more information.
4. Close the FTP session and reboot the

LON 100. When the

LON 100 reboots, it will read

the new XML files and adjust its configuration accordingly.

15.2 Modifying an XML File

The following procedure describes how to access an XML file that has already been added to
the

LON 100, and how to modify it:

1. Use an FTP client application to open an FTP session to the

LON 100. You can connect to

the

LON 100 by specifying either its IP address or its hostname.

The default user name and password for the

LON 100 is ilon.

2. Access the directory of the XML file you want to modify. Most of the XML files described in
this document can be found in the /root/config/software directory of the

LON 100. Refer to

the documentation of each application in this manual for more specific information.