nautobot 2.4.14__py3-none-any.whl → 2.4.16__py3-none-any.whl

nautobot/project-static/docs/user-guide/core-data-model/dcim/modulebaytemplate.html

@@ -8699,6 +8699,29 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../development/apps/migration/ui-component-framework/breadcrumbs-titles.html" class="md-nav__link">
+        
+  
+  
+  <span class="md-ellipsis">
+    Breadcrumbs and titles
+    
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       

nautobot/project-static/docs/user-guide/core-data-model/dcim/modulefamily.html

@@ -8687,6 +8687,29 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../development/apps/migration/ui-component-framework/breadcrumbs-titles.html" class="md-nav__link">
+        
+  
+  
+  <span class="md-ellipsis">
+    Breadcrumbs and titles
+    
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       

nautobot/project-static/docs/user-guide/core-data-model/dcim/moduletype.html

@@ -8679,6 +8679,29 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../development/apps/migration/ui-component-framework/breadcrumbs-titles.html" class="md-nav__link">
+        
+  
+  
+  <span class="md-ellipsis">
+    Breadcrumbs and titles
+    
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       

nautobot/project-static/docs/user-guide/core-data-model/dcim/platform.html

@@ -8687,6 +8687,29 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../development/apps/migration/ui-component-framework/breadcrumbs-titles.html" class="md-nav__link">
+        
+  
+  
+  <span class="md-ellipsis">
+    Breadcrumbs and titles
+    
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       

nautobot/project-static/docs/user-guide/core-data-model/dcim/powerfeed.html

@@ -4255,6 +4255,93 @@
     </label>
     <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
       
+        <li class="md-nav__item">
+  <a href="#type" class="md-nav__link">
+    <span class="md-ellipsis">
+      Type
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#power-path" class="md-nav__link">
+    <span class="md-ellipsis">
+      Power Path
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#status" class="md-nav__link">
+    <span class="md-ellipsis">
+      Status
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#panel-to-panel-distribution" class="md-nav__link">
+    <span class="md-ellipsis">
+      Panel-to-Panel Distribution
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#electrical-characteristics" class="md-nav__link">
+    <span class="md-ellipsis">
+      Electrical Characteristics
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#breaker-configuration" class="md-nav__link">
+    <span class="md-ellipsis">
+      Breaker Configuration
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Breaker Configuration">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#phase-designation" class="md-nav__link">
+    <span class="md-ellipsis">
+      Phase Designation
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#position-tracking" class="md-nav__link">
+    <span class="md-ellipsis">
+      Position Tracking
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#modeling-power-redundancy" class="md-nav__link">
+    <span class="md-ellipsis">
+      Modeling Power Redundancy
+    </span>
+  </a>
+  
+</li>
+      
         <li class="md-nav__item">
   <a href="#example-power-topology" class="md-nav__link">
     <span class="md-ellipsis">
@@ -8728,6 +8815,29 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../development/apps/migration/ui-component-framework/breadcrumbs-titles.html" class="md-nav__link">
+        
+  
+  
+  <span class="md-ellipsis">
+    Breadcrumbs and titles
+    
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -10106,6 +10216,93 @@
     </label>
     <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
       
+        <li class="md-nav__item">
+  <a href="#type" class="md-nav__link">
+    <span class="md-ellipsis">
+      Type
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#power-path" class="md-nav__link">
+    <span class="md-ellipsis">
+      Power Path
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#status" class="md-nav__link">
+    <span class="md-ellipsis">
+      Status
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#panel-to-panel-distribution" class="md-nav__link">
+    <span class="md-ellipsis">
+      Panel-to-Panel Distribution
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#electrical-characteristics" class="md-nav__link">
+    <span class="md-ellipsis">
+      Electrical Characteristics
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#breaker-configuration" class="md-nav__link">
+    <span class="md-ellipsis">
+      Breaker Configuration
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Breaker Configuration">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#phase-designation" class="md-nav__link">
+    <span class="md-ellipsis">
+      Phase Designation
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#position-tracking" class="md-nav__link">
+    <span class="md-ellipsis">
+      Position Tracking
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#modeling-power-redundancy" class="md-nav__link">
+    <span class="md-ellipsis">
+      Modeling Power Redundancy
+    </span>
+  </a>
+  
+</li>
+      
         <li class="md-nav__item">
   <a href="#example-power-topology" class="md-nav__link">
     <span class="md-ellipsis">
@@ -10135,15 +10332,53 @@
 
 
 <h1 id="power-feed">Power Feed<a class="headerlink" href="#power-feed" title="Permanent link">&para;</a></h1>
