Strategy for Two-Phase Network Start?

RapidCode API
1

Two-Step Network Start

Avatar: RapidSetup

RapidSetup gives you the power to discover, (generate a new ENI—not discussed here), and start.

Is there documentation regarding accomplishing this within RapidCode?

Discovery

I would guess that that discovery would not attempt to make the network operational. In the API (NetworkStart()), I assume should I choose RSINetworkStartModePREOPERATIONAL as the start mode and RSINetworkStartupMethodPROBE_TOPOLOGY as the startup method. Is that correct?

Result / Errors?

How do I discern success/failure? Does in throw exceptions?

When I discover in RapidSetup, the state at the end of the operation is RSINetworkState_SHUTDOWN. I might have expected it to be RSINetworkState_PREOPERATIONAL, but I don’t really know what to expect.

What should I expect?

Network Start

For this, I assume that I need to set the startup method to RSINetworkStartupMethodNETWORK_ONLY and the start mode to RSINetworkStartModeOPERATIONAL.

Result / Errors?

Is checking the network state (against operational) sufficient for success? Will it throw exceptions?

2

Documentation
We are looking into expanding the documentation. In the meantime see the network start helper function.

Discovery
Correct, you should be using RSINetworkStartupMethodPROBE_TOPOLOGY for the start mode. However, RSINetworkStartModePREOPERATIONAL is not needed or desired here. Use RSINetworkStartModeOPERATIONAL

Results
After probing you could check the node count.

RSINetworkState_SHUTDOWN is the expected state after discovery. You will find an “INITALIZE TO PREOPERATIONAL” button above the network start in Rapid Setup. That is what would get state to RSINetworkState_PREOPERATIONAL. Again, this isn’t needed in your case.

Network Start
Yes, assuming a valid ENI file is present.

1 Like