nautobot 3.0.4__py3-none-any.whl → 3.0.5__py3-none-any.whl

nautobot/project-static/docs/user-guide/administration/upgrading/upgrading.html

@@ -8,7 +8,7 @@
         <link rel="canonical" href="https://docs.nautobot.com/projects/core/en/stable/user-guide/administration/upgrading/upgrading.html">
       
       
-        <link rel="prev" href="database-backup.html">
+        <link rel="prev" href="postgresql.html">
       
       
         <link rel="next" href="from-v1/upgrading-from-nautobot-v1.html">
@@ -976,6 +976,34 @@
                 
   
   
+  
+  
+    <li class="md-nav__item">
+      <a href="postgresql.html" class="md-nav__link">
+        
+  
+  
+  <span class="md-ellipsis">
+    
+  
+    Upgrading PostgreSQL
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
     
   
   
@@ -1132,6 +1160,28 @@
       </ul>
     </nav>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#updating-from-nautobot-1x-to-2x" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        Updating from Nautobot 1.x to 2.x
+      
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#updating-from-nautobot-2x-to-3x" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        Updating from Nautobot 2.x to 3.x
+      
+    </span>
+  </a>
+  
 </li>
         
       </ul>
@@ -1221,7 +1271,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_2_3">
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_2_4">
         
           
           <div class="md-nav__link md-nav__container">
@@ -1243,14 +1293,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_2_1_2_3" id="__nav_2_1_2_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_2_1_2_4" id="__nav_2_1_2_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="4" aria-labelledby="__nav_2_1_2_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2_1_2_3">
+        <nav class="md-nav" data-md-level="4" aria-labelledby="__nav_2_1_2_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_2_1_2_4">
             <span class="md-nav__icon md-icon"></span>
             
   
@@ -1306,7 +1356,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_2_3_2">
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_2_4_2">
         
           
           <div class="md-nav__link md-nav__container">
@@ -1328,14 +1378,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_2_1_2_3_2" id="__nav_2_1_2_3_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_2_1_2_4_2" id="__nav_2_1_2_4_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="5" aria-labelledby="__nav_2_1_2_3_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2_1_2_3_2">
+        <nav class="md-nav" data-md-level="5" aria-labelledby="__nav_2_1_2_4_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_2_1_2_4_2">
             <span class="md-nav__icon md-icon"></span>
             
   
@@ -9125,6 +9175,34 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../development/apps/api/models/queryset.html" class="md-nav__link">
+        
+  
+  
+  <span class="md-ellipsis">
+    
+  
+    QuerySet
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -13318,6 +13396,28 @@
       </ul>
     </nav>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#updating-from-nautobot-1x-to-2x" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        Updating from Nautobot 1.x to 2.x
+      
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#updating-from-nautobot-2x-to-3x" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        Updating from Nautobot 2.x to 3.x
+      
+    </span>
+  </a>
+  
 </li>
         
       </ul>
@@ -13431,6 +13531,10 @@ release notes under the release in which the change went into effect.</p>
 <a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a>Query OK, 1 row affected (0.07 sec)
 </code></pre></div>
 <p>Please see the <a href="https://dev.mysql.com/blog-archive/mysql-8-0-collations-migrating-from-older-collations/">official MySQL documentation on migrating collation encoding settings</a> for more information on troubleshooting any issues you may encounter.</p>
+<h3 id="updating-from-nautobot-1x-to-2x">Updating from Nautobot 1.x to 2.x<a class="headerlink" href="#updating-from-nautobot-1x-to-2x" title="Permanent link">¶</a></h3>
+<p>See <a href="from-v1/upgrading-from-nautobot-v1.html">Upgrading from Nautobot v1</a>. In general we would recommend updating to the latest available 1.x release (v1.6.32 as of this writing) as an intermediate step, then updating directly to the latest patch release of your target 2.x minor version.</p>
+<h3 id="updating-from-nautobot-2x-to-3x">Updating from Nautobot 2.x to 3.x<a class="headerlink" href="#updating-from-nautobot-2x-to-3x" title="Permanent link">¶</a></h3>
+<p>See <a href="from-v2/index.html">Upgrading from Nautobot v2</a>. In general we would recommend updating to the latest available 2.x release as an intermediate step, then updating directly to the latest patch release of your target 3.x minor version.</p>
 <h2 id="update-prerequisites-to-required-versions">Update Prerequisites to Required Versions<a class="headerlink" href="#update-prerequisites-to-required-versions" title="Permanent link">¶</a></h2>
 <p>Nautobot v3.0.0 and later requires the following:</p>
 <table>