-<p>A power feed represents the distribution of power from a power panel to a particular device, typically a power distribution unit (PDU). The power port (inlet) on a device can be connected via a cable to a power feed. A power feed may optionally be assigned to a rack to allow more easily tracking the distribution of power among racks.</p>
-<p>Each power feed is assigned an operational type (primary or redundant) and a <a href="../../platform-functionality/status.html"><code>status</code></a>. The following statuses are available by default:</p>
+<p>A power feed represents a electrical connection that distributes power from a <a href="powerpanel.html">power panel</a> to devices or to other power panels. Power feeds can be connected via cables to device power ports and may optionally be assigned to a rack for tracking power distribution.</p>
+<p>Power feeds define the electrical characteristics of the circuit they represent and are categorized by both their operational type (type) and physical path (side) to enable accurate modeling of redundant power configurations.</p>
+<h2 id="type">Type<a class="headerlink" href="#type" title="Permanent link">&para;</a></h2>
+<p>The <code>type</code> field defines the operational type of the power feed in relation to other feeds that power the same equipment:</p>
+<ul>
+<li><strong>Primary</strong>: The main power feed for a device or rack</li>
+<li><strong>Redundant</strong>: A backup or secondary power feed</li>
+</ul>
+<p>The interpretation of these types depends on the overall power design. For example, in an active-active (2N) configuration, a device might be served by two <code>Primary</code> feeds. In an active-passive (N+1) configuration, it would be served by one <code>Primary</code> and one <code>Redundant</code> feed.</p>
+<h2 id="power-path">Power Path<a class="headerlink" href="#power-path" title="Permanent link">&para;</a></h2>
+<details class="version-added">
+<summary>Added in version 2.4.15</summary>
+<p>The <code>power_path</code> field defines the physical path or source of the power feed. It represents which power distribution path the circuit originates from, which is crucial for modeling fault tolerance:</p>
+</details>
+<ul>
+<li><strong>Path A</strong>: The power feed originates from the "A" power path</li>
+<li><strong>Path B</strong>: The power feed originates from the "B" power path  </li>
+</ul>
+<p>If a power feed is part of a single, non-redundant power system (as in a Tier I or Tier II data center), the <code>power_path</code> field can be left blank.</p>
+<h2 id="status">Status<a class="headerlink" href="#status" title="Permanent link">&para;</a></h2>
+<p>Each power feed must be assigned an operational <a href="../../platform-functionality/status.html"><code>status</code></a>. The following statuses are available by default:</p>
 <ul>
 <li>Offline</li>
 <li>Active</li>
 <li>Planned</li>
 <li>Failed</li>
 </ul>
-<p>Each power feed also defines the electrical characteristics of the circuit which it represents. These include the following:</p>
+<h2 id="panel-to-panel-distribution">Panel-to-Panel Distribution<a class="headerlink" href="#panel-to-panel-distribution" title="Permanent link">&para;</a></h2>
+<details class="version-added">
+<summary>Added in version 2.4.15</summary>
+<p>Power feeds can connect one power panel to another by specifying a <code>destination_panel</code>. This enables modeling of hierarchical power distribution where power flows from upstream panels to downstream panels.</p>
+</details>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>The <code>destination_panel</code> field should only be used for panel-to-panel connections in the power distribution hierarchy. When connecting a power feed to a rack-level PDU, leave <code>destination_panel</code> blank since rack PDUs should be modeled as <a href="device.html">devices</a> with <a href="poweroutlet.html">power outlets</a>, not as power panels.</p>
+</div>
+<div class="admonition warning">
+<p class="admonition-title">Cable Connection Exclusivity</p>
+<p>A power feed cannot specify both a <code>destination_panel</code> and be connected via cable to another endpoint simultaneously. Power feeds can either:</p>
+<ul>
+<li>Connect to a destination panel (panel-to-panel distribution), OR</li>
+<li>Be cabled to a device power port or other endpoint</li>
+</ul>
+<p>But not both. This mutual exclusivity is enforced during validation to maintain data integrity.</p>
+</div>
+<h2 id="electrical-characteristics">Electrical Characteristics<a class="headerlink" href="#electrical-characteristics" title="Permanent link">&para;</a></h2>
+<p>Each power feed defines the electrical characteristics of the circuit:</p>
 <ul>
 <li>Supply type (AC or DC)</li>
 <li>Phase (single or three-phase)</li>
@@ -10151,12 +10386,77 @@
 <li>Amperage</li>
 <li>Maximum utilization (percentage)</li>
 </ul>
