Skip to content

Commit

Permalink
netbox component connections
Browse files Browse the repository at this point in the history
  • Loading branch information
Samuel Caruso committed Jun 25, 2024
1 parent a714f1a commit fdffe85
Show file tree
Hide file tree
Showing 9 changed files with 16 additions and 9 deletions.
25 changes: 16 additions & 9 deletions docs/admin/netbox.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,17 +22,24 @@ NetBox is an infrastructure resource modeling (IRM) application designed to empo

### How to add assets into Netbox

1. Navigate to HPCCF's Netbox instance here: [HPCCF's Netbox Site](https://netbox.hpc.ucdavis.edu/dcim/sites/) ![1](../img/netbox1.jpeg)
2. Select the site to which you will be adding an asset too. In this example I have chosen Campus DC: ![2](../img/netbox2.jpeg)
3. Scroll down to the bottom of this page and select which of the locations you will add your asset too, here I chose the Storage Cabinet: ![3](../img/netbox3.jpeg) ![4](../img/netbox4.jpeg)
4. On this page scroll to the bottom and select Add a Device: ![5](../img/netbox5.jpeg)
5. After you have selected Add a Device you should see a page like this: ![6](../img/netbox6.jpeg)
6. Fill out this page with specifics of the asset, some fields are not required but try to fill out this section as much as possible with the fields available, here is an example of a created asset and how it should look: ![7](../img/netbox7.jpeg)![8](../img/netbox8.jpeg)![9](../img/netbox9.jpeg)![10](../img/netbox10.jpeg)![11](../img/netbox11.jpeg)![12](../img/netbox12.jpeg)![13](../img/netbox13.jpeg)
1. Navigate to HPCCF's Netbox instance here: [HPCCF's Netbox Site](https://netbox.hpc.ucdavis.edu/dcim/sites/) ![netbox1](../img/netbox1.jpeg)
2. Select the site to which you will be adding an asset too. In this example I have chosen Campus DC: ![netbox2](../img/netbox2.jpeg)
3. Scroll down to the bottom of this page and select which of the locations you will add your asset too, here I chose the Storage Cabinet: ![netbox3](../img/netbox3.jpeg) ![netbox4](../img/netbox4.jpeg)
4. On this page scroll to the bottom and select Add a Device: ![netbox5](../img/netbox5.jpeg)
5. After you have selected Add a Device you should see a page like this: ![netbox6](../img/netbox6.jpeg)
6. Fill out this page with specifics of the asset, some fields are not required but try to fill out this section as much as possible with the fields available, here is an example of a created asset and how it should look: ![netbox7](../img/netbox7.jpeg)![netbox8](../img/netbox8.jpeg)![netbox9](../img/netbox9.jpeg)![netbox10](../img/netbox10.jpeg)![netbox11](../img/netbox11.jpeg)![netbox12](../img/netbox12.jpeg)![netbox13](../img/netbox13.jpeg)
7. Ensure to click on Save to have the device added.

### How to add components to an Asset

1. On the asset page select the + Add Components dropdown and select the component you wish to add, for this I have chosen a Console Port: ![14](../img/netbox14.jpeg)
2. Here again you will fill out the dropdowns as thoroughly as possible, the example here is of an interface that has already been added: ![15](../img/netbox15.jpeg)![16](../img/netbox16.jpeg)![17](../img/netbox17.jpeg)![18](../img/netbox18.jpeg)
1. On the asset page select the + Add Components dropdown and select the component you wish to add, for this I have chosen a Console Port: ![netbox14](../img/netbox14.jpeg)
2. Here again you will fill out the dropdowns as thoroughly as possible, the example here is of an interface that has already been added: ![netbox15](../img/netbox15.jpeg)![netbox16](../img/netbox16.jpeg)![netbox17](../img/netbox17.jpeg)![netbox18](../img/netbox18.jpeg)
3. Again make sure to click Save to ensure the component has been added.
4. This process can be used to add all of the following componentes to a device:![netbox19](../img/netbox19.jpeg)
4. This process can be used to add all of the following componentes to a device:![netbox19](../img/netbox19.jpeg)

### How to connect components

1. After a component has been created such as an interface, power port or any other type of component you will want to connect it. For any component the process is similar within Netbox. In this example it will show how to connect an Infiniban port on a device to a port on an Infiniban switch. First navigate to the device you wish to work with and select the appropriate tab, in this case it will be Interfaces and you will see a page like this: ![netbox20](../img/netbox20.jpeg)
2. Here we will connect ib1 to an infiban switch by clicking the green dropdown off to the right of ib1 and we will be connecting to another interface on the infiban switch so we will choose interface as shown here: ![netbox21](../img/netbox21.jpeg)
3. Once selected you will come to a screen that looks like this: ![netbox22](../img/netbox22.jpeg)![netbox23](../img/netbox23.jpeg)![netbox24](../img/netbox24.jpeg)
4. Once all filled out with the required information to complete the connection (and any additional information that can be provided) at the bottom make sure to create the connection, your screen should look something like this: ![netbox25](../img/netbox25.jpeg)![netbox26](../img/netbox26.jpeg)![netbox27](../img/netbox27.jpeg)
Binary file added docs/img/netbox20.jpeg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/img/netbox21.jpeg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/img/netbox22.jpeg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/img/netbox23.jpeg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/img/netbox24.jpeg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/img/netbox25.jpeg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/img/netbox26.jpeg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/img/netbox27.jpeg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit fdffe85

Please sign in to comment.