forms.py 58 KB

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