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

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

@@ -4232,6 +4232,42 @@
     </label>
     <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
       
+        <li class="md-nav__item">
+  <a href="#panel-types" class="md-nav__link">
+    <span class="md-ellipsis">
+      Panel Types
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#breaker-positions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Breaker Positions
+    </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="#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="#example-power-topology" class="md-nav__link">
     <span class="md-ellipsis">
@@ -8728,6 +8764,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 +10165,42 @@
     </label>
     <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
       
+        <li class="md-nav__item">
+  <a href="#panel-types" class="md-nav__link">
+    <span class="md-ellipsis">
+      Panel Types
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#breaker-positions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Breaker Positions
+    </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="#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="#example-power-topology" class="md-nav__link">
     <span class="md-ellipsis">
@@ -10135,14 +10230,52 @@
 
 
 <h1 id="power-panel">Power Panel<a class="headerlink" href="#power-panel" title="Permanent link">&para;</a></h1>
-<p>A power panel represents the origin point in Nautobot for electrical power being disseminated by one or more power feeds. In a data center environment, one power panel often serves a group of racks, with an individual power feed extending to each rack, though this is not always the case. It is common to have two sets of panels and feeds arranged in parallel to provide redundant power to each rack.</p>
+<p>A power panel represents a distribution point in Nautobot's electrical power hierarchy, distributing power through one or more power feeds. Power panels can receive power from upstream sources and distribute it downstream through power feeds. In a data center environment, power panels are typically arranged in hierarchical distributions - from utility connections through main distribution panels, UPS systems, switchgear, and down to individual racks.</p>
 <p>Each power panel must be assigned to a location, and may optionally be assigned to a rack group.</p>
+<div class="admonition info">
+<p class="admonition-title">Info</p>
+<p>Rack-level PDUs should <strong>not</strong> be modeled as power panels. Instead, they should be modeled as devices with <a href="poweroutlet.html">power outlets</a> that connect to power feeds from upstream power panels.</p>
+</div>
+<h2 id="panel-types">Panel Types<a class="headerlink" href="#panel-types" title="Permanent link">&para;</a></h2>
+<details class="version-added">
+<summary>Added in version 2.4.15</summary>
+<p>Power panels can be categorized by type to better represent different components in the power distribution hierarchy:</p>
+</details>
+<ul>
+<li><strong>Utility</strong> - Main utility connection point</li>
+<li><strong>Generator</strong> - Emergency power generation equipment</li>
+<li><strong>Switchgear</strong> - High-voltage switching and protection equipment</li>
+<li><strong>Main Distribution Panel (MDP)</strong> - Primary distribution point for incoming power</li>
+<li><strong>Uninterruptible Power Supply (UPS)</strong> - Battery backup power systems</li>
+<li><strong>Transfer Switch</strong> - Automatic or manual switching between power sources</li>
+<li><strong>Power Distribution Unit (PDU)</strong> - Facility-level power distribution equipment (not rack-level PDUs)</li>
+<li><strong>Panelboard</strong> - Standard electrical distribution panels</li>
+<li><strong>Mini Load Center (MLC)</strong> - Smaller distribution panels</li>
+<li><strong>Remote Power Panel (RPP)</strong> - Distributed power panels in remote locations</li>
+</ul>
+<h2 id="breaker-positions">Breaker Positions<a class="headerlink" href="#breaker-positions" title="Permanent link">&para;</a></h2>
+<details class="version-added">
+<summary>Added in version 2.4.15</summary>
+<p>Power panels can optionally specify the total number of breaker positions. This helps track breaker capacity and prevents overallocation when power feeds specify breaker positions. For example, a 42-position panelboard would have <code>breaker_position_count</code> set to 42.</p>
+</details>
+<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 panel. It represents which power distribution path the panel originates from, which is crucial for modeling fault tolerance:</p>
+</details>
+<ul>
+<li><strong>Path A</strong>: The power panel originates from the "A" power path</li>
+<li><strong>Path B</strong>: The power panel originates from the "B" power path  </li>
+</ul>
+<p>If a power panel 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="panel-to-panel-distribution">Panel-to-Panel Distribution<a class="headerlink" href="#panel-to-panel-distribution" title="Permanent link">&para;</a></h2>
+<p>Power panels can distribute power to other power panels through power feeds with a specified <code>destination_panel</code>. This enables modeling of hierarchical power distribution where power flows from upstream panels (like utility switchgear or MDPs) to downstream panels (like UPS systems or panelboards). This allows Nautobot to model complete power paths from utility sources through multiple distribution tiers down to rack-level devices.</p>
 <div class="admonition note">
 <p class="admonition-title">Note</p>
