Recoverfromnetwork – Echelon OpenLNS User Manual

Page 903

Advertising
background image

OpenLNS Programmer's Reference

866

Layer 2 network

interface, an exception

will be thrown.

FALSE. OpenLNS will read the

domain signature from

the DomainId property.

In this case, you should

make sure the DomainId

property is set to a valid

value.

Added to API

Prior to LNS Release 3.0.

RecoverFromNetwork

Summary

Recovers the OpenLNS database from the physical network

.

The

System

object uses two methods to support network

recovery: the

PrepareToRecoverFromNetwork

method sets up

for recovery and the

RecoverFromNetwork

method performs

the actual recovery. The

RecoveryStatus

property allows

users to view the state of recovery by returning a

RecoveryStatus

object with recovery information.

To recover from the network, follow these steps. Consult the

OpenLNS Programmer’s Guide for more detailed information:

1. Call the Add method of the Network object to create a

new Network.

2. Set the NetworkInterface object contained in the System

object’s NetworkServiceDevice object to identify the

network interface for the new network.

3. Call the PrepareToRecoverFromNetwork method. Note

that the Network object must be initialized; if objects

have been added after creation, an error will result.

4. Call the Open method of the System

object. Note that if

the recoverNetInterface parameter of the

PrepareToRecoverFromNetwork method was set to True,

the domain signature will be taken from the network

interface device, and not from the System

object’s

DomainId property.

5. Optionally add objects, set properties, and call methods.

This includes defining DeviceTemplate objects and setting

network timers or other properties of the System

object.

6. Call the RecoverFromNetwork method of the System

object. If you have modified the attributes of the network

image of any of the devices in your network outside of

OpenLNS, including the channel ID of any of the devices,

the OpenLNS Server may be unable locate that device on

the network during recovery. This may cause recovery to

fail.

7. After the network recovery has completed, the

Advertising