+<h2 id="breaker-configuration">Breaker Configuration<a class="headerlink" href="#breaker-configuration" title="Permanent link">&para;</a></h2>
+<details class="version-added">
+<summary>Added in version 2.4.15</summary>
+<p>Power feeds can specify their breaker configuration within the source power panel:</p>
+</details>
+<ul>
+<li><strong>Breaker position</strong>: The starting circuit position number in the panel</li>
+<li><strong>Breaker pole count</strong>: The number of poles the breaker occupies (1, 2, or 3)</li>
+</ul>
+<p>When breaker positions are specified, Nautobot validates that:</p>
+<ol>
+<li><strong>Panel capacity</strong>: The breaker configuration fits within the panel's circuit capacity</li>
+<li><strong>Position conflicts</strong>: No conflicts exist with other power feeds' breaker positions</li>
+<li><strong>Auto-defaulting</strong>: If a breaker position is specified without a pole count, it defaults to a single-pole breaker</li>
+</ol>
+<p>The system calculates occupied positions based on standard electrical panel layouts where multi-pole breakers occupy consecutive positions with specific spacing requirements.</p>
+<h3 id="phase-designation">Phase Designation<a class="headerlink" href="#phase-designation" title="Permanent link">&para;</a></h3>
+<p>When breaker positions are configured, Nautobot automatically calculates the phase designation based on the occupied circuit positions. This follows standard electrical panel layouts where:</p>
+<ul>
+<li>Positions 1,2 = Phase A</li>
+<li>Positions 3,4 = Phase B  </li>
+<li>Positions 5,6 = Phase C</li>
+<li>Pattern repeats every 6 positions</li>
+</ul>
+<p>The calculated phase designation can be:</p>
+<ul>
+<li><strong>Single-phase (1-pole)</strong>: "A", "B", or "C" for single-pole breakers</li>
+<li><strong>Single-phase (2-pole)</strong>: "A-B", "B-C", etc. for two-pole breakers (e.g., 240V split-phase)</li>
+<li><strong>Three-phase (3-pole)</strong>: "A-B-C" for three-pole breakers</li>
+</ul>
+<p>This information is available through the <code>phase_designation</code> property and helps with load balancing and electrical planning.</p>
+<h3 id="position-tracking">Position Tracking<a class="headerlink" href="#position-tracking" title="Permanent link">&para;</a></h3>
+<p>The <code>occupied_positions</code> property provides a comma-separated string of all circuit positions occupied by the power feed. This is useful for understanding panel utilization and avoiding conflicts when adding new feeds.</p>
+<h2 id="modeling-power-redundancy">Modeling Power Redundancy<a class="headerlink" href="#modeling-power-redundancy" title="Permanent link">&para;</a></h2>
+<p>By combining the <code>type</code> and <code>power_path</code> fields, you can model various industry-standard power redundancy configurations:</p>
+<table>
+<thead>
+<tr>
+<th style="text-align: left;">Uptime Tier</th>
+<th style="text-align: left;">Design</th>
+<th style="text-align: left;">Feed 1</th>
+<th style="text-align: left;">Feed 2</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td style="text-align: left;">Tier I/II</td>
+<td style="text-align: left;">Single Path (N)</td>
+<td style="text-align: left;"><code>type=Primary</code>, <code>power_path=</code> (blank)</td>
+<td style="text-align: left;">(none)</td>
+</tr>
+<tr>
+<td style="text-align: left;">Tier III</td>
+<td style="text-align: left;">Active/Passive (N+1)</td>
+<td style="text-align: left;"><code>type=Primary</code>, <code>power_path=a</code></td>
+<td style="text-align: left;"><code>type=Redundant</code>, <code>power_path=b</code></td>
+</tr>
+<tr>
+<td style="text-align: left;">Tier IV</td>
+<td style="text-align: left;">Active/Active (2N)</td>
+<td style="text-align: left;"><code>type=Primary</code>, <code>power_path=a</code></td>
+<td style="text-align: left;"><code>type=Primary</code>, <code>power_path=b</code></td>
+</tr>
+</tbody>
+</table>
 <div class="admonition info">
 <p class="admonition-title">Info</p>
-<p>The power utilization of a rack is calculated when one or more power feeds are assigned to the rack and connected to devices that draw power.</p>
+<p>Cables can connect power feeds only to device power ports. Pass-through ports cannot be used to model power distribution. The power utilization of a rack is calculated when one or more power feeds are assigned to the rack and connected to devices that draw power.</p>
 </div>
 <h2 id="example-power-topology">Example Power Topology<a class="headerlink" href="#example-power-topology" title="Permanent link">&para;</a></h2>
-<p><img alt="Power distribution model" src="../../../media/power_distribution.png" /></p>
+<p><img alt="Power distribution model" src="../../../media/power_distribution.png" style="width: 50%" /></p>
 
 
 

nautobot/project-static/docs/user-guide/core-data-model/dcim/poweroutlet.html

@@ -8781,6 +8781,29 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../development/apps/migration/ui-component-framework/breadcrumbs-titles.html" class="md-nav__link">
+        
+  
+  
+  <span class="md-ellipsis">
+    Breadcrumbs and titles
+    
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -10196,7 +10219,7 @@
 <p>This model has been updated to support being installed in <a href="module.html">Modules</a>. As a result, there are now two fields for assignment to a Device or Module. One of the <code>device</code> or <code>module</code> fields must be populated but not both. If a <code>module</code> is supplied, the <code>device</code> field must be null, and similarly the <code>module</code> field must be null if a <code>device</code> is supplied.</p>
 </details>
 <h2 id="example-power-topology">Example Power Topology<a class="headerlink" href="#example-power-topology" title="Permanent link">&para;</a></h2>
-<p><img alt="Power distribution model" src="../../../media/power_distribution.png" /></p>
+<p><img alt="Power distribution model" src="../../../media/power_distribution.png" style="width: 50%" /></p>
 
 
 

nautobot/project-static/docs/user-guide/core-data-model/dcim/poweroutlettemplate.html

@@ -8699,6 +8699,29 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../development/apps/migration/ui-component-framework/breadcrumbs-titles.html" class="md-nav__link">
+        
+  
+  
+  <span class="md-ellipsis">
+    Breadcrumbs and titles
+    
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>