Creating a maintenance intent

Before you create a new maintenance intent, ensure that:

  • You have created and applied a maintenance label to the participating nodes. The system includes a "Maintenance" key that you can use to identify an object for maintenance. The particular value you associate with that key can be whatever you like.
  • If this maintenance intent is for a software update, ensure that the target SR Linux software load is present in the system's software catalog.
  • If you are using an external DHCP server or file server for SR Linux Zero-touch provisioning (ZTP):
    • for software changes, update the ztp-config.yml file with the new software image details
    • for node replacement, update the dhcpd.conf file with the new serial number information
  • If you are performing a software update, ensure that the target node is in a Ready or Version Mismatch state. Attempting the update on a node in any other state results in an error.
  • If you are replacing a node, any state is acceptable but some states of the maintenance intent indicating its progress may be skipped depending on the original node state.

A maintenance intent indicates a type of change and the nodes this change affects.

To create a maintenance intent:

  1. Click to open the main menu.
  2. From the menu, select Maintenance Intents.
  3. Click the + CREATE A MAINTENANCE INTENT button.
  4. Configure basic parameters for the maintenance intent.
    • Region
    • Maintenance Intent Name
    • Description (optional)
  5. Do one of the following:
    • If you are creating a maintenance intent for a software update, go to step 6.
    • If you are creating a maintenance intent to replace a node, go to step 7.
  6. Set the parameters for the software update.
    • In Maintenance Intent Type, click Software Update.
    • In the Software Catalog/Image ID field, select the target SR Linux software load.
    • In the Node Label Selector panel, click the edit icon and select the label corresponding to this maintenance action from the displayed list. In the current release, you can select only one label as the target for the maintenance action.
    When you are finished, go to step 9.
  7. Set parameters for the node replacement.
    • In the Maintenance Intent Type drop-down list, click Replace Node.
    • In the Node Label Selector panel, click the icon and select the label corresponding to this maintenance action from the displayed list. You can select only one label as the target for the maintenance action.
    The system updates the Nodes List panel to show the node bearing the selected label.
  8. Enter the replacement node's serial number in the New Serial Number field.
  9. Click the Save icon ( ) to save the maintenance intent.
  10. Click GENERATE MAINTENANCE.
  11. Optional: Review the generated configuration code to confirm that it is satisfactory.
    1. Right-click the node that is the target of the maintenance intent and select Inspect Configuration from the pop-up menu.
    2. Review the code and verify that it is satisfactory.
    3. Click at the upper right to close the Configuration Inspector window.
Deploy the maintenance intent.