Partners may need to disable an appliance or set of appliances to perform maintenance at their site. Follow the steps described here to minimize any disruption to customers.
Before you start
Read the partner maintenance guidelines on the website: https://openconnect.netflix.com/en/fill/#maintenance.
Important: The only time you can safely disconnect or power down an appliance is when it is in the “Drained” state. The process of disabling a a site or appliance can take up to 2 hours, so plan accordingly.
If your maintenance window will impact service to Netflix customers, please open a ticket to notify our Operations team.
Disabling an appliance or site
In the Partner Portal, navigate to a site or OCA and click the Perform maintenance tab to begin the process of disabling it for maintenance.
If you are performing maintenance at a site level, you will see a list of the live appliances that will be disabled for maintenance.
Select a timeframe for the maintenance window and click Activate maintenance.
When you disable an appliance that is serving traffic, the appliance will begin to drain and the serving state will change to “Draining”. During the draining process, the appliance will continue to serve its current clients, but the control plane services will not send any new traffic to the appliance. Over a period of approximately 2 hours, traffic will continue to decrease and will eventually fully drain, at which point the serving state will change to “Drained”.
Re-enabling an appliance or site
At any point if you need to reverse the process, you can do so on the Perform Maintenance tab. When the maintenance window expiration is less than 24 hours away, you can also add additional time to the maintenance window.
Disabled appliances will automatically re-enable themselves after a fixed period of time, which is indicated on the appliance widget. However, as described below, only when an appliance is able to serve traffic will it begin to do so. Therefore, you might see an appliance in the “Enabled” state that is not yet serving traffic.
If you want to more permanently prevent an appliance from serving traffic, you can do so via BGP announcements to the appliance.
More information about serving status
You can see the current serving status for an appliance in the list of appliances for a site, or on the details page for an OCA. You can also see whether the appliance is enabled or disabled from serving traffic on the partner end. It is important to understand these serving states and how the process of disabling an appliance works.
There is an important distinction between an appliance being enabled on the partner end to serve traffic and the appliance actually serving traffic. Because appliances can potentially be drained or disabled either by partners or by Netflix, or can be in problematic states that do not allow them to serve traffic, you should always refer to the serving status flags to understand the actual serving state (Serving, Draining, or Drained).