forms.py 61 KB

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