====== apparaat toevoegen======
[[netbox:netbox|{{ :netbox:icon.jpg?120|}}]]

===== context=====
dit document beschrijft hoe je een apparaat aan Netbox toevoegt.

===== vooraf =====
  * maak een **backup** van je apparaat\\ dit maakt een testkbestand aan van waaruit je makkelijker kan kopieren
  * neem een **foto** van de **sticker** die doorgaans op elk apparaat hangt met daarop: 
    * manufacturer
    * model
    * stroom input
    * MAC address {{ :netbox:2025-10-21_22_34_09-20251021_180243.jpg.png?200 |}}
  * neem je aankoopbewijs (factuur) erbij voor de **administratieve** informatie (zie:[[custom_fields|custom fields]]).



===== device type =====
==== handmatig aanmaken====

  * **Devices > Device types: Add**
  * vul mininaal in: 
    * **Manufacturer**
    * **Model**
    * **Image**: Google een foto van je apparaat
    * **comments**: voeg URL naar device specs toe\\ formaat: ''[Link text](https://URL)''
  * **Create**
  * **Add Components: Interfaces**
    * **Name**: gigabitEthernet 1/0/[0-16]\\ kijk hoe poorten worden aangeduid in je backup file\\ het aantal poorten wordt aangeduid met een [range]
    * maak een virtueel interface aan **VLan 1**. Hieraan kan je later het IP adres van het apparaat toekennen.
  * **Add Components: Power Ports**
    * **Name**: PSU (power supply unit)
    * **Type**: C14

<bootnote>EEn apparrat heeft dus minimaal onderstaande nodig: 
  * naam
  * network interface
  * power port
</bootnote>

==== importeren ====
=== community ===

De **community** stelt ook device types ter beschikking die je kan **importeren**
  * controleer of **Manufacturer** al bestaat. Zo niet, maak die eerst aan. Anders mislukt de import.
  * open [[https://github.com/netbox-community/devicetype-library/tree/master/device-types:|Netbox Community]]
  * **zoek** het type dat je nodig hebt
  * open het **YAML**-bestand
  * **kopieer** de tekst
  * **Devices > Device types: Import**
  * **Data**:plak de tekst, **Submit** {{ :netbox:2025-10-18_19_56_13-config_3_.cfg_-_visual_studio_code.png?400 |}}
  * voeg een **foto** toe van het apparaat.

=== CSV import===
zie: [[csvimport|CSV import]]

===== vlans =====
  * **IPAM > VLans**: Add
    * **VLAN ID**
    * **Name**: zoals op switch gekend
    * (**Role**): rol van het VLAN
<bootnote>Nu heb je een device type aangemaakt waarvan je nu een **instance** (apparaat) kunt maken</bootnote>
===== device =====
  * **Devices: Add**
  * vul mininaal in: 
    * **Name**: 
    * **Device role**: vb switching, routing, firewall, ...
    * **Device type**: zie hierboven
    * **Serial number**
    * **Site**
  * open nu de pagina:
    * **interfaces**
      * selecteer een interace > **edit**
      * **802.1Q Switching: 802.1Q Mode**: of/of 
        * **Access**: access poort, gevolgd door: 
          * **Untagged VLan**: selecteer de VLan waartoe de poort behoort
        * **Tagged**: selecteer de VLan**s** waartoe de poort behoort
      * **Connect > interface**
        * **B Side**:
          * **Device**: selecteer het apparaat waarmee het verbonden is
          * **Interface**: selecteer de poort waarop het verbonden is. 
        * **Cable**
          * **Type**: CAT5, gewoonlijk
          * **Color**: 
      * **herhaal** dit voor de overige actieve poorten
    * **Custom fields**: vul zoveel mogelijk administratieve data in: 
        * factuurnummer
        * orderdatum
        * prijs
        * ...

===== Trace=====
  * door interfaces van apparaten te verbinden, kan je een **trace** doen van de verbinding. 
    * **open** de interface > **Trace** {{ :netbox:2025-10-18_00_45_20-handbrake.png?400 |}}
    * dit geeft dan: {{ :netbox:2025-10-18_00_49_15-handbrake.png?400 |}}

===== meer info =====
voeg hier linken toe naar verdere uitleg
{{tag>netbox}}