@@ -13447,7 +13551,7 @@ release notes under the release in which the change went into effect.</p>
 </tr>
 <tr>
 <td>PostgreSQL</td>
-<td>12.0</td>
+<td>12.0¹</td>
 </tr>
 <tr>
 <td>Redis</td>
@@ -13455,16 +13559,22 @@ release notes under the release in which the change went into effect.</p>
 </tr>
 </tbody>
 </table>
+<p>¹ PostgreSQL versions 12.x and 13.x have reached end-of-life, and support for these versions will be dropped in Nautobot 3.1. As such, it is our recommendation that you upgrade to PostgreSQL 14+ while still on Nautobot 2.4 or Nautobot 3.0 as a separate action / maintenance window to minimize the number of simultaneous changes.</p>
+<div class="admonition warning">
+<p class="admonition-title">Warning</p>
+<p>PostgreSQL major version upgrades typically require manual steps to update or migrate the database structure. Refer to <a href="postgresql.html">Upgrading PostgreSQL</a> for more guidance on how migrate to a newer major version of PostgreSQL.</p>
+</div>
+<p>As with all dependencies, we would recommend that you follow usual industry best practices, and periodically update to the latest applicable patch version of each of these dependencies in order to receive applicable security fixes and other bug fixes.</p>
 <details class="version-removed">
-<summary>Removed in version 2.1.0</summary>
+<summary>Removed in version 2.1.0 — Dropped support for PostgreSQL 11</summary>
 <p>Support for versions of PostgreSQL older than 12.0 was removed.</p>
 </details>
 <details class="version-removed">
-<summary>Removed in version 2.4.0</summary>
+<summary>Removed in version 2.4.0 — Dropped support for Python 3.8</summary>
 <p>Support for Python 3.8 was removed.</p>
 </details>
 <details class="version-removed">
-<summary>Removed in version 2.4.20</summary>
+<summary>Removed in version 2.4.20 — Dropped support for Python 3.9</summary>
 <p>Support for Python 3.9 was removed.</p>
 </details>
 <p>Nautobot v1.1.0 and later can optionally support the following:</p>
@@ -13553,7 +13663,7 @@ release notes under the release in which the change went into effect.</p>
       <nav class="md-footer__inner md-grid" aria-label="Footer">
         
           
-          <a href="database-backup.html" class="md-footer__link md-footer__link--prev" aria-label="Previous: Database Backup">
+          <a href="postgresql.html" class="md-footer__link md-footer__link--prev" aria-label="Previous: Upgrading PostgreSQL">
             <div class="md-footer__button md-icon">
               
               <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"></path></svg>
@@ -13563,7 +13673,7 @@ release notes under the release in which the change went into effect.</p>
                 Previous
               </span>
               <div class="md-ellipsis">
-                Database Backup
+                Upgrading PostgreSQL
               </div>
             </div>
           </a>

nautobot/project-static/docs/user-guide/core-data-model/circuits/circuit.html

@@ -974,6 +974,34 @@
   
   
   
+    <li class="md-nav__item">
+      <a href="../../administration/upgrading/postgresql.html" class="md-nav__link">
+        
+  
+  
+  <span class="md-ellipsis">
+    
+  
+    Upgrading PostgreSQL
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
     <li class="md-nav__item">
       <a href="../../administration/upgrading/upgrading.html" class="md-nav__link">
         
@@ -1014,7 +1042,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_2_3">
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_2_4">
         
           
           <div class="md-nav__link md-nav__container">
@@ -1036,14 +1064,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_2_1_2_3" id="__nav_2_1_2_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_2_1_2_4" id="__nav_2_1_2_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="4" aria-labelledby="__nav_2_1_2_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2_1_2_3">
+        <nav class="md-nav" data-md-level="4" aria-labelledby="__nav_2_1_2_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_2_1_2_4">
             <span class="md-nav__icon md-icon"></span>
             
   
@@ -1099,7 +1127,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_2_3_2">
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_2_4_2">
         
           
           <div class="md-nav__link md-nav__container">
