forms.py 62 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712
  1. import re
  2. from mptt.forms import TreeNodeChoiceField
  3. from django import forms
  4. from django.contrib.postgres.forms.array import SimpleArrayField
  5. from django.core.exceptions import ValidationError
  6. from django.db.models import Count, Q
  7. from extras.forms import CustomFieldForm, CustomFieldBulkEditForm, CustomFieldFilterForm
  8. from ipam.models import IPAddress
  9. from tenancy.models import Tenant
  10. from utilities.forms import (
  11. APISelect, add_blank_choice, ArrayFieldSelectMultiple, BootstrapMixin, BulkEditForm, BulkImportForm, CommentField,
  12. CSVDataField, ExpandableNameField, FilterChoiceField, FlexibleModelChoiceField, Livesearch, SelectWithDisabled,
  13. SmallTextarea, SlugField, FilterTreeNodeMultipleChoiceField,
  14. )
  15. from .formfields import MACAddressFormField
  16. from .models import (
  17. DeviceBay, DeviceBayTemplate, CONNECTION_STATUS_CHOICES, CONNECTION_STATUS_PLANNED, CONNECTION_STATUS_CONNECTED,
  18. ConsolePort, ConsolePortTemplate, ConsoleServerPort, ConsoleServerPortTemplate, Device, DeviceRole, DeviceType,
  19. Interface, IFACE_FF_CHOICES, IFACE_FF_LAG, IFACE_ORDERING_CHOICES, InterfaceConnection, InterfaceTemplate,
  20. Manufacturer, Module, Platform, PowerOutlet, PowerOutletTemplate, PowerPort, PowerPortTemplate, RACK_TYPE_CHOICES,
  21. RACK_WIDTH_CHOICES, Rack, RackGroup, RackReservation, RackRole, Region, Site, STATUS_CHOICES, SUBDEVICE_ROLE_CHILD,
  22. SUBDEVICE_ROLE_PARENT, VIRTUAL_IFACE_TYPES
  23. )
  24. FORM_STATUS_CHOICES = [
  25. ['', '---------'],
  26. ]
  27. FORM_STATUS_CHOICES += STATUS_CHOICES
  28. DEVICE_BY_PK_RE = '{\d+\}'
  29. def get_device_by_name_or_pk(name):
  30. """
  31. Attempt to retrieve a device by either its name or primary key ('{pk}').
  32. """
  33. if re.match(DEVICE_BY_PK_RE, name):
  34. pk = name.strip('{}')
  35. device = Device.objects.get(pk=pk)
  36. else:
  37. device = Device.objects.get(name=name)
  38. return device
  39. def validate_connection_status(value):
  40. """
  41. Custom validator for connection statuses. value must be either "planned" or "connected" (case-insensitive).
  42. """
  43. if value.lower() not in ['planned', 'connected']:
  44. raise ValidationError('Invalid connection status ({}); must be either "planned" or "connected".'.format(value))
  45. class DeviceComponentForm(BootstrapMixin, forms.Form):
  46. """
  47. Allow inclusion of the parent device as context for limiting field choices.
  48. """
  49. def __init__(self, device, *args, **kwargs):
  50. self.device = device
  51. super(DeviceComponentForm, self).__init__(*args, **kwargs)
  52. #
  53. # Regions
  54. #
  55. class RegionForm(BootstrapMixin, forms.ModelForm):
  56. slug = SlugField()
  57. class Meta:
  58. model = Region
  59. fields = ['parent', 'name', 'slug']
  60. #
  61. # Sites
  62. #
  63. class SiteForm(BootstrapMixin, CustomFieldForm):
  64. region = TreeNodeChoiceField(queryset=Region.objects.all(), required=False)
  65. slug = SlugField()
  66. comments = CommentField()
  67. class Meta:
  68. model = Site
  69. fields = [
  70. 'name', 'slug', 'region', 'tenant', 'facility', 'asn', 'physical_address', 'shipping_address',
  71. 'contact_name', 'contact_phone', 'contact_email', 'comments',
  72. ]
  73. widgets = {
  74. 'physical_address': SmallTextarea(attrs={'rows': 3}),
  75. 'shipping_address': SmallTextarea(attrs={'rows': 3}),
  76. }
  77. help_texts = {
  78. 'name': "Full name of the site",
  79. 'facility': "Data center provider and facility (e.g. Equinix NY7)",
  80. 'asn': "BGP autonomous system number",
  81. 'physical_address': "Physical location of the building (e.g. for GPS)",
  82. 'shipping_address': "If different from the physical address"
  83. }
  84. class SiteFromCSVForm(forms.ModelForm):
  85. region = forms.ModelChoiceField(
  86. Region.objects.all(), to_field_name='name', required=False, error_messages={
  87. 'invalid_choice': 'Tenant not found.'
  88. }
  89. )
  90. tenant = forms.ModelChoiceField(
  91. Tenant.objects.all(), to_field_name='name', required=False, error_messages={
  92. 'invalid_choice': 'Tenant not found.'
  93. }
  94. )
  95. class Meta:
  96. model = Site
  97. fields = [
  98. 'name', 'slug', 'region', 'tenant', 'facility', 'asn', 'contact_name', 'contact_phone', 'contact_email',
  99. ]
  100. class SiteImportForm(BootstrapMixin, BulkImportForm):
  101. csv = CSVDataField(csv_form=SiteFromCSVForm)
  102. class SiteBulkEditForm(BootstrapMixin, CustomFieldBulkEditForm):
  103. pk = forms.ModelMultipleChoiceField(queryset=Site.objects.all(), widget=forms.MultipleHiddenInput)
  104. region = TreeNodeChoiceField(queryset=Region.objects.all(), required=False)
  105. tenant = forms.ModelChoiceField(queryset=Tenant.objects.all(), required=False)
  106. asn = forms.IntegerField(min_value=1, max_value=4294967295, required=False, label='ASN')
  107. class Meta:
  108. nullable_fields = ['region', 'tenant', 'asn']
  109. class SiteFilterForm(BootstrapMixin, CustomFieldFilterForm):
  110. model = Site
  111. q = forms.CharField(required=False, label='Search')
  112. region = FilterTreeNodeMultipleChoiceField(
  113. queryset=Region.objects.annotate(filter_count=Count('sites')),
  114. to_field_name='slug',
  115. required=False,
  116. )
  117. tenant = FilterChoiceField(
  118. queryset=Tenant.objects.annotate(filter_count=Count('sites')),
  119. to_field_name='slug',
  120. null_option=(0, 'None')
  121. )
  122. #
  123. # Rack groups
  124. #
  125. class RackGroupForm(BootstrapMixin, forms.ModelForm):
  126. slug = SlugField()
  127. class Meta:
  128. model = RackGroup
  129. fields = ['site', 'name', 'slug']
  130. class RackGroupFilterForm(BootstrapMixin, forms.Form):
  131. site = FilterChoiceField(queryset=Site.objects.annotate(filter_count=Count('rack_groups')), to_field_name='slug')
  132. #
  133. # Rack roles
  134. #
  135. class RackRoleForm(BootstrapMixin, forms.ModelForm):
  136. slug = SlugField()
  137. class Meta:
  138. model = RackRole
  139. fields = ['name', 'slug', 'color']
  140. #
  141. # Racks
  142. #
  143. class RackForm(BootstrapMixin, CustomFieldForm):
  144. group = forms.ModelChoiceField(queryset=RackGroup.objects.all(), required=False, label='Group', widget=APISelect(
  145. api_url='/api/dcim/rack-groups/?site_id={{site}}',
  146. ))
  147. comments = CommentField()
  148. class Meta:
  149. model = Rack
  150. fields = ['site', 'group', 'name', 'facility_id', 'tenant', 'role', 'type', 'width', 'u_height', 'desc_units',
  151. 'comments']
  152. help_texts = {
  153. 'site': "The site at which the rack exists",
  154. 'name': "Organizational rack name",
  155. 'facility_id': "The unique rack ID assigned by the facility",
  156. 'u_height': "Height in rack units",
  157. }
  158. widgets = {
  159. 'site': forms.Select(attrs={'filter-for': 'group'}),
  160. }
  161. def __init__(self, *args, **kwargs):
  162. super(RackForm, self).__init__(*args, **kwargs)
  163. # Limit rack group choices
  164. if self.is_bound and self.data.get('site'):
  165. self.fields['group'].queryset = RackGroup.objects.filter(site__pk=self.data['site'])
  166. elif self.initial.get('site'):
  167. self.fields['group'].queryset = RackGroup.objects.filter(site=self.initial['site'])
  168. else:
  169. self.fields['group'].choices = []
  170. class RackFromCSVForm(forms.ModelForm):
  171. site = forms.ModelChoiceField(queryset=Site.objects.all(), to_field_name='name',
  172. error_messages={'invalid_choice': 'Site not found.'})
  173. group_name = forms.CharField(required=False)
  174. tenant = forms.ModelChoiceField(Tenant.objects.all(), to_field_name='name', required=False,
  175. error_messages={'invalid_choice': 'Tenant not found.'})
  176. role = forms.ModelChoiceField(RackRole.objects.all(), to_field_name='name', required=False,
  177. error_messages={'invalid_choice': 'Role not found.'})
  178. type = forms.CharField(required=False)
  179. class Meta:
  180. model = Rack
  181. fields = ['site', 'group_name', 'name', 'facility_id', 'tenant', 'role', 'type', 'width', 'u_height',
  182. 'desc_units']
  183. def clean(self):
  184. site = self.cleaned_data.get('site')
  185. group = self.cleaned_data.get('group_name')
  186. # Validate rack group
  187. if site and group:
  188. try:
  189. self.instance.group = RackGroup.objects.get(site=site, name=group)
  190. except RackGroup.DoesNotExist:
  191. self.add_error('group_name', "Invalid rack group ({})".format(group))
  192. def clean_type(self):
  193. rack_type = self.cleaned_data['type']
  194. if not rack_type:
  195. return None
  196. try:
  197. choices = {v.lower(): k for k, v in RACK_TYPE_CHOICES}
  198. return choices[rack_type.lower()]
  199. except KeyError:
  200. raise forms.ValidationError('Invalid rack type ({}). Valid choices are: {}.'.format(
  201. rack_type,
  202. ', '.join({v: k for k, v in RACK_TYPE_CHOICES}),
  203. ))
  204. class RackImportForm(BootstrapMixin, BulkImportForm):
  205. csv = CSVDataField(csv_form=RackFromCSVForm)
  206. class RackBulkEditForm(BootstrapMixin, CustomFieldBulkEditForm):
  207. pk = forms.ModelMultipleChoiceField(queryset=Rack.objects.all(), widget=forms.MultipleHiddenInput)
  208. site = forms.ModelChoiceField(queryset=Site.objects.all(), required=False, label='Site')
  209. group = forms.ModelChoiceField(queryset=RackGroup.objects.all(), required=False, label='Group')
  210. tenant = forms.ModelChoiceField(queryset=Tenant.objects.all(), required=False)
  211. role = forms.ModelChoiceField(queryset=RackRole.objects.all(), required=False)
  212. type = forms.ChoiceField(choices=add_blank_choice(RACK_TYPE_CHOICES), required=False, label='Type')
  213. width = forms.ChoiceField(choices=add_blank_choice(RACK_WIDTH_CHOICES), required=False, label='Width')
  214. u_height = forms.IntegerField(required=False, label='Height (U)')
  215. comments = CommentField(widget=SmallTextarea)
  216. class Meta:
  217. nullable_fields = ['group', 'tenant', 'role', 'comments']
  218. class RackFilterForm(BootstrapMixin, CustomFieldFilterForm):
  219. model = Rack
  220. q = forms.CharField(required=False, label='Search')
  221. site = FilterChoiceField(
  222. queryset=Site.objects.annotate(filter_count=Count('racks')),
  223. to_field_name='slug'
  224. )
  225. group_id = FilterChoiceField(
  226. queryset=RackGroup.objects.select_related('site').annotate(filter_count=Count('racks')),
  227. label='Rack group',
  228. null_option=(0, 'None')
  229. )
  230. tenant = FilterChoiceField(
  231. queryset=Tenant.objects.annotate(filter_count=Count('racks')),
  232. to_field_name='slug',
  233. null_option=(0, 'None')
  234. )
  235. role = FilterChoiceField(
  236. queryset=RackRole.objects.annotate(filter_count=Count('racks')),
  237. to_field_name='slug',
  238. null_option=(0, 'None')
  239. )
  240. #
  241. # Rack reservations
  242. #
  243. class RackReservationForm(BootstrapMixin, forms.ModelForm):
  244. units = SimpleArrayField(forms.IntegerField(), widget=ArrayFieldSelectMultiple(attrs={'size': 10}))
  245. class Meta:
  246. model = RackReservation
  247. fields = ['units', 'description']
  248. def __init__(self, *args, **kwargs):
  249. super(RackReservationForm, self).__init__(*args, **kwargs)
  250. # Populate rack unit choices
  251. self.fields['units'].widget.choices = self._get_unit_choices()
  252. def _get_unit_choices(self):
  253. rack = self.instance.rack
  254. reserved_units = []
  255. for resv in rack.reservations.exclude(pk=self.instance.pk):
  256. for u in resv.units:
  257. reserved_units.append(u)
  258. unit_choices = [(u, {'label': str(u), 'disabled': u in reserved_units}) for u in rack.units]
  259. return unit_choices
  260. #
  261. # Manufacturers
  262. #
  263. class ManufacturerForm(BootstrapMixin, forms.ModelForm):
  264. slug = SlugField()
  265. class Meta:
  266. model = Manufacturer
  267. fields = ['name', 'slug']
  268. #
  269. # Device types
  270. #
  271. class DeviceTypeForm(BootstrapMixin, CustomFieldForm):
  272. slug = SlugField(slug_source='model')
  273. class Meta:
  274. model = DeviceType
  275. fields = ['manufacturer', 'model', 'slug', 'part_number', 'u_height', 'is_full_depth', 'is_console_server',
  276. 'is_pdu', 'is_network_device', 'subdevice_role', 'interface_ordering', 'comments']
  277. labels = {
  278. 'interface_ordering': 'Order interfaces by',
  279. }
  280. class DeviceTypeBulkEditForm(BootstrapMixin, CustomFieldBulkEditForm):
  281. pk = forms.ModelMultipleChoiceField(queryset=DeviceType.objects.all(), widget=forms.MultipleHiddenInput)
  282. manufacturer = forms.ModelChoiceField(queryset=Manufacturer.objects.all(), required=False)
  283. u_height = forms.IntegerField(min_value=1, required=False)
  284. interface_ordering = forms.ChoiceField(choices=add_blank_choice(IFACE_ORDERING_CHOICES), required=False)
  285. class Meta:
  286. nullable_fields = []
  287. class DeviceTypeFilterForm(BootstrapMixin, CustomFieldFilterForm):
  288. model = DeviceType
  289. q = forms.CharField(required=False, label='Search')
  290. manufacturer = FilterChoiceField(
  291. queryset=Manufacturer.objects.annotate(filter_count=Count('device_types')),
  292. to_field_name='slug'
  293. )
  294. is_console_server = forms.BooleanField(
  295. required=False, label='Is a console server', widget=forms.CheckboxInput(attrs={'value': 'True'}))
  296. is_pdu = forms.BooleanField(
  297. required=False, label='Is a PDU', widget=forms.CheckboxInput(attrs={'value': 'True'})
  298. )
  299. is_network_device = forms.BooleanField(
  300. required=False, label='Is a network device', widget=forms.CheckboxInput(attrs={'value': 'True'})
  301. )
  302. subdevice_role = forms.NullBooleanField(
  303. required=False, label='Subdevice role', widget=forms.Select(choices=(
  304. ('', '---------'),
  305. (SUBDEVICE_ROLE_PARENT, 'Parent'),
  306. (SUBDEVICE_ROLE_CHILD, 'Child'),
  307. ))
  308. )
  309. #
  310. # Device component templates
  311. #
  312. class ConsolePortTemplateForm(BootstrapMixin, forms.ModelForm):
  313. class Meta:
  314. model = ConsolePortTemplate
  315. fields = ['device_type', 'name']
  316. widgets = {
  317. 'device_type': forms.HiddenInput(),
  318. }
  319. class ConsolePortTemplateCreateForm(DeviceComponentForm):
  320. name_pattern = ExpandableNameField(label='Name')
  321. class ConsoleServerPortTemplateForm(BootstrapMixin, forms.ModelForm):
  322. class Meta:
  323. model = ConsoleServerPortTemplate
  324. fields = ['device_type', 'name']
  325. widgets = {
  326. 'device_type': forms.HiddenInput(),
  327. }
  328. class ConsoleServerPortTemplateCreateForm(DeviceComponentForm):
  329. name_pattern = ExpandableNameField(label='Name')
  330. class PowerPortTemplateForm(BootstrapMixin, forms.ModelForm):
  331. class Meta:
  332. model = PowerPortTemplate
  333. fields = ['device_type', 'name']
  334. widgets = {
  335. 'device_type': forms.HiddenInput(),
  336. }
  337. class PowerPortTemplateCreateForm(DeviceComponentForm):
  338. name_pattern = ExpandableNameField(label='Name')
  339. class PowerOutletTemplateForm(BootstrapMixin, forms.ModelForm):
  340. class Meta:
  341. model = PowerOutletTemplate
  342. fields = ['device_type', 'name']
  343. widgets = {
  344. 'device_type': forms.HiddenInput(),
  345. }
  346. class PowerOutletTemplateCreateForm(DeviceComponentForm):
  347. name_pattern = ExpandableNameField(label='Name')
  348. class InterfaceTemplateForm(BootstrapMixin, forms.ModelForm):
  349. class Meta:
  350. model = InterfaceTemplate
  351. fields = ['device_type', 'name', 'form_factor', 'mgmt_only']
  352. widgets = {
  353. 'device_type': forms.HiddenInput(),
  354. }
  355. class InterfaceTemplateCreateForm(DeviceComponentForm):
  356. name_pattern = ExpandableNameField(label='Name')
  357. form_factor = forms.ChoiceField(choices=IFACE_FF_CHOICES)
  358. mgmt_only = forms.BooleanField(required=False, label='OOB Management')
  359. class InterfaceTemplateBulkEditForm(BootstrapMixin, BulkEditForm):
  360. pk = forms.ModelMultipleChoiceField(queryset=InterfaceTemplate.objects.all(), widget=forms.MultipleHiddenInput)
  361. form_factor = forms.ChoiceField(choices=add_blank_choice(IFACE_FF_CHOICES), required=False)
  362. class Meta:
  363. nullable_fields = []
  364. class DeviceBayTemplateForm(BootstrapMixin, forms.ModelForm):
  365. class Meta:
  366. model = DeviceBayTemplate
  367. fields = ['device_type', 'name']
  368. widgets = {
  369. 'device_type': forms.HiddenInput(),
  370. }
  371. class DeviceBayTemplateCreateForm(DeviceComponentForm):
  372. name_pattern = ExpandableNameField(label='Name')
  373. #
  374. # Device roles
  375. #
  376. class DeviceRoleForm(BootstrapMixin, forms.ModelForm):
  377. slug = SlugField()
  378. class Meta:
  379. model = DeviceRole
  380. fields = ['name', 'slug', 'color']
  381. #
  382. # Platforms
  383. #
  384. class PlatformForm(BootstrapMixin, forms.ModelForm):
  385. slug = SlugField()
  386. class Meta:
  387. model = Platform
  388. fields = ['name', 'slug']
  389. #
  390. # Devices
  391. #
  392. class DeviceForm(BootstrapMixin, CustomFieldForm):
  393. site = forms.ModelChoiceField(queryset=Site.objects.all(), widget=forms.Select(attrs={'filter-for': 'rack'}))
  394. rack = forms.ModelChoiceField(queryset=Rack.objects.all(), required=False, widget=APISelect(
  395. api_url='/api/dcim/racks/?site_id={{site}}',
  396. display_field='display_name',
  397. attrs={'filter-for': 'position'}
  398. ))
  399. position = forms.TypedChoiceField(required=False, empty_value=None,
  400. help_text="The lowest-numbered unit occupied by the device",
  401. widget=APISelect(api_url='/api/dcim/racks/{{rack}}/rack-units/?face={{face}}',
  402. disabled_indicator='device'))
  403. manufacturer = forms.ModelChoiceField(queryset=Manufacturer.objects.all(),
  404. widget=forms.Select(attrs={'filter-for': 'device_type'}))
  405. device_type = forms.ModelChoiceField(queryset=DeviceType.objects.all(), label='Device type', widget=APISelect(
  406. api_url='/api/dcim/device-types/?manufacturer_id={{manufacturer}}',
  407. display_field='model'
  408. ))
  409. comments = CommentField()
  410. class Meta:
  411. model = Device
  412. fields = ['name', 'device_role', 'tenant', 'device_type', 'serial', 'asset_tag', 'site', 'rack', 'position',
  413. 'face', 'status', 'platform', 'primary_ip4', 'primary_ip6', 'comments']
  414. help_texts = {
  415. 'device_role': "The function this device serves",
  416. 'serial': "Chassis serial number",
  417. }
  418. widgets = {
  419. 'face': forms.Select(attrs={'filter-for': 'position'}),
  420. 'manufacturer': forms.Select(attrs={'filter-for': 'device_type'}),
  421. }
  422. def __init__(self, *args, **kwargs):
  423. super(DeviceForm, self).__init__(*args, **kwargs)
  424. if self.instance.pk:
  425. # Initialize helper selections
  426. self.initial['site'] = self.instance.site
  427. self.initial['manufacturer'] = self.instance.device_type.manufacturer
  428. # Compile list of choices for primary IPv4 and IPv6 addresses
  429. for family in [4, 6]:
  430. ip_choices = []
  431. interface_ips = IPAddress.objects.filter(family=family, interface__device=self.instance)
  432. ip_choices += [(ip.id, u'{} ({})'.format(ip.address, ip.interface)) for ip in interface_ips]
  433. nat_ips = IPAddress.objects.filter(family=family, nat_inside__interface__device=self.instance)\
  434. .select_related('nat_inside__interface')
  435. ip_choices += [(ip.id, u'{} ({} NAT)'.format(ip.address, ip.nat_inside.interface)) for ip in nat_ips]
  436. self.fields['primary_ip{}'.format(family)].choices = [(None, '---------')] + ip_choices
  437. # If editing an existing device, exclude it from the list of occupied rack units. This ensures that a device
  438. # can be flipped from one face to another.
  439. self.fields['position'].widget.attrs['api-url'] += '&exclude={}'.format(self.instance.pk)
  440. else:
  441. # An object that doesn't exist yet can't have any IPs assigned to it
  442. self.fields['primary_ip4'].choices = []
  443. self.fields['primary_ip4'].widget.attrs['readonly'] = True
  444. self.fields['primary_ip6'].choices = []
  445. self.fields['primary_ip6'].widget.attrs['readonly'] = True
  446. # Limit rack choices
  447. if self.is_bound and self.data.get('site'):
  448. self.fields['rack'].queryset = Rack.objects.filter(site__pk=self.data['site'])
  449. elif self.initial.get('site'):
  450. self.fields['rack'].queryset = Rack.objects.filter(site=self.initial['site'])
  451. else:
  452. self.fields['rack'].choices = []
  453. # Rack position
  454. pk = self.instance.pk if self.instance.pk else None
  455. try:
  456. if self.is_bound and self.data.get('rack') and str(self.data.get('face')):
  457. position_choices = Rack.objects.get(pk=self.data['rack'])\
  458. .get_rack_units(face=self.data.get('face'), exclude=pk)
  459. elif self.initial.get('rack') and str(self.initial.get('face')):
  460. position_choices = Rack.objects.get(pk=self.initial['rack'])\
  461. .get_rack_units(face=self.initial.get('face'), exclude=pk)
  462. else:
  463. position_choices = []
  464. except Rack.DoesNotExist:
  465. position_choices = []
  466. self.fields['position'].choices = [('', '---------')] + [
  467. (p['id'], {
  468. 'label': p['name'],
  469. 'disabled': bool(p['device'] and p['id'] != self.initial.get('position')),
  470. }) for p in position_choices
  471. ]
  472. # Limit device_type choices
  473. if self.is_bound:
  474. self.fields['device_type'].queryset = DeviceType.objects.filter(manufacturer__pk=self.data['manufacturer'])\
  475. .select_related('manufacturer')
  476. elif self.initial.get('manufacturer'):
  477. self.fields['device_type'].queryset = DeviceType.objects.filter(manufacturer=self.initial['manufacturer'])\
  478. .select_related('manufacturer')
  479. else:
  480. self.fields['device_type'].choices = []
  481. # Disable rack assignment if this is a child device installed in a parent device
  482. if pk and self.instance.device_type.is_child_device and hasattr(self.instance, 'parent_bay'):
  483. self.fields['site'].disabled = True
  484. self.fields['rack'].disabled = True
  485. self.initial['site'] = self.instance.parent_bay.device.site_id
  486. self.initial['rack'] = self.instance.parent_bay.device.rack_id
  487. class BaseDeviceFromCSVForm(forms.ModelForm):
  488. device_role = forms.ModelChoiceField(queryset=DeviceRole.objects.all(), to_field_name='name',
  489. error_messages={'invalid_choice': 'Invalid device role.'})
  490. tenant = forms.ModelChoiceField(Tenant.objects.all(), to_field_name='name', required=False,
  491. error_messages={'invalid_choice': 'Tenant not found.'})
  492. manufacturer = forms.ModelChoiceField(queryset=Manufacturer.objects.all(), to_field_name='name',
  493. error_messages={'invalid_choice': 'Invalid manufacturer.'})
  494. model_name = forms.CharField()
  495. platform = forms.ModelChoiceField(queryset=Platform.objects.all(), required=False, to_field_name='name',
  496. error_messages={'invalid_choice': 'Invalid platform.'})
  497. class Meta:
  498. fields = []
  499. model = Device
  500. def clean(self):
  501. manufacturer = self.cleaned_data.get('manufacturer')
  502. model_name = self.cleaned_data.get('model_name')
  503. # Validate device type
  504. if manufacturer and model_name:
  505. try:
  506. self.instance.device_type = DeviceType.objects.get(manufacturer=manufacturer, model=model_name)
  507. except DeviceType.DoesNotExist:
  508. self.add_error('model_name', "Invalid device type ({} {})".format(manufacturer, model_name))
  509. class DeviceFromCSVForm(BaseDeviceFromCSVForm):
  510. site = forms.ModelChoiceField(queryset=Site.objects.all(), to_field_name='name', error_messages={
  511. 'invalid_choice': 'Invalid site name.',
  512. })
  513. rack_name = forms.CharField(required=False)
  514. face = forms.CharField(required=False)
  515. class Meta(BaseDeviceFromCSVForm.Meta):
  516. fields = ['name', 'device_role', 'tenant', 'manufacturer', 'model_name', 'platform', 'serial', 'asset_tag',
  517. 'site', 'rack_name', 'position', 'face']
  518. def clean(self):
  519. super(DeviceFromCSVForm, self).clean()
  520. site = self.cleaned_data.get('site')
  521. rack_name = self.cleaned_data.get('rack_name')
  522. # Validate rack
  523. if site and rack_name:
  524. try:
  525. self.instance.rack = Rack.objects.get(site=site, name=rack_name)
  526. except Rack.DoesNotExist:
  527. self.add_error('rack_name', "Invalid rack ({})".format(rack_name))
  528. def clean_face(self):
  529. face = self.cleaned_data['face']
  530. if not face:
  531. return None
  532. try:
  533. return {
  534. 'front': 0,
  535. 'rear': 1,
  536. }[face.lower()]
  537. except KeyError:
  538. raise forms.ValidationError('Invalid rack face ({}); must be "front" or "rear".'.format(face))
  539. class ChildDeviceFromCSVForm(BaseDeviceFromCSVForm):
  540. parent = FlexibleModelChoiceField(
  541. queryset=Device.objects.all(),
  542. to_field_name='name',
  543. required=False,
  544. error_messages={
  545. 'invalid_choice': 'Parent device not found.'
  546. }
  547. )
  548. device_bay_name = forms.CharField(required=False)
  549. class Meta(BaseDeviceFromCSVForm.Meta):
  550. fields = [
  551. 'name', 'device_role', 'tenant', 'manufacturer', 'model_name', 'platform', 'serial', 'asset_tag', 'parent',
  552. 'device_bay_name',
  553. ]
  554. def clean(self):
  555. super(ChildDeviceFromCSVForm, self).clean()
  556. parent = self.cleaned_data.get('parent')
  557. device_bay_name = self.cleaned_data.get('device_bay_name')
  558. # Validate device bay
  559. if parent and device_bay_name:
  560. try:
  561. device_bay = DeviceBay.objects.get(device=parent, name=device_bay_name)
  562. if device_bay.installed_device:
  563. self.add_error('device_bay_name',
  564. "Device bay ({} {}) is already occupied".format(parent, device_bay_name))
  565. else:
  566. self.instance.parent_bay = device_bay
  567. except DeviceBay.DoesNotExist:
  568. self.add_error('device_bay_name', "Parent device/bay ({} {}) not found".format(parent, device_bay_name))
  569. class DeviceImportForm(BootstrapMixin, BulkImportForm):
  570. csv = CSVDataField(csv_form=DeviceFromCSVForm)
  571. class ChildDeviceImportForm(BootstrapMixin, BulkImportForm):
  572. csv = CSVDataField(csv_form=ChildDeviceFromCSVForm)
  573. class DeviceBulkEditForm(BootstrapMixin, CustomFieldBulkEditForm):
  574. pk = forms.ModelMultipleChoiceField(queryset=Device.objects.all(), widget=forms.MultipleHiddenInput)
  575. device_type = forms.ModelChoiceField(queryset=DeviceType.objects.all(), required=False, label='Type')
  576. device_role = forms.ModelChoiceField(queryset=DeviceRole.objects.all(), required=False, label='Role')
  577. tenant = forms.ModelChoiceField(queryset=Tenant.objects.all(), required=False)
  578. platform = forms.ModelChoiceField(queryset=Platform.objects.all(), required=False)
  579. status = forms.ChoiceField(choices=FORM_STATUS_CHOICES, required=False, initial='', label='Status')
  580. serial = forms.CharField(max_length=50, required=False, label='Serial Number')
  581. class Meta:
  582. nullable_fields = ['tenant', 'platform']
  583. class DeviceFilterForm(BootstrapMixin, CustomFieldFilterForm):
  584. model = Device
  585. q = forms.CharField(required=False, label='Search')
  586. site = FilterChoiceField(
  587. queryset=Site.objects.annotate(filter_count=Count('devices')),
  588. to_field_name='slug',
  589. )
  590. rack_group_id = FilterChoiceField(
  591. queryset=RackGroup.objects.select_related('site').annotate(filter_count=Count('racks__devices')),
  592. label='Rack group',
  593. )
  594. role = FilterChoiceField(
  595. queryset=DeviceRole.objects.annotate(filter_count=Count('devices')),
  596. to_field_name='slug',
  597. )
  598. tenant = FilterChoiceField(
  599. queryset=Tenant.objects.annotate(filter_count=Count('devices')), to_field_name='slug',
  600. null_option=(0, 'None'),
  601. )
  602. manufacturer_id = FilterChoiceField(
  603. queryset=Manufacturer.objects.all(),
  604. label='Manufacturer',
  605. )
  606. device_type_id = FilterChoiceField(
  607. queryset=DeviceType.objects.select_related('manufacturer').order_by('model').annotate(
  608. filter_count=Count('instances'),
  609. ),
  610. label='Model',
  611. )
  612. platform = FilterChoiceField(
  613. queryset=Platform.objects.annotate(filter_count=Count('devices')),
  614. to_field_name='slug',
  615. null_option=(0, 'None'),
  616. )
  617. status = forms.NullBooleanField(
  618. required=False,
  619. widget=forms.Select(choices=FORM_STATUS_CHOICES),
  620. )
  621. mac_address = forms.CharField(
  622. required=False,
  623. label='MAC address',
  624. )
  625. #
  626. # Bulk device component creation
  627. #
  628. class DeviceBulkAddComponentForm(BootstrapMixin, forms.Form):
  629. pk = forms.ModelMultipleChoiceField(queryset=Device.objects.all(), widget=forms.MultipleHiddenInput)
  630. name_pattern = ExpandableNameField(label='Name')
  631. class DeviceBulkAddInterfaceForm(forms.ModelForm, DeviceBulkAddComponentForm):
  632. class Meta:
  633. model = Interface
  634. fields = ['pk', 'name_pattern', 'form_factor', 'mgmt_only', 'description']
  635. #
  636. # Console ports
  637. #
  638. class ConsolePortForm(BootstrapMixin, forms.ModelForm):
  639. class Meta:
  640. model = ConsolePort
  641. fields = ['device', 'name']
  642. widgets = {
  643. 'device': forms.HiddenInput(),
  644. }
  645. class ConsolePortCreateForm(DeviceComponentForm):
  646. name_pattern = ExpandableNameField(label='Name')
  647. class ConsoleConnectionCSVForm(forms.Form):
  648. console_server = FlexibleModelChoiceField(
  649. queryset=Device.objects.filter(device_type__is_console_server=True),
  650. to_field_name='name',
  651. error_messages={
  652. 'invalid_choice': 'Console server not found',
  653. }
  654. )
  655. cs_port = forms.CharField()
  656. device = FlexibleModelChoiceField(queryset=Device.objects.all(), to_field_name='name',
  657. error_messages={'invalid_choice': 'Device not found'})
  658. console_port = forms.CharField()
  659. status = forms.CharField(validators=[validate_connection_status])
  660. def clean(self):
  661. # Validate console server port
  662. if self.cleaned_data.get('console_server'):
  663. try:
  664. cs_port = ConsoleServerPort.objects.get(device=self.cleaned_data['console_server'],
  665. name=self.cleaned_data['cs_port'])
  666. if ConsolePort.objects.filter(cs_port=cs_port):
  667. raise forms.ValidationError("Console server port is already occupied (by {} {})"
  668. .format(cs_port.connected_console.device, cs_port.connected_console))
  669. except ConsoleServerPort.DoesNotExist:
  670. raise forms.ValidationError("Invalid console server port ({} {})"
  671. .format(self.cleaned_data['console_server'], self.cleaned_data['cs_port']))
  672. # Validate console port
  673. if self.cleaned_data.get('device'):
  674. try:
  675. console_port = ConsolePort.objects.get(device=self.cleaned_data['device'],
  676. name=self.cleaned_data['console_port'])
  677. if console_port.cs_port:
  678. raise forms.ValidationError("Console port is already connected (to {} {})"
  679. .format(console_port.cs_port.device, console_port.cs_port))
  680. except ConsolePort.DoesNotExist:
  681. raise forms.ValidationError("Invalid console port ({} {})"
  682. .format(self.cleaned_data['device'], self.cleaned_data['console_port']))
  683. class ConsoleConnectionImportForm(BootstrapMixin, BulkImportForm):
  684. csv = CSVDataField(csv_form=ConsoleConnectionCSVForm)
  685. def clean(self):
  686. records = self.cleaned_data.get('csv')
  687. if not records:
  688. return
  689. connection_list = []
  690. for i, record in enumerate(records, start=1):
  691. form = self.fields['csv'].csv_form(data=record)
  692. if form.is_valid():
  693. console_port = ConsolePort.objects.get(device=form.cleaned_data['device'],
  694. name=form.cleaned_data['console_port'])
  695. console_port.cs_port = ConsoleServerPort.objects.get(device=form.cleaned_data['console_server'],
  696. name=form.cleaned_data['cs_port'])
  697. if form.cleaned_data['status'] == 'planned':
  698. console_port.connection_status = CONNECTION_STATUS_PLANNED
  699. else:
  700. console_port.connection_status = CONNECTION_STATUS_CONNECTED
  701. connection_list.append(console_port)
  702. else:
  703. for field, errors in form.errors.items():
  704. for e in errors:
  705. self.add_error('csv', "Record {} {}: {}".format(i, field, e))
  706. self.cleaned_data['csv'] = connection_list
  707. class ConsolePortConnectionForm(BootstrapMixin, forms.ModelForm):
  708. site = forms.ModelChoiceField(
  709. queryset=Site.objects.all(),
  710. widget=forms.HiddenInput(),
  711. )
  712. rack = forms.ModelChoiceField(
  713. queryset=Rack.objects.all(),
  714. label='Rack',
  715. required=False,
  716. widget=forms.Select(
  717. attrs={'filter-for': 'console_server', 'nullable': 'true'}
  718. )
  719. )
  720. console_server = forms.ModelChoiceField(
  721. queryset=Device.objects.all(),
  722. label='Console Server',
  723. required=False,
  724. widget=APISelect(
  725. api_url='/api/dcim/devices/?site_id={{site}}&rack_id={{rack}}&is_console_server=True',
  726. display_field='display_name',
  727. attrs={'filter-for': 'cs_port'}
  728. )
  729. )
  730. livesearch = forms.CharField(
  731. required=False,
  732. label='Console Server',
  733. widget=Livesearch(
  734. query_key='q',
  735. query_url='dcim-api:device_list',
  736. field_to_update='console_server',
  737. )
  738. )
  739. cs_port = forms.ModelChoiceField(
  740. queryset=ConsoleServerPort.objects.all(),
  741. label='Port',
  742. widget=APISelect(
  743. api_url='/api/dcim/devices/{{console_server}}/console-server-ports/',
  744. disabled_indicator='connected_console',
  745. )
  746. )
  747. class Meta:
  748. model = ConsolePort
  749. fields = ['site', 'rack', 'console_server', 'livesearch', 'cs_port', 'connection_status']
  750. labels = {
  751. 'cs_port': 'Port',
  752. 'connection_status': 'Status',
  753. }
  754. def __init__(self, *args, **kwargs):
  755. super(ConsolePortConnectionForm, self).__init__(*args, **kwargs)
  756. if not self.instance.pk:
  757. raise RuntimeError("ConsolePortConnectionForm must be initialized with an existing ConsolePort instance.")
  758. # Initialize rack choices if site is set
  759. if self.initial.get('site'):
  760. self.fields['rack'].queryset = Rack.objects.filter(site=self.initial['site'])
  761. else:
  762. self.fields['rack'].choices = []
  763. # Initialize console_server choices if rack or site is set
  764. if self.initial.get('rack'):
  765. self.fields['console_server'].queryset = Device.objects.filter(
  766. rack=self.initial['rack'], device_type__is_console_server=True
  767. )
  768. elif self.initial.get('site'):
  769. self.fields['console_server'].queryset = Device.objects.filter(
  770. site=self.initial['site'], rack__isnull=True, device_type__is_console_server=True
  771. )
  772. else:
  773. self.fields['console_server'].choices = []
  774. # Initialize CS port choices if console_server is set
  775. if self.initial.get('console_server'):
  776. self.fields['cs_port'].queryset = ConsoleServerPort.objects.filter(
  777. device=self.initial['console_server']
  778. )
  779. else:
  780. self.fields['cs_port'].choices = []
  781. #
  782. # Console server ports
  783. #
  784. class ConsoleServerPortForm(BootstrapMixin, forms.ModelForm):
  785. class Meta:
  786. model = ConsoleServerPort
  787. fields = ['device', 'name']
  788. widgets = {
  789. 'device': forms.HiddenInput(),
  790. }
  791. class ConsoleServerPortCreateForm(DeviceComponentForm):
  792. name_pattern = ExpandableNameField(label='Name')
  793. class ConsoleServerPortConnectionForm(BootstrapMixin, forms.Form):
  794. site = forms.ModelChoiceField(
  795. queryset=Site.objects.all(),
  796. widget=forms.HiddenInput(),
  797. )
  798. rack = forms.ModelChoiceField(
  799. queryset=Rack.objects.all(),
  800. label='Rack',
  801. required=False,
  802. widget=forms.Select(
  803. attrs={'filter-for': 'device', 'nullable': 'true'}
  804. )
  805. )
  806. device = forms.ModelChoiceField(
  807. queryset=Device.objects.all(),
  808. label='Device',
  809. required=False,
  810. widget=APISelect(
  811. api_url='/api/dcim/devices/?site_id={{site}}&rack_id={{rack}}',
  812. display_field='display_name',
  813. attrs={'filter-for': 'port'}
  814. )
  815. )
  816. livesearch = forms.CharField(
  817. required=False,
  818. label='Device',
  819. widget=Livesearch(
  820. query_key='q',
  821. query_url='dcim-api:device_list',
  822. field_to_update='device'
  823. )
  824. )
  825. port = forms.ModelChoiceField(
  826. queryset=ConsolePort.objects.all(),
  827. label='Port',
  828. widget=APISelect(
  829. api_url='/api/dcim/devices/{{device}}/console-ports/',
  830. disabled_indicator='cs_port'
  831. )
  832. )
  833. connection_status = forms.BooleanField(
  834. required=False,
  835. initial=CONNECTION_STATUS_CONNECTED,
  836. label='Status',
  837. widget=forms.Select(
  838. choices=CONNECTION_STATUS_CHOICES
  839. )
  840. )
  841. class Meta:
  842. fields = ['site', 'rack', 'device', 'livesearch', 'port', 'connection_status']
  843. labels = {
  844. 'connection_status': 'Status',
  845. }
  846. def __init__(self, *args, **kwargs):
  847. super(ConsoleServerPortConnectionForm, self).__init__(*args, **kwargs)
  848. # Initialize rack choices if site is set
  849. if self.initial.get('site'):
  850. self.fields['rack'].queryset = Rack.objects.filter(site=self.initial['site'])
  851. else:
  852. self.fields['rack'].choices = []
  853. # Initialize device choices if rack or site is set
  854. if self.initial.get('rack'):
  855. self.fields['device'].queryset = Device.objects.filter(rack=self.initial['rack'])
  856. elif self.initial.get('site'):
  857. self.fields['device'].queryset = Device.objects.filter(site=self.initial['site'], rack__isnull=True)
  858. else:
  859. self.fields['device'].choices = []
  860. # Initialize port choices if device is set
  861. if self.initial.get('device'):
  862. self.fields['port'].queryset = ConsolePort.objects.filter(device=self.initial['device'])
  863. else:
  864. self.fields['port'].choices = []
  865. #
  866. # Power ports
  867. #
  868. class PowerPortForm(BootstrapMixin, forms.ModelForm):
  869. class Meta:
  870. model = PowerPort
  871. fields = ['device', 'name']
  872. widgets = {
  873. 'device': forms.HiddenInput(),
  874. }
  875. class PowerPortCreateForm(DeviceComponentForm):
  876. name_pattern = ExpandableNameField(label='Name')
  877. class PowerConnectionCSVForm(forms.Form):
  878. pdu = FlexibleModelChoiceField(
  879. queryset=Device.objects.filter(device_type__is_pdu=True),
  880. to_field_name='name',
  881. error_messages={
  882. 'invalid_choice': 'PDU not found.',
  883. }
  884. )
  885. power_outlet = forms.CharField()
  886. device = FlexibleModelChoiceField(queryset=Device.objects.all(), to_field_name='name',
  887. error_messages={'invalid_choice': 'Device not found'})
  888. power_port = forms.CharField()
  889. status = forms.CharField(validators=[validate_connection_status])
  890. def clean(self):
  891. # Validate power outlet
  892. if self.cleaned_data.get('pdu'):
  893. try:
  894. power_outlet = PowerOutlet.objects.get(device=self.cleaned_data['pdu'],
  895. name=self.cleaned_data['power_outlet'])
  896. if PowerPort.objects.filter(power_outlet=power_outlet):
  897. raise forms.ValidationError("Power outlet is already occupied (by {} {})"
  898. .format(power_outlet.connected_port.device,
  899. power_outlet.connected_port))
  900. except PowerOutlet.DoesNotExist:
  901. raise forms.ValidationError("Invalid PDU port ({} {})"
  902. .format(self.cleaned_data['pdu'], self.cleaned_data['power_outlet']))
  903. # Validate power port
  904. if self.cleaned_data.get('device'):
  905. try:
  906. power_port = PowerPort.objects.get(device=self.cleaned_data['device'],
  907. name=self.cleaned_data['power_port'])
  908. if power_port.power_outlet:
  909. raise forms.ValidationError("Power port is already connected (to {} {})"
  910. .format(power_port.power_outlet.device, power_port.power_outlet))
  911. except PowerPort.DoesNotExist:
  912. raise forms.ValidationError("Invalid power port ({} {})"
  913. .format(self.cleaned_data['device'], self.cleaned_data['power_port']))
  914. class PowerConnectionImportForm(BootstrapMixin, BulkImportForm):
  915. csv = CSVDataField(csv_form=PowerConnectionCSVForm)
  916. def clean(self):
  917. records = self.cleaned_data.get('csv')
  918. if not records:
  919. return
  920. connection_list = []
  921. for i, record in enumerate(records, start=1):
  922. form = self.fields['csv'].csv_form(data=record)
  923. if form.is_valid():
  924. power_port = PowerPort.objects.get(device=form.cleaned_data['device'],
  925. name=form.cleaned_data['power_port'])
  926. power_port.power_outlet = PowerOutlet.objects.get(device=form.cleaned_data['pdu'],
  927. name=form.cleaned_data['power_outlet'])
  928. if form.cleaned_data['status'] == 'planned':
  929. power_port.connection_status = CONNECTION_STATUS_PLANNED
  930. else:
  931. power_port.connection_status = CONNECTION_STATUS_CONNECTED
  932. connection_list.append(power_port)
  933. else:
  934. for field, errors in form.errors.items():
  935. for e in errors:
  936. self.add_error('csv', "Record {} {}: {}".format(i, field, e))
  937. self.cleaned_data['csv'] = connection_list
  938. class PowerPortConnectionForm(BootstrapMixin, forms.ModelForm):
  939. site = forms.ModelChoiceField(queryset=Site.objects.all(), widget=forms.HiddenInput())
  940. rack = forms.ModelChoiceField(
  941. queryset=Rack.objects.all(),
  942. label='Rack',
  943. required=False,
  944. widget=forms.Select(
  945. attrs={'filter-for': 'pdu', 'nullable': 'true'}
  946. )
  947. )
  948. pdu = forms.ModelChoiceField(
  949. queryset=Device.objects.all(),
  950. label='PDU',
  951. required=False,
  952. widget=APISelect(
  953. api_url='/api/dcim/devices/?site_id={{site}}&rack_id={{rack}}&is_pdu=True',
  954. display_field='display_name',
  955. attrs={'filter-for': 'power_outlet'}
  956. )
  957. )
  958. livesearch = forms.CharField(
  959. required=False,
  960. label='PDU',
  961. widget=Livesearch(
  962. query_key='q',
  963. query_url='dcim-api:device_list',
  964. field_to_update='pdu'
  965. )
  966. )
  967. power_outlet = forms.ModelChoiceField(
  968. queryset=PowerOutlet.objects.all(),
  969. label='Outlet',
  970. widget=APISelect(
  971. api_url='/api/dcim/devices/{{pdu}}/power-outlets/',
  972. disabled_indicator='connected_port'
  973. )
  974. )
  975. class Meta:
  976. model = PowerPort
  977. fields = ['site', 'rack', 'pdu', 'livesearch', 'power_outlet', 'connection_status']
  978. labels = {
  979. 'power_outlet': 'Outlet',
  980. 'connection_status': 'Status',
  981. }
  982. def __init__(self, *args, **kwargs):
  983. super(PowerPortConnectionForm, self).__init__(*args, **kwargs)
  984. if not self.instance.pk:
  985. raise RuntimeError("PowerPortConnectionForm must be initialized with an existing PowerPort instance.")
  986. # Initialize rack choices if site is set
  987. if self.initial.get('site'):
  988. self.fields['rack'].queryset = Rack.objects.filter(site=self.initial['site'])
  989. else:
  990. self.fields['rack'].choices = []
  991. # Initialize pdu choices if rack or site is set
  992. if self.initial.get('rack'):
  993. self.fields['pdu'].queryset = Device.objects.filter(
  994. rack=self.initial['rack'], device_type__is_pdu=True
  995. )
  996. elif self.initial.get('site'):
  997. self.fields['pdu'].queryset = Device.objects.filter(
  998. site=self.initial['site'], rack__isnull=True, device_type__is_pdu=True
  999. )
  1000. else:
  1001. self.fields['pdu'].choices = []
  1002. # Initialize power outlet choices if pdu is set
  1003. if self.initial.get('pdu'):
  1004. self.fields['power_outlet'].queryset = PowerOutlet.objects.filter(device=self.initial['pdu'])
  1005. else:
  1006. self.fields['power_outlet'].choices = []
  1007. #
  1008. # Power outlets
  1009. #
  1010. class PowerOutletForm(BootstrapMixin, forms.ModelForm):
  1011. class Meta:
  1012. model = PowerOutlet
  1013. fields = ['device', 'name']
  1014. widgets = {
  1015. 'device': forms.HiddenInput(),
  1016. }
  1017. class PowerOutletCreateForm(DeviceComponentForm):
  1018. name_pattern = ExpandableNameField(label='Name')
  1019. class PowerOutletConnectionForm(BootstrapMixin, forms.Form):
  1020. site = forms.ModelChoiceField(
  1021. queryset=Site.objects.all(),
  1022. widget=forms.HiddenInput()
  1023. )
  1024. rack = forms.ModelChoiceField(
  1025. queryset=Rack.objects.all(),
  1026. label='Rack',
  1027. required=False,
  1028. widget=forms.Select(
  1029. attrs={'filter-for': 'device', 'nullable': 'true'}
  1030. )
  1031. )
  1032. device = forms.ModelChoiceField(
  1033. queryset=Device.objects.all(),
  1034. label='Device',
  1035. required=False,
  1036. widget=APISelect(
  1037. api_url='/api/dcim/devices/?site_id={{site}}&rack_id={{rack}}',
  1038. display_field='display_name',
  1039. attrs={'filter-for': 'port'}
  1040. )
  1041. )
  1042. livesearch = forms.CharField(
  1043. required=False,
  1044. label='Device',
  1045. widget=Livesearch(
  1046. query_key='q',
  1047. query_url='dcim-api:device_list',
  1048. field_to_update='device'
  1049. )
  1050. )
  1051. port = forms.ModelChoiceField(
  1052. queryset=PowerPort.objects.all(),
  1053. label='Port',
  1054. widget=APISelect(
  1055. api_url='/api/dcim/devices/{{device}}/power-ports/',
  1056. disabled_indicator='power_outlet'
  1057. )
  1058. )
  1059. connection_status = forms.BooleanField(
  1060. required=False,
  1061. initial=CONNECTION_STATUS_CONNECTED,
  1062. label='Status',
  1063. widget=forms.Select(
  1064. choices=CONNECTION_STATUS_CHOICES
  1065. )
  1066. )
  1067. class Meta:
  1068. fields = ['site', 'rack', 'device', 'livesearch', 'port', 'connection_status']
  1069. labels = {
  1070. 'connection_status': 'Status',
  1071. }
  1072. def __init__(self, *args, **kwargs):
  1073. super(PowerOutletConnectionForm, self).__init__(*args, **kwargs)
  1074. # Initialize rack choices if site is set
  1075. if self.initial.get('site'):
  1076. self.fields['rack'].queryset = Rack.objects.filter(site=self.initial['site'])
  1077. else:
  1078. self.fields['rack'].choices = []
  1079. # Initialize device choices if rack or site is set
  1080. if self.initial.get('rack'):
  1081. self.fields['device'].queryset = Device.objects.filter(rack=self.initial['rack'])
  1082. elif self.initial.get('site'):
  1083. self.fields['device'].queryset = Device.objects.filter(site=self.initial['site'], rack__isnull=True)
  1084. else:
  1085. self.fields['device'].choices = []
  1086. # Initialize port choices if device is set
  1087. if self.initial.get('device'):
  1088. self.fields['port'].queryset = PowerPort.objects.filter(device=self.initial['device'])
  1089. else:
  1090. self.fields['port'].choices = []
  1091. #
  1092. # Interfaces
  1093. #
  1094. class InterfaceForm(BootstrapMixin, forms.ModelForm):
  1095. class Meta:
  1096. model = Interface
  1097. fields = ['device', 'name', 'form_factor', 'lag', 'mac_address', 'mgmt_only', 'description']
  1098. widgets = {
  1099. 'device': forms.HiddenInput(),
  1100. }
  1101. def __init__(self, *args, **kwargs):
  1102. super(InterfaceForm, self).__init__(*args, **kwargs)
  1103. # Limit LAG choices to interfaces belonging to this device
  1104. if self.is_bound:
  1105. self.fields['lag'].queryset = Interface.objects.order_naturally().filter(
  1106. device_id=self.data['device'], form_factor=IFACE_FF_LAG
  1107. )
  1108. else:
  1109. self.fields['lag'].queryset = Interface.objects.order_naturally().filter(
  1110. device=self.instance.device, form_factor=IFACE_FF_LAG
  1111. )
  1112. class InterfaceCreateForm(DeviceComponentForm):
  1113. name_pattern = ExpandableNameField(label='Name')
  1114. form_factor = forms.ChoiceField(choices=IFACE_FF_CHOICES)
  1115. lag = forms.ModelChoiceField(queryset=Interface.objects.all(), required=False, label='Parent LAG')
  1116. mac_address = MACAddressFormField(required=False, label='MAC Address')
  1117. mgmt_only = forms.BooleanField(required=False, label='OOB Management')
  1118. description = forms.CharField(max_length=100, required=False)
  1119. def __init__(self, *args, **kwargs):
  1120. super(InterfaceCreateForm, self).__init__(*args, **kwargs)
  1121. # Limit LAG choices to interfaces belonging to this device
  1122. if self.device is not None:
  1123. self.fields['lag'].queryset = Interface.objects.order_naturally().filter(
  1124. device=self.device, form_factor=IFACE_FF_LAG
  1125. )
  1126. else:
  1127. self.fields['lag'].queryset = Interface.objects.none()
  1128. class InterfaceBulkEditForm(BootstrapMixin, BulkEditForm):
  1129. pk = forms.ModelMultipleChoiceField(queryset=Interface.objects.all(), widget=forms.MultipleHiddenInput)
  1130. device = forms.ModelChoiceField(queryset=Device.objects.all(), widget=forms.HiddenInput)
  1131. lag = forms.ModelChoiceField(queryset=Interface.objects.all(), required=False, label='Parent LAG')
  1132. form_factor = forms.ChoiceField(choices=add_blank_choice(IFACE_FF_CHOICES), required=False)
  1133. description = forms.CharField(max_length=100, required=False)
  1134. class Meta:
  1135. nullable_fields = ['lag', 'description']
  1136. def __init__(self, *args, **kwargs):
  1137. super(InterfaceBulkEditForm, self).__init__(*args, **kwargs)
  1138. # Limit LAG choices to interfaces which belong to the parent device.
  1139. if self.initial.get('device'):
  1140. self.fields['lag'].queryset = Interface.objects.filter(
  1141. device=self.initial['device'], form_factor=IFACE_FF_LAG
  1142. )
  1143. else:
  1144. self.fields['lag'].choices = []
  1145. #
  1146. # Interface connections
  1147. #
  1148. class InterfaceConnectionForm(BootstrapMixin, forms.ModelForm):
  1149. interface_a = forms.ChoiceField(
  1150. choices=[],
  1151. widget=SelectWithDisabled,
  1152. label='Interface'
  1153. )
  1154. site_b = forms.ModelChoiceField(
  1155. queryset=Site.objects.all(),
  1156. label='Site',
  1157. required=False,
  1158. widget=forms.Select(
  1159. attrs={'filter-for': 'rack_b'}
  1160. )
  1161. )
  1162. rack_b = forms.ModelChoiceField(
  1163. queryset=Rack.objects.all(),
  1164. label='Rack',
  1165. required=False,
  1166. widget=APISelect(
  1167. api_url='/api/dcim/racks/?site_id={{site_b}}',
  1168. attrs={'filter-for': 'device_b', 'nullable': 'true'}
  1169. )
  1170. )
  1171. device_b = forms.ModelChoiceField(
  1172. queryset=Device.objects.all(),
  1173. label='Device',
  1174. required=False,
  1175. widget=APISelect(
  1176. api_url='/api/dcim/devices/?site_id={{site_b}}&rack_id={{rack_b}}',
  1177. display_field='display_name',
  1178. attrs={'filter-for': 'interface_b'}
  1179. )
  1180. )
  1181. livesearch = forms.CharField(
  1182. required=False,
  1183. label='Device',
  1184. widget=Livesearch(
  1185. query_key='q',
  1186. query_url='dcim-api:device_list',
  1187. field_to_update='device_b'
  1188. )
  1189. )
  1190. interface_b = forms.ModelChoiceField(
  1191. queryset=Interface.objects.all(),
  1192. label='Interface',
  1193. widget=APISelect(
  1194. api_url='/api/dcim/devices/{{device_b}}/interfaces/?type=physical',
  1195. disabled_indicator='is_connected'
  1196. )
  1197. )
  1198. class Meta:
  1199. model = InterfaceConnection
  1200. fields = ['interface_a', 'site_b', 'rack_b', 'device_b', 'interface_b', 'livesearch', 'connection_status']
  1201. def __init__(self, device_a, *args, **kwargs):
  1202. super(InterfaceConnectionForm, self).__init__(*args, **kwargs)
  1203. # Initialize interface A choices
  1204. device_a_interfaces = Interface.objects.filter(device=device_a).exclude(
  1205. form_factor__in=VIRTUAL_IFACE_TYPES
  1206. ).select_related(
  1207. 'circuit_termination', 'connected_as_a', 'connected_as_b'
  1208. )
  1209. self.fields['interface_a'].choices = [
  1210. (iface.id, {'label': iface.name, 'disabled': iface.is_connected}) for iface in device_a_interfaces
  1211. ]
  1212. # Initialize rack_b choices if site_b is set
  1213. if self.initial.get('site_b'):
  1214. self.fields['rack_b'].queryset = Rack.objects.filter(site=self.initial['site_b'])
  1215. else:
  1216. self.fields['rack_b'].choices = []
  1217. # Initialize device_b choices if rack_b or site_b is set
  1218. if self.initial.get('rack_b'):
  1219. self.fields['device_b'].queryset = Device.objects.filter(rack=self.initial['rack_b'])
  1220. elif self.initial.get('site_b'):
  1221. self.fields['device_b'].queryset = Device.objects.filter(site=self.initial['site_b'], rack__isnull=True)
  1222. else:
  1223. self.fields['device_b'].choices = []
  1224. # Initialize interface_b choices if device_b is set
  1225. if self.initial.get('device_b'):
  1226. device_b_interfaces = Interface.objects.filter(device=self.initial['device_b']).exclude(
  1227. form_factor__in=VIRTUAL_IFACE_TYPES
  1228. ).select_related(
  1229. 'circuit_termination', 'connected_as_a', 'connected_as_b'
  1230. )
  1231. else:
  1232. device_b_interfaces = []
  1233. self.fields['interface_b'].choices = [
  1234. (iface.id, {'label': iface.name, 'disabled': iface.is_connected}) for iface in device_b_interfaces
  1235. ]
  1236. class InterfaceConnectionCSVForm(forms.Form):
  1237. device_a = FlexibleModelChoiceField(
  1238. queryset=Device.objects.all(),
  1239. to_field_name='name',
  1240. error_messages={'invalid_choice': 'Device A not found.'}
  1241. )
  1242. interface_a = forms.CharField()
  1243. device_b = FlexibleModelChoiceField(
  1244. queryset=Device.objects.all(),
  1245. to_field_name='name',
  1246. error_messages={'invalid_choice': 'Device B not found.'}
  1247. )
  1248. interface_b = forms.CharField()
  1249. status = forms.CharField(
  1250. validators=[validate_connection_status]
  1251. )
  1252. def clean(self):
  1253. # Validate interface A
  1254. if self.cleaned_data.get('device_a'):
  1255. try:
  1256. interface_a = Interface.objects.get(device=self.cleaned_data['device_a'],
  1257. name=self.cleaned_data['interface_a'])
  1258. except Interface.DoesNotExist:
  1259. raise forms.ValidationError("Invalid interface ({} {})"
  1260. .format(self.cleaned_data['device_a'], self.cleaned_data['interface_a']))
  1261. try:
  1262. InterfaceConnection.objects.get(Q(interface_a=interface_a) | Q(interface_b=interface_a))
  1263. raise forms.ValidationError("{} {} is already connected"
  1264. .format(self.cleaned_data['device_a'], self.cleaned_data['interface_a']))
  1265. except InterfaceConnection.DoesNotExist:
  1266. pass
  1267. # Validate interface B
  1268. if self.cleaned_data.get('device_b'):
  1269. try:
  1270. interface_b = Interface.objects.get(device=self.cleaned_data['device_b'],
  1271. name=self.cleaned_data['interface_b'])
  1272. except Interface.DoesNotExist:
  1273. raise forms.ValidationError("Invalid interface ({} {})"
  1274. .format(self.cleaned_data['device_b'], self.cleaned_data['interface_b']))
  1275. try:
  1276. InterfaceConnection.objects.get(Q(interface_a=interface_b) | Q(interface_b=interface_b))
  1277. raise forms.ValidationError("{} {} is already connected"
  1278. .format(self.cleaned_data['device_b'], self.cleaned_data['interface_b']))
  1279. except InterfaceConnection.DoesNotExist:
  1280. pass
  1281. class InterfaceConnectionImportForm(BootstrapMixin, BulkImportForm):
  1282. csv = CSVDataField(csv_form=InterfaceConnectionCSVForm)
  1283. def clean(self):
  1284. records = self.cleaned_data.get('csv')
  1285. if not records:
  1286. return
  1287. connection_list = []
  1288. occupied_interfaces = []
  1289. for i, record in enumerate(records, start=1):
  1290. form = self.fields['csv'].csv_form(data=record)
  1291. if form.is_valid():
  1292. interface_a = Interface.objects.get(device=form.cleaned_data['device_a'],
  1293. name=form.cleaned_data['interface_a'])
  1294. if interface_a in occupied_interfaces:
  1295. raise forms.ValidationError("{} {} found in multiple connections"
  1296. .format(interface_a.device.name, interface_a.name))
  1297. interface_b = Interface.objects.get(device=form.cleaned_data['device_b'],
  1298. name=form.cleaned_data['interface_b'])
  1299. if interface_b in occupied_interfaces:
  1300. raise forms.ValidationError("{} {} found in multiple connections"
  1301. .format(interface_b.device.name, interface_b.name))
  1302. connection = InterfaceConnection(interface_a=interface_a, interface_b=interface_b)
  1303. if form.cleaned_data['status'] == 'planned':
  1304. connection.connection_status = CONNECTION_STATUS_PLANNED
  1305. else:
  1306. connection.connection_status = CONNECTION_STATUS_CONNECTED
  1307. connection_list.append(connection)
  1308. occupied_interfaces.append(interface_a)
  1309. occupied_interfaces.append(interface_b)
  1310. else:
  1311. for field, errors in form.errors.items():
  1312. for e in errors:
  1313. self.add_error('csv', "Record {} {}: {}".format(i, field, e))
  1314. self.cleaned_data['csv'] = connection_list
  1315. class InterfaceConnectionDeletionForm(BootstrapMixin, forms.Form):
  1316. confirm = forms.BooleanField(required=True)
  1317. # Used for HTTP redirect upon successful deletion
  1318. device = forms.ModelChoiceField(queryset=Device.objects.all(), widget=forms.HiddenInput(), required=False)
  1319. #
  1320. # Device bays
  1321. #
  1322. class DeviceBayForm(BootstrapMixin, forms.ModelForm):
  1323. class Meta:
  1324. model = DeviceBay
  1325. fields = ['device', 'name']
  1326. widgets = {
  1327. 'device': forms.HiddenInput(),
  1328. }
  1329. class DeviceBayCreateForm(DeviceComponentForm):
  1330. name_pattern = ExpandableNameField(label='Name')
  1331. class PopulateDeviceBayForm(BootstrapMixin, forms.Form):
  1332. installed_device = forms.ModelChoiceField(
  1333. queryset=Device.objects.all(),
  1334. label='Child Device',
  1335. help_text="Child devices must first be created and assigned to the site/rack of the parent device."
  1336. )
  1337. def __init__(self, device_bay, *args, **kwargs):
  1338. super(PopulateDeviceBayForm, self).__init__(*args, **kwargs)
  1339. self.fields['installed_device'].queryset = Device.objects.filter(
  1340. site=device_bay.device.site,
  1341. rack=device_bay.device.rack,
  1342. parent_bay__isnull=True,
  1343. device_type__u_height=0,
  1344. device_type__subdevice_role=SUBDEVICE_ROLE_CHILD
  1345. ).exclude(pk=device_bay.device.pk)
  1346. #
  1347. # Connections
  1348. #
  1349. class ConsoleConnectionFilterForm(BootstrapMixin, forms.Form):
  1350. site = forms.ModelChoiceField(required=False, queryset=Site.objects.all(), to_field_name='slug')
  1351. device = forms.CharField(required=False, label='Device name')
  1352. class PowerConnectionFilterForm(BootstrapMixin, forms.Form):
  1353. site = forms.ModelChoiceField(required=False, queryset=Site.objects.all(), to_field_name='slug')
  1354. device = forms.CharField(required=False, label='Device name')
  1355. class InterfaceConnectionFilterForm(BootstrapMixin, forms.Form):
  1356. site = forms.ModelChoiceField(required=False, queryset=Site.objects.all(), to_field_name='slug')
  1357. device = forms.CharField(required=False, label='Device name')
  1358. #
  1359. # IP addresses
  1360. #
  1361. class IPAddressForm(BootstrapMixin, CustomFieldForm):
  1362. set_as_primary = forms.BooleanField(label='Set as primary IP for device', required=False)
  1363. class Meta:
  1364. model = IPAddress
  1365. fields = ['address', 'vrf', 'tenant', 'status', 'interface', 'description']
  1366. def __init__(self, device, *args, **kwargs):
  1367. super(IPAddressForm, self).__init__(*args, **kwargs)
  1368. self.fields['vrf'].empty_label = 'Global'
  1369. interfaces = device.interfaces.all()
  1370. self.fields['interface'].queryset = interfaces
  1371. self.fields['interface'].required = True
  1372. # If this device has only one interface, select it by default.
  1373. if len(interfaces) == 1:
  1374. self.fields['interface'].initial = interfaces[0]
  1375. # If this device does not have any IP addresses assigned, default to setting the first IP as its primary.
  1376. if not IPAddress.objects.filter(interface__device=device).count():
  1377. self.fields['set_as_primary'].initial = True
  1378. #
  1379. # Modules
  1380. #
  1381. class ModuleForm(BootstrapMixin, forms.ModelForm):
  1382. class Meta:
  1383. model = Module
  1384. fields = ['name', 'manufacturer', 'part_id', 'serial']