-<p>Nautobot does not model the mechanism by which power is delivered to a power panel. Power panels define the root level of the power distribution hierarchy in Nautobot.</p>
+<p>Power panels model hierarchical power distribution relationships through panel-to-panel connections. While some panels may serve as root sources (like utility connections), others function as intermediate distribution points receiving power from upstream panels and distributing it downstream.</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/powerport.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>
       
@@ -10198,8 +10221,25 @@
 <summary>Changed in version 2.3.0</summary>
 <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>
+<details class="version-added">
+<summary>Added in version 2.4.15</summary>
+<p>Power Ports include a <code>power_factor</code> field for converting between watts (W) and volt-amps (VA) in power calculations.</p>
+<p>The power factor represents the ratio of real power (watts) to apparent power (volt-amps) and defaults to 0.95, which is typical for modern server equipment. To find the power factor for your specific equipment, check:</p>
+<ul>
+<li><strong>Power supply datasheets</strong> - Look for 80 PLUS certification specifications</li>
+<li><strong>Server management interfaces</strong> - iDRAC, iLO, or IPMI may display PSU power factor settings  </li>
+<li><strong>Equipment specifications</strong> - Listed in the electrical characteristics section</li>
+</ul>
+<p>Typical power factor ranges:</p>
+<ul>
+<li><strong>0.95-0.99</strong>: Modern servers with 80 PLUS Platinum/Titanium certified PSUs</li>
+<li><strong>0.9-0.95</strong>: Standard servers with 80 PLUS Gold/Silver/Bronze certification</li>
+<li><strong>0.5-0.9</strong>: Older equipment or basic power supplies without certification</li>
+</ul>
+<p>The power factor is used in rack power utilization calculations to accurately convert watts to volt-amps for proper capacity planning. For more information, see the <a href="https://www.clearesult.com/80plus/">80 PLUS certification program</a>.</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/powerporttemplate.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>
       
@@ -10094,6 +10117,23 @@
 <summary>Changed in version 2.3.0</summary>
 <p>This model has been updated to support being installed in <a href="module.html">Modules</a> through the <a href="moduletype.html">ModuleType</a> model. As a result, there are now two fields for assignment to a DeviceType or ModuleType. One of the <code>device_type</code> or <code>module_type</code> fields must be populated but not both. If a <code>module_type</code> is supplied, the <code>device_type</code> field must be null, and similarly the <code>module_type</code> field must be null if a <code>device_type</code> is supplied.</p>
 </details>
+<details class="version-added">
+<summary>Added in version 2.4.15</summary>
+<p>Power Port Templates include a <code>power_factor</code> field for converting between watts (W) and volt-amps (VA) in power calculations.</p>
+<p>The power factor represents the ratio of real power (watts) to apparent power (volt-amps) and defaults to 0.95, which is typical for modern server equipment. To find the power factor for your specific equipment, check:</p>
+<ul>
+<li><strong>Power supply datasheets</strong> - Look for 80 PLUS certification specifications</li>
+<li><strong>Server management interfaces</strong> - iDRAC, iLO, or IPMI may display PSU power factor settings  </li>
+<li><strong>Equipment specifications</strong> - Listed in the electrical characteristics section</li>
+</ul>
+<p>Typical power factor ranges:</p>
+<ul>
+<li><strong>0.95-0.99</strong>: Modern servers with 80 PLUS Platinum/Titanium certified PSUs</li>
+<li><strong>0.9-0.95</strong>: Standard servers with 80 PLUS Gold/Silver/Bronze certification</li>
+<li><strong>0.5-0.9</strong>: Older equipment or basic power supplies without certification</li>
+</ul>
+<p>The power factor is used in rack power utilization calculations to accurately convert watts to volt-amps for proper capacity planning. For more information, see the <a href="https://www.clearesult.com/80plus/">80 PLUS certification program</a>.</p>
+</details>
 
 
 

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

@@ -8728,6 +8728,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/rackgroup.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/rackreservation.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/rearport.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/rearporttemplate.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/softwareimagefile.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/softwareversion.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/virtualchassis.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/virtualdevicecontext.html

@@ -8746,6 +8746,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/extras/configcontext.html

@@ -8737,6 +8737,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/extras/configcontextschema.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/extras/contact.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/extras/team.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>