=====================
Managing node records
=====================

Node records are displayed in a list on the **Nodes** page. Navigate to the
list by clicking the **Laywire** button in the top menu, and then clicking
**Nodes**.

.. contents::
    :local:
    :depth: 1

Navigating the list
===================

The node list is configured by default to display 25 nodes per page. Other
pages can be viewed by clicking the navigation buttons at the bottom right side
of the list:

|managing-node-records-1|

To change the number of nodes displayed per page, select a new value from the
dropdown menu on the top right of the list:

|managing-node-records-2|

Pages can be configured to display 25, 50, or 100 nodes.

Searching and sorting
=====================

The node list can be filtered by typing a term into the search box in the upper
right corner:

|managing-node-records-3|

Nodes can also be sorted by column by clicking the arrow buttons next to the
column name:

|managing-node-records-4|

Adding a node
=============

To add a node, click the **Add node** button located underneath the heading on
the node list page:

|managing-node-records-5|

From here you can specify the following information. Fields marked with an
asterisk are required.

Name *
------

A descriptive name for the node.

Space *
-------

The space the node will be assigned to. The space determines which users can
see and manage the node.

Administrative profile *
------------------------

The administrative profile assigned to the node. The default profile will be
used if unset.

Groups
------

Any node groups you would like the node to be a part of. See the `node group
documentation <../node-groups/index.html>`__ for more information.

Metadata
--------

Optional data about the node, in key-value pairs. This is purely user-defined.
It can be used to store data such as location and CRM identifiers.

Note
----

Any miscellaneous information you would like to include about the node.

Once you have entered your information, click on **Save** to add the node.
You will then be directed to the newly created node's details page.

Editing a node
==============

To edit a node record, navigate to the node's details page by clicking on its
name in the node list:

|managing-node-records-6|

Then, click the |edit| button next to the header on the **Configuration**
table:

|managing-node-records-7|

This will open the **Edit node** modal. From here you can edit any of the
properties of the node that were specified when it was created.

To manage any interfaces, peers, nexthops, routes, and access rules on the
node, see the `interface and address documentation
<../interfaces-and-addressing/index.html>`__, the `peer documentation
<../peers/index.html>`__, the `routing documentation
<../routing-and-vrfs/index.html>`__, and the `access rules documentation
<../access-rules/index.html>`__.

Deleting a node
===============

To delete a node, navigate to the node's details page and click the **Delete**
button underneath the node's name:

|managing-node-records-8|

This will open up a modal asking you to confirm before the node record is
**permanently** deleted.

.. |managing-node-records-1| image:: /attachments/laywire/nodes/managing-node-records-1.png
    :scale: 75%
.. |managing-node-records-2| image:: /attachments/laywire/nodes/managing-node-records-2.png
    :scale: 75%
.. |managing-node-records-3| image:: /attachments/laywire/nodes/managing-node-records-3.png
    :scale: 75%
.. |managing-node-records-4| image:: /attachments/laywire/nodes/managing-node-records-4.png
    :scale: 75%
.. |managing-node-records-5| image:: /attachments/laywire/nodes/managing-node-records-5.png
    :scale: 75%
.. |managing-node-records-6| image:: /attachments/laywire/nodes/managing-node-records-6.png
    :scale: 75%
.. |managing-node-records-7| image:: /attachments/laywire/nodes/managing-node-records-7.png
    :scale: 75%
.. |managing-node-records-8| image:: /attachments/laywire/nodes/managing-node-records-8.png
    :scale: 75%

.. |add| image:: /attachments/laywire/add.svg
    :width: 20px
.. |edit| image:: /attachments/laywire/edit.svg
    :width: 20px
.. |delete| image:: /attachments/laywire/delete.svg
    :width: 20px