forms.py 58 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637
  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 = forms.CharField()
  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(self):
  551. status_choices = {s[1].lower(): s[0] for s in STATUS_CHOICES}
  552. try:
  553. return status_choices[self.cleaned_data['status'].lower()]
  554. except KeyError:
  555. raise ValidationError("Invalid status: {}".format(self.cleaned_data['status']))
  556. class DeviceFromCSVForm(BaseDeviceFromCSVForm):
  557. site = forms.ModelChoiceField(
  558. queryset=Site.objects.all(), to_field_name='name', error_messages={
  559. 'invalid_choice': 'Invalid site name.',
  560. }
  561. )
  562. rack_name = forms.CharField(required=False)
  563. face = forms.CharField(required=False)
  564. class Meta(BaseDeviceFromCSVForm.Meta):
  565. fields = [
  566. 'name', 'device_role', 'tenant', 'manufacturer', 'model_name', 'platform', 'serial', 'asset_tag', 'status',
  567. 'site', 'rack_name', 'position', 'face',
  568. ]
  569. def clean(self):
  570. super(DeviceFromCSVForm, self).clean()
  571. site = self.cleaned_data.get('site')
  572. rack_name = self.cleaned_data.get('rack_name')
  573. # Validate rack
  574. if site and rack_name:
  575. try:
  576. self.instance.rack = Rack.objects.get(site=site, name=rack_name)
  577. except Rack.DoesNotExist:
  578. self.add_error('rack_name', "Invalid rack ({})".format(rack_name))
  579. def clean_face(self):
  580. face = self.cleaned_data['face']
  581. if not face:
  582. return None
  583. try:
  584. return {
  585. 'front': 0,
  586. 'rear': 1,
  587. }[face.lower()]
  588. except KeyError:
  589. raise forms.ValidationError('Invalid rack face ({}); must be "front" or "rear".'.format(face))
  590. class ChildDeviceFromCSVForm(BaseDeviceFromCSVForm):
  591. parent = FlexibleModelChoiceField(
  592. queryset=Device.objects.all(),
  593. to_field_name='name',
  594. required=False,
  595. error_messages={
  596. 'invalid_choice': 'Parent device not found.'
  597. }
  598. )
  599. device_bay_name = forms.CharField(required=False)
  600. class Meta(BaseDeviceFromCSVForm.Meta):
  601. fields = [
  602. 'name', 'device_role', 'tenant', 'manufacturer', 'model_name', 'platform', 'serial', 'asset_tag', 'status',
  603. 'parent', 'device_bay_name',
  604. ]
  605. def clean(self):
  606. super(ChildDeviceFromCSVForm, self).clean()
  607. parent = self.cleaned_data.get('parent')
  608. device_bay_name = self.cleaned_data.get('device_bay_name')
  609. # Validate device bay
  610. if parent and device_bay_name:
  611. try:
  612. device_bay = DeviceBay.objects.get(device=parent, name=device_bay_name)
  613. if device_bay.installed_device:
  614. self.add_error('device_bay_name',
  615. "Device bay ({} {}) is already occupied".format(parent, device_bay_name))
  616. else:
  617. self.instance.parent_bay = device_bay
  618. except DeviceBay.DoesNotExist:
  619. self.add_error('device_bay_name', "Parent device/bay ({} {}) not found".format(parent, device_bay_name))
  620. class DeviceImportForm(BootstrapMixin, BulkImportForm):
  621. csv = CSVDataField(csv_form=DeviceFromCSVForm)
  622. class ChildDeviceImportForm(BootstrapMixin, BulkImportForm):
  623. csv = CSVDataField(csv_form=ChildDeviceFromCSVForm)
  624. class DeviceBulkEditForm(BootstrapMixin, CustomFieldBulkEditForm):
  625. pk = forms.ModelMultipleChoiceField(queryset=Device.objects.all(), widget=forms.MultipleHiddenInput)
  626. device_type = forms.ModelChoiceField(queryset=DeviceType.objects.all(), required=False, label='Type')
  627. device_role = forms.ModelChoiceField(queryset=DeviceRole.objects.all(), required=False, label='Role')
  628. tenant = forms.ModelChoiceField(queryset=Tenant.objects.all(), required=False)
  629. platform = forms.ModelChoiceField(queryset=Platform.objects.all(), required=False)
  630. status = forms.ChoiceField(choices=FORM_STATUS_CHOICES, required=False, initial='', label='Status')
  631. serial = forms.CharField(max_length=50, required=False, label='Serial Number')
  632. class Meta:
  633. nullable_fields = ['tenant', 'platform']
  634. def device_status_choices():
  635. status_counts = {}
  636. for status in Device.objects.values('status').annotate(count=Count('status')).order_by('status'):
  637. status_counts[status['status']] = status['count']
  638. return [(s[0], u'{} ({})'.format(s[1], status_counts.get(s[0], 0))) for s in STATUS_CHOICES]
  639. class DeviceFilterForm(BootstrapMixin, CustomFieldFilterForm):
  640. model = Device
  641. q = forms.CharField(required=False, label='Search')
  642. site = FilterChoiceField(
  643. queryset=Site.objects.annotate(filter_count=Count('devices')),
  644. to_field_name='slug',
  645. )
  646. rack_group_id = FilterChoiceField(
  647. queryset=RackGroup.objects.select_related('site').annotate(filter_count=Count('racks__devices')),
  648. label='Rack group',
  649. )
  650. rack_id = FilterChoiceField(
  651. queryset=Rack.objects.annotate(filter_count=Count('devices')),
  652. label='Rack',
  653. )
  654. role = FilterChoiceField(
  655. queryset=DeviceRole.objects.annotate(filter_count=Count('devices')),
  656. to_field_name='slug',
  657. )
  658. tenant = FilterChoiceField(
  659. queryset=Tenant.objects.annotate(filter_count=Count('devices')), to_field_name='slug',
  660. null_option=(0, 'None'),
  661. )
  662. manufacturer_id = FilterChoiceField(queryset=Manufacturer.objects.all(), label='Manufacturer')
  663. device_type_id = FilterChoiceField(
  664. queryset=DeviceType.objects.select_related('manufacturer').order_by('model').annotate(
  665. filter_count=Count('instances'),
  666. ),
  667. label='Model',
  668. )
  669. platform = FilterChoiceField(
  670. queryset=Platform.objects.annotate(filter_count=Count('devices')),
  671. to_field_name='slug',
  672. null_option=(0, 'None'),
  673. )
  674. status = forms.MultipleChoiceField(choices=device_status_choices, required=False)
  675. mac_address = forms.CharField(required=False, label='MAC address')
  676. #
  677. # Bulk device component creation
  678. #
  679. class DeviceBulkAddComponentForm(BootstrapMixin, forms.Form):
  680. pk = forms.ModelMultipleChoiceField(queryset=Device.objects.all(), widget=forms.MultipleHiddenInput)
  681. name_pattern = ExpandableNameField(label='Name')
  682. class DeviceBulkAddInterfaceForm(forms.ModelForm, DeviceBulkAddComponentForm):
  683. class Meta:
  684. model = Interface
  685. fields = ['pk', 'name_pattern', 'form_factor', 'mgmt_only', 'description']
  686. #
  687. # Console ports
  688. #
  689. class ConsolePortForm(BootstrapMixin, forms.ModelForm):
  690. class Meta:
  691. model = ConsolePort
  692. fields = ['device', 'name']
  693. widgets = {
  694. 'device': forms.HiddenInput(),
  695. }
  696. class ConsolePortCreateForm(DeviceComponentForm):
  697. name_pattern = ExpandableNameField(label='Name')
  698. class ConsoleConnectionCSVForm(forms.Form):
  699. console_server = FlexibleModelChoiceField(
  700. queryset=Device.objects.filter(device_type__is_console_server=True),
  701. to_field_name='name',
  702. error_messages={
  703. 'invalid_choice': 'Console server not found',
  704. }
  705. )
  706. cs_port = forms.CharField()
  707. device = FlexibleModelChoiceField(queryset=Device.objects.all(), to_field_name='name',
  708. error_messages={'invalid_choice': 'Device not found'})
  709. console_port = forms.CharField()
  710. status = forms.CharField(validators=[validate_connection_status])
  711. def clean(self):
  712. # Validate console server port
  713. if self.cleaned_data.get('console_server'):
  714. try:
  715. cs_port = ConsoleServerPort.objects.get(device=self.cleaned_data['console_server'],
  716. name=self.cleaned_data['cs_port'])
  717. if ConsolePort.objects.filter(cs_port=cs_port):
  718. raise forms.ValidationError("Console server port is already occupied (by {} {})"
  719. .format(cs_port.connected_console.device, cs_port.connected_console))
  720. except ConsoleServerPort.DoesNotExist:
  721. raise forms.ValidationError("Invalid console server port ({} {})"
  722. .format(self.cleaned_data['console_server'], self.cleaned_data['cs_port']))
  723. # Validate console port
  724. if self.cleaned_data.get('device'):
  725. try:
  726. console_port = ConsolePort.objects.get(device=self.cleaned_data['device'],
  727. name=self.cleaned_data['console_port'])
  728. if console_port.cs_port:
  729. raise forms.ValidationError("Console port is already connected (to {} {})"
  730. .format(console_port.cs_port.device, console_port.cs_port))
  731. except ConsolePort.DoesNotExist:
  732. raise forms.ValidationError("Invalid console port ({} {})"
  733. .format(self.cleaned_data['device'], self.cleaned_data['console_port']))
  734. class ConsoleConnectionImportForm(BootstrapMixin, BulkImportForm):
  735. csv = CSVDataField(csv_form=ConsoleConnectionCSVForm)
  736. def clean(self):
  737. records = self.cleaned_data.get('csv')
  738. if not records:
  739. return
  740. connection_list = []
  741. for i, record in enumerate(records, start=1):
  742. form = self.fields['csv'].csv_form(data=record)
  743. if form.is_valid():
  744. console_port = ConsolePort.objects.get(device=form.cleaned_data['device'],
  745. name=form.cleaned_data['console_port'])
  746. console_port.cs_port = ConsoleServerPort.objects.get(device=form.cleaned_data['console_server'],
  747. name=form.cleaned_data['cs_port'])
  748. if form.cleaned_data['status'] == 'planned':
  749. console_port.connection_status = CONNECTION_STATUS_PLANNED
  750. else:
  751. console_port.connection_status = CONNECTION_STATUS_CONNECTED
  752. connection_list.append(console_port)
  753. else:
  754. for field, errors in form.errors.items():
  755. for e in errors:
  756. self.add_error('csv', "Record {} {}: {}".format(i, field, e))
  757. self.cleaned_data['csv'] = connection_list
  758. class ConsolePortConnectionForm(BootstrapMixin, ChainedFieldsMixin, forms.ModelForm):
  759. site = forms.ModelChoiceField(
  760. queryset=Site.objects.all(),
  761. widget=forms.HiddenInput(),
  762. )
  763. rack = ChainedModelChoiceField(
  764. queryset=Rack.objects.all(),
  765. chains={'site': 'site'},
  766. label='Rack',
  767. required=False,
  768. widget=forms.Select(
  769. attrs={'filter-for': 'console_server', 'nullable': 'true'}
  770. )
  771. )
  772. console_server = ChainedModelChoiceField(
  773. queryset=Device.objects.filter(device_type__is_console_server=True),
  774. chains={'site': 'site', 'rack': 'rack'},
  775. label='Console Server',
  776. required=False,
  777. widget=APISelect(
  778. api_url='/api/dcim/devices/?site_id={{site}}&rack_id={{rack}}&is_console_server=True',
  779. display_field='display_name',
  780. attrs={'filter-for': 'cs_port'}
  781. )
  782. )
  783. livesearch = forms.CharField(
  784. required=False,
  785. label='Console Server',
  786. widget=Livesearch(
  787. query_key='q',
  788. query_url='dcim-api:device-list',
  789. field_to_update='console_server',
  790. )
  791. )
  792. cs_port = ChainedModelChoiceField(
  793. queryset=ConsoleServerPort.objects.all(),
  794. chains={'device': 'console_server'},
  795. label='Port',
  796. widget=APISelect(
  797. api_url='/api/dcim/console-server-ports/?device_id={{console_server}}',
  798. disabled_indicator='connected_console',
  799. )
  800. )
  801. class Meta:
  802. model = ConsolePort
  803. fields = ['site', 'rack', 'console_server', 'livesearch', 'cs_port', 'connection_status']
  804. labels = {
  805. 'cs_port': 'Port',
  806. 'connection_status': 'Status',
  807. }
  808. def __init__(self, *args, **kwargs):
  809. super(ConsolePortConnectionForm, self).__init__(*args, **kwargs)
  810. if not self.instance.pk:
  811. raise RuntimeError("ConsolePortConnectionForm must be initialized with an existing ConsolePort instance.")
  812. #
  813. # Console server ports
  814. #
  815. class ConsoleServerPortForm(BootstrapMixin, forms.ModelForm):
  816. class Meta:
  817. model = ConsoleServerPort
  818. fields = ['device', 'name']
  819. widgets = {
  820. 'device': forms.HiddenInput(),
  821. }
  822. class ConsoleServerPortCreateForm(DeviceComponentForm):
  823. name_pattern = ExpandableNameField(label='Name')
  824. class ConsoleServerPortConnectionForm(BootstrapMixin, ChainedFieldsMixin, forms.Form):
  825. site = forms.ModelChoiceField(
  826. queryset=Site.objects.all(),
  827. widget=forms.HiddenInput(),
  828. )
  829. rack = ChainedModelChoiceField(
  830. queryset=Rack.objects.all(),
  831. chains={'site': 'site'},
  832. label='Rack',
  833. required=False,
  834. widget=forms.Select(
  835. attrs={'filter-for': 'device', 'nullable': 'true'}
  836. )
  837. )
  838. device = ChainedModelChoiceField(
  839. queryset=Device.objects.all(),
  840. chains={'site': 'site', 'rack': 'rack'},
  841. label='Device',
  842. required=False,
  843. widget=APISelect(
  844. api_url='/api/dcim/devices/?site_id={{site}}&rack_id={{rack}}',
  845. display_field='display_name',
  846. attrs={'filter-for': 'port'}
  847. )
  848. )
  849. livesearch = forms.CharField(
  850. required=False,
  851. label='Device',
  852. widget=Livesearch(
  853. query_key='q',
  854. query_url='dcim-api:device-list',
  855. field_to_update='device'
  856. )
  857. )
  858. port = ChainedModelChoiceField(
  859. queryset=ConsolePort.objects.all(),
  860. chains={'device': 'device'},
  861. label='Port',
  862. widget=APISelect(
  863. api_url='/api/dcim/console-ports/?device_id={{device}}',
  864. disabled_indicator='cs_port'
  865. )
  866. )
  867. connection_status = forms.BooleanField(
  868. required=False,
  869. initial=CONNECTION_STATUS_CONNECTED,
  870. label='Status',
  871. widget=forms.Select(
  872. choices=CONNECTION_STATUS_CHOICES
  873. )
  874. )
  875. class Meta:
  876. fields = ['site', 'rack', 'device', 'livesearch', 'port', 'connection_status']
  877. labels = {
  878. 'connection_status': 'Status',
  879. }
  880. #
  881. # Power ports
  882. #
  883. class PowerPortForm(BootstrapMixin, forms.ModelForm):
  884. class Meta:
  885. model = PowerPort
  886. fields = ['device', 'name']
  887. widgets = {
  888. 'device': forms.HiddenInput(),
  889. }
  890. class PowerPortCreateForm(DeviceComponentForm):
  891. name_pattern = ExpandableNameField(label='Name')
  892. class PowerConnectionCSVForm(forms.Form):
  893. pdu = FlexibleModelChoiceField(
  894. queryset=Device.objects.filter(device_type__is_pdu=True),
  895. to_field_name='name',
  896. error_messages={
  897. 'invalid_choice': 'PDU not found.',
  898. }
  899. )
  900. power_outlet = forms.CharField()
  901. device = FlexibleModelChoiceField(queryset=Device.objects.all(), to_field_name='name',
  902. error_messages={'invalid_choice': 'Device not found'})
  903. power_port = forms.CharField()
  904. status = forms.CharField(validators=[validate_connection_status])
  905. def clean(self):
  906. # Validate power outlet
  907. if self.cleaned_data.get('pdu'):
  908. try:
  909. power_outlet = PowerOutlet.objects.get(device=self.cleaned_data['pdu'],
  910. name=self.cleaned_data['power_outlet'])
  911. if PowerPort.objects.filter(power_outlet=power_outlet):
  912. raise forms.ValidationError("Power outlet is already occupied (by {} {})"
  913. .format(power_outlet.connected_port.device,
  914. power_outlet.connected_port))
  915. except PowerOutlet.DoesNotExist:
  916. raise forms.ValidationError("Invalid PDU port ({} {})"
  917. .format(self.cleaned_data['pdu'], self.cleaned_data['power_outlet']))
  918. # Validate power port
  919. if self.cleaned_data.get('device'):
  920. try:
  921. power_port = PowerPort.objects.get(device=self.cleaned_data['device'],
  922. name=self.cleaned_data['power_port'])
  923. if power_port.power_outlet:
  924. raise forms.ValidationError("Power port is already connected (to {} {})"
  925. .format(power_port.power_outlet.device, power_port.power_outlet))
  926. except PowerPort.DoesNotExist:
  927. raise forms.ValidationError("Invalid power port ({} {})"
  928. .format(self.cleaned_data['device'], self.cleaned_data['power_port']))
  929. class PowerConnectionImportForm(BootstrapMixin, BulkImportForm):
  930. csv = CSVDataField(csv_form=PowerConnectionCSVForm)
  931. def clean(self):
  932. records = self.cleaned_data.get('csv')
  933. if not records:
  934. return
  935. connection_list = []
  936. for i, record in enumerate(records, start=1):
  937. form = self.fields['csv'].csv_form(data=record)
  938. if form.is_valid():
  939. power_port = PowerPort.objects.get(device=form.cleaned_data['device'],
  940. name=form.cleaned_data['power_port'])
  941. power_port.power_outlet = PowerOutlet.objects.get(device=form.cleaned_data['pdu'],
  942. name=form.cleaned_data['power_outlet'])
  943. if form.cleaned_data['status'] == 'planned':
  944. power_port.connection_status = CONNECTION_STATUS_PLANNED
  945. else:
  946. power_port.connection_status = CONNECTION_STATUS_CONNECTED
  947. connection_list.append(power_port)
  948. else:
  949. for field, errors in form.errors.items():
  950. for e in errors:
  951. self.add_error('csv', "Record {} {}: {}".format(i, field, e))
  952. self.cleaned_data['csv'] = connection_list
  953. class PowerPortConnectionForm(BootstrapMixin, ChainedFieldsMixin, forms.ModelForm):
  954. site = forms.ModelChoiceField(queryset=Site.objects.all(), widget=forms.HiddenInput())
  955. rack = ChainedModelChoiceField(
  956. queryset=Rack.objects.all(),
  957. chains={'site': 'site'},
  958. label='Rack',
  959. required=False,
  960. widget=forms.Select(
  961. attrs={'filter-for': 'pdu', 'nullable': 'true'}
  962. )
  963. )
  964. pdu = ChainedModelChoiceField(
  965. queryset=Device.objects.all(),
  966. chains={'site': 'site', 'rack': 'rack'},
  967. label='PDU',
  968. required=False,
  969. widget=APISelect(
  970. api_url='/api/dcim/devices/?site_id={{site}}&rack_id={{rack}}&is_pdu=True',
  971. display_field='display_name',
  972. attrs={'filter-for': 'power_outlet'}
  973. )
  974. )
  975. livesearch = forms.CharField(
  976. required=False,
  977. label='PDU',
  978. widget=Livesearch(
  979. query_key='q',
  980. query_url='dcim-api:device-list',
  981. field_to_update='pdu'
  982. )
  983. )
  984. power_outlet = ChainedModelChoiceField(
  985. queryset=PowerOutlet.objects.all(),
  986. chains={'device': 'device'},
  987. label='Outlet',
  988. widget=APISelect(
  989. api_url='/api/dcim/power-outlets/?device_id={{pdu}}',
  990. disabled_indicator='connected_port'
  991. )
  992. )
  993. class Meta:
  994. model = PowerPort
  995. fields = ['site', 'rack', 'pdu', 'livesearch', 'power_outlet', 'connection_status']
  996. labels = {
  997. 'power_outlet': 'Outlet',
  998. 'connection_status': 'Status',
  999. }
  1000. def __init__(self, *args, **kwargs):
  1001. super(PowerPortConnectionForm, self).__init__(*args, **kwargs)
  1002. if not self.instance.pk:
  1003. raise RuntimeError("PowerPortConnectionForm must be initialized with an existing PowerPort instance.")
  1004. #
  1005. # Power outlets
  1006. #
  1007. class PowerOutletForm(BootstrapMixin, forms.ModelForm):
  1008. class Meta:
  1009. model = PowerOutlet
  1010. fields = ['device', 'name']
  1011. widgets = {
  1012. 'device': forms.HiddenInput(),
  1013. }
  1014. class PowerOutletCreateForm(DeviceComponentForm):
  1015. name_pattern = ExpandableNameField(label='Name')
  1016. class PowerOutletConnectionForm(BootstrapMixin, ChainedFieldsMixin, forms.Form):
  1017. site = forms.ModelChoiceField(
  1018. queryset=Site.objects.all(),
  1019. widget=forms.HiddenInput()
  1020. )
  1021. rack = ChainedModelChoiceField(
  1022. queryset=Rack.objects.all(),
  1023. chains={'site': 'site'},
  1024. label='Rack',
  1025. required=False,
  1026. widget=forms.Select(
  1027. attrs={'filter-for': 'device', 'nullable': 'true'}
  1028. )
  1029. )
  1030. device = ChainedModelChoiceField(
  1031. queryset=Device.objects.all(),
  1032. chains={'site': 'site', 'rack': 'rack'},
  1033. label='Device',
  1034. required=False,
  1035. widget=APISelect(
  1036. api_url='/api/dcim/devices/?site_id={{site}}&rack_id={{rack}}',
  1037. display_field='display_name',
  1038. attrs={'filter-for': 'port'}
  1039. )
  1040. )
  1041. livesearch = forms.CharField(
  1042. required=False,
  1043. label='Device',
  1044. widget=Livesearch(
  1045. query_key='q',
  1046. query_url='dcim-api:device-list',
  1047. field_to_update='device'
  1048. )
  1049. )
  1050. port = ChainedModelChoiceField(
  1051. queryset=PowerPort.objects.all(),
  1052. chains={'device': 'device'},
  1053. label='Port',
  1054. widget=APISelect(
  1055. api_url='/api/dcim/power-ports/?device_id={{device}}',
  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. #
  1073. # Interfaces
  1074. #
  1075. class InterfaceForm(BootstrapMixin, forms.ModelForm):
  1076. class Meta:
  1077. model = Interface
  1078. fields = ['device', 'name', 'form_factor', 'lag', 'mac_address', 'mgmt_only', 'description']
  1079. widgets = {
  1080. 'device': forms.HiddenInput(),
  1081. }
  1082. def __init__(self, *args, **kwargs):
  1083. super(InterfaceForm, self).__init__(*args, **kwargs)
  1084. # Limit LAG choices to interfaces belonging to this device
  1085. if self.is_bound:
  1086. self.fields['lag'].queryset = Interface.objects.order_naturally().filter(
  1087. device_id=self.data['device'], form_factor=IFACE_FF_LAG
  1088. )
  1089. else:
  1090. self.fields['lag'].queryset = Interface.objects.order_naturally().filter(
  1091. device=self.instance.device, form_factor=IFACE_FF_LAG
  1092. )
  1093. class InterfaceCreateForm(DeviceComponentForm):
  1094. name_pattern = ExpandableNameField(label='Name')
  1095. form_factor = forms.ChoiceField(choices=IFACE_FF_CHOICES)
  1096. lag = forms.ModelChoiceField(queryset=Interface.objects.all(), required=False, label='Parent LAG')
  1097. mac_address = MACAddressFormField(required=False, label='MAC Address')
  1098. mgmt_only = forms.BooleanField(required=False, label='OOB Management')
  1099. description = forms.CharField(max_length=100, required=False)
  1100. def __init__(self, *args, **kwargs):
  1101. super(InterfaceCreateForm, self).__init__(*args, **kwargs)
  1102. # Limit LAG choices to interfaces belonging to this device
  1103. if self.device is not None:
  1104. self.fields['lag'].queryset = Interface.objects.order_naturally().filter(
  1105. device=self.device, form_factor=IFACE_FF_LAG
  1106. )
  1107. else:
  1108. self.fields['lag'].queryset = Interface.objects.none()
  1109. class InterfaceBulkEditForm(BootstrapMixin, BulkEditForm):
  1110. pk = forms.ModelMultipleChoiceField(queryset=Interface.objects.all(), widget=forms.MultipleHiddenInput)
  1111. device = forms.ModelChoiceField(queryset=Device.objects.all(), widget=forms.HiddenInput)
  1112. lag = forms.ModelChoiceField(queryset=Interface.objects.all(), required=False, label='Parent LAG')
  1113. form_factor = forms.ChoiceField(choices=add_blank_choice(IFACE_FF_CHOICES), required=False)
  1114. mgmt_only = forms.NullBooleanField(required=False, widget=BulkEditNullBooleanSelect, label='Management only')
  1115. description = forms.CharField(max_length=100, required=False)
  1116. class Meta:
  1117. nullable_fields = ['lag', 'description']
  1118. def __init__(self, *args, **kwargs):
  1119. super(InterfaceBulkEditForm, self).__init__(*args, **kwargs)
  1120. # Limit LAG choices to interfaces which belong to the parent device.
  1121. device = None
  1122. if self.initial.get('device'):
  1123. try:
  1124. device = Device.objects.get(pk=self.initial.get('device'))
  1125. except Device.DoesNotExist:
  1126. pass
  1127. if device is not None:
  1128. interface_ordering = device.device_type.interface_ordering
  1129. self.fields['lag'].queryset = Interface.objects.order_naturally(method=interface_ordering).filter(
  1130. device=device, form_factor=IFACE_FF_LAG
  1131. )
  1132. else:
  1133. self.fields['lag'].choices = []
  1134. #
  1135. # Interface connections
  1136. #
  1137. class InterfaceConnectionForm(BootstrapMixin, ChainedFieldsMixin, forms.ModelForm):
  1138. interface_a = forms.ChoiceField(
  1139. choices=[],
  1140. widget=SelectWithDisabled,
  1141. label='Interface'
  1142. )
  1143. site_b = forms.ModelChoiceField(
  1144. queryset=Site.objects.all(),
  1145. label='Site',
  1146. required=False,
  1147. widget=forms.Select(
  1148. attrs={'filter-for': 'rack_b'}
  1149. )
  1150. )
  1151. rack_b = ChainedModelChoiceField(
  1152. queryset=Rack.objects.all(),
  1153. chains={'site': 'site_b'},
  1154. label='Rack',
  1155. required=False,
  1156. widget=APISelect(
  1157. api_url='/api/dcim/racks/?site_id={{site_b}}',
  1158. attrs={'filter-for': 'device_b', 'nullable': 'true'}
  1159. )
  1160. )
  1161. device_b = ChainedModelChoiceField(
  1162. queryset=Device.objects.all(),
  1163. chains={'site': 'site_b', 'rack': 'rack_b'},
  1164. label='Device',
  1165. required=False,
  1166. widget=APISelect(
  1167. api_url='/api/dcim/devices/?site_id={{site_b}}&rack_id={{rack_b}}',
  1168. display_field='display_name',
  1169. attrs={'filter-for': 'interface_b'}
  1170. )
  1171. )
  1172. livesearch = forms.CharField(
  1173. required=False,
  1174. label='Device',
  1175. widget=Livesearch(
  1176. query_key='q',
  1177. query_url='dcim-api:device-list',
  1178. field_to_update='device_b'
  1179. )
  1180. )
  1181. interface_b = ChainedModelChoiceField(
  1182. queryset=Interface.objects.exclude(form_factor__in=VIRTUAL_IFACE_TYPES).select_related(
  1183. 'circuit_termination', 'connected_as_a', 'connected_as_b'
  1184. ),
  1185. chains={'device': 'device_b'},
  1186. label='Interface',
  1187. widget=APISelect(
  1188. api_url='/api/dcim/interfaces/?device_id={{device_b}}&type=physical',
  1189. disabled_indicator='is_connected'
  1190. )
  1191. )
  1192. class Meta:
  1193. model = InterfaceConnection
  1194. fields = ['interface_a', 'site_b', 'rack_b', 'device_b', 'interface_b', 'livesearch', 'connection_status']
  1195. def __init__(self, device_a, *args, **kwargs):
  1196. super(InterfaceConnectionForm, self).__init__(*args, **kwargs)
  1197. # Initialize interface A choices
  1198. device_a_interfaces = Interface.objects.order_naturally().filter(device=device_a).exclude(
  1199. form_factor__in=VIRTUAL_IFACE_TYPES
  1200. ).select_related(
  1201. 'circuit_termination', 'connected_as_a', 'connected_as_b'
  1202. )
  1203. self.fields['interface_a'].choices = [
  1204. (iface.id, {'label': iface.name, 'disabled': iface.is_connected}) for iface in device_a_interfaces
  1205. ]
  1206. # Mark connected interfaces as disabled
  1207. self.fields['interface_b'].choices = [
  1208. (iface.id, {'label': iface.name, 'disabled': iface.is_connected}) for iface in self.fields['interface_b'].queryset
  1209. ]
  1210. class InterfaceConnectionCSVForm(forms.Form):
  1211. device_a = FlexibleModelChoiceField(
  1212. queryset=Device.objects.all(),
  1213. to_field_name='name',
  1214. error_messages={'invalid_choice': 'Device A not found.'}
  1215. )
  1216. interface_a = forms.CharField()
  1217. device_b = FlexibleModelChoiceField(
  1218. queryset=Device.objects.all(),
  1219. to_field_name='name',
  1220. error_messages={'invalid_choice': 'Device B not found.'}
  1221. )
  1222. interface_b = forms.CharField()
  1223. status = forms.CharField(
  1224. validators=[validate_connection_status]
  1225. )
  1226. def clean(self):
  1227. # Validate interface A
  1228. if self.cleaned_data.get('device_a'):
  1229. try:
  1230. interface_a = Interface.objects.get(device=self.cleaned_data['device_a'],
  1231. name=self.cleaned_data['interface_a'])
  1232. except Interface.DoesNotExist:
  1233. raise forms.ValidationError("Invalid interface ({} {})"
  1234. .format(self.cleaned_data['device_a'], self.cleaned_data['interface_a']))
  1235. try:
  1236. InterfaceConnection.objects.get(Q(interface_a=interface_a) | Q(interface_b=interface_a))
  1237. raise forms.ValidationError("{} {} is already connected"
  1238. .format(self.cleaned_data['device_a'], self.cleaned_data['interface_a']))
  1239. except InterfaceConnection.DoesNotExist:
  1240. pass
  1241. # Validate interface B
  1242. if self.cleaned_data.get('device_b'):
  1243. try:
  1244. interface_b = Interface.objects.get(device=self.cleaned_data['device_b'],
  1245. name=self.cleaned_data['interface_b'])
  1246. except Interface.DoesNotExist:
  1247. raise forms.ValidationError("Invalid interface ({} {})"
  1248. .format(self.cleaned_data['device_b'], self.cleaned_data['interface_b']))
  1249. try:
  1250. InterfaceConnection.objects.get(Q(interface_a=interface_b) | Q(interface_b=interface_b))
  1251. raise forms.ValidationError("{} {} is already connected"
  1252. .format(self.cleaned_data['device_b'], self.cleaned_data['interface_b']))
  1253. except InterfaceConnection.DoesNotExist:
  1254. pass
  1255. class InterfaceConnectionImportForm(BootstrapMixin, BulkImportForm):
  1256. csv = CSVDataField(csv_form=InterfaceConnectionCSVForm)
  1257. def clean(self):
  1258. records = self.cleaned_data.get('csv')
  1259. if not records:
  1260. return
  1261. connection_list = []
  1262. occupied_interfaces = []
  1263. for i, record in enumerate(records, start=1):
  1264. form = self.fields['csv'].csv_form(data=record)
  1265. if form.is_valid():
  1266. interface_a = Interface.objects.get(device=form.cleaned_data['device_a'],
  1267. name=form.cleaned_data['interface_a'])
  1268. if interface_a in occupied_interfaces:
  1269. raise forms.ValidationError("{} {} found in multiple connections"
  1270. .format(interface_a.device.name, interface_a.name))
  1271. interface_b = Interface.objects.get(device=form.cleaned_data['device_b'],
  1272. name=form.cleaned_data['interface_b'])
  1273. if interface_b in occupied_interfaces:
  1274. raise forms.ValidationError("{} {} found in multiple connections"
  1275. .format(interface_b.device.name, interface_b.name))
  1276. connection = InterfaceConnection(interface_a=interface_a, interface_b=interface_b)
  1277. if form.cleaned_data['status'] == 'planned':
  1278. connection.connection_status = CONNECTION_STATUS_PLANNED
  1279. else:
  1280. connection.connection_status = CONNECTION_STATUS_CONNECTED
  1281. connection_list.append(connection)
  1282. occupied_interfaces.append(interface_a)
  1283. occupied_interfaces.append(interface_b)
  1284. else:
  1285. for field, errors in form.errors.items():
  1286. for e in errors:
  1287. self.add_error('csv', "Record {} {}: {}".format(i, field, e))
  1288. self.cleaned_data['csv'] = connection_list
  1289. class InterfaceConnectionDeletionForm(BootstrapMixin, forms.Form):
  1290. confirm = forms.BooleanField(required=True)
  1291. # Used for HTTP redirect upon successful deletion
  1292. device = forms.ModelChoiceField(queryset=Device.objects.all(), widget=forms.HiddenInput(), required=False)
  1293. #
  1294. # Device bays
  1295. #
  1296. class DeviceBayForm(BootstrapMixin, forms.ModelForm):
  1297. class Meta:
  1298. model = DeviceBay
  1299. fields = ['device', 'name']
  1300. widgets = {
  1301. 'device': forms.HiddenInput(),
  1302. }
  1303. class DeviceBayCreateForm(DeviceComponentForm):
  1304. name_pattern = ExpandableNameField(label='Name')
  1305. class PopulateDeviceBayForm(BootstrapMixin, forms.Form):
  1306. installed_device = forms.ModelChoiceField(
  1307. queryset=Device.objects.all(),
  1308. label='Child Device',
  1309. help_text="Child devices must first be created and assigned to the site/rack of the parent device."
  1310. )
  1311. def __init__(self, device_bay, *args, **kwargs):
  1312. super(PopulateDeviceBayForm, self).__init__(*args, **kwargs)
  1313. self.fields['installed_device'].queryset = Device.objects.filter(
  1314. site=device_bay.device.site,
  1315. rack=device_bay.device.rack,
  1316. parent_bay__isnull=True,
  1317. device_type__u_height=0,
  1318. device_type__subdevice_role=SUBDEVICE_ROLE_CHILD
  1319. ).exclude(pk=device_bay.device.pk)
  1320. #
  1321. # Connections
  1322. #
  1323. class ConsoleConnectionFilterForm(BootstrapMixin, forms.Form):
  1324. site = forms.ModelChoiceField(required=False, queryset=Site.objects.all(), to_field_name='slug')
  1325. device = forms.CharField(required=False, label='Device name')
  1326. class PowerConnectionFilterForm(BootstrapMixin, forms.Form):
  1327. site = forms.ModelChoiceField(required=False, queryset=Site.objects.all(), to_field_name='slug')
  1328. device = forms.CharField(required=False, label='Device name')
  1329. class InterfaceConnectionFilterForm(BootstrapMixin, forms.Form):
  1330. site = forms.ModelChoiceField(required=False, queryset=Site.objects.all(), to_field_name='slug')
  1331. device = forms.CharField(required=False, label='Device name')
  1332. #
  1333. # Inventory items
  1334. #
  1335. class InventoryItemForm(BootstrapMixin, forms.ModelForm):
  1336. class Meta:
  1337. model = InventoryItem
  1338. fields = ['name', 'manufacturer', 'part_id', 'serial']