You are here: CSP Developer’s Guide: Overview > 4 EXS API Application Development > Reconfiguration Considerations
Reconfiguration Considerations
You should design your host application to ensure correct reconfiguration after resets.
When you return power to the Excel platform, it retains the system software load but resets the configuration to default values. The host must restore the customizations (such as custom protocols) but it must wait until the Poll message indicates that the Excel platform is ready to take configuration. Review all fields in the Card Status Report message to verify the contents of the Excel platform.
Voice Recorded Announcements are stored in non-volatile flash memory, and are preserved even during power failures.
Single Matrix Controller Reset
Use the Poll message to detect a single Matrix Controller reset. The Matrix Controller state changes from initialize, to standby, to active or switchover, to boot. If the Matrix Controller has a valid system software load, it retains the load. The Poll message also indicates the Matrix Controller state changing from boot, to initialize, to standby, and then to active.
The Excel platform sends Card Status Report messages for all cards. The Excel platform retains the configuration that was last sent by the host (except when the Excel platform is being powered down or when a card is being removed).
When a single Matrix Controller is reset, all calls that were previously connected are torn down and the information on all of the in-service channels reports to the host with the DS0 Status Change message. The host determines the cause of the reset.
If a software fault caused the reset, please send the Fault Log to Excel Technical Support. To obtain Fault Logs, send the Fault Log Query message to the Excel platform.
Standby Matrix Controller Reset
The host is notified of a standby Matrix Controller reset two ways:
• The Poll message from the standby Matrix Controller indicates that the Matrix Controller state has changed from Initialize or Standby to Boot.
• The Poll message from the active Matrix Controller indicates that the standby Matrix Controller has reset.
The system software load is retained. The Poll messages of the standby Matrix Controller indicate the return to the standby state. Any information shared by the active and standby Matrix Controller is sent to the standby from the active Matrix Controller.
The active Matrix Controller sends a Card Status Report message to the host reporting on the standby Matrix Controller. The Poll message reports that the adjacent Matrix Controller is not responding to the Polls. A Matrix Controller reset does not affect connected calls or calls that are in the process of setup.
Active Matrix Controller Reset
The active Matrix Controller sends Poll messages to the host to report a reset. The Poll messages report the Matrix Controller state changes as it transitions from Active, to Boot, to Initialize, to Standby. The standby Matrix Controller sends Poll messages that report the Matrix Controller state changes from Standby, to Switchover, to Active.
When the standby Matrix Controller changes to the active state, the Excel platform sends Card Status Report messages for all cards to the host applications. The Matrix Controller retains the configuration. We recommend creating your host application so that it verifies that the Matrix Controller has retained the configuration. You can use the configuration tags that are returned in the Card Status Report messages, as well as the tags that the application stores for each line card.
The application should prepare itself to communicate with the new active Matrix Controller. The Excel platform maintains connections for all channels that were connected before the switchover occurred. But calls that were in the process of setup are torn down. The Excel platform sends the DS0 Status Change message to the host to report all of the in-service channel states. If a software fault occurs, please notify Excel Technical Support.
When a line card resets, the Excel platform notifies the host with the Card Status Report message. The cards maintain their software load and configuration. Your application should check the configuration tag to confirm that configuration is intact.
All calls associated with the card, both connected and in the process of setup, are torn down. The DS0 Status Change message informs the host of the affected channel states. If the Excel platform is configured for line card redundancy, your application can configure the standby line card and can instruct it to become active.
DSP Card Reset
The Excel platform sends the Card Status Report message to the host to report a DSP card reset. The card maintains its software load and configuration. Use the configuration tag to verify the card configuration. The Excel platform removes the DSP resources from service during the reset. If a second card has the same configuration, DSP resources are maintained.
If the Excel platform cannot appropriately correlate conditions relating to a channel, a channel purge occurs. The channel purge ensures that the Excel platform retains channels when an unexpected condition occurs, such as the following:
• Unexpected signaling conditions
• Unexpected results of related channels
• Timeouts
When a channel purges, the host receives a set of three DS0 Status Change messages with the following values:
• Channel Status: 0x01 (Out-of-Service)
• Channel Status: 0x00 (Purge)
Purge Status: See Purge Status Values for purge reason
• Channel Status: 0x02 (In-Service)
If a channel purges, the host may not receive acknowledgments for outstanding call processing messages sent to the purged channel. Therefore, design all host applications to handle a channel purge.