mirror/netbox-community-netbox
1
0
Fork 0
mirror of https://github.com/netbox-community/netbox.git synced 2024-05-10 07:54:54 +00:00
Code Activity

Finish refreshing DCIM models documentation

Browse Source
This commit is contained in:
jeremystretch
2022-08-15 15:16:02 -04:00
parent f76ce172e0
commit 4307f078ed
28 changed files with 547 additions and 70 deletions
Download Patch File Download Diff File Expand all files Collapse all files

58
docs/models/dcim/powerfeed.md
View File

@@ -1,21 +1,55 @@
# Power Feed
A power feed represents the distribution of power from a power panel to a particular device, typically a power distribution unit (PDU). The power port (inlet) on a device can be connected via a cable to a power feed. A power feed may optionally be assigned to a rack to allow more easily tracking the distribution of power among racks.
A power feed represents the distribution of power from a [power panel](./powerpanel.md) to a particular [device](./device.md), typically a power distribution unit (PDU). The [power port](./powerport.md) (inlet) on a device can be connected via a cable to a power feed. A power feed may optionally be assigned to a rack to allow more easily tracking the distribution of power among racks.
Each power feed is assigned an operational type (primary or redundant) and one of the following statuses:
## Fields
* Offline
* Active
* Planned
* Failed
### Power Panel
Each power feed also defines the electrical characteristics of the circuit which it represents. These include the following:
The [power panel](./powerpanel.md) which supplies upstream power to this feed.
* Supply type (AC or DC)
* Phase (single or three-phase)
* Voltage
* Amperage
* Maximum utilization (percentage)
### Rack
The [rack](./rack.md) within which this feed delivers power (optional).
### Name
The feed's name or other identifier. Must be unique to the assigned power panel.
### Status
The feed's operational status.
!!! tip
Additional statuses may be defined by setting `PowerFeed.status` under the [`FIELD_CHOICES`](../../configuration/data-validation.md#field_choices) configuration parameter.
### Type
In redundant environments, each power feed can be designated as providing either primary or redundant power. (In environment with only one power source, all power feeds should be designated as primary.)
### Mark Connected
If selected, the power feed will be treated as if a cable has been connected.
### Supply
Electrical current type (AC or DC).
### Voltage
Operating circuit voltage, in volts.
### Amperage
Operation circuit amperage, in amperes.
### Phase
Indicates whether the circuit provides single- or three-phase power.
### Max Utilization
The maximum safe utilization of the feed, expressed as a percentage of the total available power. (Typically this will be set to around 80%, to avoid tripping a breaker during heaving spikes in current draw.)
!!! info
The power utilization of a rack is calculated when one or more power feeds are assigned to the rack and connected to devices that draw power.