@@ -1121,14 +1149,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_2_1_2_3_2" id="__nav_2_1_2_3_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_2_1_2_4_2" id="__nav_2_1_2_4_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="5" aria-labelledby="__nav_2_1_2_3_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2_1_2_3_2">
+        <nav class="md-nav" data-md-level="5" aria-labelledby="__nav_2_1_2_4_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_2_1_2_4_2">
             <span class="md-nav__icon md-icon"></span>
             
   
@@ -8932,6 +8960,34 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../development/apps/api/models/queryset.html" class="md-nav__link">
+        
+  
+  
+  <span class="md-ellipsis">
+    
+  
+    QuerySet
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       

nautobot/project-static/docs/user-guide/core-data-model/circuits/circuittermination.html

@@ -974,6 +974,34 @@
   
   
   
+    <li class="md-nav__item">
+      <a href="../../administration/upgrading/postgresql.html" class="md-nav__link">
+        
+  
+  
+  <span class="md-ellipsis">
+    
+  
+    Upgrading PostgreSQL
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
     <li class="md-nav__item">
       <a href="../../administration/upgrading/upgrading.html" class="md-nav__link">
         
@@ -1014,7 +1042,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_2_3">
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_2_4">
         
           
           <div class="md-nav__link md-nav__container">
@@ -1036,14 +1064,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_2_1_2_3" id="__nav_2_1_2_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_2_1_2_4" id="__nav_2_1_2_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="4" aria-labelledby="__nav_2_1_2_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2_1_2_3">
+        <nav class="md-nav" data-md-level="4" aria-labelledby="__nav_2_1_2_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_2_1_2_4">
             <span class="md-nav__icon md-icon"></span>
             
   
@@ -1099,7 +1127,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_2_3_2">
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_2_4_2">
         
           
           <div class="md-nav__link md-nav__container">
@@ -1121,14 +1149,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_2_1_2_3_2" id="__nav_2_1_2_3_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_2_1_2_4_2" id="__nav_2_1_2_4_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="5" aria-labelledby="__nav_2_1_2_3_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2_1_2_3_2">
+        <nav class="md-nav" data-md-level="5" aria-labelledby="__nav_2_1_2_4_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_2_1_2_4_2">
             <span class="md-nav__icon md-icon"></span>
             
   
@@ -8932,6 +8960,34 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../development/apps/api/models/queryset.html" class="md-nav__link">
+        
+  
+  
+  <span class="md-ellipsis">
+    
+  
+    QuerySet
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       

nautobot/project-static/docs/user-guide/core-data-model/circuits/circuittype.html

@@ -974,6 +974,34 @@
   
   
   
+    <li class="md-nav__item">
+      <a href="../../administration/upgrading/postgresql.html" class="md-nav__link">
+        
+  
+  
+  <span class="md-ellipsis">
+    
+  
+    Upgrading PostgreSQL
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
     <li class="md-nav__item">
       <a href="../../administration/upgrading/upgrading.html" class="md-nav__link">
         
@@ -1014,7 +1042,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_2_3">
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_2_4">
         
           
           <div class="md-nav__link md-nav__container">
@@ -1036,14 +1064,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_2_1_2_3" id="__nav_2_1_2_3_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_2_1_2_4" id="__nav_2_1_2_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="4" aria-labelledby="__nav_2_1_2_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2_1_2_3">
+        <nav class="md-nav" data-md-level="4" aria-labelledby="__nav_2_1_2_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_2_1_2_4">
             <span class="md-nav__icon md-icon"></span>
             
   
@@ -1099,7 +1127,7 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_2_3_2">
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_2_4_2">
         
           
           <div class="md-nav__link md-nav__container">
@@ -1121,14 +1149,14 @@
             </a>
             
               
-              <label class="md-nav__link " for="__nav_2_1_2_3_2" id="__nav_2_1_2_3_2_label" tabindex="0">
+              <label class="md-nav__link " for="__nav_2_1_2_4_2" id="__nav_2_1_2_4_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
             
           </div>
         
-        <nav class="md-nav" data-md-level="5" aria-labelledby="__nav_2_1_2_3_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2_1_2_3_2">
+        <nav class="md-nav" data-md-level="5" aria-labelledby="__nav_2_1_2_4_2_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_2_1_2_4_2">
             <span class="md-nav__icon md-icon"></span>
             
   
@@ -8932,6 +8960,34 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../development/apps/api/models/queryset.html" class="md-nav__link">
+        
+  
+  
+  <span class="md-ellipsis">
+    
+  
+    QuerySet
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>