Echelon OpenLNS - Manual (Page 889)

OpenLNS Programmer's Reference 852
discovery process (see the DiscoveryInterval property).
Devices do not have to be installed by the OpenLNS Server to
be deconfigured; however the following must be true:
•
The devices’ domain IDs must match the domain IDs
referenced by the domainTypes or explicitDomain
elements passed to this method.
• The devices must be in the configured online or soft
offline state.
• The devices must not be authenticated.
The method's parameters specify the domains to deconfigure
and the types of special-purpose devices to exclude. The
possible uses of this method include:
•
To re-use devices from another network. You can invoke
this service to ensure that devices are deconfigured, so
that they do not interfere with traffic on the new
network. In this case, you must specify the domain ID of
the devices to deconfigure. Deconfiguring the devices
also ensures that the OpenLNS Server can discover and
query them using background discovery.
• To deconfigure all devices. Before commissioning a new
network using the predefined components installation
scenario, you can invoke this method to deconfigure all
devices. This ensures that after commissioning, any
AppDevice object that was not defined with the Add
method is unconfigured.
• To refresh the entire network installation. You can
invoke this method to deconfigure all devices, and then
reload the network images for installed devices by
invoking the Commission method, once for each device.
This method does not use or affect device configuration
information in the database. As a result, if devices are
specified to be excluded from deconfiguration, the OpenLNS
Server must individually discover and deconfigure each
device. This process is very time consuming.
Additionally, when deconfiguring a multi-channel network, if
any device type is excluded, routers must also be excluded
(using lcaExcludedDevTypeRouters). Otherwise, routers
will be deconfigured along with the other devices, isolating
remote channels and preventing all devices on those channels
from being deconfigured reliably.
When no devices are excluded (using
lcaExcludedDevTypeNone), the OpenLNS Server
deconfigures the devices using domain-wide broadcast
messaging. All devices configured on the specified domain
that can receive the broadcast will be deconfigured. Devices
residing on channels other than the OpenLNS Server's will
only be deconfigured if the intervening routers are also
configured on the specified domain. When the domain