Nile Field Notice: NFN-2025-10-10
Notice ID: NFN-2025-10-10 Date Issued: 10th Oct, 2025 Priority Level: ⚠️ Critical Applies To: SEs | CSEs | Field Architects | PNEs | SDMs | Partners | Customers Applicable Nav App Version: 1.3.0
Summary
During recent site activations, an issue has been observed where the customer router is unable to ping the Nile NSB uplink interface immediately after activation. The root cause is premature settings pushed from Nile Nav while the switch system (ICOS) is still initializing and is not fully ready to recieve the settings.
Key findings from testing:
- Post reboot, Nile switches require a minimum 5 minutes for the device to be ready to receive the settings. Switch will reboot in the following conditions & require a 5 minute wait time to initialise before pushing the settings:
- Power cycle of the switch
- Device update execution
- Factory reset
- In-place deactivation (of a switch that is already operational)
- The gateway settings were pushed prior to the Switch readiness to receive the settings.
- If settings are pushed before the device is ready, it may fail silently, causing uplink connectivity issues.
- The primary workaround is to wait for at least 5 minutes before pushing the settings to the switch. Alternatively Deactivate + Reactivate or manual reboot have been observed to restore connectivity.
Impact
This issue affects Nile Nav activation workflows across all switch platforms and is observed across multiple software trains during the activation timing window. Premature settings push may result in:
- The customer router is unable to ping the Nile NSB uplink interface immediately after activation.
- Router IP/interface changes not taking effect until a full restart.
- Additional troubleshooting and first-time activations delays.
Actions Required
To avoid encountering this issue, please follow the mandatory SOP below during all activations:
- Device Setup: Wait Time Post Reboot
- Before proceeding to setup the device after reboot, wait at least 5 minutes to push the settings via BLE (reboot conditions for reference listed in Key findings from testing 1)
- Do not press the “Setup” button in the Nile Nav Setup screen to push the settings to the switch via BLE until 5 minutes have elapsed.
- If Connectivity Fails
- Use one of the following recovery options:
- Perform Deactivate + Reactivate from Nile Nav before device setup.
- Reboot/Restart the affected switch and retry to setup the device by pushing the settings only after a 5 minute wait time.
Troubleshooting Tips
Use Nile Nav Troubleshoot if required to validate settings, check switch & ICO status using below commands:
- Command 1.4.1 - NSB GW: Check provisioning settings to validate that the router interface IPs, DNS, NTP, and NSB IP ranges in the bringup.json file match with the settings that were pushed.
- Command 6.2.1 Switch: Check ICOS status must show “running” to ensure ICOS up.
- Command 6.2.3 Switch: Check Switch Agent Status must show “active/ok” to ensure sw-agent up.
- Command 2.2.1 Switch: Get IP to confirm if interface IP is correctly applied.
- Command 2.2.2 Switch: Get Interface with UP status to confirm if interfaces are up with expected settings.
Next Steps / Resolution Plan
- Nile Nav app changes are planned to introduce device readiness check feature to ensure device is ready to setup and receive the settings
- Switch system change is planned to intelligently handle the settings push done from the Nav app in a deferred way if the switch system (ICOS/switchdrvr) is not yet ready to receive the settings.
- Target availability for fixes in the upcoming release in Q4 2025.
Contact / Escalation
Support Email: [email protected]
Note: All partners and field teams are requested to adhere to the above SOP to prevent Nile gateway activation failures until Nile Nav updates are released.