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.
Steps to disable an appliance or site
Use the “Enable/Disable” control in the Partner Portal for a site or appliance to begin the process of disabling it for 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”.
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
The appliance status widget in the status board indicates the current serving status of an appliance, and also 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).