)]}'
{"doc/networking-guide/source/config-network-trunking.rst":[{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"a457cf5419d39dbbe99dba136ed1f3ba5db573c2","unresolved":false,"context_lines":[{"line_number":10,"context_line":""},{"line_number":11,"context_line":"Network trunking consists of a service plug-in and a set of drivers"},{"line_number":12,"context_line":"that manage trunks on different L2 networking solutions (for example OVS,"},{"line_number":13,"context_line":"Linux bridge, and so on). Users can create a port, associate it with a trunk,"},{"line_number":14,"context_line":"and boot instances on that port. This gives the instance access to"},{"line_number":15,"context_line":"a trunk, enabling the instance to be attached and detached from networks"},{"line_number":16,"context_line":"dynamically without shutting down, re-building, or attaching and detaching"}],"source_content_type":"text/x-rst","patch_set":13,"id":"5a74a57a_6a3151ec","line":13,"range":{"start_line":13,"start_character":0,"end_line":13,"end_character":12},"updated":"2016-11-30 13:47:36.000000000","message":"nit: \"Bridge\" is capitalized everywhere else in this document.","commit_id":"bcf6b79ccb6b0940ebda07ff7bc5ab1d336417c4"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"a457cf5419d39dbbe99dba136ed1f3ba5db573c2","unresolved":false,"context_lines":[{"line_number":52,"context_line":""},{"line_number":53,"context_line":"When using a ``segmentation-type`` of ``vlan``, the OVS and Linux Bridge"},{"line_number":54,"context_line":"drivers present the network of the parent port as the untagged VLAN and all"},{"line_number":55,"context_line":"subports as tagged VLAN\u0027s."},{"line_number":56,"context_line":""},{"line_number":57,"context_line":"Controller node"},{"line_number":58,"context_line":"---------------"}],"source_content_type":"text/x-rst","patch_set":13,"id":"5a74a57a_0a68ddb9","line":55,"range":{"start_line":55,"start_character":19,"end_line":55,"end_character":25},"updated":"2016-11-30 13:47:36.000000000","message":"VLANs","commit_id":"bcf6b79ccb6b0940ebda07ff7bc5ab1d336417c4"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"a457cf5419d39dbbe99dba136ed1f3ba5db573c2","unresolved":false,"context_lines":[{"line_number":69,"context_line":""},{"line_number":70,"context_line":"#. Source the administrative project credentials and list the enabled"},{"line_number":71,"context_line":"   extensions."},{"line_number":72,"context_line":"#. Use the command ``openstack extension list --network`` to verify that the"},{"line_number":73,"context_line":"   ``Trunk Extension`` and ``Trunk port details`` extensions are enabled."},{"line_number":74,"context_line":""},{"line_number":75,"context_line":"Workflow"}],"source_content_type":"text/x-rst","patch_set":13,"id":"5a74a57a_6ae4f13a","line":72,"range":{"start_line":72,"start_character":11,"end_line":72,"end_character":57},"updated":"2016-11-30 13:47:36.000000000","message":":command:`openstack extension list --network`","commit_id":"bcf6b79ccb6b0940ebda07ff7bc5ab1d336417c4"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"a457cf5419d39dbbe99dba136ed1f3ba5db573c2","unresolved":false,"context_lines":[{"line_number":317,"context_line":"on a trunk to be configured without explicitly setting a MAC address. Although"},{"line_number":318,"context_line":"unique MAC addresses can be used for subports, this can present issues with"},{"line_number":319,"context_line":"ARP spoof protections and the native OVS firewall driver. If the native OVS"},{"line_number":320,"context_line":"firewall driver is to be used, we recommend that the MAC address of the trunk"},{"line_number":321,"context_line":"be re-used on all subports."},{"line_number":322,"context_line":""},{"line_number":323,"context_line":"Trunk States"}],"source_content_type":"text/x-rst","patch_set":13,"id":"5a74a57a_4d774f02","line":320,"range":{"start_line":320,"start_character":72,"end_line":320,"end_character":77},"updated":"2016-11-30 13:47:36.000000000","message":"parent port","commit_id":"bcf6b79ccb6b0940ebda07ff7bc5ab1d336417c4"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"a457cf5419d39dbbe99dba136ed1f3ba5db573c2","unresolved":false,"context_lines":[{"line_number":320,"context_line":"firewall driver is to be used, we recommend that the MAC address of the trunk"},{"line_number":321,"context_line":"be re-used on all subports."},{"line_number":322,"context_line":""},{"line_number":323,"context_line":"Trunk States"},{"line_number":324,"context_line":"------------"},{"line_number":325,"context_line":""},{"line_number":326,"context_line":"* ``ACTIVE``"}],"source_content_type":"text/x-rst","patch_set":13,"id":"5a74a57a_edd57bb9","line":323,"range":{"start_line":323,"start_character":6,"end_line":323,"end_character":12},"updated":"2016-11-30 13:47:36.000000000","message":"states","commit_id":"bcf6b79ccb6b0940ebda07ff7bc5ab1d336417c4"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"a457cf5419d39dbbe99dba136ed1f3ba5db573c2","unresolved":false,"context_lines":[{"line_number":364,"context_line":"  operations on the trunk. ``admin_state`` is set by the user and should not be"},{"line_number":365,"context_line":"  used to monitor the health of the trunk."},{"line_number":366,"context_line":""},{"line_number":367,"context_line":"Known Limitations"},{"line_number":368,"context_line":"-----------------"},{"line_number":369,"context_line":""},{"line_number":370,"context_line":"* https://bugs.launchpad.net/neutron/+bugs?field.tag\u003dtrunk"}],"source_content_type":"text/x-rst","patch_set":13,"id":"5a74a57a_4de58fa6","line":367,"range":{"start_line":367,"start_character":6,"end_line":367,"end_character":17},"updated":"2016-11-30 13:47:36.000000000","message":"limitations","commit_id":"bcf6b79ccb6b0940ebda07ff7bc5ab1d336417c4"}],"doc/networking-guide/source/config-vlan-trunking.rst":[{"author":{"_account_id":8655,"name":"Jakub Libosvar","email":"libosvar@redhat.com","username":"jlibosva"},"change_message_id":"404268b623751c0d798c7ccbbc7975ae48dcdefb","unresolved":false,"context_lines":[{"line_number":4,"context_line":"VLAN Trunking"},{"line_number":5,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":6,"context_line":""},{"line_number":7,"context_line":"VLAN trunk allows multiple networks to be connected an instance using a"},{"line_number":8,"context_line":"single virtual NIC (vNIC). Multiple networks can be presented to an"},{"line_number":9,"context_line":"instance using 802.1Q tagged VLAN\u0027s over a trunk."},{"line_number":10,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_5de31e33","line":7,"range":{"start_line":7,"start_character":51,"end_line":7,"end_character":52},"updated":"2016-08-29 16:19:46.000000000","message":"connected to an instance","commit_id":"89a7f668650242a48812f1969dbbd045b5058d55"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"ef4a99bfbcfb370f7c9adbe29c366cbf3de4a1dc","unresolved":false,"context_lines":[{"line_number":9,"context_line":"instance using 802.1Q tagged VLAN\u0027s over a trunk."},{"line_number":10,"context_line":""},{"line_number":11,"context_line":"VLAN trunking consists of a service plugin and a set of drivers"},{"line_number":12,"context_line":"that manage trunks on different L2 networking solutions (eg. OVS, linux"},{"line_number":13,"context_line":"bridge, etc.). Users can configure a trunk, boot an instance on that trunk,"},{"line_number":14,"context_line":"and attach/detach networks dynamically without shutting down or re-building"},{"line_number":15,"context_line":"the instance."}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_96121561","line":12,"range":{"start_line":12,"start_character":57,"end_line":12,"end_character":60},"updated":"2016-09-01 11:54:21.000000000","message":"Use \"for example\"","commit_id":"89a7f668650242a48812f1969dbbd045b5058d55"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"ef4a99bfbcfb370f7c9adbe29c366cbf3de4a1dc","unresolved":false,"context_lines":[{"line_number":10,"context_line":""},{"line_number":11,"context_line":"VLAN trunking consists of a service plugin and a set of drivers"},{"line_number":12,"context_line":"that manage trunks on different L2 networking solutions (eg. OVS, linux"},{"line_number":13,"context_line":"bridge, etc.). Users can configure a trunk, boot an instance on that trunk,"},{"line_number":14,"context_line":"and attach/detach networks dynamically without shutting down or re-building"},{"line_number":15,"context_line":"the instance."},{"line_number":16,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_d60c9d44","line":13,"range":{"start_line":13,"start_character":7,"end_line":13,"end_character":12},"updated":"2016-09-01 11:54:21.000000000","message":"Avoid using \u0027etc\u0027 please","commit_id":"89a7f668650242a48812f1969dbbd045b5058d55"},{"author":{"_account_id":8655,"name":"Jakub Libosvar","email":"libosvar@redhat.com","username":"jlibosva"},"change_message_id":"404268b623751c0d798c7ccbbc7975ae48dcdefb","unresolved":false,"context_lines":[{"line_number":10,"context_line":""},{"line_number":11,"context_line":"VLAN trunking consists of a service plugin and a set of drivers"},{"line_number":12,"context_line":"that manage trunks on different L2 networking solutions (eg. OVS, linux"},{"line_number":13,"context_line":"bridge, etc.). Users can configure a trunk, boot an instance on that trunk,"},{"line_number":14,"context_line":"and attach/detach networks dynamically without shutting down or re-building"},{"line_number":15,"context_line":"the instance."},{"line_number":16,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_9d33e6aa","line":13,"range":{"start_line":13,"start_character":15,"end_line":13,"end_character":42},"updated":"2016-08-29 16:19:46.000000000","message":"I might find it misleading. I\u0027d mention users need to create unbound port and associate it with trunk first.","commit_id":"89a7f668650242a48812f1969dbbd045b5058d55"},{"author":{"_account_id":8655,"name":"Jakub Libosvar","email":"libosvar@redhat.com","username":"jlibosva"},"change_message_id":"404268b623751c0d798c7ccbbc7975ae48dcdefb","unresolved":false,"context_lines":[{"line_number":10,"context_line":""},{"line_number":11,"context_line":"VLAN trunking consists of a service plugin and a set of drivers"},{"line_number":12,"context_line":"that manage trunks on different L2 networking solutions (eg. OVS, linux"},{"line_number":13,"context_line":"bridge, etc.). Users can configure a trunk, boot an instance on that trunk,"},{"line_number":14,"context_line":"and attach/detach networks dynamically without shutting down or re-building"},{"line_number":15,"context_line":"the instance."},{"line_number":16,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_dd448e1c","line":13,"range":{"start_line":13,"start_character":8,"end_line":13,"end_character":11},"updated":"2016-08-29 16:19:46.000000000","message":"That almost sounds like we have more than those two :)","commit_id":"89a7f668650242a48812f1969dbbd045b5058d55"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"ef4a99bfbcfb370f7c9adbe29c366cbf3de4a1dc","unresolved":false,"context_lines":[{"line_number":11,"context_line":"VLAN trunking consists of a service plugin and a set of drivers"},{"line_number":12,"context_line":"that manage trunks on different L2 networking solutions (eg. OVS, linux"},{"line_number":13,"context_line":"bridge, etc.). Users can configure a trunk, boot an instance on that trunk,"},{"line_number":14,"context_line":"and attach/detach networks dynamically without shutting down or re-building"},{"line_number":15,"context_line":"the instance."},{"line_number":16,"context_line":""},{"line_number":17,"context_line":"Every trunk has a parent port, and can have any number of subports. The parent"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_91021f08","line":14,"range":{"start_line":14,"start_character":4,"end_line":14,"end_character":17},"updated":"2016-09-01 11:54:21.000000000","message":"attach/detach - please avoid using a slash if possible","commit_id":"89a7f668650242a48812f1969dbbd045b5058d55"},{"author":{"_account_id":15554,"name":"Bence Romsics","email":"bence.romsics@gmail.com","username":"ebenrom","status":"inactive contributor"},"change_message_id":"99e003dc8d1e38075341e1ef1678e9116d87eb44","unresolved":false,"context_lines":[{"line_number":14,"context_line":"and attach/detach networks dynamically without shutting down or re-building"},{"line_number":15,"context_line":"the instance."},{"line_number":16,"context_line":""},{"line_number":17,"context_line":"Every trunk has a parent port, and can have any number of subports. The parent"},{"line_number":18,"context_line":"port is the port that the trunk is associated with. Users create instances and"},{"line_number":19,"context_line":"specify the parent port of the trunk when booting instances attached to a"},{"line_number":20,"context_line":"trunk. The network of the parent port is the network presented as the untagged"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_9d0cf895","line":17,"range":{"start_line":17,"start_character":67,"end_line":17,"end_character":68},"updated":"2016-09-01 11:38:48.000000000","message":"A suggestion: Having a trunk with zero subports is practically equivalent with having a regular port, but with the option of adding subports later.","commit_id":"89a7f668650242a48812f1969dbbd045b5058d55"},{"author":{"_account_id":15554,"name":"Bence Romsics","email":"bence.romsics@gmail.com","username":"ebenrom","status":"inactive contributor"},"change_message_id":"99e003dc8d1e38075341e1ef1678e9116d87eb44","unresolved":false,"context_lines":[{"line_number":15,"context_line":"the instance."},{"line_number":16,"context_line":""},{"line_number":17,"context_line":"Every trunk has a parent port, and can have any number of subports. The parent"},{"line_number":18,"context_line":"port is the port that the trunk is associated with. Users create instances and"},{"line_number":19,"context_line":"specify the parent port of the trunk when booting instances attached to a"},{"line_number":20,"context_line":"trunk. The network of the parent port is the network presented as the untagged"},{"line_number":21,"context_line":"VLAN."},{"line_number":22,"context_line":""},{"line_number":23,"context_line":"Subports belong to a trunk and also have a parent port. The network of the"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_5337bfaf","line":20,"range":{"start_line":18,"start_character":52,"end_line":20,"end_character":6},"updated":"2016-09-01 11:38:48.000000000","message":"I find this sentence a bit hard to parse, maybe a clarification: When booting an instance users must specify the parent port belonging to the trunk, not the trunk itself (nova need not know about the trunk).","commit_id":"89a7f668650242a48812f1969dbbd045b5058d55"},{"author":{"_account_id":15554,"name":"Bence Romsics","email":"bence.romsics@gmail.com","username":"ebenrom","status":"inactive contributor"},"change_message_id":"99e003dc8d1e38075341e1ef1678e9116d87eb44","unresolved":false,"context_lines":[{"line_number":21,"context_line":"VLAN."},{"line_number":22,"context_line":""},{"line_number":23,"context_line":"Subports belong to a trunk and also have a parent port. The network of the"},{"line_number":24,"context_line":"subport parent is the network presented by the subport. When creating a"},{"line_number":25,"context_line":"subport, a segmentation-id is required. segmentation-id defines the tagged"},{"line_number":26,"context_line":"VLAN that the parent port network will be presented to the instance as."},{"line_number":27,"context_line":"segmentation-type is must be specified, although at this time only ``vlan``"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_9d123861","line":24,"range":{"start_line":24,"start_character":0,"end_line":24,"end_character":14},"updated":"2016-09-01 11:38:48.000000000","message":"subport? But then the sentence sounds trivial.","commit_id":"89a7f668650242a48812f1969dbbd045b5058d55"},{"author":{"_account_id":8655,"name":"Jakub Libosvar","email":"libosvar@redhat.com","username":"jlibosva"},"change_message_id":"404268b623751c0d798c7ccbbc7975ae48dcdefb","unresolved":false,"context_lines":[{"line_number":22,"context_line":""},{"line_number":23,"context_line":"Subports belong to a trunk and also have a parent port. The network of the"},{"line_number":24,"context_line":"subport parent is the network presented by the subport. When creating a"},{"line_number":25,"context_line":"subport, a segmentation-id is required. segmentation-id defines the tagged"},{"line_number":26,"context_line":"VLAN that the parent port network will be presented to the instance as."},{"line_number":27,"context_line":"segmentation-type is must be specified, although at this time only ``vlan``"},{"line_number":28,"context_line":"is supported as a segmentation-type."}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_1da3569e","line":25,"range":{"start_line":25,"start_character":8,"end_line":25,"end_character":38},"updated":"2016-08-29 16:19:46.000000000","message":"Not related to this patch: I need to ask someone why don\u0027t we read this from network that subport\u0027s parent port belongs to and use the segmentation configuration based on the network.","commit_id":"89a7f668650242a48812f1969dbbd045b5058d55"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"ef4a99bfbcfb370f7c9adbe29c366cbf3de4a1dc","unresolved":false,"context_lines":[{"line_number":22,"context_line":""},{"line_number":23,"context_line":"Subports belong to a trunk and also have a parent port. The network of the"},{"line_number":24,"context_line":"subport parent is the network presented by the subport. When creating a"},{"line_number":25,"context_line":"subport, a segmentation-id is required. segmentation-id defines the tagged"},{"line_number":26,"context_line":"VLAN that the parent port network will be presented to the instance as."},{"line_number":27,"context_line":"segmentation-type is must be specified, although at this time only ``vlan``"},{"line_number":28,"context_line":"is supported as a segmentation-type."}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_11360fe7","line":25,"range":{"start_line":25,"start_character":40,"end_line":25,"end_character":55},"updated":"2016-09-01 11:54:21.000000000","message":"``segmentation-id``","commit_id":"89a7f668650242a48812f1969dbbd045b5058d55"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"ef4a99bfbcfb370f7c9adbe29c366cbf3de4a1dc","unresolved":false,"context_lines":[{"line_number":22,"context_line":""},{"line_number":23,"context_line":"Subports belong to a trunk and also have a parent port. The network of the"},{"line_number":24,"context_line":"subport parent is the network presented by the subport. When creating a"},{"line_number":25,"context_line":"subport, a segmentation-id is required. segmentation-id defines the tagged"},{"line_number":26,"context_line":"VLAN that the parent port network will be presented to the instance as."},{"line_number":27,"context_line":"segmentation-type is must be specified, although at this time only ``vlan``"},{"line_number":28,"context_line":"is supported as a segmentation-type."}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_d123c7a5","line":25,"range":{"start_line":25,"start_character":11,"end_line":25,"end_character":26},"updated":"2016-09-01 11:54:21.000000000","message":"``segmentation-id``","commit_id":"89a7f668650242a48812f1969dbbd045b5058d55"},{"author":{"_account_id":15554,"name":"Bence Romsics","email":"bence.romsics@gmail.com","username":"ebenrom","status":"inactive contributor"},"change_message_id":"99e003dc8d1e38075341e1ef1678e9116d87eb44","unresolved":false,"context_lines":[{"line_number":22,"context_line":""},{"line_number":23,"context_line":"Subports belong to a trunk and also have a parent port. The network of the"},{"line_number":24,"context_line":"subport parent is the network presented by the subport. When creating a"},{"line_number":25,"context_line":"subport, a segmentation-id is required. segmentation-id defines the tagged"},{"line_number":26,"context_line":"VLAN that the parent port network will be presented to the instance as."},{"line_number":27,"context_line":"segmentation-type is must be specified, although at this time only ``vlan``"},{"line_number":28,"context_line":"is supported as a segmentation-type."}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_c0121309","line":25,"in_reply_to":"fa7ab95a_1425c107","updated":"2016-09-01 11:38:48.000000000","message":"I suppose the readers of the networking guide will have similar questions. What about adding a paragraph like:\n\nThe segmentation type and id specified by the user on the subports (and used inside the instance) is intentionally decoupled from the segmentation type and id of neutron networks. For example it is possible to configure neutron with \u0027tenant_network_types \u003d vxlan\u0027 and still create subports with \u0027segmentation_type \u003d vlan\u0027. Neutron will remap packets as needed.","commit_id":"89a7f668650242a48812f1969dbbd045b5058d55"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"3e86366f7fecacf0f8f8b0d0d622f02f8da5afee","unresolved":false,"context_lines":[{"line_number":22,"context_line":""},{"line_number":23,"context_line":"Subports belong to a trunk and also have a parent port. The network of the"},{"line_number":24,"context_line":"subport parent is the network presented by the subport. When creating a"},{"line_number":25,"context_line":"subport, a segmentation-id is required. segmentation-id defines the tagged"},{"line_number":26,"context_line":"VLAN that the parent port network will be presented to the instance as."},{"line_number":27,"context_line":"segmentation-type is must be specified, although at this time only ``vlan``"},{"line_number":28,"context_line":"is supported as a segmentation-type."}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_f8a79208","line":25,"in_reply_to":"fa7ab95a_1da3569e","updated":"2016-08-29 19:59:39.000000000","message":"A logical network you\u0027d want to trunk may be realized with VXLAN and thus may not even have a VLAN ID associated to it, the local vlan mapping that exists in OVS is also something that is implementation specific.\n\nThat said when trunking you\u0027re looking at a different layer of multiplexing that is orthogonal to how you provide tenant isolation. The same VLAN ID used to multiplex traffic in a trunk can be reused in another trunk and to trunk another set of networks. This would not be possible if you reused the VLAN ID from the logical network.","commit_id":"89a7f668650242a48812f1969dbbd045b5058d55"},{"author":{"_account_id":8655,"name":"Jakub Libosvar","email":"libosvar@redhat.com","username":"jlibosva"},"change_message_id":"53ee1453e790c284aa2affa91565f8810e156c1c","unresolved":false,"context_lines":[{"line_number":22,"context_line":""},{"line_number":23,"context_line":"Subports belong to a trunk and also have a parent port. The network of the"},{"line_number":24,"context_line":"subport parent is the network presented by the subport. When creating a"},{"line_number":25,"context_line":"subport, a segmentation-id is required. segmentation-id defines the tagged"},{"line_number":26,"context_line":"VLAN that the parent port network will be presented to the instance as."},{"line_number":27,"context_line":"segmentation-type is must be specified, although at this time only ``vlan``"},{"line_number":28,"context_line":"is supported as a segmentation-type."}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_1425c107","line":25,"in_reply_to":"fa7ab95a_f8a79208","updated":"2016-08-30 09:24:07.000000000","message":"Aha, thanks for explanation.","commit_id":"89a7f668650242a48812f1969dbbd045b5058d55"},{"author":{"_account_id":15554,"name":"Bence Romsics","email":"bence.romsics@gmail.com","username":"ebenrom","status":"inactive contributor"},"change_message_id":"99e003dc8d1e38075341e1ef1678e9116d87eb44","unresolved":false,"context_lines":[{"line_number":24,"context_line":"subport parent is the network presented by the subport. When creating a"},{"line_number":25,"context_line":"subport, a segmentation-id is required. segmentation-id defines the tagged"},{"line_number":26,"context_line":"VLAN that the parent port network will be presented to the instance as."},{"line_number":27,"context_line":"segmentation-type is must be specified, although at this time only ``vlan``"},{"line_number":28,"context_line":"is supported as a segmentation-type."},{"line_number":29,"context_line":""},{"line_number":30,"context_line":"Example configuration"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_201e5f63","line":27,"range":{"start_line":27,"start_character":18,"end_line":27,"end_character":25},"updated":"2016-09-01 11:38:48.000000000","message":"must","commit_id":"89a7f668650242a48812f1969dbbd045b5058d55"},{"author":{"_account_id":15554,"name":"Bence Romsics","email":"bence.romsics@gmail.com","username":"ebenrom","status":"inactive contributor"},"change_message_id":"99e003dc8d1e38075341e1ef1678e9116d87eb44","unresolved":false,"context_lines":[{"line_number":27,"context_line":"segmentation-type is must be specified, although at this time only ``vlan``"},{"line_number":28,"context_line":"is supported as a segmentation-type."},{"line_number":29,"context_line":""},{"line_number":30,"context_line":"Example configuration"},{"line_number":31,"context_line":"~~~~~~~~~~~~~~~~~~~~~"},{"line_number":32,"context_line":""},{"line_number":33,"context_line":"Configuration of VLAN trunking involves only the service plugin, drivers are"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_bd9c5c5e","line":30,"range":{"start_line":30,"start_character":0,"end_line":30,"end_character":21},"updated":"2016-09-01 11:38:48.000000000","message":"Shall we have a list of mechanism drivers supporting trunks?","commit_id":"89a7f668650242a48812f1969dbbd045b5058d55"},{"author":{"_account_id":8655,"name":"Jakub Libosvar","email":"libosvar@redhat.com","username":"jlibosva"},"change_message_id":"404268b623751c0d798c7ccbbc7975ae48dcdefb","unresolved":false,"context_lines":[{"line_number":52,"context_line":"   .. code-block:: console"},{"line_number":53,"context_line":""},{"line_number":54,"context_line":"      $ neutron ext-list"},{"line_number":55,"context_line":"#TODO(tidwellr) output here showing the trunk extension"},{"line_number":56,"context_line":""},{"line_number":57,"context_line":""},{"line_number":58,"context_line":"Creating a trunk"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_3d765a06","line":55,"updated":"2016-08-29 16:19:46.000000000","message":"There you go :) http://paste.openstack.org/show/564600/","commit_id":"89a7f668650242a48812f1969dbbd045b5058d55"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"ef4a99bfbcfb370f7c9adbe29c366cbf3de4a1dc","unresolved":false,"context_lines":[{"line_number":52,"context_line":"   .. code-block:: console"},{"line_number":53,"context_line":""},{"line_number":54,"context_line":"      $ neutron ext-list"},{"line_number":55,"context_line":"#TODO(tidwellr) output here showing the trunk extension"},{"line_number":56,"context_line":""},{"line_number":57,"context_line":""},{"line_number":58,"context_line":"Creating a trunk"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_7174bb9b","line":55,"in_reply_to":"fa7ab95a_3d765a06","updated":"2016-09-01 11:54:21.000000000","message":".. TODO * will ensure it\u0027s commented out :)","commit_id":"89a7f668650242a48812f1969dbbd045b5058d55"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"ef4a99bfbcfb370f7c9adbe29c366cbf3de4a1dc","unresolved":false,"context_lines":[{"line_number":56,"context_line":""},{"line_number":57,"context_line":""},{"line_number":58,"context_line":"Creating a trunk"},{"line_number":59,"context_line":"-----------------------------------------"},{"line_number":60,"context_line":""},{"line_number":61,"context_line":"#. Create the parent port. The must have a parent port, so a port must be"},{"line_number":62,"context_line":"   created before creating the trunk."}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_91777f9e","line":59,"range":{"start_line":59,"start_character":16,"end_line":59,"end_character":41},"updated":"2016-09-01 11:54:21.000000000","message":"a wee bit long","commit_id":"89a7f668650242a48812f1969dbbd045b5058d55"},{"author":{"_account_id":8655,"name":"Jakub Libosvar","email":"libosvar@redhat.com","username":"jlibosva"},"change_message_id":"404268b623751c0d798c7ccbbc7975ae48dcdefb","unresolved":false,"context_lines":[{"line_number":58,"context_line":"Creating a trunk"},{"line_number":59,"context_line":"-----------------------------------------"},{"line_number":60,"context_line":""},{"line_number":61,"context_line":"#. Create the parent port. The must have a parent port, so a port must be"},{"line_number":62,"context_line":"   created before creating the trunk."},{"line_number":63,"context_line":""},{"line_number":64,"context_line":"   .. code-block:: console"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_fd56b25a","line":61,"range":{"start_line":61,"start_character":27,"end_line":61,"end_character":30},"updated":"2016-08-29 16:19:46.000000000","message":"Trunk ?","commit_id":"89a7f668650242a48812f1969dbbd045b5058d55"},{"author":{"_account_id":15554,"name":"Bence Romsics","email":"bence.romsics@gmail.com","username":"ebenrom","status":"inactive contributor"},"change_message_id":"99e003dc8d1e38075341e1ef1678e9116d87eb44","unresolved":false,"context_lines":[{"line_number":63,"context_line":""},{"line_number":64,"context_line":"   .. code-block:: console"},{"line_number":65,"context_line":""},{"line_number":66,"context_line":"      $ neutron port-create --name trunk-parent private"},{"line_number":67,"context_line":"#TODO(tidwellr) output here showing the port"},{"line_number":68,"context_line":""},{"line_number":69,"context_line":"#. Create the trunk. The trunk is created by specifying ``trunk-parent`` as"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_564ded70","line":66,"range":{"start_line":66,"start_character":8,"end_line":66,"end_character":55},"updated":"2016-09-01 11:38:48.000000000","message":"I have collected some examples here:\n\nhttps://wiki.openstack.org/wiki/Neutron/TrunkPort#CLI_usage_example","commit_id":"89a7f668650242a48812f1969dbbd045b5058d55"},{"author":{"_account_id":8655,"name":"Jakub Libosvar","email":"libosvar@redhat.com","username":"jlibosva"},"change_message_id":"404268b623751c0d798c7ccbbc7975ae48dcdefb","unresolved":false,"context_lines":[{"line_number":63,"context_line":""},{"line_number":64,"context_line":"   .. code-block:: console"},{"line_number":65,"context_line":""},{"line_number":66,"context_line":"      $ neutron port-create --name trunk-parent private"},{"line_number":67,"context_line":"#TODO(tidwellr) output here showing the port"},{"line_number":68,"context_line":""},{"line_number":69,"context_line":"#. Create the trunk. The trunk is created by specifying ``trunk-parent`` as"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_fd8b12c1","line":66,"range":{"start_line":66,"start_character":8,"end_line":66,"end_character":15},"updated":"2016-08-29 16:19:46.000000000","message":"Since we deprecate neutron client in Ocata, we could think ahead and use \u0027openstack port create\u0027 instead.","commit_id":"89a7f668650242a48812f1969dbbd045b5058d55"},{"author":{"_account_id":15554,"name":"Bence Romsics","email":"bence.romsics@gmail.com","username":"ebenrom","status":"inactive contributor"},"change_message_id":"99e003dc8d1e38075341e1ef1678e9116d87eb44","unresolved":false,"context_lines":[{"line_number":71,"context_line":""},{"line_number":72,"context_line":"     .. code-block:: console"},{"line_number":73,"context_line":""},{"line_number":74,"context_line":"        $ openstack network trunk create"},{"line_number":75,"context_line":"#TODO(tidwellr) output showing the trunk"},{"line_number":76,"context_line":""},{"line_number":77,"context_line":"Create subports"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_e0cab74e","line":74,"range":{"start_line":74,"start_character":10,"end_line":74,"end_character":40},"updated":"2016-09-01 11:38:48.000000000","message":"openstack network trunk create --parent-port trunk-parent","commit_id":"89a7f668650242a48812f1969dbbd045b5058d55"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"ef4a99bfbcfb370f7c9adbe29c366cbf3de4a1dc","unresolved":false,"context_lines":[{"line_number":75,"context_line":"#TODO(tidwellr) output showing the trunk"},{"line_number":76,"context_line":""},{"line_number":77,"context_line":"Create subports"},{"line_number":78,"context_line":"---------------------------------------------"},{"line_number":79,"context_line":""},{"line_number":80,"context_line":"#. Method 1: Create trunk with subports."},{"line_number":81,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_919e9fb6","line":78,"range":{"start_line":78,"start_character":15,"end_line":78,"end_character":45},"updated":"2016-09-01 11:54:21.000000000","message":"ditto","commit_id":"89a7f668650242a48812f1969dbbd045b5058d55"},{"author":{"_account_id":15554,"name":"Bence Romsics","email":"bence.romsics@gmail.com","username":"ebenrom","status":"inactive contributor"},"change_message_id":"99e003dc8d1e38075341e1ef1678e9116d87eb44","unresolved":false,"context_lines":[{"line_number":81,"context_line":""},{"line_number":82,"context_line":"   .. code-block:: console"},{"line_number":83,"context_line":""},{"line_number":84,"context_line":"      $ openstack network trunk create"},{"line_number":85,"context_line":"#TODO(tidwell) show output of trunk"},{"line_number":86,"context_line":""},{"line_number":87,"context_line":"#. Method 2: Add subports to an existing trunk."}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_e0263715","line":84,"range":{"start_line":84,"start_character":8,"end_line":84,"end_character":38},"updated":"2016-09-01 11:38:48.000000000","message":"openstack network trunk create --parent-port trunk-parent --subport port\u003dport1,segmentation-type\u003dvlan,segmentation-id\u003d101","commit_id":"89a7f668650242a48812f1969dbbd045b5058d55"},{"author":{"_account_id":15554,"name":"Bence Romsics","email":"bence.romsics@gmail.com","username":"ebenrom","status":"inactive contributor"},"change_message_id":"99e003dc8d1e38075341e1ef1678e9116d87eb44","unresolved":false,"context_lines":[{"line_number":86,"context_line":""},{"line_number":87,"context_line":"#. Method 2: Add subports to an existing trunk."},{"line_number":88,"context_line":""},{"line_number":89,"context_line":"   .. code-block:: console"},{"line_number":90,"context_line":""},{"line_number":91,"context_line":"#TODO(tidwellr) show command and output"},{"line_number":92,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_60eea78c","line":89,"range":{"start_line":89,"start_character":3,"end_line":89,"end_character":26},"updated":"2016-09-01 11:38:48.000000000","message":"openstack network trunk create --parent-port trunk-parent trunk0\nopenstack network trunk set --subport port\u003dport2,segmentation-type\u003dvlan,segmentation-id\u003d102 trunk0","commit_id":"89a7f668650242a48812f1969dbbd045b5058d55"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"3e86366f7fecacf0f8f8b0d0d622f02f8da5afee","unresolved":false,"context_lines":[{"line_number":106,"context_line":"#. Boot an instance on the trunk."},{"line_number":107,"context_line":"#TODO(tidwellr) show commands and output"},{"line_number":108,"context_line":""},{"line_number":109,"context_line":"Using trunks and subports inside an instance"},{"line_number":110,"context_line":"--------------------------------------------"},{"line_number":111,"context_line":"# TODO(tidwellr) show how to configure VLAN subinterfaces properly eg. set hw-mac-address"},{"line_number":112,"context_line":"# to the MAC of parent port of the subport"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_d823ae56","line":109,"updated":"2016-08-29 19:59:39.000000000","message":"I think in terms of content, I think this is enough to start with; perhaps we\u0027d want to add a Limitations section where we capture some of the things that may be too elaborated to describe on the release notes?","commit_id":"89a7f668650242a48812f1969dbbd045b5058d55"},{"author":{"_account_id":15554,"name":"Bence Romsics","email":"bence.romsics@gmail.com","username":"ebenrom","status":"inactive contributor"},"change_message_id":"99e003dc8d1e38075341e1ef1678e9116d87eb44","unresolved":false,"context_lines":[{"line_number":108,"context_line":""},{"line_number":109,"context_line":"Using trunks and subports inside an instance"},{"line_number":110,"context_line":"--------------------------------------------"},{"line_number":111,"context_line":"# TODO(tidwellr) show how to configure VLAN subinterfaces properly eg. set hw-mac-address"},{"line_number":112,"context_line":"# to the MAC of parent port of the subport"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_53b6dfdc","line":111,"range":{"start_line":111,"start_character":2,"end_line":111,"end_character":6},"updated":"2016-09-01 11:38:48.000000000","message":"+1 for this. I think it will confuse users unless we explain it.","commit_id":"89a7f668650242a48812f1969dbbd045b5058d55"},{"author":{"_account_id":15554,"name":"Bence Romsics","email":"bence.romsics@gmail.com","username":"ebenrom","status":"inactive contributor"},"change_message_id":"99e003dc8d1e38075341e1ef1678e9116d87eb44","unresolved":false,"context_lines":[],"source_content_type":"","patch_set":1,"id":"fa7ab95a_1307f71c","line":113,"updated":"2016-09-01 11:38:48.000000000","message":"Maybe we could add a sentence or two about various constraints.\n\n1) deletion\nParent and subports associated with a trunk cannot be deleted. The trunk must be deleted first.\n\n2) trunk create on a bound parent port\nSome mechanism drivers (eg. ovs in newton) do not support turning a port into the parent of a trunk if the port is already used by a vm. Other mechanism drivers may support this.","commit_id":"89a7f668650242a48812f1969dbbd045b5058d55"},{"author":{"_account_id":9200,"name":"IWAMOTO Toshihiro","email":"iwamoto@valinux.co.jp","username":"toshii"},"change_message_id":"8c949772655aa7a04225e082283455b10cb174cf","unresolved":false,"context_lines":[{"line_number":270,"context_line":""},{"line_number":271,"context_line":"   .. code-block:: console"},{"line_number":272,"context_line":""},{"line_number":273,"context_line":"      $ openstack server create --nic port-id\u003d61d8e620-fe3a-4d8f-b9e6-e1b0dea6d9e3 --flavor 1 --image a6ece084-0db4-4cd2-893a-70b52ef5460a"},{"line_number":274,"context_line":""},{"line_number":275,"context_line":"Using trunks and subports inside an instance"},{"line_number":276,"context_line":"--------------------------------------------"}],"source_content_type":"text/x-rst","patch_set":2,"id":"7a8ec9b2_bd0c4943","line":273,"updated":"2016-09-21 08:27:49.000000000","message":"shouldn\u0027t be the parent port id instead of the trunk id?","commit_id":"87a2507d5952a04ca79a350699d628e78ac8ffe2"},{"author":{"_account_id":4187,"name":"Ryan Tidwell","email":"rtidwell@suse.com","username":"ryan-tidwell"},"change_message_id":"7c723da353cd6f30f82b099b5ce04699370d0aa9","unresolved":false,"context_lines":[{"line_number":270,"context_line":""},{"line_number":271,"context_line":"   .. code-block:: console"},{"line_number":272,"context_line":""},{"line_number":273,"context_line":"      $ openstack server create --nic port-id\u003d61d8e620-fe3a-4d8f-b9e6-e1b0dea6d9e3 --flavor 1 --image a6ece084-0db4-4cd2-893a-70b52ef5460a"},{"line_number":274,"context_line":""},{"line_number":275,"context_line":"Using trunks and subports inside an instance"},{"line_number":276,"context_line":"--------------------------------------------"}],"source_content_type":"text/x-rst","patch_set":2,"id":"5a8bc5a2_06800046","line":273,"in_reply_to":"7a8ec9b2_bd0c4943","updated":"2016-09-27 18:41:20.000000000","message":"Yes, that is a typo.","commit_id":"87a2507d5952a04ca79a350699d628e78ac8ffe2"},{"author":{"_account_id":9200,"name":"IWAMOTO Toshihiro","email":"iwamoto@valinux.co.jp","username":"toshii"},"change_message_id":"8c949772655aa7a04225e082283455b10cb174cf","unresolved":false,"context_lines":[{"line_number":278,"context_line":"When configuring instances to use a subport, ensure that the interface on the"},{"line_number":279,"context_line":"instance is set to use the MAC address assigned to the port by neutron."},{"line_number":280,"context_line":""},{"line_number":281,"context_line":"#. Configuring cirros instance to use a subport."},{"line_number":282,"context_line":""},{"line_number":283,"context_line":"   .. code-block:: console"},{"line_number":284,"context_line":"      auto ens3.100"}],"source_content_type":"text/x-rst","patch_set":2,"id":"7a8ec9b2_ef4b7457","line":281,"updated":"2016-09-21 08:27:49.000000000","message":"I heard cirros doesn\u0027t support VLAN.","commit_id":"87a2507d5952a04ca79a350699d628e78ac8ffe2"},{"author":{"_account_id":4187,"name":"Ryan Tidwell","email":"rtidwell@suse.com","username":"ryan-tidwell"},"change_message_id":"7c723da353cd6f30f82b099b5ce04699370d0aa9","unresolved":false,"context_lines":[{"line_number":278,"context_line":"When configuring instances to use a subport, ensure that the interface on the"},{"line_number":279,"context_line":"instance is set to use the MAC address assigned to the port by neutron."},{"line_number":280,"context_line":""},{"line_number":281,"context_line":"#. Configuring cirros instance to use a subport."},{"line_number":282,"context_line":""},{"line_number":283,"context_line":"   .. code-block:: console"},{"line_number":284,"context_line":"      auto ens3.100"}],"source_content_type":"text/x-rst","patch_set":2,"id":"5a8bc5a2_c608d8dc","line":281,"in_reply_to":"7a8ec9b2_ef4b7457","updated":"2016-09-27 18:41:20.000000000","message":"Correct, should maybe mention Ubuntu and RedHat. What I wanted to express here is that VLAN subinterfaces need to have the MAC address set such that it matches the MAC address of the neutron port. This can be done by either re-using the parent port MAC address on the subports, or by setting it explicitly inside the VM.","commit_id":"87a2507d5952a04ca79a350699d628e78ac8ffe2"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"9388ee1bfb740a94877e50baa5c1bdb59cff19c8","unresolved":false,"context_lines":[{"line_number":1,"context_line":".. _config-vlan-trunking:"},{"line_number":2,"context_line":""},{"line_number":3,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":4,"context_line":"VLAN Trunking"},{"line_number":5,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":6,"context_line":""},{"line_number":7,"context_line":"# TODO(tidwellr) Let the docs experts clean up the wording once we fill out"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a95cdbc_e069218d","line":4,"updated":"2016-10-05 01:31:24.000000000","message":"I wonder if we should also use the well known (vlan-aware-vms) label here somewhere in this doc? So that the reader can get hold of additional details?\n\n[1] http://specs.openstack.org/openstack/neutron-specs/specs/newton/vlan-aware-vms.html","commit_id":"51950e0eb1cd65187479a6727d6fc604d8a0beda"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"9388ee1bfb740a94877e50baa5c1bdb59cff19c8","unresolved":false,"context_lines":[{"line_number":7,"context_line":"# TODO(tidwellr) Let the docs experts clean up the wording once we fill out"},{"line_number":8,"context_line":"# the technical content."},{"line_number":9,"context_line":""},{"line_number":10,"context_line":"The VLAN trunk service allows multiple networks to be connected to an instance"},{"line_number":11,"context_line":"using a single virtual NIC (vNIC). Multiple networks can be presented to an"},{"line_number":12,"context_line":"instance by connecting it to a single port."},{"line_number":13,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a95cdbc_00b60ddc","line":10,"updated":"2016-10-05 01:31:24.000000000","message":"shall we link the spec [1] somewhere here?","commit_id":"51950e0eb1cd65187479a6727d6fc604d8a0beda"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"9388ee1bfb740a94877e50baa5c1bdb59cff19c8","unresolved":false,"context_lines":[{"line_number":11,"context_line":"using a single virtual NIC (vNIC). Multiple networks can be presented to an"},{"line_number":12,"context_line":"instance by connecting it to a single port."},{"line_number":13,"context_line":""},{"line_number":14,"context_line":"VLAN trunking consists of a service plugin and a set of drivers"},{"line_number":15,"context_line":"that manage trunks on different L2 networking solutions (eg. OVS, linux"},{"line_number":16,"context_line":"bridge, etc.). Users can create an unbound port, associate it with a trunk,"},{"line_number":17,"context_line":"and boot instances on the unbound port. This will enable the instance access"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a95cdbc_20d86953","line":14,"updated":"2016-10-05 01:31:24.000000000","message":"I\u0027d start this phrase by saying: From a Neutron architectural point of view, but it\u0027s a nitt-y.","commit_id":"51950e0eb1cd65187479a6727d6fc604d8a0beda"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"9388ee1bfb740a94877e50baa5c1bdb59cff19c8","unresolved":false,"context_lines":[{"line_number":13,"context_line":""},{"line_number":14,"context_line":"VLAN trunking consists of a service plugin and a set of drivers"},{"line_number":15,"context_line":"that manage trunks on different L2 networking solutions (eg. OVS, linux"},{"line_number":16,"context_line":"bridge, etc.). Users can create an unbound port, associate it with a trunk,"},{"line_number":17,"context_line":"and boot instances on the unbound port. This will enable the instance access"},{"line_number":18,"context_line":"to trunk, enabling the instance to be attached and detached from networks"},{"line_number":19,"context_line":"dynamically without shutting down or re-building the instance."}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a95cdbc_208dc931","line":16,"updated":"2016-10-05 01:31:24.000000000","message":"the unbound word is kinda misleading because some drivers like LB allows you to use bound ports in trunks.","commit_id":"51950e0eb1cd65187479a6727d6fc604d8a0beda"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"9388ee1bfb740a94877e50baa5c1bdb59cff19c8","unresolved":false,"context_lines":[{"line_number":16,"context_line":"bridge, etc.). Users can create an unbound port, associate it with a trunk,"},{"line_number":17,"context_line":"and boot instances on the unbound port. This will enable the instance access"},{"line_number":18,"context_line":"to trunk, enabling the instance to be attached and detached from networks"},{"line_number":19,"context_line":"dynamically without shutting down or re-building the instance."},{"line_number":20,"context_line":""},{"line_number":21,"context_line":"Every trunk has a parent port, and can have any number of subports. The parent"},{"line_number":22,"context_line":"port is the port that the trunk is associated with. Users create instances and"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a95cdbc_6087d10f","line":19,"updated":"2016-10-05 01:31:24.000000000","message":"not only that, you can also avoid attaching/detaching vNICs.","commit_id":"51950e0eb1cd65187479a6727d6fc604d8a0beda"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"9388ee1bfb740a94877e50baa5c1bdb59cff19c8","unresolved":false,"context_lines":[{"line_number":18,"context_line":"to trunk, enabling the instance to be attached and detached from networks"},{"line_number":19,"context_line":"dynamically without shutting down or re-building the instance."},{"line_number":20,"context_line":""},{"line_number":21,"context_line":"Every trunk has a parent port, and can have any number of subports. The parent"},{"line_number":22,"context_line":"port is the port that the trunk is associated with. Users create instances and"},{"line_number":23,"context_line":"specify the parent port of the trunk when booting instances attached to a"},{"line_number":24,"context_line":"trunk. The network of the parent port is the network presented as the untagged"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a95cdbc_4099f56d","line":21,"updated":"2016-10-05 01:31:24.000000000","message":"I\u0027d put parent and subports in italic.","commit_id":"51950e0eb1cd65187479a6727d6fc604d8a0beda"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"9388ee1bfb740a94877e50baa5c1bdb59cff19c8","unresolved":false,"context_lines":[{"line_number":25,"context_line":"VLAN."},{"line_number":26,"context_line":""},{"line_number":27,"context_line":"The network presented by the subport is the network of the associated port."},{"line_number":28,"context_line":"When creating a subport, a ``segmentation-id`` is required. segmentation-id"},{"line_number":29,"context_line":"defines the tagged VLAN that the parent port network will be presented to the"},{"line_number":30,"context_line":"instance as. ``segmentation-type`` must be specified, although at this time"},{"line_number":31,"context_line":"only ``vlan`` is supported as a ``segmentation-type``."}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a95cdbc_c077c500","line":28,"updated":"2016-10-05 01:31:24.000000000","message":"even though this claim is true right now, in the future this may be relaxed and the segmentation ID may or may not be required, so I\u0027d say \u0027may be required\u0027.","commit_id":"51950e0eb1cd65187479a6727d6fc604d8a0beda"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"9388ee1bfb740a94877e50baa5c1bdb59cff19c8","unresolved":false,"context_lines":[{"line_number":27,"context_line":"The network presented by the subport is the network of the associated port."},{"line_number":28,"context_line":"When creating a subport, a ``segmentation-id`` is required. segmentation-id"},{"line_number":29,"context_line":"defines the tagged VLAN that the parent port network will be presented to the"},{"line_number":30,"context_line":"instance as. ``segmentation-type`` must be specified, although at this time"},{"line_number":31,"context_line":"only ``vlan`` is supported as a ``segmentation-type``."},{"line_number":32,"context_line":""},{"line_number":33,"context_line":"The segmentation type and id specified by the user on the subports is"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a95cdbc_605fd172","line":30,"updated":"2016-10-05 01:31:24.000000000","message":"same","commit_id":"51950e0eb1cd65187479a6727d6fc604d8a0beda"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"9388ee1bfb740a94877e50baa5c1bdb59cff19c8","unresolved":false,"context_lines":[{"line_number":30,"context_line":"instance as. ``segmentation-type`` must be specified, although at this time"},{"line_number":31,"context_line":"only ``vlan`` is supported as a ``segmentation-type``."},{"line_number":32,"context_line":""},{"line_number":33,"context_line":"The segmentation type and id specified by the user on the subports is"},{"line_number":34,"context_line":"intentionally decoupled from the segmentation type and id of neutron networks."},{"line_number":35,"context_line":"For example it is possible to configure neutron with"},{"line_number":36,"context_line":"``tenant_network_types \u003d vxlan`` and still create subports with"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a95cdbc_8054dd54","line":33,"updated":"2016-10-05 01:31:24.000000000","message":"id should be capitalized everywhere.","commit_id":"51950e0eb1cd65187479a6727d6fc604d8a0beda"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"9388ee1bfb740a94877e50baa5c1bdb59cff19c8","unresolved":false,"context_lines":[{"line_number":31,"context_line":"only ``vlan`` is supported as a ``segmentation-type``."},{"line_number":32,"context_line":""},{"line_number":33,"context_line":"The segmentation type and id specified by the user on the subports is"},{"line_number":34,"context_line":"intentionally decoupled from the segmentation type and id of neutron networks."},{"line_number":35,"context_line":"For example it is possible to configure neutron with"},{"line_number":36,"context_line":"``tenant_network_types \u003d vxlan`` and still create subports with"},{"line_number":37,"context_line":"``segmentation_type \u003d vlan``. Neutron will remap packets as needed."}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a95cdbc_e04be1ae","line":34,"updated":"2016-10-05 01:31:24.000000000","message":"Neutron","commit_id":"51950e0eb1cd65187479a6727d6fc604d8a0beda"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"9388ee1bfb740a94877e50baa5c1bdb59cff19c8","unresolved":false,"context_lines":[{"line_number":36,"context_line":"``tenant_network_types \u003d vxlan`` and still create subports with"},{"line_number":37,"context_line":"``segmentation_type \u003d vlan``. Neutron will remap packets as needed."},{"line_number":38,"context_line":""},{"line_number":39,"context_line":"#TODO(tidwellr) should we mention support for OVS and LinuxBridge with ML2?"},{"line_number":40,"context_line":""},{"line_number":41,"context_line":"Example configuration"},{"line_number":42,"context_line":"~~~~~~~~~~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a95cdbc_00c7ed12","line":39,"updated":"2016-10-05 01:31:24.000000000","message":"I think so, though it should be in a separate section.","commit_id":"51950e0eb1cd65187479a6727d6fc604d8a0beda"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"9388ee1bfb740a94877e50baa5c1bdb59cff19c8","unresolved":false,"context_lines":[{"line_number":41,"context_line":"Example configuration"},{"line_number":42,"context_line":"~~~~~~~~~~~~~~~~~~~~~"},{"line_number":43,"context_line":""},{"line_number":44,"context_line":"Configuration of VLAN trunking involves only the service plugin, drivers are"},{"line_number":45,"context_line":"automatically registered with the plugin when it loads."},{"line_number":46,"context_line":""},{"line_number":47,"context_line":"Controller node"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a95cdbc_0031ad0b","line":44,"updated":"2016-10-05 01:31:24.000000000","message":"I\u0027d say that trunk drivers available in the environment will automatically discover whether the trunk plugin is compatible with the defined L2 configuration, perhaps you can mention here that at the time of writing the following drivers for ML2 are available:\n\nopenswitch\nlinuxbridge\novn\n\nand for the trunk plugin to load successfully at least one of the three must be defined in \u0027mechanism_drivers\u0027","commit_id":"51950e0eb1cd65187479a6727d6fc604d8a0beda"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"659ef35557fad533403a563d635a344c33afa6da","unresolved":false,"context_lines":[{"line_number":62,"context_line":"   .. code-block:: console"},{"line_number":63,"context_line":""},{"line_number":64,"context_line":"      $ neutron ext-list"},{"line_number":65,"context_line":"+---------------------------+-----------------------------------------------+"},{"line_number":66,"context_line":"| alias                     | name                                          |"},{"line_number":67,"context_line":"+---------------------------+-----------------------------------------------+"},{"line_number":68,"context_line":"| default-subnetpools       | Default Subnetpools                           |"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a95cdbc_b290ca44","line":65,"updated":"2016-10-07 12:43:39.000000000","message":"This needs to be indented at the level of the line above","commit_id":"51950e0eb1cd65187479a6727d6fc604d8a0beda"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"9388ee1bfb740a94877e50baa5c1bdb59cff19c8","unresolved":false,"context_lines":[{"line_number":101,"context_line":""},{"line_number":102,"context_line":"The ``trunk`` and ``trunk-details`` extensions should be available."},{"line_number":103,"context_line":""},{"line_number":104,"context_line":"Creating a trunk"},{"line_number":105,"context_line":"-----------------------------------------"},{"line_number":106,"context_line":""},{"line_number":107,"context_line":"#. Create the parent port. The must have a parent port, so a port must be"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a95cdbc_fbfe3004","line":104,"updated":"2016-10-05 01:31:24.000000000","message":"before diving into the actual list of commands and outputs, I\u0027d simplify the workflow at high level. For example the use case is creating a VM that connects to Network A, B, and C. A is the untagged traffic, then you do:\n\n a) create networks A, B, C\n b) create ports Pa, Pb, Pc\n d) create trunk with parent Pa, and subports Pb, Pc\n c) boot VM on port Pa\n e) enjoy\n\nAt least the untagged network and the respective port must be created to create a trunk. A trunk can be created without subports, which may be edited separately, even after the VM has booted.","commit_id":"51950e0eb1cd65187479a6727d6fc604d8a0beda"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"5d69839caac25d7f7426bc451e33f9adca29b836","unresolved":false,"context_lines":[{"line_number":101,"context_line":""},{"line_number":102,"context_line":"The ``trunk`` and ``trunk-details`` extensions should be available."},{"line_number":103,"context_line":""},{"line_number":104,"context_line":"Creating a trunk"},{"line_number":105,"context_line":"-----------------------------------------"},{"line_number":106,"context_line":""},{"line_number":107,"context_line":"#. Create the parent port. The must have a parent port, so a port must be"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a95cdbc_2138dcee","line":104,"in_reply_to":"1a95cdbc_d2fba0bf","updated":"2016-10-07 17:32:23.000000000","message":"e) is out of scope of the doc that\u0027s why I left it out.","commit_id":"51950e0eb1cd65187479a6727d6fc604d8a0beda"},{"author":{"_account_id":15554,"name":"Bence Romsics","email":"bence.romsics@gmail.com","username":"ebenrom","status":"inactive contributor"},"change_message_id":"1857adbbafd0fb8b7e4f1a8b78399a945837ef17","unresolved":false,"context_lines":[{"line_number":101,"context_line":""},{"line_number":102,"context_line":"The ``trunk`` and ``trunk-details`` extensions should be available."},{"line_number":103,"context_line":""},{"line_number":104,"context_line":"Creating a trunk"},{"line_number":105,"context_line":"-----------------------------------------"},{"line_number":106,"context_line":""},{"line_number":107,"context_line":"#. Create the parent port. The must have a parent port, so a port must be"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a95cdbc_d2fba0bf","line":104,"in_reply_to":"1a95cdbc_fbfe3004","updated":"2016-10-07 08:12:40.000000000","message":"I\u0027d say even the overview should contain something about the bringup of the subport vlan interfaces, otherwise we\u0027ll have confused users, like:\n\nd) boot VM on port Pa\ne) configure vlan interfaces (and their mac addresses) inside the instance\nf) enjoy","commit_id":"51950e0eb1cd65187479a6727d6fc604d8a0beda"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"9388ee1bfb740a94877e50baa5c1bdb59cff19c8","unresolved":false,"context_lines":[{"line_number":102,"context_line":"The ``trunk`` and ``trunk-details`` extensions should be available."},{"line_number":103,"context_line":""},{"line_number":104,"context_line":"Creating a trunk"},{"line_number":105,"context_line":"-----------------------------------------"},{"line_number":106,"context_line":""},{"line_number":107,"context_line":"#. Create the parent port. The must have a parent port, so a port must be"},{"line_number":108,"context_line":"   created before creating the trunk."}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a95cdbc_e02cc1ad","line":105,"updated":"2016-10-05 01:31:24.000000000","message":"aren\u0027t they too many dashes?","commit_id":"51950e0eb1cd65187479a6727d6fc604d8a0beda"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"659ef35557fad533403a563d635a344c33afa6da","unresolved":false,"context_lines":[{"line_number":102,"context_line":"The ``trunk`` and ``trunk-details`` extensions should be available."},{"line_number":103,"context_line":""},{"line_number":104,"context_line":"Creating a trunk"},{"line_number":105,"context_line":"-----------------------------------------"},{"line_number":106,"context_line":""},{"line_number":107,"context_line":"#. Create the parent port. The must have a parent port, so a port must be"},{"line_number":108,"context_line":"   created before creating the trunk."}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a95cdbc_129c1e5c","line":105,"in_reply_to":"1a95cdbc_e02cc1ad","updated":"2016-10-07 12:43:39.000000000","message":"they are :)","commit_id":"51950e0eb1cd65187479a6727d6fc604d8a0beda"},{"author":{"_account_id":17130,"name":"melissaml","email":"ma.lei@99cloud.net","username":"malei"},"change_message_id":"823dbff456837dfd26cf787797a6be9a041dda9d","unresolved":false,"context_lines":[{"line_number":104,"context_line":"Creating a trunk"},{"line_number":105,"context_line":"-----------------------------------------"},{"line_number":106,"context_line":""},{"line_number":107,"context_line":"#. Create the parent port. The must have a parent port, so a port must be"},{"line_number":108,"context_line":"   created before creating the trunk."},{"line_number":109,"context_line":""},{"line_number":110,"context_line":"   .. code-block:: console"}],"source_content_type":"text/x-rst","patch_set":3,"id":"fa6399be_fde45c3c","line":107,"range":{"start_line":107,"start_character":27,"end_line":107,"end_character":31},"updated":"2016-10-11 14:43:23.000000000","message":"The trunk","commit_id":"51950e0eb1cd65187479a6727d6fc604d8a0beda"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"9388ee1bfb740a94877e50baa5c1bdb59cff19c8","unresolved":false,"context_lines":[{"line_number":104,"context_line":"Creating a trunk"},{"line_number":105,"context_line":"-----------------------------------------"},{"line_number":106,"context_line":""},{"line_number":107,"context_line":"#. Create the parent port. The must have a parent port, so a port must be"},{"line_number":108,"context_line":"   created before creating the trunk."},{"line_number":109,"context_line":""},{"line_number":110,"context_line":"   .. code-block:: console"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a95cdbc_a022b9b7","line":107,"updated":"2016-10-05 01:31:24.000000000","message":"missing trunk word","commit_id":"51950e0eb1cd65187479a6727d6fc604d8a0beda"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"659ef35557fad533403a563d635a344c33afa6da","unresolved":false,"context_lines":[{"line_number":110,"context_line":"   .. code-block:: console"},{"line_number":111,"context_line":""},{"line_number":112,"context_line":"      $ openstack port create --network tenant-net trunk"},{"line_number":113,"context_line":"+-----------------------+-----------------------------------------------------------------------------------------------------+"},{"line_number":114,"context_line":"| Field                 | Value                                                                                               |"},{"line_number":115,"context_line":"+-----------------------+-----------------------------------------------------------------------------------------------------+"},{"line_number":116,"context_line":"| admin_state_up        | UP                                                                                                  |"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a95cdbc_92a82e79","line":113,"updated":"2016-10-07 12:43:39.000000000","message":"ditto L65","commit_id":"51950e0eb1cd65187479a6727d6fc604d8a0beda"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"659ef35557fad533403a563d635a344c33afa6da","unresolved":false,"context_lines":[{"line_number":148,"context_line":"     .. code-block:: console"},{"line_number":149,"context_line":""},{"line_number":150,"context_line":"        $ openstack network trunk create --parent-port 73fb9d54-43a7-4bb1-a8dc-569e0e0a0a38 trunk"},{"line_number":151,"context_line":"+-----------------+--------------------------------------+"},{"line_number":152,"context_line":"| Field           | Value                                |"},{"line_number":153,"context_line":"+-----------------+--------------------------------------+"},{"line_number":154,"context_line":"| admin_state_up  | UP                                   |"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a95cdbc_12b33eea","line":151,"updated":"2016-10-07 12:43:39.000000000","message":"ditto L65","commit_id":"51950e0eb1cd65187479a6727d6fc604d8a0beda"},{"author":{"_account_id":17130,"name":"melissaml","email":"ma.lei@99cloud.net","username":"malei"},"change_message_id":"823dbff456837dfd26cf787797a6be9a041dda9d","unresolved":false,"context_lines":[{"line_number":164,"context_line":"| updated_at      | 2016-09-13T21:21:44Z                 |"},{"line_number":165,"context_line":"+-----------------+--------------------------------------+"},{"line_number":166,"context_line":""},{"line_number":167,"context_line":"Create subports"},{"line_number":168,"context_line":"---------------------------------------------"},{"line_number":169,"context_line":""},{"line_number":170,"context_line":"#. Method 1: Create trunk with subports."}],"source_content_type":"text/x-rst","patch_set":3,"id":"fa6399be_bdc74444","line":167,"range":{"start_line":167,"start_character":0,"end_line":167,"end_character":6},"updated":"2016-10-11 14:43:23.000000000","message":"Creating subports  ( the same format with L104 )","commit_id":"51950e0eb1cd65187479a6727d6fc604d8a0beda"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"659ef35557fad533403a563d635a344c33afa6da","unresolved":false,"context_lines":[{"line_number":165,"context_line":"+-----------------+--------------------------------------+"},{"line_number":166,"context_line":""},{"line_number":167,"context_line":"Create subports"},{"line_number":168,"context_line":"---------------------------------------------"},{"line_number":169,"context_line":""},{"line_number":170,"context_line":"#. Method 1: Create trunk with subports."},{"line_number":171,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a95cdbc_d2e396d7","line":168,"updated":"2016-10-07 12:43:39.000000000","message":"Too many dashes","commit_id":"51950e0eb1cd65187479a6727d6fc604d8a0beda"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"659ef35557fad533403a563d635a344c33afa6da","unresolved":false,"context_lines":[{"line_number":172,"context_line":"   .. code-block:: console"},{"line_number":173,"context_line":""},{"line_number":174,"context_line":"      $ openstack port create --network tenant-net trunk-parent"},{"line_number":175,"context_line":"+-----------------------+-----------------------------------------------------------------------------------------------------+"},{"line_number":176,"context_line":"| Field                 | Value                                                                                               |"},{"line_number":177,"context_line":"+-----------------------+-----------------------------------------------------------------------------------------------------+"},{"line_number":178,"context_line":"| admin_state_up        | UP                                                                                                  |"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a95cdbc_52c94658","line":175,"updated":"2016-10-07 12:43:39.000000000","message":"ditto L65","commit_id":"51950e0eb1cd65187479a6727d6fc604d8a0beda"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"659ef35557fad533403a563d635a344c33afa6da","unresolved":false,"context_lines":[{"line_number":205,"context_line":""},{"line_number":206,"context_line":""},{"line_number":207,"context_line":"      $ openstack port create --network trunked-net subport1"},{"line_number":208,"context_line":"+-----------------------+----------------------------------------------------------------------------+"},{"line_number":209,"context_line":"| Field                 | Value                                                                      |"},{"line_number":210,"context_line":"+-----------------------+----------------------------------------------------------------------------+"},{"line_number":211,"context_line":"| admin_state_up        | UP                                                                         |"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a95cdbc_32d3da05","line":208,"updated":"2016-10-07 12:43:39.000000000","message":"ditto L65","commit_id":"51950e0eb1cd65187479a6727d6fc604d8a0beda"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"659ef35557fad533403a563d635a344c33afa6da","unresolved":false,"context_lines":[{"line_number":237,"context_line":"+-----------------------+----------------------------------------------------------------------------+"},{"line_number":238,"context_line":""},{"line_number":239,"context_line":""},{"line_number":240,"context_line":"      $ openstack network trunk create --parent-port 73fb9d54-43a7-4bb1-a8dc-569e0e0a0a38 --subport port\u003d91f9dde8-80a4-4506-b5da-c287feb8f5d8,segmentation-type\u003dvlan,segmentation-id\u003d100"},{"line_number":241,"context_line":""},{"line_number":242,"context_line":"+-----------------+-------------------------------------------------------------------------------------------------+"},{"line_number":243,"context_line":"| Field           | Value                                                                                           |"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a95cdbc_f2097285","line":240,"updated":"2016-10-07 12:43:39.000000000","message":"escape this with a \u0027\\\u0027 before it gets to 79 chars and continue on the next line","commit_id":"51950e0eb1cd65187479a6727d6fc604d8a0beda"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"659ef35557fad533403a563d635a344c33afa6da","unresolved":false,"context_lines":[{"line_number":238,"context_line":""},{"line_number":239,"context_line":""},{"line_number":240,"context_line":"      $ openstack network trunk create --parent-port 73fb9d54-43a7-4bb1-a8dc-569e0e0a0a38 --subport port\u003d91f9dde8-80a4-4506-b5da-c287feb8f5d8,segmentation-type\u003dvlan,segmentation-id\u003d100"},{"line_number":241,"context_line":""},{"line_number":242,"context_line":"+-----------------+-------------------------------------------------------------------------------------------------+"},{"line_number":243,"context_line":"| Field           | Value                                                                                           |"},{"line_number":244,"context_line":"+-----------------+-------------------------------------------------------------------------------------------------+"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a95cdbc_d2663650","line":241,"updated":"2016-10-07 12:43:39.000000000","message":"remove whitespace line","commit_id":"51950e0eb1cd65187479a6727d6fc604d8a0beda"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"659ef35557fad533403a563d635a344c33afa6da","unresolved":false,"context_lines":[{"line_number":239,"context_line":""},{"line_number":240,"context_line":"      $ openstack network trunk create --parent-port 73fb9d54-43a7-4bb1-a8dc-569e0e0a0a38 --subport port\u003d91f9dde8-80a4-4506-b5da-c287feb8f5d8,segmentation-type\u003dvlan,segmentation-id\u003d100"},{"line_number":241,"context_line":""},{"line_number":242,"context_line":"+-----------------+-------------------------------------------------------------------------------------------------+"},{"line_number":243,"context_line":"| Field           | Value                                                                                           |"},{"line_number":244,"context_line":"+-----------------+-------------------------------------------------------------------------------------------------+"},{"line_number":245,"context_line":"| admin_state_up  | UP                                                                                              |"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a95cdbc_52d066f6","line":242,"updated":"2016-10-07 12:43:39.000000000","message":"ditto L65","commit_id":"51950e0eb1cd65187479a6727d6fc604d8a0beda"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"659ef35557fad533403a563d635a344c33afa6da","unresolved":false,"context_lines":[{"line_number":260,"context_line":""},{"line_number":261,"context_line":"   .. code-block:: console"},{"line_number":262,"context_line":""},{"line_number":263,"context_line":"      $ openstack network trunk set --subport port\u003d91f9dde8-80a4-4506-b5da-c287feb8f5d8,segmentation-type\u003dvlan,segmentation-id\u003d100 61d8e620-fe3a-4d8f-b9e6-e1b0dea6d9e3"},{"line_number":264,"context_line":""},{"line_number":265,"context_line":"      $ openstack network trunk show 61d8e620-fe3a-4d8f-b9e6-e1b0dea6d9e3"},{"line_number":266,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a95cdbc_32dd9ae0","line":263,"updated":"2016-10-07 12:43:39.000000000","message":"ditto L240","commit_id":"51950e0eb1cd65187479a6727d6fc604d8a0beda"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"659ef35557fad533403a563d635a344c33afa6da","unresolved":false,"context_lines":[{"line_number":263,"context_line":"      $ openstack network trunk set --subport port\u003d91f9dde8-80a4-4506-b5da-c287feb8f5d8,segmentation-type\u003dvlan,segmentation-id\u003d100 61d8e620-fe3a-4d8f-b9e6-e1b0dea6d9e3"},{"line_number":264,"context_line":""},{"line_number":265,"context_line":"      $ openstack network trunk show 61d8e620-fe3a-4d8f-b9e6-e1b0dea6d9e3"},{"line_number":266,"context_line":""},{"line_number":267,"context_line":"+-----------------+-------------------------------------------------------------------------------------------------+"},{"line_number":268,"context_line":"| Field           | Value                                                                                           |"},{"line_number":269,"context_line":"+-----------------+-------------------------------------------------------------------------------------------------+"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a95cdbc_b2efea85","line":266,"updated":"2016-10-07 12:43:39.000000000","message":"remove whitespace line","commit_id":"51950e0eb1cd65187479a6727d6fc604d8a0beda"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"659ef35557fad533403a563d635a344c33afa6da","unresolved":false,"context_lines":[{"line_number":264,"context_line":""},{"line_number":265,"context_line":"      $ openstack network trunk show 61d8e620-fe3a-4d8f-b9e6-e1b0dea6d9e3"},{"line_number":266,"context_line":""},{"line_number":267,"context_line":"+-----------------+-------------------------------------------------------------------------------------------------+"},{"line_number":268,"context_line":"| Field           | Value                                                                                           |"},{"line_number":269,"context_line":"+-----------------+-------------------------------------------------------------------------------------------------+"},{"line_number":270,"context_line":"| admin_state_up  | UP                                                                                              |"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a95cdbc_5253066b","line":267,"updated":"2016-10-07 12:43:39.000000000","message":"ditto L65","commit_id":"51950e0eb1cd65187479a6727d6fc604d8a0beda"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"9388ee1bfb740a94877e50baa5c1bdb59cff19c8","unresolved":false,"context_lines":[{"line_number":280,"context_line":"| updated_at      | 2016-09-13T21:35:01Z                                                                            |"},{"line_number":281,"context_line":"+-----------------+-------------------------------------------------------------------------------------------------+"},{"line_number":282,"context_line":""},{"line_number":283,"context_line":"Booting an instance on a trunk"},{"line_number":284,"context_line":"------------------------------"},{"line_number":285,"context_line":""},{"line_number":286,"context_line":"#. Show trunk details on the parent port."}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a95cdbc_db1a546e","line":283,"updated":"2016-10-05 01:31:24.000000000","message":"is something missing here?","commit_id":"51950e0eb1cd65187479a6727d6fc604d8a0beda"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"659ef35557fad533403a563d635a344c33afa6da","unresolved":false,"context_lines":[{"line_number":288,"context_line":"   .. code-block:: console"},{"line_number":289,"context_line":""},{"line_number":290,"context_line":"      $ openstack network trunk show 61d8e620-fe3a-4d8f-b9e6-e1b0dea6d9e3"},{"line_number":291,"context_line":""},{"line_number":292,"context_line":"+-----------------+-------------------------------------------------------------------------------------------------+"},{"line_number":293,"context_line":"| Field           | Value                                                                                           |"},{"line_number":294,"context_line":"+-----------------+-------------------------------------------------------------------------------------------------+"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a95cdbc_f2e5f2a3","line":291,"updated":"2016-10-07 12:43:39.000000000","message":"remove whitespace line","commit_id":"51950e0eb1cd65187479a6727d6fc604d8a0beda"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"659ef35557fad533403a563d635a344c33afa6da","unresolved":false,"context_lines":[{"line_number":289,"context_line":""},{"line_number":290,"context_line":"      $ openstack network trunk show 61d8e620-fe3a-4d8f-b9e6-e1b0dea6d9e3"},{"line_number":291,"context_line":""},{"line_number":292,"context_line":"+-----------------+-------------------------------------------------------------------------------------------------+"},{"line_number":293,"context_line":"| Field           | Value                                                                                           |"},{"line_number":294,"context_line":"+-----------------+-------------------------------------------------------------------------------------------------+"},{"line_number":295,"context_line":"| admin_state_up  | UP                                                                                              |"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a95cdbc_92490eba","line":292,"updated":"2016-10-07 12:43:39.000000000","message":"ditto L65","commit_id":"51950e0eb1cd65187479a6727d6fc604d8a0beda"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"659ef35557fad533403a563d635a344c33afa6da","unresolved":false,"context_lines":[{"line_number":309,"context_line":""},{"line_number":310,"context_line":"   .. code-block:: console"},{"line_number":311,"context_line":""},{"line_number":312,"context_line":"      $ openstack network trunk set --subport port\u003d91f9dde8-80a4-4506-b5da-c287feb8f5d8,segmentation-type\u003dvlan,segmentation-id\u003d100 61d8e620-fe3a-4d8f-b9e6-e1b0dea6d9e3"},{"line_number":313,"context_line":""},{"line_number":314,"context_line":"#. Boot an instance on the trunk."},{"line_number":315,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a95cdbc_12eb3e79","line":312,"updated":"2016-10-07 12:43:39.000000000","message":"ditto L240","commit_id":"51950e0eb1cd65187479a6727d6fc604d8a0beda"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"659ef35557fad533403a563d635a344c33afa6da","unresolved":false,"context_lines":[{"line_number":315,"context_line":""},{"line_number":316,"context_line":"   .. code-block:: console"},{"line_number":317,"context_line":""},{"line_number":318,"context_line":"      $ openstack server create --nic port-id\u003d73fb9d54-43a7-4bb1-a8dc-569e0e0a0a38 --flavor 1 --image a6ece084-0db4-4cd2-893a-70b52ef5460a my-instance"},{"line_number":319,"context_line":""},{"line_number":320,"context_line":"Using trunks and subports inside an instance"},{"line_number":321,"context_line":"--------------------------------------------"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a95cdbc_3204ba48","line":318,"updated":"2016-10-07 12:43:39.000000000","message":"ditto L240","commit_id":"51950e0eb1cd65187479a6727d6fc604d8a0beda"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"9388ee1bfb740a94877e50baa5c1bdb59cff19c8","unresolved":false,"context_lines":[{"line_number":317,"context_line":""},{"line_number":318,"context_line":"      $ openstack server create --nic port-id\u003d73fb9d54-43a7-4bb1-a8dc-569e0e0a0a38 --flavor 1 --image a6ece084-0db4-4cd2-893a-70b52ef5460a my-instance"},{"line_number":319,"context_line":""},{"line_number":320,"context_line":"Using trunks and subports inside an instance"},{"line_number":321,"context_line":"--------------------------------------------"},{"line_number":322,"context_line":""},{"line_number":323,"context_line":"When configuring instances to use a subport, ensure that the interface on the"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a95cdbc_7b414039","line":320,"updated":"2016-10-05 01:31:24.000000000","message":"there\u0027s more that should be added here:\n\nhttp://lists.openstack.org/pipermail/openstack-dev/2016-September/104848.html","commit_id":"51950e0eb1cd65187479a6727d6fc604d8a0beda"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"9388ee1bfb740a94877e50baa5c1bdb59cff19c8","unresolved":false,"context_lines":[{"line_number":319,"context_line":""},{"line_number":320,"context_line":"Using trunks and subports inside an instance"},{"line_number":321,"context_line":"--------------------------------------------"},{"line_number":322,"context_line":""},{"line_number":323,"context_line":"When configuring instances to use a subport, ensure that the interface on the"},{"line_number":324,"context_line":"instance is set to use the MAC address assigned to the port by neutron. When"},{"line_number":325,"context_line":"creating subports, the MAC address of the trunk parent port can be set on the"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a95cdbc_db48945e","line":322,"updated":"2016-10-05 01:31:24.000000000","message":"do we want to mention a few words on the state and admin_state of a trunk?","commit_id":"51950e0eb1cd65187479a6727d6fc604d8a0beda"},{"author":{"_account_id":4187,"name":"Ryan Tidwell","email":"rtidwell@suse.com","username":"ryan-tidwell"},"change_message_id":"606da59a96a867758b86195f645a6f04f18b40ff","unresolved":false,"context_lines":[{"line_number":324,"context_line":"instance is set to use the MAC address assigned to the port by neutron. When"},{"line_number":325,"context_line":"creating subports, the MAC address of the trunk parent port can be set on the"},{"line_number":326,"context_line":"subport. This will allow VLAN subinterfaces inside an instance booted on a"},{"line_number":327,"context_line":"trunk to be configured without explicitly setting a MAC address."}],"source_content_type":"text/x-rst","patch_set":3,"id":"5a8bc5a2_4953f46c","line":327,"updated":"2016-09-27 21:06:26.000000000","message":"I don\u0027t have the link to the bug, but I think there may be an issue related to security groups with the native OVS firewall driver.","commit_id":"51950e0eb1cd65187479a6727d6fc604d8a0beda"},{"author":{"_account_id":4187,"name":"Ryan Tidwell","email":"rtidwell@suse.com","username":"ryan-tidwell"},"change_message_id":"bcdd3db4e26e91e77412c06a5bda7bcaeef2e116","unresolved":false,"context_lines":[{"line_number":324,"context_line":"instance is set to use the MAC address assigned to the port by neutron. When"},{"line_number":325,"context_line":"creating subports, the MAC address of the trunk parent port can be set on the"},{"line_number":326,"context_line":"subport. This will allow VLAN subinterfaces inside an instance booted on a"},{"line_number":327,"context_line":"trunk to be configured without explicitly setting a MAC address."}],"source_content_type":"text/x-rst","patch_set":3,"id":"5a8bc5a2_5f5ac651","line":327,"in_reply_to":"5a8bc5a2_4953f46c","updated":"2016-09-27 21:46:22.000000000","message":"Here it is https://bugs.launchpad.net/neutron/+bug/1626010","commit_id":"51950e0eb1cd65187479a6727d6fc604d8a0beda"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"6ba2c2aea62ddc519ae7d99fe7b5634e366318ec","unresolved":false,"context_lines":[{"line_number":12,"context_line":"instance by connecting it to a single port."},{"line_number":13,"context_line":""},{"line_number":14,"context_line":"VLAN trunking consists of a service plugin and a set of drivers"},{"line_number":15,"context_line":"that manage trunks on different L2 networking solutions (eg. OVS, linux"},{"line_number":16,"context_line":"bridge, etc.). Users can create a port, associate it with a trunk,"},{"line_number":17,"context_line":"and boot instances on that port. This will give the instance access to"},{"line_number":18,"context_line":"a trunk, enabling the instance to be attached and detached from networks"}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_25b095f4","line":15,"range":{"start_line":15,"start_character":57,"end_line":15,"end_character":59},"updated":"2016-11-07 14:32:43.000000000","message":"Use \"for example\"","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"6ba2c2aea62ddc519ae7d99fe7b5634e366318ec","unresolved":false,"context_lines":[{"line_number":13,"context_line":""},{"line_number":14,"context_line":"VLAN trunking consists of a service plugin and a set of drivers"},{"line_number":15,"context_line":"that manage trunks on different L2 networking solutions (eg. OVS, linux"},{"line_number":16,"context_line":"bridge, etc.). Users can create a port, associate it with a trunk,"},{"line_number":17,"context_line":"and boot instances on that port. This will give the instance access to"},{"line_number":18,"context_line":"a trunk, enabling the instance to be attached and detached from networks"},{"line_number":19,"context_line":"dynamically without shutting down, re-building, or attaching/detaching"}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_859fa15e","line":16,"range":{"start_line":16,"start_character":8,"end_line":16,"end_character":12},"updated":"2016-11-07 14:32:43.000000000","message":"avoid \u0027etc\u0027 - use \u0027and so on\u0027 or complete the example.","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"6ba2c2aea62ddc519ae7d99fe7b5634e366318ec","unresolved":false,"context_lines":[{"line_number":16,"context_line":"bridge, etc.). Users can create a port, associate it with a trunk,"},{"line_number":17,"context_line":"and boot instances on that port. This will give the instance access to"},{"line_number":18,"context_line":"a trunk, enabling the instance to be attached and detached from networks"},{"line_number":19,"context_line":"dynamically without shutting down, re-building, or attaching/detaching"},{"line_number":20,"context_line":"vNIC\u0027s to the instance."},{"line_number":21,"context_line":""},{"line_number":22,"context_line":"Every trunk has a ``parent`` port, and can have any number of ``subports``."}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_e58cdd37","line":19,"range":{"start_line":19,"start_character":60,"end_line":19,"end_character":61},"updated":"2016-11-07 14:32:43.000000000","message":"attaching and detaching *","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"6ba2c2aea62ddc519ae7d99fe7b5634e366318ec","unresolved":false,"context_lines":[{"line_number":19,"context_line":"dynamically without shutting down, re-building, or attaching/detaching"},{"line_number":20,"context_line":"vNIC\u0027s to the instance."},{"line_number":21,"context_line":""},{"line_number":22,"context_line":"Every trunk has a ``parent`` port, and can have any number of ``subports``."},{"line_number":23,"context_line":"The ``parent`` port is the port that the trunk is associated with. Users"},{"line_number":24,"context_line":"create instances and specify the ``parent`` port of the trunk when booting"},{"line_number":25,"context_line":"instances attached to a trunk. The network of the ``parent`` port is the"}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_45d109fb","line":22,"range":{"start_line":22,"start_character":18,"end_line":22,"end_character":28},"updated":"2016-11-07 14:32:43.000000000","message":"I\u0027m not too sure why all the instances of parent are in the double back ticks? Is this a name of the port? If not, remove the double back ticks. It\u0027s unnecessary and looks like scare quotes.","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"6ba2c2aea62ddc519ae7d99fe7b5634e366318ec","unresolved":false,"context_lines":[{"line_number":19,"context_line":"dynamically without shutting down, re-building, or attaching/detaching"},{"line_number":20,"context_line":"vNIC\u0027s to the instance."},{"line_number":21,"context_line":""},{"line_number":22,"context_line":"Every trunk has a ``parent`` port, and can have any number of ``subports``."},{"line_number":23,"context_line":"The ``parent`` port is the port that the trunk is associated with. Users"},{"line_number":24,"context_line":"create instances and specify the ``parent`` port of the trunk when booting"},{"line_number":25,"context_line":"instances attached to a trunk. The network of the ``parent`` port is the"}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_a5d8251f","line":22,"range":{"start_line":22,"start_character":62,"end_line":22,"end_character":74},"updated":"2016-11-07 14:32:43.000000000","message":"ditto.","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"bd22c363502457030ed769d29a9c798b863397a5","unresolved":false,"context_lines":[{"line_number":25,"context_line":"instances attached to a trunk. The network of the ``parent`` port is the"},{"line_number":26,"context_line":"network presented as the untagged VLAN."},{"line_number":27,"context_line":""},{"line_number":28,"context_line":"The network presented by the subport is the network of the associated port."},{"line_number":29,"context_line":"When creating a subport, a ``segmentation-id`` may be required by the driver."},{"line_number":30,"context_line":"``segmentation-id`` defines the tagged VLAN that the parent port network"},{"line_number":31,"context_line":"will be presented to the instance as. ``segmentation-type`` may be"}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_a3c10531","line":28,"range":{"start_line":28,"start_character":29,"end_line":28,"end_character":36},"updated":"2016-11-07 13:55:00.000000000","message":"``subport``","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"6ba2c2aea62ddc519ae7d99fe7b5634e366318ec","unresolved":false,"context_lines":[{"line_number":25,"context_line":"instances attached to a trunk. The network of the ``parent`` port is the"},{"line_number":26,"context_line":"network presented as the untagged VLAN."},{"line_number":27,"context_line":""},{"line_number":28,"context_line":"The network presented by the subport is the network of the associated port."},{"line_number":29,"context_line":"When creating a subport, a ``segmentation-id`` may be required by the driver."},{"line_number":30,"context_line":"``segmentation-id`` defines the tagged VLAN that the parent port network"},{"line_number":31,"context_line":"will be presented to the instance as. ``segmentation-type`` may be"}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_058391cd","line":28,"range":{"start_line":28,"start_character":29,"end_line":28,"end_character":36},"in_reply_to":"9a629dbe_a3c10531","updated":"2016-11-07 14:32:43.000000000","message":"Applicable if the above is applicable ^^ let\u0027s work on consistency.","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"6ba2c2aea62ddc519ae7d99fe7b5634e366318ec","unresolved":false,"context_lines":[{"line_number":26,"context_line":"network presented as the untagged VLAN."},{"line_number":27,"context_line":""},{"line_number":28,"context_line":"The network presented by the subport is the network of the associated port."},{"line_number":29,"context_line":"When creating a subport, a ``segmentation-id`` may be required by the driver."},{"line_number":30,"context_line":"``segmentation-id`` defines the tagged VLAN that the parent port network"},{"line_number":31,"context_line":"will be presented to the instance as. ``segmentation-type`` may be"},{"line_number":32,"context_line":"required by certain drivers like OVS, although at this time only ``vlan``"}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_255fb573","line":29,"range":{"start_line":29,"start_character":27,"end_line":29,"end_character":46},"updated":"2016-11-07 14:32:43.000000000","message":"I\u0027m unsure why this is in backticks too...","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"ee5fccce09e5b8b87ba63428bab3dc297d28afb0","unresolved":false,"context_lines":[{"line_number":26,"context_line":"network presented as the untagged VLAN."},{"line_number":27,"context_line":""},{"line_number":28,"context_line":"The network presented by the subport is the network of the associated port."},{"line_number":29,"context_line":"When creating a subport, a ``segmentation-id`` may be required by the driver."},{"line_number":30,"context_line":"``segmentation-id`` defines the tagged VLAN that the parent port network"},{"line_number":31,"context_line":"will be presented to the instance as. ``segmentation-type`` may be"},{"line_number":32,"context_line":"required by certain drivers like OVS, although at this time only ``vlan``"}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_ec4cc578","line":29,"range":{"start_line":29,"start_character":27,"end_line":29,"end_character":46},"in_reply_to":"9a629dbe_255fb573","updated":"2016-11-07 14:33:10.000000000","message":"I remember now. Ignore this, haha.","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"bd22c363502457030ed769d29a9c798b863397a5","unresolved":false,"context_lines":[{"line_number":27,"context_line":""},{"line_number":28,"context_line":"The network presented by the subport is the network of the associated port."},{"line_number":29,"context_line":"When creating a subport, a ``segmentation-id`` may be required by the driver."},{"line_number":30,"context_line":"``segmentation-id`` defines the tagged VLAN that the parent port network"},{"line_number":31,"context_line":"will be presented to the instance as. ``segmentation-type`` may be"},{"line_number":32,"context_line":"required by certain drivers like OVS, although at this time only ``vlan``"},{"line_number":33,"context_line":"is supported as a ``segmentation-type``."}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_e3085d94","line":30,"range":{"start_line":30,"start_character":53,"end_line":30,"end_character":59},"updated":"2016-11-07 13:55:00.000000000","message":"``parent``","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"bd22c363502457030ed769d29a9c798b863397a5","unresolved":false,"context_lines":[{"line_number":32,"context_line":"required by certain drivers like OVS, although at this time only ``vlan``"},{"line_number":33,"context_line":"is supported as a ``segmentation-type``."},{"line_number":34,"context_line":""},{"line_number":35,"context_line":"The segmentation type and ID specified by the user on the subports is"},{"line_number":36,"context_line":"intentionally decoupled from the segmentation type and id of neutron networks."},{"line_number":37,"context_line":"For example it is possible to configure neutron with"},{"line_number":38,"context_line":"``tenant_network_types \u003d vxlan`` and still create subports with"}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_834961d3","line":35,"range":{"start_line":35,"start_character":4,"end_line":35,"end_character":21},"updated":"2016-11-07 13:55:00.000000000","message":"``segmentation-type``","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"bd22c363502457030ed769d29a9c798b863397a5","unresolved":false,"context_lines":[{"line_number":32,"context_line":"required by certain drivers like OVS, although at this time only ``vlan``"},{"line_number":33,"context_line":"is supported as a ``segmentation-type``."},{"line_number":34,"context_line":""},{"line_number":35,"context_line":"The segmentation type and ID specified by the user on the subports is"},{"line_number":36,"context_line":"intentionally decoupled from the segmentation type and id of neutron networks."},{"line_number":37,"context_line":"For example it is possible to configure neutron with"},{"line_number":38,"context_line":"``tenant_network_types \u003d vxlan`` and still create subports with"}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_63d8cdf0","line":35,"range":{"start_line":35,"start_character":58,"end_line":35,"end_character":66},"updated":"2016-11-07 13:55:00.000000000","message":"``subports``","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"bd22c363502457030ed769d29a9c798b863397a5","unresolved":false,"context_lines":[{"line_number":33,"context_line":"is supported as a ``segmentation-type``."},{"line_number":34,"context_line":""},{"line_number":35,"context_line":"The segmentation type and ID specified by the user on the subports is"},{"line_number":36,"context_line":"intentionally decoupled from the segmentation type and id of neutron networks."},{"line_number":37,"context_line":"For example it is possible to configure neutron with"},{"line_number":38,"context_line":"``tenant_network_types \u003d vxlan`` and still create subports with"},{"line_number":39,"context_line":"``segmentation_type \u003d vlan``. Neutron will remap packets as needed."}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_a3f90550","line":36,"range":{"start_line":36,"start_character":55,"end_line":36,"end_character":57},"updated":"2016-11-07 13:55:00.000000000","message":"ID","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"bd22c363502457030ed769d29a9c798b863397a5","unresolved":false,"context_lines":[{"line_number":33,"context_line":"is supported as a ``segmentation-type``."},{"line_number":34,"context_line":""},{"line_number":35,"context_line":"The segmentation type and ID specified by the user on the subports is"},{"line_number":36,"context_line":"intentionally decoupled from the segmentation type and id of neutron networks."},{"line_number":37,"context_line":"For example it is possible to configure neutron with"},{"line_number":38,"context_line":"``tenant_network_types \u003d vxlan`` and still create subports with"},{"line_number":39,"context_line":"``segmentation_type \u003d vlan``. Neutron will remap packets as needed."}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_23edf58b","line":36,"range":{"start_line":36,"start_character":33,"end_line":36,"end_character":50},"updated":"2016-11-07 13:55:00.000000000","message":"``segmentation-type``","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"6ba2c2aea62ddc519ae7d99fe7b5634e366318ec","unresolved":false,"context_lines":[{"line_number":34,"context_line":""},{"line_number":35,"context_line":"The segmentation type and ID specified by the user on the subports is"},{"line_number":36,"context_line":"intentionally decoupled from the segmentation type and id of neutron networks."},{"line_number":37,"context_line":"For example it is possible to configure neutron with"},{"line_number":38,"context_line":"``tenant_network_types \u003d vxlan`` and still create subports with"},{"line_number":39,"context_line":"``segmentation_type \u003d vlan``. Neutron will remap packets as needed."},{"line_number":40,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_a9be3ffd","line":37,"range":{"start_line":37,"start_character":0,"end_line":37,"end_character":11},"updated":"2016-11-07 14:32:43.000000000","message":"For example, it is*","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"bd22c363502457030ed769d29a9c798b863397a5","unresolved":false,"context_lines":[{"line_number":35,"context_line":"The segmentation type and ID specified by the user on the subports is"},{"line_number":36,"context_line":"intentionally decoupled from the segmentation type and id of neutron networks."},{"line_number":37,"context_line":"For example it is possible to configure neutron with"},{"line_number":38,"context_line":"``tenant_network_types \u003d vxlan`` and still create subports with"},{"line_number":39,"context_line":"``segmentation_type \u003d vlan``. Neutron will remap packets as needed."},{"line_number":40,"context_line":""},{"line_number":41,"context_line":"Design details can be found `here \u003chttp://specs.openstack.org/openstack/neutron-specs/specs/newton/vlan-aware-vms.html\u003e`_."}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_c3bb5974","line":38,"range":{"start_line":38,"start_character":50,"end_line":38,"end_character":58},"updated":"2016-11-07 13:55:00.000000000","message":"``subports``","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"bd22c363502457030ed769d29a9c798b863397a5","unresolved":false,"context_lines":[{"line_number":45,"context_line":"~~~~~~~~~~~~~~~~~~~~~"},{"line_number":46,"context_line":""},{"line_number":47,"context_line":"Neutron will automatically validate the trunk plugin is compatible with the"},{"line_number":48,"context_line":"main neutron plugin. As of now, the following trunk drivers are available for"},{"line_number":49,"context_line":"use with ML2:"},{"line_number":50,"context_line":""},{"line_number":51,"context_line":"* OVS"}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_635b6d55","line":48,"range":{"start_line":48,"start_character":21,"end_line":48,"end_character":30},"updated":"2016-11-07 13:55:00.000000000","message":"In the Newton release,","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"6ba2c2aea62ddc519ae7d99fe7b5634e366318ec","unresolved":false,"context_lines":[{"line_number":44,"context_line":"Example configuration"},{"line_number":45,"context_line":"~~~~~~~~~~~~~~~~~~~~~"},{"line_number":46,"context_line":""},{"line_number":47,"context_line":"Neutron will automatically validate the trunk plugin is compatible with the"},{"line_number":48,"context_line":"main neutron plugin. As of now, the following trunk drivers are available for"},{"line_number":49,"context_line":"use with ML2:"},{"line_number":50,"context_line":""},{"line_number":51,"context_line":"* OVS"}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_694b472c","line":48,"range":{"start_line":47,"start_character":0,"end_line":48,"end_character":20},"updated":"2016-11-07 14:32:43.000000000","message":"Neutron automatically validates the trunk plugin that is * ???","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"6ba2c2aea62ddc519ae7d99fe7b5634e366318ec","unresolved":false,"context_lines":[{"line_number":45,"context_line":"~~~~~~~~~~~~~~~~~~~~~"},{"line_number":46,"context_line":""},{"line_number":47,"context_line":"Neutron will automatically validate the trunk plugin is compatible with the"},{"line_number":48,"context_line":"main neutron plugin. As of now, the following trunk drivers are available for"},{"line_number":49,"context_line":"use with ML2:"},{"line_number":50,"context_line":""},{"line_number":51,"context_line":"* OVS"}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_c95293dd","line":48,"range":{"start_line":48,"start_character":21,"end_line":48,"end_character":30},"in_reply_to":"9a629dbe_635b6d55","updated":"2016-11-07 14:32:43.000000000","message":"Or, \"As of the Newton release...\"","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"bd22c363502457030ed769d29a9c798b863397a5","unresolved":false,"context_lines":[{"line_number":53,"context_line":"* OVN"},{"line_number":54,"context_line":""},{"line_number":55,"context_line":"The trunk plugin will fail to load unless one of the corresponding mechanism"},{"line_number":56,"context_line":"drivers is configured in the ``mechanism_drivers`` section of neutron.conf."},{"line_number":57,"context_line":""},{"line_number":58,"context_line":"Controller node"},{"line_number":59,"context_line":"---------------"}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_b6fea103","line":56,"range":{"start_line":56,"start_character":62,"end_line":56,"end_character":74},"updated":"2016-11-07 13:55:00.000000000","message":"``neutron.conf``","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"6ba2c2aea62ddc519ae7d99fe7b5634e366318ec","unresolved":false,"context_lines":[{"line_number":68,"context_line":"Verify service operation"},{"line_number":69,"context_line":"------------------------"},{"line_number":70,"context_line":""},{"line_number":71,"context_line":"#. Source the project credentials."},{"line_number":72,"context_line":""},{"line_number":73,"context_line":"   .. code-block:: console"},{"line_number":74,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_e95d97ed","line":71,"range":{"start_line":71,"start_character":22,"end_line":71,"end_character":33},"updated":"2016-11-07 14:32:43.000000000","message":"credentials: *","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"bd22c363502457030ed769d29a9c798b863397a5","unresolved":false,"context_lines":[{"line_number":72,"context_line":""},{"line_number":73,"context_line":"   .. code-block:: console"},{"line_number":74,"context_line":""},{"line_number":75,"context_line":"      $ neutron ext-list"},{"line_number":76,"context_line":"      +---------------------------+-----------------------------------------------+"},{"line_number":77,"context_line":"      | alias                     | name                                          |"},{"line_number":78,"context_line":"      +---------------------------+-----------------------------------------------+"}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_766249da","line":75,"range":{"start_line":75,"start_character":8,"end_line":75,"end_character":24},"updated":"2016-11-07 13:55:00.000000000","message":"We should use OSC where possible. In this case I believe the command is:\n\n  $ os extension list --network","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"bd22c363502457030ed769d29a9c798b863397a5","unresolved":false,"context_lines":[{"line_number":118,"context_line":"At a high level, the basic steps to booting an instance on a trunk are"},{"line_number":119,"context_line":"the following:"},{"line_number":120,"context_line":""},{"line_number":121,"context_line":"#. Create a network for the trunk"},{"line_number":122,"context_line":"#. Create the networks that will participate in the trunk"},{"line_number":123,"context_line":"#. Create a parent port for the trunk"},{"line_number":124,"context_line":"#. Create ports for the subports on each trunked network"},{"line_number":125,"context_line":"#. Add the subports to the trunk"},{"line_number":126,"context_line":"#. Boot an instance on the parent port"},{"line_number":127,"context_line":""},{"line_number":128,"context_line":"Creating a trunk"},{"line_number":129,"context_line":"----------------"}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_d68cf537","line":126,"range":{"start_line":121,"start_character":0,"end_line":126,"end_character":38},"updated":"2016-11-07 13:55:00.000000000","message":"Either remove this list, or make it match with the steps below.","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"6ba2c2aea62ddc519ae7d99fe7b5634e366318ec","unresolved":false,"context_lines":[{"line_number":118,"context_line":"At a high level, the basic steps to booting an instance on a trunk are"},{"line_number":119,"context_line":"the following:"},{"line_number":120,"context_line":""},{"line_number":121,"context_line":"#. Create a network for the trunk"},{"line_number":122,"context_line":"#. Create the networks that will participate in the trunk"},{"line_number":123,"context_line":"#. Create a parent port for the trunk"},{"line_number":124,"context_line":"#. Create ports for the subports on each trunked network"},{"line_number":125,"context_line":"#. Add the subports to the trunk"},{"line_number":126,"context_line":"#. Boot an instance on the parent port"},{"line_number":127,"context_line":""},{"line_number":128,"context_line":"Creating a trunk"},{"line_number":129,"context_line":"----------------"}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_c969b38d","line":126,"range":{"start_line":121,"start_character":0,"end_line":126,"end_character":38},"in_reply_to":"9a629dbe_d68cf537","updated":"2016-11-07 14:32:43.000000000","message":"+1","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"6ba2c2aea62ddc519ae7d99fe7b5634e366318ec","unresolved":false,"context_lines":[{"line_number":128,"context_line":"Creating a trunk"},{"line_number":129,"context_line":"----------------"},{"line_number":130,"context_line":""},{"line_number":131,"context_line":"#. Create the parent port. The trunk must have a parent port, so a port must be"},{"line_number":132,"context_line":"   created before creating the trunk."},{"line_number":133,"context_line":""},{"line_number":134,"context_line":"   .. code-block:: console"},{"line_number":135,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_89f6dbd5","line":132,"range":{"start_line":131,"start_character":13,"end_line":132,"end_character":37},"updated":"2016-11-07 14:32:43.000000000","message":"shorten this. \"Create the parent port before creating the trunk:\"","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"6ba2c2aea62ddc519ae7d99fe7b5634e366318ec","unresolved":false,"context_lines":[{"line_number":166,"context_line":"      +-----------------------+-----------------------------------------------------------------------------------------------------+"},{"line_number":167,"context_line":""},{"line_number":168,"context_line":""},{"line_number":169,"context_line":"#. Create the trunk. The trunk is created by specifying ``trunk-parent`` as"},{"line_number":170,"context_line":"   the parent port."},{"line_number":171,"context_line":""},{"line_number":172,"context_line":"     .. code-block:: console"}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_492be330","line":169,"range":{"start_line":169,"start_character":19,"end_line":169,"end_character":41},"updated":"2016-11-07 14:32:43.000000000","message":"Create the trunk by specifying ``trunk-parent`` as the parent port: *","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"bd22c363502457030ed769d29a9c798b863397a5","unresolved":false,"context_lines":[{"line_number":172,"context_line":"     .. code-block:: console"},{"line_number":173,"context_line":""},{"line_number":174,"context_line":"        $ openstack network trunk create --parent-port 73fb9d54-43a7-4bb1-a8dc-569e0e0a0a38 trunk"},{"line_number":175,"context_line":"      +-----------------+--------------------------------------+"},{"line_number":176,"context_line":"      | Field           | Value                                |"},{"line_number":177,"context_line":"      +-----------------+--------------------------------------+"},{"line_number":178,"context_line":"      | admin_state_up  | UP                                   |"},{"line_number":179,"context_line":"      | created_at      | 2016-09-13T21:21:44Z                 |"},{"line_number":180,"context_line":"      | description     |                                      |"},{"line_number":181,"context_line":"      | id              | fdf02fcb-1844-45f1-9d9b-e4c2f522c164 |"},{"line_number":182,"context_line":"      | name            | trunk                                |"},{"line_number":183,"context_line":"      | port_id         | 73fb9d54-43a7-4bb1-a8dc-569e0e0a0a38 |"},{"line_number":184,"context_line":"      | revision_number | 1                                    |"},{"line_number":185,"context_line":"      | status          | DOWN                                 |"},{"line_number":186,"context_line":"      | sub_ports       |                                      |"},{"line_number":187,"context_line":"      | tenant_id       | b5c38e6514324770adaa237fbebd7ce8     |"},{"line_number":188,"context_line":"      | updated_at      | 2016-09-13T21:21:44Z                 |"},{"line_number":189,"context_line":"      +-----------------+--------------------------------------+"},{"line_number":190,"context_line":""},{"line_number":191,"context_line":"Creating subports"},{"line_number":192,"context_line":"-----------------"}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_16b58dcc","line":189,"range":{"start_line":175,"start_character":6,"end_line":189,"end_character":64},"updated":"2016-11-07 13:55:00.000000000","message":"Needs to be indented to match the line above","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"6ba2c2aea62ddc519ae7d99fe7b5634e366318ec","unresolved":false,"context_lines":[{"line_number":191,"context_line":"Creating subports"},{"line_number":192,"context_line":"-----------------"},{"line_number":193,"context_line":""},{"line_number":194,"context_line":"#. Method 1: Create trunk with subports."},{"line_number":195,"context_line":""},{"line_number":196,"context_line":"   .. code-block:: console"},{"line_number":197,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_a9f1dfcf","line":194,"range":{"start_line":194,"start_character":2,"end_line":194,"end_character":12},"updated":"2016-11-07 14:32:43.000000000","message":"If there are two methods to this process, I recommend a introductory sentence above explaining this.","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"6ba2c2aea62ddc519ae7d99fe7b5634e366318ec","unresolved":false,"context_lines":[{"line_number":191,"context_line":"Creating subports"},{"line_number":192,"context_line":"-----------------"},{"line_number":193,"context_line":""},{"line_number":194,"context_line":"#. Method 1: Create trunk with subports."},{"line_number":195,"context_line":""},{"line_number":196,"context_line":"   .. code-block:: console"},{"line_number":197,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_09bf2bd1","line":194,"range":{"start_line":194,"start_character":31,"end_line":194,"end_character":40},"updated":"2016-11-07 14:32:43.000000000","message":"subports: *","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"bd22c363502457030ed769d29a9c798b863397a5","unresolved":false,"context_lines":[{"line_number":261,"context_line":"      +-----------------------+----------------------------------------------------------------------------+"},{"line_number":262,"context_line":""},{"line_number":263,"context_line":""},{"line_number":264,"context_line":"      $ openstack network trunk create --parent-port 73fb9d54-43a7-4bb1-a8dc-569e0e0a0a38 --subport port\u003d91f9dde8-80a4-4506-b5da-c287feb8f5d8,segmentation-type\u003dvlan,segmentation-id\u003d100"},{"line_number":265,"context_line":""},{"line_number":266,"context_line":"      +-----------------+-------------------------------------------------------------------------------------------------+"},{"line_number":267,"context_line":"      | Field           | Value                                                                                           |"}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_964b5db0","line":264,"updated":"2016-11-07 13:55:00.000000000","message":"escape this with a \u0027\\\u0027 before it gets to 79 chars and continue on the next line","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"bd22c363502457030ed769d29a9c798b863397a5","unresolved":false,"context_lines":[{"line_number":262,"context_line":""},{"line_number":263,"context_line":""},{"line_number":264,"context_line":"      $ openstack network trunk create --parent-port 73fb9d54-43a7-4bb1-a8dc-569e0e0a0a38 --subport port\u003d91f9dde8-80a4-4506-b5da-c287feb8f5d8,segmentation-type\u003dvlan,segmentation-id\u003d100"},{"line_number":265,"context_line":""},{"line_number":266,"context_line":"      +-----------------+-------------------------------------------------------------------------------------------------+"},{"line_number":267,"context_line":"      | Field           | Value                                                                                           |"},{"line_number":268,"context_line":"      +-----------------+-------------------------------------------------------------------------------------------------+"}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_36db71ef","line":265,"updated":"2016-11-07 13:55:00.000000000","message":"remove whitespace line","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"6ba2c2aea62ddc519ae7d99fe7b5634e366318ec","unresolved":false,"context_lines":[{"line_number":280,"context_line":"      +-----------------+-------------------------------------------------------------------------------------------------+"},{"line_number":281,"context_line":""},{"line_number":282,"context_line":""},{"line_number":283,"context_line":"#. Method 2: Add subports to an existing trunk."},{"line_number":284,"context_line":""},{"line_number":285,"context_line":"   .. code-block:: console"},{"line_number":286,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_29b4eff0","line":283,"range":{"start_line":283,"start_character":40,"end_line":283,"end_character":47},"updated":"2016-11-07 14:32:43.000000000","message":"trunk: *","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"bd22c363502457030ed769d29a9c798b863397a5","unresolved":false,"context_lines":[{"line_number":284,"context_line":""},{"line_number":285,"context_line":"   .. code-block:: console"},{"line_number":286,"context_line":""},{"line_number":287,"context_line":"      $ openstack network trunk set --subport port\u003d91f9dde8-80a4-4506-b5da-c287feb8f5d8,segmentation-type\u003dvlan,segmentation-id\u003d100 61d8e620-fe3a-4d8f-b9e6-e1b0dea6d9e3"},{"line_number":288,"context_line":""},{"line_number":289,"context_line":"      $ openstack network trunk show 61d8e620-fe3a-4d8f-b9e6-e1b0dea6d9e3"},{"line_number":290,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_3602913f","line":287,"updated":"2016-11-07 13:55:00.000000000","message":"escape this with a \u0027\\\u0027 before it gets to 79 chars and continue on the next line","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"bd22c363502457030ed769d29a9c798b863397a5","unresolved":false,"context_lines":[{"line_number":287,"context_line":"      $ openstack network trunk set --subport port\u003d91f9dde8-80a4-4506-b5da-c287feb8f5d8,segmentation-type\u003dvlan,segmentation-id\u003d100 61d8e620-fe3a-4d8f-b9e6-e1b0dea6d9e3"},{"line_number":288,"context_line":""},{"line_number":289,"context_line":"      $ openstack network trunk show 61d8e620-fe3a-4d8f-b9e6-e1b0dea6d9e3"},{"line_number":290,"context_line":""},{"line_number":291,"context_line":"      +-----------------+-------------------------------------------------------------------------------------------------+"},{"line_number":292,"context_line":"      | Field           | Value                                                                                           |"},{"line_number":293,"context_line":"      +-----------------+-------------------------------------------------------------------------------------------------+"}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_6fda6c7a","line":290,"updated":"2016-11-07 13:55:00.000000000","message":"remove whitespace line","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"6ba2c2aea62ddc519ae7d99fe7b5634e366318ec","unresolved":false,"context_lines":[{"line_number":307,"context_line":"Booting an instance on a trunk"},{"line_number":308,"context_line":"------------------------------"},{"line_number":309,"context_line":""},{"line_number":310,"context_line":"#. Show trunk details on the parent port."},{"line_number":311,"context_line":""},{"line_number":312,"context_line":"   .. code-block:: console"},{"line_number":313,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_a9c8ff75","line":310,"range":{"start_line":310,"start_character":36,"end_line":310,"end_character":41},"updated":"2016-11-07 14:32:43.000000000","message":"port: *","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"bd22c363502457030ed769d29a9c798b863397a5","unresolved":false,"context_lines":[{"line_number":312,"context_line":"   .. code-block:: console"},{"line_number":313,"context_line":""},{"line_number":314,"context_line":"      $ openstack network trunk show 61d8e620-fe3a-4d8f-b9e6-e1b0dea6d9e3"},{"line_number":315,"context_line":""},{"line_number":316,"context_line":"      +-----------------+-------------------------------------------------------------------------------------------------+"},{"line_number":317,"context_line":"      | Field           | Value                                                                                           |"},{"line_number":318,"context_line":"      +-----------------+-------------------------------------------------------------------------------------------------+"}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_b4aa196f","line":315,"updated":"2016-11-07 13:55:00.000000000","message":"remove whitespace line","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"bd22c363502457030ed769d29a9c798b863397a5","unresolved":false,"context_lines":[{"line_number":313,"context_line":""},{"line_number":314,"context_line":"      $ openstack network trunk show 61d8e620-fe3a-4d8f-b9e6-e1b0dea6d9e3"},{"line_number":315,"context_line":""},{"line_number":316,"context_line":"      +-----------------+-------------------------------------------------------------------------------------------------+"},{"line_number":317,"context_line":"      | Field           | Value                                                                                           |"},{"line_number":318,"context_line":"      +-----------------+-------------------------------------------------------------------------------------------------+"},{"line_number":319,"context_line":"      | admin_state_up  | UP                                                                                              |"},{"line_number":320,"context_line":"      | created_at      | 2016-09-13T21:35:01Z                                                                            |"},{"line_number":321,"context_line":"      | description     |                                                                                                 |"},{"line_number":322,"context_line":"      | id              | 61d8e620-fe3a-4d8f-b9e6-e1b0dea6d9e3                                                            |"},{"line_number":323,"context_line":"      | name            | trunk                                                                                           |"},{"line_number":324,"context_line":"      | port_id         | 73fb9d54-43a7-4bb1-a8dc-569e0e0a0a38                                                            |"},{"line_number":325,"context_line":"      | revision_number | 1                                                                                               |"},{"line_number":326,"context_line":"      | status          | DOWN                                                                                            |"},{"line_number":327,"context_line":"      | sub_ports       |                                                                                                 |"},{"line_number":328,"context_line":"      | tenant_id       | b5c38e6514324770adaa237fbebd7ce8                                                                |"},{"line_number":329,"context_line":"      | updated_at      | 2016-09-13T21:35:01Z                                                                            |"},{"line_number":330,"context_line":"      +-----------------+-------------------------------------------------------------------------------------------------+"},{"line_number":331,"context_line":""},{"line_number":332,"context_line":"#. Add subports to the trunk."},{"line_number":333,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_1499056f","line":330,"range":{"start_line":316,"start_character":6,"end_line":330,"end_character":123},"updated":"2016-11-07 13:55:00.000000000","message":"Table doesn\u0027t need to be so wide","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"6ba2c2aea62ddc519ae7d99fe7b5634e366318ec","unresolved":false,"context_lines":[{"line_number":329,"context_line":"      | updated_at      | 2016-09-13T21:35:01Z                                                                            |"},{"line_number":330,"context_line":"      +-----------------+-------------------------------------------------------------------------------------------------+"},{"line_number":331,"context_line":""},{"line_number":332,"context_line":"#. Add subports to the trunk."},{"line_number":333,"context_line":""},{"line_number":334,"context_line":"   .. code-block:: console"},{"line_number":335,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_49b043f5","line":332,"range":{"start_line":332,"start_character":22,"end_line":332,"end_character":29},"updated":"2016-11-07 14:32:43.000000000","message":"trunk: *","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"bd22c363502457030ed769d29a9c798b863397a5","unresolved":false,"context_lines":[{"line_number":333,"context_line":""},{"line_number":334,"context_line":"   .. code-block:: console"},{"line_number":335,"context_line":""},{"line_number":336,"context_line":"      $ openstack network trunk set --subport port\u003d91f9dde8-80a4-4506-b5da-c287feb8f5d8,segmentation-type\u003dvlan,segmentation-id\u003d100 61d8e620-fe3a-4d8f-b9e6-e1b0dea6d9e3"},{"line_number":337,"context_line":""},{"line_number":338,"context_line":"#. Boot an instance on the trunk."},{"line_number":339,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_2f5dd4e9","line":336,"updated":"2016-11-07 13:55:00.000000000","message":"escape this with a \u0027\\\u0027 before it gets to 79 chars and continue on the next line","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"6ba2c2aea62ddc519ae7d99fe7b5634e366318ec","unresolved":false,"context_lines":[{"line_number":335,"context_line":""},{"line_number":336,"context_line":"      $ openstack network trunk set --subport port\u003d91f9dde8-80a4-4506-b5da-c287feb8f5d8,segmentation-type\u003dvlan,segmentation-id\u003d100 61d8e620-fe3a-4d8f-b9e6-e1b0dea6d9e3"},{"line_number":337,"context_line":""},{"line_number":338,"context_line":"#. Boot an instance on the trunk."},{"line_number":339,"context_line":""},{"line_number":340,"context_line":"   .. code-block:: console"},{"line_number":341,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_a99f1f5e","line":338,"range":{"start_line":338,"start_character":26,"end_line":338,"end_character":33},"updated":"2016-11-07 14:32:43.000000000","message":"trunk: *","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"bd22c363502457030ed769d29a9c798b863397a5","unresolved":false,"context_lines":[{"line_number":339,"context_line":""},{"line_number":340,"context_line":"   .. code-block:: console"},{"line_number":341,"context_line":""},{"line_number":342,"context_line":"      $ openstack server create --nic port-id\u003d73fb9d54-43a7-4bb1-a8dc-569e0e0a0a38 --flavor 1 --image a6ece084-0db4-4cd2-893a-70b52ef5460a my-instance"},{"line_number":343,"context_line":""},{"line_number":344,"context_line":"Using trunks and subports inside an instance"},{"line_number":345,"context_line":"--------------------------------------------"}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_8f6c209e","line":342,"updated":"2016-11-07 13:55:00.000000000","message":"escape this with a \u0027\\\u0027 before it gets to 79 chars and continue on the next line","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"6ba2c2aea62ddc519ae7d99fe7b5634e366318ec","unresolved":false,"context_lines":[{"line_number":351,"context_line":"trunk to be configured without explicitly setting a MAC address. Although"},{"line_number":352,"context_line":"unique MAC addresses can be used for subports, this can present issues with"},{"line_number":353,"context_line":"ARP spoof protections and the native OVS firewall driver. If the native OVS"},{"line_number":354,"context_line":"firewall driver is to be used, it is strongly recommended that the MAC address"},{"line_number":355,"context_line":"of the trunk should be re-used on all subports. See the following bugs:"},{"line_number":356,"context_line":""},{"line_number":357,"context_line":"* `https://bugs.launchpad.net/neutron/+bug/1626010`"}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_89a09b92","line":354,"range":{"start_line":354,"start_character":31,"end_line":354,"end_character":58},"updated":"2016-11-07 14:32:43.000000000","message":"we recommend *","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"bd22c363502457030ed769d29a9c798b863397a5","unresolved":false,"context_lines":[{"line_number":354,"context_line":"firewall driver is to be used, it is strongly recommended that the MAC address"},{"line_number":355,"context_line":"of the trunk should be re-used on all subports. See the following bugs:"},{"line_number":356,"context_line":""},{"line_number":357,"context_line":"* `https://bugs.launchpad.net/neutron/+bug/1626010`"},{"line_number":358,"context_line":"* `https://bugs.launchpad.net/neutron/+bug/1593760`"},{"line_number":359,"context_line":""},{"line_number":360,"context_line":"Attention should also be given to the status of the ``state`` of a trunk:"},{"line_number":361,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_8ac88e76","line":358,"range":{"start_line":357,"start_character":0,"end_line":358,"end_character":51},"updated":"2016-11-07 13:55:00.000000000","message":"remove backticks","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"bd22c363502457030ed769d29a9c798b863397a5","unresolved":false,"context_lines":[{"line_number":357,"context_line":"* `https://bugs.launchpad.net/neutron/+bug/1626010`"},{"line_number":358,"context_line":"* `https://bugs.launchpad.net/neutron/+bug/1593760`"},{"line_number":359,"context_line":""},{"line_number":360,"context_line":"Attention should also be given to the status of the ``state`` of a trunk:"},{"line_number":361,"context_line":""},{"line_number":362,"context_line":"#. ``ACTIVE``"},{"line_number":363,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_0a82be00","line":360,"range":{"start_line":360,"start_character":38,"end_line":360,"end_character":51},"updated":"2016-11-07 13:55:00.000000000","message":"remove","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"6ba2c2aea62ddc519ae7d99fe7b5634e366318ec","unresolved":false,"context_lines":[{"line_number":374,"context_line":""},{"line_number":375,"context_line":"   A trunk can be in a ``DEGRADED`` state when a temporary failure during"},{"line_number":376,"context_line":"   the provisioning process is encountered. This includes situations where a"},{"line_number":377,"context_line":"   subport add/remove operation fails. When in a degraded state, the trunk is"},{"line_number":378,"context_line":"   still usable and some subports may be usable as well. Operations that cause"},{"line_number":379,"context_line":"   the trunk to go into a ``DEGRADED`` state can be retried to fix temporary"},{"line_number":380,"context_line":"   failures and move the trunk into an ``ACTIVE`` state."}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_e962f715","line":377,"range":{"start_line":377,"start_character":11,"end_line":377,"end_character":21},"updated":"2016-11-07 14:32:43.000000000","message":"add or remove *","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"bd22c363502457030ed769d29a9c798b863397a5","unresolved":false,"context_lines":[{"line_number":359,"context_line":""},{"line_number":360,"context_line":"Attention should also be given to the status of the ``state`` of a trunk:"},{"line_number":361,"context_line":""},{"line_number":362,"context_line":"#. ``ACTIVE``"},{"line_number":363,"context_line":""},{"line_number":364,"context_line":"    The trunk is ``ACTIVE`` when both the logical and physical resources have"},{"line_number":365,"context_line":"    been created. This means that all operations on the neutron server and on"},{"line_number":366,"context_line":"    the compute host have completed and that the trunk is ready for use."},{"line_number":367,"context_line":""},{"line_number":368,"context_line":"#. ``DOWN``"},{"line_number":369,"context_line":""},{"line_number":370,"context_line":"    A trunk is ``DOWN`` when it is first created without an instance booted on"},{"line_number":371,"context_line":"    it, or when the instance associated with the trunk has been deleted."},{"line_number":372,"context_line":""},{"line_number":373,"context_line":"#. ``DEGRADED``"},{"line_number":374,"context_line":""},{"line_number":375,"context_line":"   A trunk can be in a ``DEGRADED`` state when a temporary failure during"},{"line_number":376,"context_line":"   the provisioning process is encountered. This includes situations where a"},{"line_number":377,"context_line":"   subport add/remove operation fails. When in a degraded state, the trunk is"},{"line_number":378,"context_line":"   still usable and some subports may be usable as well. Operations that cause"},{"line_number":379,"context_line":"   the trunk to go into a ``DEGRADED`` state can be retried to fix temporary"},{"line_number":380,"context_line":"   failures and move the trunk into an ``ACTIVE`` state."},{"line_number":381,"context_line":""},{"line_number":382,"context_line":"#. ``ERROR``"},{"line_number":383,"context_line":""},{"line_number":384,"context_line":"    A trunk will be in ``ERROR`` if the request leads to a conflict or an"},{"line_number":385,"context_line":"    error that cannot be fixed by retrying the request. ``ERROR`` status"},{"line_number":386,"context_line":"    can be encountered if the network is not compatible with the trunk"},{"line_number":387,"context_line":"    configuration or the binding process leads to a persistent failure. When"},{"line_number":388,"context_line":"    a trunk is ``ERROR`` state, it must be brought to a sane state (``ACTIVE``)"},{"line_number":389,"context_line":"    or else requests to add subports will be rejected."},{"line_number":390,"context_line":""},{"line_number":391,"context_line":"#. ``BUILD``"},{"line_number":392,"context_line":""},{"line_number":393,"context_line":"    A trunk will be in ``BUILD`` state while the resources associated with the"},{"line_number":394,"context_line":"    trunk are in the process of being provisioned. Once the trunk and all of"},{"line_number":395,"context_line":"    the subports have been provisioned successfully, the trunk will transition"},{"line_number":396,"context_line":"    to ``ACTIVE``. If there was a partial failure, the trunk will transition"},{"line_number":397,"context_line":"    to ``DEGRADED``"},{"line_number":398,"context_line":""},{"line_number":399,"context_line":"When ``admin_state`` is set to ``DOWN``, the user is blocked from performing"},{"line_number":400,"context_line":"operations on the trunk. ``admin_state`` is set by the user and should not be"}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a629dbe_8aaa4e18","line":397,"range":{"start_line":362,"start_character":0,"end_line":397,"end_character":19},"updated":"2016-11-07 13:55:00.000000000","message":"I\u0027d recommend either a bulleted list or a definition list for this section. See http://docs.openstack.org/contributor-guide/rst-conv/lists.html","commit_id":"b5173ef767d44ab9e7859c6b8ff693e7a6ca15a6"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"e44fbae0433a44c7e5115a26719fed7bb402983e","unresolved":false,"context_lines":[{"line_number":11,"context_line":"VLAN trunking consists of a service plugin and a set of drivers"},{"line_number":12,"context_line":"that manage trunks on different L2 networking solutions (for example OVS,"},{"line_number":13,"context_line":"linux bridge, and so on). Users can create a port, associate it with a trunk,"},{"line_number":14,"context_line":"and boot instances on that port. This will give the instance access to"},{"line_number":15,"context_line":"a trunk, enabling the instance to be attached and detached from networks"},{"line_number":16,"context_line":"dynamically without shutting down, re-building, or attaching and detaching"},{"line_number":17,"context_line":"vNIC\u0027s to the instance."}],"source_content_type":"text/x-rst","patch_set":6,"id":"7a77a97e_af9e2554","line":14,"range":{"start_line":14,"start_character":34,"end_line":14,"end_character":47},"updated":"2016-11-15 13:10:24.000000000","message":"This gives * (remove the will, it changes the tense)","commit_id":"f06c5f541420b8041160678100a43b131dd77871"},{"author":{"_account_id":4187,"name":"Ryan Tidwell","email":"rtidwell@suse.com","username":"ryan-tidwell"},"change_message_id":"771bffc8ce17516332b10f11fbb70b188357f3e5","unresolved":false,"context_lines":[{"line_number":11,"context_line":"VLAN trunking consists of a service plugin and a set of drivers"},{"line_number":12,"context_line":"that manage trunks on different L2 networking solutions (for example OVS,"},{"line_number":13,"context_line":"linux bridge, and so on). Users can create a port, associate it with a trunk,"},{"line_number":14,"context_line":"and boot instances on that port. This will give the instance access to"},{"line_number":15,"context_line":"a trunk, enabling the instance to be attached and detached from networks"},{"line_number":16,"context_line":"dynamically without shutting down, re-building, or attaching and detaching"},{"line_number":17,"context_line":"vNIC\u0027s to the instance."}],"source_content_type":"text/x-rst","patch_set":6,"id":"7a77a97e_0fad48e9","line":14,"range":{"start_line":14,"start_character":34,"end_line":14,"end_character":47},"in_reply_to":"7a77a97e_af9e2554","updated":"2016-11-15 21:51:10.000000000","message":"Done","commit_id":"f06c5f541420b8041160678100a43b131dd77871"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"e44fbae0433a44c7e5115a26719fed7bb402983e","unresolved":false,"context_lines":[{"line_number":25,"context_line":"The network presented by the subport is the network of the associated"},{"line_number":26,"context_line":"port. When creating a subport, a ``segmentation-id`` may be required by"},{"line_number":27,"context_line":"the driver. ``segmentation-id`` defines the tagged VLAN that the parent"},{"line_number":28,"context_line":"port network will be presented to the instance as. ``segmentation-type`` may"},{"line_number":29,"context_line":"be required by certain drivers like OVS, although at this time only ``vlan``"},{"line_number":30,"context_line":"is supported as a ``segmentation-type``."},{"line_number":31,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"7a77a97e_2f2db5a7","line":28,"range":{"start_line":28,"start_character":12,"end_line":28,"end_character":20},"updated":"2016-11-15 13:10:24.000000000","message":"network is presented to the instance. *","commit_id":"f06c5f541420b8041160678100a43b131dd77871"},{"author":{"_account_id":4187,"name":"Ryan Tidwell","email":"rtidwell@suse.com","username":"ryan-tidwell"},"change_message_id":"771bffc8ce17516332b10f11fbb70b188357f3e5","unresolved":false,"context_lines":[{"line_number":25,"context_line":"The network presented by the subport is the network of the associated"},{"line_number":26,"context_line":"port. When creating a subport, a ``segmentation-id`` may be required by"},{"line_number":27,"context_line":"the driver. ``segmentation-id`` defines the tagged VLAN that the parent"},{"line_number":28,"context_line":"port network will be presented to the instance as. ``segmentation-type`` may"},{"line_number":29,"context_line":"be required by certain drivers like OVS, although at this time only ``vlan``"},{"line_number":30,"context_line":"is supported as a ``segmentation-type``."},{"line_number":31,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"7a77a97e_2fba0424","line":28,"range":{"start_line":28,"start_character":12,"end_line":28,"end_character":20},"in_reply_to":"7a77a97e_2f2db5a7","updated":"2016-11-15 21:51:10.000000000","message":"Done","commit_id":"f06c5f541420b8041160678100a43b131dd77871"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"e44fbae0433a44c7e5115a26719fed7bb402983e","unresolved":false,"context_lines":[{"line_number":25,"context_line":"The network presented by the subport is the network of the associated"},{"line_number":26,"context_line":"port. When creating a subport, a ``segmentation-id`` may be required by"},{"line_number":27,"context_line":"the driver. ``segmentation-id`` defines the tagged VLAN that the parent"},{"line_number":28,"context_line":"port network will be presented to the instance as. ``segmentation-type`` may"},{"line_number":29,"context_line":"be required by certain drivers like OVS, although at this time only ``vlan``"},{"line_number":30,"context_line":"is supported as a ``segmentation-type``."},{"line_number":31,"context_line":""},{"line_number":32,"context_line":"The segmentation type and ID specified by the user on the subports is"},{"line_number":33,"context_line":"intentionally decoupled from the segmentation type and ID of neutron networks."}],"source_content_type":"text/x-rst","patch_set":6,"id":"7a77a97e_6f1ded72","line":30,"range":{"start_line":28,"start_character":51,"end_line":30,"end_character":40},"updated":"2016-11-15 13:10:24.000000000","message":"Call out in a notation","commit_id":"f06c5f541420b8041160678100a43b131dd77871"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"e44fbae0433a44c7e5115a26719fed7bb402983e","unresolved":false,"context_lines":[{"line_number":30,"context_line":"is supported as a ``segmentation-type``."},{"line_number":31,"context_line":""},{"line_number":32,"context_line":"The segmentation type and ID specified by the user on the subports is"},{"line_number":33,"context_line":"intentionally decoupled from the segmentation type and ID of neutron networks."},{"line_number":34,"context_line":"For example, it is possible to configure neutron with"},{"line_number":35,"context_line":"``tenant_network_types \u003d vxlan`` and still create subports with"},{"line_number":36,"context_line":"``segmentation_type \u003d vlan``. Neutron will remap packets as needed."}],"source_content_type":"text/x-rst","patch_set":6,"id":"7a77a97e_2f04d515","line":33,"range":{"start_line":33,"start_character":33,"end_line":33,"end_character":50},"updated":"2016-11-15 13:10:24.000000000","message":"should this be ``segmentation-type``?","commit_id":"f06c5f541420b8041160678100a43b131dd77871"},{"author":{"_account_id":4187,"name":"Ryan Tidwell","email":"rtidwell@suse.com","username":"ryan-tidwell"},"change_message_id":"771bffc8ce17516332b10f11fbb70b188357f3e5","unresolved":false,"context_lines":[{"line_number":30,"context_line":"is supported as a ``segmentation-type``."},{"line_number":31,"context_line":""},{"line_number":32,"context_line":"The segmentation type and ID specified by the user on the subports is"},{"line_number":33,"context_line":"intentionally decoupled from the segmentation type and ID of neutron networks."},{"line_number":34,"context_line":"For example, it is possible to configure neutron with"},{"line_number":35,"context_line":"``tenant_network_types \u003d vxlan`` and still create subports with"},{"line_number":36,"context_line":"``segmentation_type \u003d vlan``. Neutron will remap packets as needed."}],"source_content_type":"text/x-rst","patch_set":6,"id":"7a77a97e_cff8b0e8","line":33,"range":{"start_line":33,"start_character":33,"end_line":33,"end_character":50},"in_reply_to":"7a77a97e_2f04d515","updated":"2016-11-15 21:51:10.000000000","message":"Done","commit_id":"f06c5f541420b8041160678100a43b131dd77871"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"4cec1fd3397a929c38beb2dc11dfbce94d4af67e","unresolved":false,"context_lines":[{"line_number":71,"context_line":"   .. code-block:: console"},{"line_number":72,"context_line":""},{"line_number":73,"context_line":"      $ os extension list --network"},{"line_number":74,"context_line":"      +---------------------------+-----------------------------------------------+"},{"line_number":75,"context_line":"      | alias                     | name                                          |"},{"line_number":76,"context_line":"      +---------------------------+-----------------------------------------------+"},{"line_number":77,"context_line":"      | default-subnetpools       | Default Subnetpools                           |"},{"line_number":78,"context_line":"      | network-ip-availability   | Network IP Availability                       |"},{"line_number":79,"context_line":"      | network_availability_zone | Network Availability Zone                     |"},{"line_number":80,"context_line":"      | auto-allocated-topology   | Auto Allocated Topology Services              |"},{"line_number":81,"context_line":"      | ext-gw-mode               | Neutron L3 Configurable external gateway mode |"},{"line_number":82,"context_line":"      | binding                   | Port Binding                                  |"},{"line_number":83,"context_line":"      | trunk-details             | Trunk port details                            |"},{"line_number":84,"context_line":"      | agent                     | agent                                         |"},{"line_number":85,"context_line":"      | subnet_allocation         | Subnet Allocation                             |"},{"line_number":86,"context_line":"      | l3_agent_scheduler        | L3 Agent Scheduler                            |"},{"line_number":87,"context_line":"      | tag                       | Tag support                                   |"},{"line_number":88,"context_line":"      | external-net              | Neutron external network                      |"},{"line_number":89,"context_line":"      | net-mtu                   | Network MTU                                   |"},{"line_number":90,"context_line":"      | availability_zone         | Availability Zone                             |"},{"line_number":91,"context_line":"      | quotas                    | Quota management support                      |"},{"line_number":92,"context_line":"      | l3-ha                     | HA Router extension                           |"},{"line_number":93,"context_line":"      | provider                  | Provider Network                              |"},{"line_number":94,"context_line":"      | multi-provider            | Multi Provider Network                        |"},{"line_number":95,"context_line":"      | address-scope             | Address scope                                 |"},{"line_number":96,"context_line":"      | trunk                     | Trunk Extension                               |"},{"line_number":97,"context_line":"      | extraroute                | Neutron Extra Route                           |"},{"line_number":98,"context_line":"      | timestamp_core            | Time Stamp Fields addition for core resources |"},{"line_number":99,"context_line":"      | router                    | Neutron L3 Router                             |"},{"line_number":100,"context_line":"      | extra_dhcp_opt            | Neutron Extra DHCP opts                       |"},{"line_number":101,"context_line":"      | security-group            | security-group                                |"},{"line_number":102,"context_line":"      | dhcp_agent_scheduler      | DHCP Agent Scheduler                          |"},{"line_number":103,"context_line":"      | router_availability_zone  | Router Availability Zone                      |"},{"line_number":104,"context_line":"      | rbac-policies             | RBAC Policies                                 |"},{"line_number":105,"context_line":"      | standard-attr-description | standard-attr-description                     |"},{"line_number":106,"context_line":"      | port-security             | Port Security                                 |"},{"line_number":107,"context_line":"      | allowed-address-pairs     | Allowed Address Pairs                         |"},{"line_number":108,"context_line":"      | dvr                       | Distributed Virtual Router                    |"},{"line_number":109,"context_line":"      +---------------------------+-----------------------------------------------+"},{"line_number":110,"context_line":""},{"line_number":111,"context_line":"The ``trunk`` and ``trunk-details`` extensions should be available."},{"line_number":112,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"9a629dbe_2325e85b","line":109,"range":{"start_line":74,"start_character":6,"end_line":109,"end_character":83},"updated":"2016-11-14 11:18:13.000000000","message":"This no longer matches the output from OSC. There are 3 columns; Name, Alias, and Description.","commit_id":"f06c5f541420b8041160678100a43b131dd77871"},{"author":{"_account_id":4187,"name":"Ryan Tidwell","email":"rtidwell@suse.com","username":"ryan-tidwell"},"change_message_id":"091706159ea57e185e12bf38fe0f655dc29855c6","unresolved":false,"context_lines":[{"line_number":71,"context_line":"   .. code-block:: console"},{"line_number":72,"context_line":""},{"line_number":73,"context_line":"      $ os extension list --network"},{"line_number":74,"context_line":"      +---------------------------+-----------------------------------------------+"},{"line_number":75,"context_line":"      | alias                     | name                                          |"},{"line_number":76,"context_line":"      +---------------------------+-----------------------------------------------+"},{"line_number":77,"context_line":"      | default-subnetpools       | Default Subnetpools                           |"},{"line_number":78,"context_line":"      | network-ip-availability   | Network IP Availability                       |"},{"line_number":79,"context_line":"      | network_availability_zone | Network Availability Zone                     |"},{"line_number":80,"context_line":"      | auto-allocated-topology   | Auto Allocated Topology Services              |"},{"line_number":81,"context_line":"      | ext-gw-mode               | Neutron L3 Configurable external gateway mode |"},{"line_number":82,"context_line":"      | binding                   | Port Binding                                  |"},{"line_number":83,"context_line":"      | trunk-details             | Trunk port details                            |"},{"line_number":84,"context_line":"      | agent                     | agent                                         |"},{"line_number":85,"context_line":"      | subnet_allocation         | Subnet Allocation                             |"},{"line_number":86,"context_line":"      | l3_agent_scheduler        | L3 Agent Scheduler                            |"},{"line_number":87,"context_line":"      | tag                       | Tag support                                   |"},{"line_number":88,"context_line":"      | external-net              | Neutron external network                      |"},{"line_number":89,"context_line":"      | net-mtu                   | Network MTU                                   |"},{"line_number":90,"context_line":"      | availability_zone         | Availability Zone                             |"},{"line_number":91,"context_line":"      | quotas                    | Quota management support                      |"},{"line_number":92,"context_line":"      | l3-ha                     | HA Router extension                           |"},{"line_number":93,"context_line":"      | provider                  | Provider Network                              |"},{"line_number":94,"context_line":"      | multi-provider            | Multi Provider Network                        |"},{"line_number":95,"context_line":"      | address-scope             | Address scope                                 |"},{"line_number":96,"context_line":"      | trunk                     | Trunk Extension                               |"},{"line_number":97,"context_line":"      | extraroute                | Neutron Extra Route                           |"},{"line_number":98,"context_line":"      | timestamp_core            | Time Stamp Fields addition for core resources |"},{"line_number":99,"context_line":"      | router                    | Neutron L3 Router                             |"},{"line_number":100,"context_line":"      | extra_dhcp_opt            | Neutron Extra DHCP opts                       |"},{"line_number":101,"context_line":"      | security-group            | security-group                                |"},{"line_number":102,"context_line":"      | dhcp_agent_scheduler      | DHCP Agent Scheduler                          |"},{"line_number":103,"context_line":"      | router_availability_zone  | Router Availability Zone                      |"},{"line_number":104,"context_line":"      | rbac-policies             | RBAC Policies                                 |"},{"line_number":105,"context_line":"      | standard-attr-description | standard-attr-description                     |"},{"line_number":106,"context_line":"      | port-security             | Port Security                                 |"},{"line_number":107,"context_line":"      | allowed-address-pairs     | Allowed Address Pairs                         |"},{"line_number":108,"context_line":"      | dvr                       | Distributed Virtual Router                    |"},{"line_number":109,"context_line":"      +---------------------------+-----------------------------------------------+"},{"line_number":110,"context_line":""},{"line_number":111,"context_line":"The ``trunk`` and ``trunk-details`` extensions should be available."},{"line_number":112,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"7a77a97e_5c4e55c2","line":109,"range":{"start_line":74,"start_character":6,"end_line":109,"end_character":83},"in_reply_to":"9a629dbe_2325e85b","updated":"2016-11-14 19:05:39.000000000","message":"Good catch, I haven\u0027t updated this.","commit_id":"f06c5f541420b8041160678100a43b131dd77871"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"e44fbae0433a44c7e5115a26719fed7bb402983e","unresolved":false,"context_lines":[{"line_number":108,"context_line":"      | dvr                       | Distributed Virtual Router                    |"},{"line_number":109,"context_line":"      +---------------------------+-----------------------------------------------+"},{"line_number":110,"context_line":""},{"line_number":111,"context_line":"The ``trunk`` and ``trunk-details`` extensions should be available."},{"line_number":112,"context_line":""},{"line_number":113,"context_line":"Workflow"},{"line_number":114,"context_line":"--------"}],"source_content_type":"text/x-rst","patch_set":6,"id":"7a77a97e_c137b5e1","line":111,"range":{"start_line":111,"start_character":47,"end_line":111,"end_character":56},"updated":"2016-11-15 13:10:24.000000000","message":"should be? are? - could we have a concrete note here :)","commit_id":"f06c5f541420b8041160678100a43b131dd77871"},{"author":{"_account_id":4187,"name":"Ryan Tidwell","email":"rtidwell@suse.com","username":"ryan-tidwell"},"change_message_id":"709905a660a2c7f3368336387f77ad426a05503f","unresolved":false,"context_lines":[{"line_number":108,"context_line":"      | dvr                       | Distributed Virtual Router                    |"},{"line_number":109,"context_line":"      +---------------------------+-----------------------------------------------+"},{"line_number":110,"context_line":""},{"line_number":111,"context_line":"The ``trunk`` and ``trunk-details`` extensions should be available."},{"line_number":112,"context_line":""},{"line_number":113,"context_line":"Workflow"},{"line_number":114,"context_line":"--------"}],"source_content_type":"text/x-rst","patch_set":6,"id":"7a77a97e_7d4af984","line":111,"range":{"start_line":111,"start_character":47,"end_line":111,"end_character":56},"in_reply_to":"7a77a97e_c137b5e1","updated":"2016-11-15 18:33:21.000000000","message":"I\u0027ll re-word this. The intent is to convey that the presence of both extensions is required for proper operation.","commit_id":"f06c5f541420b8041160678100a43b131dd77871"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"4cec1fd3397a929c38beb2dc11dfbce94d4af67e","unresolved":false,"context_lines":[{"line_number":116,"context_line":"At a high level, the basic steps to booting an instance on a trunk are"},{"line_number":117,"context_line":"the following:"},{"line_number":118,"context_line":""},{"line_number":119,"context_line":"#. Create a network for the trunk"},{"line_number":120,"context_line":"#. Create the networks that will participate in the trunk"},{"line_number":121,"context_line":"#. Create a parent port for the trunk"},{"line_number":122,"context_line":"#. Create ports for the subports on each trunked network"},{"line_number":123,"context_line":"#. Add the subports to the trunk"},{"line_number":124,"context_line":"#. Boot an instance on the parent port"},{"line_number":125,"context_line":""},{"line_number":126,"context_line":"Creating a trunk"},{"line_number":127,"context_line":"----------------"}],"source_content_type":"text/x-rst","patch_set":6,"id":"9a629dbe_78478b1d","line":124,"range":{"start_line":119,"start_character":0,"end_line":124,"end_character":38},"updated":"2016-11-14 11:18:13.000000000","message":"This list still doesn\u0027t match the order of commands below. Either remove it, or change the commands that follow to match.","commit_id":"f06c5f541420b8041160678100a43b131dd77871"},{"author":{"_account_id":4187,"name":"Ryan Tidwell","email":"rtidwell@suse.com","username":"ryan-tidwell"},"change_message_id":"091706159ea57e185e12bf38fe0f655dc29855c6","unresolved":false,"context_lines":[{"line_number":116,"context_line":"At a high level, the basic steps to booting an instance on a trunk are"},{"line_number":117,"context_line":"the following:"},{"line_number":118,"context_line":""},{"line_number":119,"context_line":"#. Create a network for the trunk"},{"line_number":120,"context_line":"#. Create the networks that will participate in the trunk"},{"line_number":121,"context_line":"#. Create a parent port for the trunk"},{"line_number":122,"context_line":"#. Create ports for the subports on each trunked network"},{"line_number":123,"context_line":"#. Add the subports to the trunk"},{"line_number":124,"context_line":"#. Boot an instance on the parent port"},{"line_number":125,"context_line":""},{"line_number":126,"context_line":"Creating a trunk"},{"line_number":127,"context_line":"----------------"}],"source_content_type":"text/x-rst","patch_set":6,"id":"7a77a97e_dcd0a5cc","line":124,"range":{"start_line":119,"start_character":0,"end_line":124,"end_character":38},"in_reply_to":"9a629dbe_78478b1d","updated":"2016-11-14 19:05:39.000000000","message":"I know this is the 2nd or 3rd time this was pointed out, til now I\u0027ve just been iterating on raw content. This is a good catch.","commit_id":"f06c5f541420b8041160678100a43b131dd77871"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"4cec1fd3397a929c38beb2dc11dfbce94d4af67e","unresolved":false,"context_lines":[{"line_number":164,"context_line":""},{"line_number":165,"context_line":"#. Create the trunk by specifying ``trunk-parent`` as the parent port:"},{"line_number":166,"context_line":""},{"line_number":167,"context_line":"     .. code-block:: console"},{"line_number":168,"context_line":""},{"line_number":169,"context_line":"      $ openstack network trunk create --parent-port 73fb9d54-43a7-4bb1-a8dc-569e0e0a0a38 trunk"},{"line_number":170,"context_line":"      +-----------------+--------------------------------------+"}],"source_content_type":"text/x-rst","patch_set":6,"id":"9a629dbe_03a544b4","line":167,"updated":"2016-11-14 11:18:13.000000000","message":"This should be indented one level less.","commit_id":"f06c5f541420b8041160678100a43b131dd77871"},{"author":{"_account_id":4187,"name":"Ryan Tidwell","email":"rtidwell@suse.com","username":"ryan-tidwell"},"change_message_id":"091706159ea57e185e12bf38fe0f655dc29855c6","unresolved":false,"context_lines":[{"line_number":164,"context_line":""},{"line_number":165,"context_line":"#. Create the trunk by specifying ``trunk-parent`` as the parent port:"},{"line_number":166,"context_line":""},{"line_number":167,"context_line":"     .. code-block:: console"},{"line_number":168,"context_line":""},{"line_number":169,"context_line":"      $ openstack network trunk create --parent-port 73fb9d54-43a7-4bb1-a8dc-569e0e0a0a38 trunk"},{"line_number":170,"context_line":"      +-----------------+--------------------------------------+"}],"source_content_type":"text/x-rst","patch_set":6,"id":"7a77a97e_1cdbfdee","line":167,"in_reply_to":"9a629dbe_03a544b4","updated":"2016-11-14 19:05:39.000000000","message":"Done","commit_id":"f06c5f541420b8041160678100a43b131dd77871"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"e44fbae0433a44c7e5115a26719fed7bb402983e","unresolved":false,"context_lines":[{"line_number":186,"context_line":"Creating subports"},{"line_number":187,"context_line":"-----------------"},{"line_number":188,"context_line":""},{"line_number":189,"context_line":"Subports can be added to a trunk in two ways:"},{"line_number":190,"context_line":""},{"line_number":191,"context_line":"#. Method 1: Create trunk with subports:"},{"line_number":192,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"7a77a97e_815cdd26","line":189,"range":{"start_line":189,"start_character":40,"end_line":189,"end_character":45},"updated":"2016-11-15 13:10:24.000000000","message":"I think this should be a full stop.","commit_id":"f06c5f541420b8041160678100a43b131dd77871"},{"author":{"_account_id":4187,"name":"Ryan Tidwell","email":"rtidwell@suse.com","username":"ryan-tidwell"},"change_message_id":"709905a660a2c7f3368336387f77ad426a05503f","unresolved":false,"context_lines":[{"line_number":186,"context_line":"Creating subports"},{"line_number":187,"context_line":"-----------------"},{"line_number":188,"context_line":""},{"line_number":189,"context_line":"Subports can be added to a trunk in two ways:"},{"line_number":190,"context_line":""},{"line_number":191,"context_line":"#. Method 1: Create trunk with subports:"},{"line_number":192,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"7a77a97e_1d5ca54a","line":189,"range":{"start_line":189,"start_character":40,"end_line":189,"end_character":45},"in_reply_to":"7a77a97e_815cdd26","updated":"2016-11-15 18:33:21.000000000","message":"Done","commit_id":"f06c5f541420b8041160678100a43b131dd77871"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"4cec1fd3397a929c38beb2dc11dfbce94d4af67e","unresolved":false,"context_lines":[{"line_number":190,"context_line":""},{"line_number":191,"context_line":"#. Method 1: Create trunk with subports:"},{"line_number":192,"context_line":""},{"line_number":193,"context_line":"This method entails creating the trunk with subports specified at trunk creation."},{"line_number":194,"context_line":""},{"line_number":195,"context_line":"   .. code-block:: console"},{"line_number":196,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"9a629dbe_433f3cd6","line":193,"range":{"start_line":193,"start_character":0,"end_line":193,"end_character":81},"updated":"2016-11-14 11:18:13.000000000","message":"This section isn\u0027t formatting correctly. I suspect you need to indent this line.","commit_id":"f06c5f541420b8041160678100a43b131dd77871"},{"author":{"_account_id":4187,"name":"Ryan Tidwell","email":"rtidwell@suse.com","username":"ryan-tidwell"},"change_message_id":"091706159ea57e185e12bf38fe0f655dc29855c6","unresolved":false,"context_lines":[{"line_number":190,"context_line":""},{"line_number":191,"context_line":"#. Method 1: Create trunk with subports:"},{"line_number":192,"context_line":""},{"line_number":193,"context_line":"This method entails creating the trunk with subports specified at trunk creation."},{"line_number":194,"context_line":""},{"line_number":195,"context_line":"   .. code-block:: console"},{"line_number":196,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"7a77a97e_3cd8b9ef","line":193,"range":{"start_line":193,"start_character":0,"end_line":193,"end_character":81},"in_reply_to":"9a629dbe_433f3cd6","updated":"2016-11-14 19:05:39.000000000","message":"Done","commit_id":"f06c5f541420b8041160678100a43b131dd77871"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"4cec1fd3397a929c38beb2dc11dfbce94d4af67e","unresolved":false,"context_lines":[{"line_number":255,"context_line":"      +---------------------+-----------------------------------------------------------------------+"},{"line_number":256,"context_line":""},{"line_number":257,"context_line":""},{"line_number":258,"context_line":"      $ openstack network trunk create --parent-port 73fb9d54-43a7-4bb1-a8dc-569e0e0a0a38 --subport port\u003d91f9dde8-80a4-4506-b5da-c287feb8f5d8,segmentation-type\u003dvlan,segmentation-id\u003d100"},{"line_number":259,"context_line":"      +-----------------+-------------------------------------------------------------------------------------------------+"},{"line_number":260,"context_line":"      | Field           | Value                                                                                           |"},{"line_number":261,"context_line":"      +-----------------+-------------------------------------------------------------------------------------------------+"}],"source_content_type":"text/x-rst","patch_set":6,"id":"9a629dbe_b8684389","line":258,"updated":"2016-11-14 11:18:13.000000000","message":"escape this with a \u0027\\\u0027 before it gets to 79 chars and continue on the next line","commit_id":"f06c5f541420b8041160678100a43b131dd77871"},{"author":{"_account_id":4187,"name":"Ryan Tidwell","email":"rtidwell@suse.com","username":"ryan-tidwell"},"change_message_id":"091706159ea57e185e12bf38fe0f655dc29855c6","unresolved":false,"context_lines":[{"line_number":255,"context_line":"      +---------------------+-----------------------------------------------------------------------+"},{"line_number":256,"context_line":""},{"line_number":257,"context_line":""},{"line_number":258,"context_line":"      $ openstack network trunk create --parent-port 73fb9d54-43a7-4bb1-a8dc-569e0e0a0a38 --subport port\u003d91f9dde8-80a4-4506-b5da-c287feb8f5d8,segmentation-type\u003dvlan,segmentation-id\u003d100"},{"line_number":259,"context_line":"      +-----------------+-------------------------------------------------------------------------------------------------+"},{"line_number":260,"context_line":"      | Field           | Value                                                                                           |"},{"line_number":261,"context_line":"      +-----------------+-------------------------------------------------------------------------------------------------+"}],"source_content_type":"text/x-rst","patch_set":6,"id":"7a77a97e_7ce231a1","line":258,"in_reply_to":"9a629dbe_b8684389","updated":"2016-11-14 19:05:39.000000000","message":"Done","commit_id":"f06c5f541420b8041160678100a43b131dd77871"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"4cec1fd3397a929c38beb2dc11dfbce94d4af67e","unresolved":false,"context_lines":[{"line_number":275,"context_line":""},{"line_number":276,"context_line":"#. Method 2: Add subports to an existing trunk:"},{"line_number":277,"context_line":""},{"line_number":278,"context_line":"This method entails creating a trunk, then adding subports to the trunk after"},{"line_number":279,"context_line":"it has already been created."},{"line_number":280,"context_line":""},{"line_number":281,"context_line":"   .. code-block:: console"},{"line_number":282,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"9a629dbe_2311685e","line":279,"range":{"start_line":278,"start_character":0,"end_line":279,"end_character":28},"updated":"2016-11-14 11:18:13.000000000","message":"Ditto L193","commit_id":"f06c5f541420b8041160678100a43b131dd77871"},{"author":{"_account_id":4187,"name":"Ryan Tidwell","email":"rtidwell@suse.com","username":"ryan-tidwell"},"change_message_id":"091706159ea57e185e12bf38fe0f655dc29855c6","unresolved":false,"context_lines":[{"line_number":275,"context_line":""},{"line_number":276,"context_line":"#. Method 2: Add subports to an existing trunk:"},{"line_number":277,"context_line":""},{"line_number":278,"context_line":"This method entails creating a trunk, then adding subports to the trunk after"},{"line_number":279,"context_line":"it has already been created."},{"line_number":280,"context_line":""},{"line_number":281,"context_line":"   .. code-block:: console"},{"line_number":282,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"7a77a97e_bcf2096e","line":279,"range":{"start_line":278,"start_character":0,"end_line":279,"end_character":28},"in_reply_to":"9a629dbe_2311685e","updated":"2016-11-14 19:05:39.000000000","message":"Done","commit_id":"f06c5f541420b8041160678100a43b131dd77871"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"4cec1fd3397a929c38beb2dc11dfbce94d4af67e","unresolved":false,"context_lines":[{"line_number":280,"context_line":""},{"line_number":281,"context_line":"   .. code-block:: console"},{"line_number":282,"context_line":""},{"line_number":283,"context_line":"      $ openstack network trunk set --subport port\u003d91f9dde8-80a4-4506-b5da-c287feb8f5d8,segmentation-type\u003dvlan,segmentation-id\u003d100 61d8e620-fe3a-4d8f-b9e6-e1b0dea6d9e3"},{"line_number":284,"context_line":""},{"line_number":285,"context_line":"      $ openstack network trunk show 61d8e620-fe3a-4d8f-b9e6-e1b0dea6d9e3"},{"line_number":286,"context_line":"      +-----------------+-------------------------------------------------------------------------------------------------+"}],"source_content_type":"text/x-rst","patch_set":6,"id":"9a629dbe_78f5cbc9","line":283,"updated":"2016-11-14 11:18:13.000000000","message":"escape this with a \u0027\\\u0027 before it gets to 79 chars and continue on the next line","commit_id":"f06c5f541420b8041160678100a43b131dd77871"},{"author":{"_account_id":4187,"name":"Ryan Tidwell","email":"rtidwell@suse.com","username":"ryan-tidwell"},"change_message_id":"091706159ea57e185e12bf38fe0f655dc29855c6","unresolved":false,"context_lines":[{"line_number":280,"context_line":""},{"line_number":281,"context_line":"   .. code-block:: console"},{"line_number":282,"context_line":""},{"line_number":283,"context_line":"      $ openstack network trunk set --subport port\u003d91f9dde8-80a4-4506-b5da-c287feb8f5d8,segmentation-type\u003dvlan,segmentation-id\u003d100 61d8e620-fe3a-4d8f-b9e6-e1b0dea6d9e3"},{"line_number":284,"context_line":""},{"line_number":285,"context_line":"      $ openstack network trunk show 61d8e620-fe3a-4d8f-b9e6-e1b0dea6d9e3"},{"line_number":286,"context_line":"      +-----------------+-------------------------------------------------------------------------------------------------+"}],"source_content_type":"text/x-rst","patch_set":6,"id":"7a77a97e_dce7c5aa","line":283,"in_reply_to":"9a629dbe_78f5cbc9","updated":"2016-11-14 19:05:39.000000000","message":"Done","commit_id":"f06c5f541420b8041160678100a43b131dd77871"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"4cec1fd3397a929c38beb2dc11dfbce94d4af67e","unresolved":false,"context_lines":[{"line_number":307,"context_line":"   .. code-block:: console"},{"line_number":308,"context_line":""},{"line_number":309,"context_line":"      $ openstack network trunk show 61d8e620-fe3a-4d8f-b9e6-e1b0dea6d9e3"},{"line_number":310,"context_line":"      +-----------------+-------------------------------------------------------------------------------------------------+"},{"line_number":311,"context_line":"      | Field           | Value                                                                                           |"},{"line_number":312,"context_line":"      +-----------------+-------------------------------------------------------------------------------------------------+"},{"line_number":313,"context_line":"      | admin_state_up  | UP                                                                                              |"},{"line_number":314,"context_line":"      | created_at      | 2016-09-13T21:35:01Z                                                                            |"},{"line_number":315,"context_line":"      | description     |                                                                                                 |"},{"line_number":316,"context_line":"      | id              | 61d8e620-fe3a-4d8f-b9e6-e1b0dea6d9e3                                                            |"},{"line_number":317,"context_line":"      | name            | trunk                                                                                           |"},{"line_number":318,"context_line":"      | port_id         | 73fb9d54-43a7-4bb1-a8dc-569e0e0a0a38                                                            |"},{"line_number":319,"context_line":"      | revision_number | 1                                                                                               |"},{"line_number":320,"context_line":"      | status          | DOWN                                                                                            |"},{"line_number":321,"context_line":"      | sub_ports       |                                                                                                 |"},{"line_number":322,"context_line":"      | tenant_id       | b5c38e6514324770adaa237fbebd7ce8                                                                |"},{"line_number":323,"context_line":"      | updated_at      | 2016-09-13T21:35:01Z                                                                            |"},{"line_number":324,"context_line":"      +-----------------+-------------------------------------------------------------------------------------------------+"},{"line_number":325,"context_line":""},{"line_number":326,"context_line":"#. Add subports to the trunk:"},{"line_number":327,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"9a629dbe_581f2709","line":324,"range":{"start_line":310,"start_character":5,"end_line":324,"end_character":123},"updated":"2016-11-14 11:18:13.000000000","message":"Table doesn\u0027t need to be so wide","commit_id":"f06c5f541420b8041160678100a43b131dd77871"},{"author":{"_account_id":4187,"name":"Ryan Tidwell","email":"rtidwell@suse.com","username":"ryan-tidwell"},"change_message_id":"091706159ea57e185e12bf38fe0f655dc29855c6","unresolved":false,"context_lines":[{"line_number":307,"context_line":"   .. code-block:: console"},{"line_number":308,"context_line":""},{"line_number":309,"context_line":"      $ openstack network trunk show 61d8e620-fe3a-4d8f-b9e6-e1b0dea6d9e3"},{"line_number":310,"context_line":"      +-----------------+-------------------------------------------------------------------------------------------------+"},{"line_number":311,"context_line":"      | Field           | Value                                                                                           |"},{"line_number":312,"context_line":"      +-----------------+-------------------------------------------------------------------------------------------------+"},{"line_number":313,"context_line":"      | admin_state_up  | UP                                                                                              |"},{"line_number":314,"context_line":"      | created_at      | 2016-09-13T21:35:01Z                                                                            |"},{"line_number":315,"context_line":"      | description     |                                                                                                 |"},{"line_number":316,"context_line":"      | id              | 61d8e620-fe3a-4d8f-b9e6-e1b0dea6d9e3                                                            |"},{"line_number":317,"context_line":"      | name            | trunk                                                                                           |"},{"line_number":318,"context_line":"      | port_id         | 73fb9d54-43a7-4bb1-a8dc-569e0e0a0a38                                                            |"},{"line_number":319,"context_line":"      | revision_number | 1                                                                                               |"},{"line_number":320,"context_line":"      | status          | DOWN                                                                                            |"},{"line_number":321,"context_line":"      | sub_ports       |                                                                                                 |"},{"line_number":322,"context_line":"      | tenant_id       | b5c38e6514324770adaa237fbebd7ce8                                                                |"},{"line_number":323,"context_line":"      | updated_at      | 2016-09-13T21:35:01Z                                                                            |"},{"line_number":324,"context_line":"      +-----------------+-------------------------------------------------------------------------------------------------+"},{"line_number":325,"context_line":""},{"line_number":326,"context_line":"#. Add subports to the trunk:"},{"line_number":327,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"7a77a97e_7cf9514d","line":324,"range":{"start_line":310,"start_character":5,"end_line":324,"end_character":123},"in_reply_to":"9a629dbe_581f2709","updated":"2016-11-14 19:05:39.000000000","message":"Done","commit_id":"f06c5f541420b8041160678100a43b131dd77871"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"4cec1fd3397a929c38beb2dc11dfbce94d4af67e","unresolved":false,"context_lines":[{"line_number":333,"context_line":""},{"line_number":334,"context_line":"   .. code-block:: console"},{"line_number":335,"context_line":""},{"line_number":336,"context_line":"      $ openstack server create --nic port-id\u003d73fb9d54-43a7-4bb1-a8dc-569e0e0a0a38 --flavor 1 --image a6ece084-0db4-4cd2-893a-70b52ef5460a my-instance"},{"line_number":337,"context_line":""},{"line_number":338,"context_line":"Using trunks and subports inside an instance"},{"line_number":339,"context_line":"--------------------------------------------"}],"source_content_type":"text/x-rst","patch_set":6,"id":"9a629dbe_9819bf25","line":336,"updated":"2016-11-14 11:18:13.000000000","message":"escape this with a \u0027\\\u0027 before it gets to 79 chars and continue on the next line","commit_id":"f06c5f541420b8041160678100a43b131dd77871"},{"author":{"_account_id":4187,"name":"Ryan Tidwell","email":"rtidwell@suse.com","username":"ryan-tidwell"},"change_message_id":"091706159ea57e185e12bf38fe0f655dc29855c6","unresolved":false,"context_lines":[{"line_number":333,"context_line":""},{"line_number":334,"context_line":"   .. code-block:: console"},{"line_number":335,"context_line":""},{"line_number":336,"context_line":"      $ openstack server create --nic port-id\u003d73fb9d54-43a7-4bb1-a8dc-569e0e0a0a38 --flavor 1 --image a6ece084-0db4-4cd2-893a-70b52ef5460a my-instance"},{"line_number":337,"context_line":""},{"line_number":338,"context_line":"Using trunks and subports inside an instance"},{"line_number":339,"context_line":"--------------------------------------------"}],"source_content_type":"text/x-rst","patch_set":6,"id":"7a77a97e_9c946de9","line":336,"in_reply_to":"9a629dbe_9819bf25","updated":"2016-11-14 19:05:39.000000000","message":"Done","commit_id":"f06c5f541420b8041160678100a43b131dd77871"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"4cec1fd3397a929c38beb2dc11dfbce94d4af67e","unresolved":false,"context_lines":[{"line_number":397,"context_line":"Known Limitations"},{"line_number":398,"context_line":"-----------------"},{"line_number":399,"context_line":""},{"line_number":400,"context_line":"* `https://bugs.launchpad.net/neutron/+bug/1626010`"},{"line_number":401,"context_line":"* `https://bugs.launchpad.net/neutron/+bug/1593760`"},{"line_number":402,"context_line":"* `https://bugs.launchpad.net/neutron/+bug/1639186`"},{"line_number":403,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"9a629dbe_b8c4c35f","line":402,"range":{"start_line":400,"start_character":0,"end_line":402,"end_character":51},"updated":"2016-11-14 11:18:13.000000000","message":"remove backticks","commit_id":"f06c5f541420b8041160678100a43b131dd77871"},{"author":{"_account_id":4187,"name":"Ryan Tidwell","email":"rtidwell@suse.com","username":"ryan-tidwell"},"change_message_id":"091706159ea57e185e12bf38fe0f655dc29855c6","unresolved":false,"context_lines":[{"line_number":397,"context_line":"Known Limitations"},{"line_number":398,"context_line":"-----------------"},{"line_number":399,"context_line":""},{"line_number":400,"context_line":"* `https://bugs.launchpad.net/neutron/+bug/1626010`"},{"line_number":401,"context_line":"* `https://bugs.launchpad.net/neutron/+bug/1593760`"},{"line_number":402,"context_line":"* `https://bugs.launchpad.net/neutron/+bug/1639186`"},{"line_number":403,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"7a77a97e_dc9ee506","line":402,"range":{"start_line":400,"start_character":0,"end_line":402,"end_character":51},"in_reply_to":"9a629dbe_b8c4c35f","updated":"2016-11-14 19:05:39.000000000","message":"Done","commit_id":"f06c5f541420b8041160678100a43b131dd77871"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"a943b11596fe9b09adb92031057bf296e4669047","unresolved":false,"context_lines":[{"line_number":1,"context_line":".. _config-vlan-trunking:"},{"line_number":2,"context_line":""},{"line_number":3,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":4,"context_line":"VLAN-Aware VM\u0027s"},{"line_number":5,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":6,"context_line":""},{"line_number":7,"context_line":"The VLAN trunk service allows multiple networks to be connected to an instance"}],"source_content_type":"text/x-rst","patch_set":9,"id":"7a77a97e_324c1242","line":4,"range":{"start_line":4,"start_character":11,"end_line":4,"end_character":15},"updated":"2016-11-16 10:08:10.000000000","message":"If we mean \u0027virtual machines\u0027 here (plural), remove the apostrophe.","commit_id":"203b5fff53ac038a04eff290e17557e3ba7b7374"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"8029e6d36e10c4252f5e2334015e41f902fb34bd","unresolved":false,"context_lines":[{"line_number":1,"context_line":".. _config-vlan-trunking:"},{"line_number":2,"context_line":""},{"line_number":3,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":4,"context_line":"VLAN-Aware VM\u0027s"},{"line_number":5,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":6,"context_line":""},{"line_number":7,"context_line":"The VLAN trunk service allows multiple networks to be connected to an instance"}],"source_content_type":"text/x-rst","patch_set":10,"id":"7a77a97e_0921a49f","line":4,"range":{"start_line":4,"start_character":11,"end_line":4,"end_character":15},"updated":"2016-11-16 11:47:40.000000000","message":"agree with Olena on removing the apostrophe","commit_id":"7283aff20a3ea1fc4afde855b62e0761ed448b0f"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"8029e6d36e10c4252f5e2334015e41f902fb34bd","unresolved":false,"context_lines":[{"line_number":30,"context_line":"as a ``segmentation-type``."},{"line_number":31,"context_line":""},{"line_number":32,"context_line":"The ``segmentation-type`` and ``segmentation-id`` specified by the user on the"},{"line_number":33,"context_line":"subports is intentionally decoupled from the segmentation type and ID of"},{"line_number":34,"context_line":"neutron networks. For example, it is possible to configure neutron with"},{"line_number":35,"context_line":"``tenant_network_types \u003d vxlan`` and still create subports with"},{"line_number":36,"context_line":"``segmentation_type \u003d vlan``. Neutron will remap packets as needed."}],"source_content_type":"text/x-rst","patch_set":10,"id":"7a77a97e_f62fe73b","line":33,"range":{"start_line":33,"start_character":45,"end_line":33,"end_character":62},"updated":"2016-11-16 11:47:40.000000000","message":"``segmentation-type`` - missed from a previous review","commit_id":"7283aff20a3ea1fc4afde855b62e0761ed448b0f"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"8029e6d36e10c4252f5e2334015e41f902fb34bd","unresolved":false,"context_lines":[{"line_number":195,"context_line":"    |updated_at           | 2016-09-13T21:19:55                                                   |"},{"line_number":196,"context_line":"    +---------------------+-----------------------------------------------------------------------+"},{"line_number":197,"context_line":""},{"line_number":198,"context_line":"* Create the trunk using ``parent-port`` to reference the port from the"},{"line_number":199,"context_line":"  previous step."},{"line_number":200,"context_line":""},{"line_number":201,"context_line":"  .. code-block:: console"}],"source_content_type":"text/x-rst","patch_set":10,"id":"7a77a97e_d6dd8b15","line":198,"range":{"start_line":198,"start_character":25,"end_line":198,"end_character":40},"updated":"2016-11-16 11:47:40.000000000","message":":option:`--parent-port`","commit_id":"7283aff20a3ea1fc4afde855b62e0761ed448b0f"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"8029e6d36e10c4252f5e2334015e41f902fb34bd","unresolved":false,"context_lines":[{"line_number":290,"context_line":"      +---------------------+-----------------------------------------------------------------------+"},{"line_number":291,"context_line":""},{"line_number":292,"context_line":""},{"line_number":293,"context_line":"      $ openstack network trunk create\\"},{"line_number":294,"context_line":"        --parent-port 73fb9d54-43a7-4bb1-a8dc-569e0e0a0a38\\"},{"line_number":295,"context_line":"        --subport port\u003d91f9dde8-80a4-4506-b5da-c287feb8f5d8,\\"},{"line_number":296,"context_line":"        segmentation-type\u003dvlan,segmentation-id\u003d100"},{"line_number":297,"context_line":"      +-----------------+-------------------------------------------------------------------------------------------------+"},{"line_number":298,"context_line":"      | Field           | Value                                                                                           |"}],"source_content_type":"text/x-rst","patch_set":10,"id":"7a77a97e_768597ab","line":295,"range":{"start_line":293,"start_character":8,"end_line":295,"end_character":61},"updated":"2016-11-16 11:47:40.000000000","message":"need a space before each \u0027\\\u0027 char","commit_id":"7283aff20a3ea1fc4afde855b62e0761ed448b0f"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"8029e6d36e10c4252f5e2334015e41f902fb34bd","unresolved":false,"context_lines":[{"line_number":318,"context_line":""},{"line_number":319,"context_line":"   .. code-block:: console"},{"line_number":320,"context_line":""},{"line_number":321,"context_line":"      $ openstack network trunk set --subport\\"},{"line_number":322,"context_line":"        port\u003d91f9dde8-80a4-4506-b5da-c287feb8f5d8,\\"},{"line_number":323,"context_line":"        segmentation-type\u003dvlan,\\"},{"line_number":324,"context_line":"        segmentation-id\u003d100 61d8e620-fe3a-4d8f-b9e6-e1b0dea6d9e3"},{"line_number":325,"context_line":""},{"line_number":326,"context_line":"      $ openstack network trunk show 61d8e620-fe3a-4d8f-b9e6-e1b0dea6d9e3"}],"source_content_type":"text/x-rst","patch_set":10,"id":"7a77a97e_96ab131d","line":323,"range":{"start_line":321,"start_character":0,"end_line":323,"end_character":32},"updated":"2016-11-16 11:47:40.000000000","message":"ditto L295","commit_id":"7283aff20a3ea1fc4afde855b62e0761ed448b0f"},{"author":{"_account_id":6635,"name":"John Davidge","email":"john.davidge@rackspace.com","username":"john-davidge"},"change_message_id":"8029e6d36e10c4252f5e2334015e41f902fb34bd","unresolved":false,"context_lines":[{"line_number":369,"context_line":""},{"line_number":370,"context_line":"  .. code-block:: console"},{"line_number":371,"context_line":""},{"line_number":372,"context_line":"     $ openstack server create\\"},{"line_number":373,"context_line":"       --nic port-id\u003d73fb9d54-43a7-4bb1-a8dc-569e0e0a0a38\\"},{"line_number":374,"context_line":"       --flavor 1 --image a6ece084-0db4-4cd2-893a-70b52ef5460a my-instance"},{"line_number":375,"context_line":""},{"line_number":376,"context_line":"Using trunks and subports inside an instance"},{"line_number":377,"context_line":"--------------------------------------------"}],"source_content_type":"text/x-rst","patch_set":10,"id":"7a77a97e_f6660728","line":374,"range":{"start_line":372,"start_character":0,"end_line":374,"end_character":74},"updated":"2016-11-16 11:47:40.000000000","message":"ditto L295","commit_id":"7283aff20a3ea1fc4afde855b62e0761ed448b0f"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"1b118a31eaa4a3236522e098383e8635466bcd23","unresolved":false,"context_lines":[{"line_number":1,"context_line":".. _config-vlan-trunking:"},{"line_number":2,"context_line":""},{"line_number":3,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":4,"context_line":"VLAN-Aware VMs"},{"line_number":5,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":6,"context_line":""},{"line_number":7,"context_line":"The VLAN trunk service allows multiple networks to be connected to an instance"}],"source_content_type":"text/x-rst","patch_set":11,"id":"7a77a97e_4d646848","line":4,"updated":"2016-11-16 22:20:07.000000000","message":"just a note: right now, there\u0027s nothing specific to vlans when trunking networks. I wonder if a more generic title is appropriate, like Networking trunking.","commit_id":"9c063221237019b755bb53017c575f89949e3763"},{"author":{"_account_id":9515,"name":"Matthew Kassawara","email":"mkassawara@gmail.com","username":"ionosphere80"},"change_message_id":"efd8e228c004b4451d3de9c174910b3ba4bc5709","unresolved":false,"context_lines":[{"line_number":1,"context_line":".. _config-vlan-trunking:"},{"line_number":2,"context_line":""},{"line_number":3,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":4,"context_line":"VLAN-Aware VMs"},{"line_number":5,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":6,"context_line":""},{"line_number":7,"context_line":"The VLAN trunk service allows multiple networks to be connected to an instance"}],"source_content_type":"text/x-rst","patch_set":11,"id":"7a77a97e_c6e5b238","line":4,"in_reply_to":"7a77a97e_064b2db1","updated":"2016-11-17 01:24:33.000000000","message":"To remove any vendor-specific connotation, we should use VLAN-aware or VLAN tagging instead of variations on trunk.","commit_id":"9c063221237019b755bb53017c575f89949e3763"},{"author":{"_account_id":4187,"name":"Ryan Tidwell","email":"rtidwell@suse.com","username":"ryan-tidwell"},"change_message_id":"83713307a308f35846cf89913b7b5ed238f8fcd1","unresolved":false,"context_lines":[{"line_number":1,"context_line":".. _config-vlan-trunking:"},{"line_number":2,"context_line":""},{"line_number":3,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":4,"context_line":"VLAN-Aware VMs"},{"line_number":5,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":6,"context_line":""},{"line_number":7,"context_line":"The VLAN trunk service allows multiple networks to be connected to an instance"}],"source_content_type":"text/x-rst","patch_set":11,"id":"7a77a97e_064b2db1","line":4,"in_reply_to":"7a77a97e_4d646848","updated":"2016-11-16 23:22:12.000000000","message":"I started down that route, but was persuaded to go with the well-known name of the feature. I\u0027m actually partial to \"Network trunking\"","commit_id":"9c063221237019b755bb53017c575f89949e3763"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"1b118a31eaa4a3236522e098383e8635466bcd23","unresolved":false,"context_lines":[{"line_number":4,"context_line":"VLAN-Aware VMs"},{"line_number":5,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":6,"context_line":""},{"line_number":7,"context_line":"The VLAN trunk service allows multiple networks to be connected to an instance"},{"line_number":8,"context_line":"using a single virtual NIC (vNIC). Multiple networks can be presented to an"},{"line_number":9,"context_line":"instance by connecting it to a single port."},{"line_number":10,"context_line":""}],"source_content_type":"text/x-rst","patch_set":11,"id":"7a77a97e_0d4b50b1","line":7,"updated":"2016-11-16 22:20:07.000000000","message":"I wonder if it\u0027s appropriate to drop any specific reference to VLAN and try to make this a little more agnostic of the segmentation type (except where we provide actual examples)","commit_id":"9c063221237019b755bb53017c575f89949e3763"},{"author":{"_account_id":4187,"name":"Ryan Tidwell","email":"rtidwell@suse.com","username":"ryan-tidwell"},"change_message_id":"83713307a308f35846cf89913b7b5ed238f8fcd1","unresolved":false,"context_lines":[{"line_number":4,"context_line":"VLAN-Aware VMs"},{"line_number":5,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":6,"context_line":""},{"line_number":7,"context_line":"The VLAN trunk service allows multiple networks to be connected to an instance"},{"line_number":8,"context_line":"using a single virtual NIC (vNIC). Multiple networks can be presented to an"},{"line_number":9,"context_line":"instance by connecting it to a single port."},{"line_number":10,"context_line":""}],"source_content_type":"text/x-rst","patch_set":11,"id":"7a77a97e_e6e631b3","line":7,"in_reply_to":"7a77a97e_0d4b50b1","updated":"2016-11-16 23:22:12.000000000","message":"You\u0027re probably right. What I wanted to accomplish was to shed some light on how to use the reference implementations.","commit_id":"9c063221237019b755bb53017c575f89949e3763"},{"author":{"_account_id":9515,"name":"Matthew Kassawara","email":"mkassawara@gmail.com","username":"ionosphere80"},"change_message_id":"efd8e228c004b4451d3de9c174910b3ba4bc5709","unresolved":false,"context_lines":[{"line_number":4,"context_line":"VLAN-Aware VMs"},{"line_number":5,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":6,"context_line":""},{"line_number":7,"context_line":"The VLAN trunk service allows multiple networks to be connected to an instance"},{"line_number":8,"context_line":"using a single virtual NIC (vNIC). Multiple networks can be presented to an"},{"line_number":9,"context_line":"instance by connecting it to a single port."},{"line_number":10,"context_line":""}],"source_content_type":"text/x-rst","patch_set":11,"id":"7a77a97e_06608aa4","line":7,"in_reply_to":"7a77a97e_e6e631b3","updated":"2016-11-17 01:24:33.000000000","message":"As I see it from a conceptual level...\n\nFor VLAN-type networks, this feature simply passes a VLAN tag to the instance VIF rather than stripping it via the layer-2 agent on the compute node.\n\nFor overlay-type networks, this feature generates a VLAN tag via the layer-2 agent on the compute node and passes it to the instance VIF.","commit_id":"9c063221237019b755bb53017c575f89949e3763"},{"author":{"_account_id":9515,"name":"Matthew Kassawara","email":"mkassawara@gmail.com","username":"ionosphere80"},"change_message_id":"efd8e228c004b4451d3de9c174910b3ba4bc5709","unresolved":false,"context_lines":[{"line_number":31,"context_line":""},{"line_number":32,"context_line":"The ``segmentation-type`` and ``segmentation-id`` specified by the user on the"},{"line_number":33,"context_line":"subports is intentionally decoupled from the ``segmentation-type`` and ID of"},{"line_number":34,"context_line":"neutron networks. For example, it is possible to configure neutron with"},{"line_number":35,"context_line":"``tenant_network_types \u003d vxlan`` and still create subports with"},{"line_number":36,"context_line":"``segmentation_type \u003d vlan``. Neutron will remap packets as needed."},{"line_number":37,"context_line":""}],"source_content_type":"text/x-rst","patch_set":11,"id":"7a77a97e_c6f05294","line":34,"updated":"2016-11-17 01:24:33.000000000","message":"We use \"Networking service\" instead of \"neutron\" whenever possible. Sometimes, the phrases \"virtual network\" or \"cloud network\" sound better than \"Networking service networks\".","commit_id":"9c063221237019b755bb53017c575f89949e3763"},{"author":{"_account_id":4187,"name":"Ryan Tidwell","email":"rtidwell@suse.com","username":"ryan-tidwell"},"change_message_id":"5ce96ad5479447ee540002a1cb7aa56ae032d94e","unresolved":false,"context_lines":[{"line_number":31,"context_line":""},{"line_number":32,"context_line":"The ``segmentation-type`` and ``segmentation-id`` specified by the user on the"},{"line_number":33,"context_line":"subports is intentionally decoupled from the ``segmentation-type`` and ID of"},{"line_number":34,"context_line":"neutron networks. For example, it is possible to configure neutron with"},{"line_number":35,"context_line":"``tenant_network_types \u003d vxlan`` and still create subports with"},{"line_number":36,"context_line":"``segmentation_type \u003d vlan``. Neutron will remap packets as needed."},{"line_number":37,"context_line":""}],"source_content_type":"text/x-rst","patch_set":11,"id":"5a74a57a_8105dd15","line":34,"in_reply_to":"7a77a97e_c6f05294","updated":"2016-11-29 19:18:29.000000000","message":"Done","commit_id":"9c063221237019b755bb53017c575f89949e3763"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"1b118a31eaa4a3236522e098383e8635466bcd23","unresolved":false,"context_lines":[{"line_number":35,"context_line":"``tenant_network_types \u003d vxlan`` and still create subports with"},{"line_number":36,"context_line":"``segmentation_type \u003d vlan``. Neutron will remap packets as needed."},{"line_number":37,"context_line":""},{"line_number":38,"context_line":"Design details can be found `here \u003chttp://specs.openstack.org/openstack/neutron-specs/specs/newton/vlan-aware-vms.html\u003e`_."},{"line_number":39,"context_line":""},{"line_number":40,"context_line":""},{"line_number":41,"context_line":"Example configuration"}],"source_content_type":"text/x-rst","patch_set":11,"id":"7a77a97e_cdfeb837","line":38,"updated":"2016-11-16 22:20:07.000000000","message":"\u0027Here\u0027 is not very UX friendly. I\u0027d replace it with a more meaningful link.\n\nAlso what about we add [1] to the list of references?\n\n[1] http://docs.openstack.org/developer/neutron/devref/openvswitch_agent.html#tackling-the-network-trunking-use-case","commit_id":"9c063221237019b755bb53017c575f89949e3763"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"c40dbdf25a7c4fdd566666c02fee62de3b5553a7","unresolved":false,"context_lines":[{"line_number":35,"context_line":"``tenant_network_types \u003d vxlan`` and still create subports with"},{"line_number":36,"context_line":"``segmentation_type \u003d vlan``. Neutron will remap packets as needed."},{"line_number":37,"context_line":""},{"line_number":38,"context_line":"Design details can be found `here \u003chttp://specs.openstack.org/openstack/neutron-specs/specs/newton/vlan-aware-vms.html\u003e`_."},{"line_number":39,"context_line":""},{"line_number":40,"context_line":""},{"line_number":41,"context_line":"Example configuration"}],"source_content_type":"text/x-rst","patch_set":11,"id":"7a77a97e_2d9d5ebc","line":38,"in_reply_to":"7a77a97e_c6abf273","updated":"2016-11-17 05:46:44.000000000","message":"I am merely suggesting to avoid the phrase \u0027click here\u0027 in web pages. It\u0027s a basic accessibility requirement.\n\nAs for the design docs, I suppose I\u0027d want the docs closer to the code so that we can keep dod and code in sync more easily. On the other hand, I appreciate your point, but it\u0027s a trade off.","commit_id":"9c063221237019b755bb53017c575f89949e3763"},{"author":{"_account_id":9515,"name":"Matthew Kassawara","email":"mkassawara@gmail.com","username":"ionosphere80"},"change_message_id":"efd8e228c004b4451d3de9c174910b3ba4bc5709","unresolved":false,"context_lines":[{"line_number":35,"context_line":"``tenant_network_types \u003d vxlan`` and still create subports with"},{"line_number":36,"context_line":"``segmentation_type \u003d vlan``. Neutron will remap packets as needed."},{"line_number":37,"context_line":""},{"line_number":38,"context_line":"Design details can be found `here \u003chttp://specs.openstack.org/openstack/neutron-specs/specs/newton/vlan-aware-vms.html\u003e`_."},{"line_number":39,"context_line":""},{"line_number":40,"context_line":""},{"line_number":41,"context_line":"Example configuration"}],"source_content_type":"text/x-rst","patch_set":11,"id":"7a77a97e_c6abf273","line":38,"in_reply_to":"7a77a97e_cdfeb837","updated":"2016-11-17 01:24:33.000000000","message":"We try to cater to our audience of operators in this guide by providing all the necessary information to deploy and operate a particular feature. If something in the developer documentation or specs seems relevant to operators, we should place the specific content in this guide rather than providing links to it.","commit_id":"9c063221237019b755bb53017c575f89949e3763"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"1b118a31eaa4a3236522e098383e8635466bcd23","unresolved":false,"context_lines":[{"line_number":51,"context_line":""},{"line_number":52,"context_line":"The trunk plug-in will fail to load unless one of the corresponding mechanism"},{"line_number":53,"context_line":"drivers is configured in the ``mechanism_drivers`` section of"},{"line_number":54,"context_line":"``neutron.conf``."},{"line_number":55,"context_line":""},{"line_number":56,"context_line":"Controller node"},{"line_number":57,"context_line":"---------------"}],"source_content_type":"text/x-rst","patch_set":11,"id":"7a77a97e_4d99c81e","line":54,"updated":"2016-11-16 22:20:07.000000000","message":"or other init logic fails to pass.","commit_id":"9c063221237019b755bb53017c575f89949e3763"},{"author":{"_account_id":9515,"name":"Matthew Kassawara","email":"mkassawara@gmail.com","username":"ionosphere80"},"change_message_id":"efd8e228c004b4451d3de9c174910b3ba4bc5709","unresolved":false,"context_lines":[{"line_number":66,"context_line":"Verify service operation"},{"line_number":67,"context_line":"------------------------"},{"line_number":68,"context_line":""},{"line_number":69,"context_line":"#. Source the project credentials and list the enabled extensions:"},{"line_number":70,"context_line":""},{"line_number":71,"context_line":"   .. code-block:: console"},{"line_number":72,"context_line":""}],"source_content_type":"text/x-rst","patch_set":11,"id":"7a77a97e_268026c0","line":69,"updated":"2016-11-17 01:24:33.000000000","message":"Only administrators can see extensions, thus this step should say \"Source the administrative project credentials...\" and, in a separate step, indicate the command to list the extensions.","commit_id":"9c063221237019b755bb53017c575f89949e3763"},{"author":{"_account_id":4187,"name":"Ryan Tidwell","email":"rtidwell@suse.com","username":"ryan-tidwell"},"change_message_id":"3f4310bbbb41173c6b76dd581373db3e567189b3","unresolved":false,"context_lines":[{"line_number":66,"context_line":"Verify service operation"},{"line_number":67,"context_line":"------------------------"},{"line_number":68,"context_line":""},{"line_number":69,"context_line":"#. Source the project credentials and list the enabled extensions:"},{"line_number":70,"context_line":""},{"line_number":71,"context_line":"   .. code-block:: console"},{"line_number":72,"context_line":""}],"source_content_type":"text/x-rst","patch_set":11,"id":"7a77a97e_ba0bcd2a","line":69,"in_reply_to":"7a77a97e_268026c0","updated":"2016-11-21 18:53:57.000000000","message":"Done","commit_id":"9c063221237019b755bb53017c575f89949e3763"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"1b118a31eaa4a3236522e098383e8635466bcd23","unresolved":false,"context_lines":[{"line_number":70,"context_line":""},{"line_number":71,"context_line":"   .. code-block:: console"},{"line_number":72,"context_line":""},{"line_number":73,"context_line":"      $ openstack extension list --network"},{"line_number":74,"context_line":"      +-----------------------------------------------+---------------------------+------------------------------------------------+"},{"line_number":75,"context_line":"      | Name                                          | Alias                     | Description                                    |"},{"line_number":76,"context_line":"      +-----------------------------------------------+---------------------------+------------------------------------------------+"}],"source_content_type":"text/x-rst","patch_set":11,"id":"7a77a97e_cdacf837","line":73,"updated":"2016-11-16 22:20:07.000000000","message":"I\u0027d personally shrink this list with some sort of [...], but it\u0027s a nit.","commit_id":"9c063221237019b755bb53017c575f89949e3763"},{"author":{"_account_id":4187,"name":"Ryan Tidwell","email":"rtidwell@suse.com","username":"ryan-tidwell"},"change_message_id":"3f4310bbbb41173c6b76dd581373db3e567189b3","unresolved":false,"context_lines":[{"line_number":70,"context_line":""},{"line_number":71,"context_line":"   .. code-block:: console"},{"line_number":72,"context_line":""},{"line_number":73,"context_line":"      $ openstack extension list --network"},{"line_number":74,"context_line":"      +-----------------------------------------------+---------------------------+------------------------------------------------+"},{"line_number":75,"context_line":"      | Name                                          | Alias                     | Description                                    |"},{"line_number":76,"context_line":"      +-----------------------------------------------+---------------------------+------------------------------------------------+"}],"source_content_type":"text/x-rst","patch_set":11,"id":"7a77a97e_3dfed705","line":73,"in_reply_to":"7a77a97e_06624a3e","updated":"2016-11-21 18:53:57.000000000","message":"Done","commit_id":"9c063221237019b755bb53017c575f89949e3763"},{"author":{"_account_id":9515,"name":"Matthew Kassawara","email":"mkassawara@gmail.com","username":"ionosphere80"},"change_message_id":"efd8e228c004b4451d3de9c174910b3ba4bc5709","unresolved":false,"context_lines":[{"line_number":70,"context_line":""},{"line_number":71,"context_line":"   .. code-block:: console"},{"line_number":72,"context_line":""},{"line_number":73,"context_line":"      $ openstack extension list --network"},{"line_number":74,"context_line":"      +-----------------------------------------------+---------------------------+------------------------------------------------+"},{"line_number":75,"context_line":"      | Name                                          | Alias                     | Description                                    |"},{"line_number":76,"context_line":"      +-----------------------------------------------+---------------------------+------------------------------------------------+"}],"source_content_type":"text/x-rst","patch_set":11,"id":"7a77a97e_06624a3e","line":73,"in_reply_to":"7a77a97e_cdacf837","updated":"2016-11-17 01:24:33.000000000","message":"Rather than providing output, you can simply say \"Run the XXX command and verify presence of the ``Trunk Extension`` in the list of extensions.\"","commit_id":"9c063221237019b755bb53017c575f89949e3763"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"1b118a31eaa4a3236522e098383e8635466bcd23","unresolved":false,"context_lines":[{"line_number":153,"context_line":"At a high level, the basic steps to booting an instance on a trunk are"},{"line_number":154,"context_line":"the following:"},{"line_number":155,"context_line":""},{"line_number":156,"context_line":"#. Create the trunk"},{"line_number":157,"context_line":"#. Add subports to the trunk"},{"line_number":158,"context_line":"#. Boot an instance on the trunk"},{"line_number":159,"context_line":""}],"source_content_type":"text/x-rst","patch_set":11,"id":"7a77a97e_cd7318e6","line":156,"updated":"2016-11-16 22:20:07.000000000","message":"Remember to create networks and subnets, in case you\u0027re doing something interesting ;)","commit_id":"9c063221237019b755bb53017c575f89949e3763"},{"author":{"_account_id":4187,"name":"Ryan Tidwell","email":"rtidwell@suse.com","username":"ryan-tidwell"},"change_message_id":"3f4310bbbb41173c6b76dd581373db3e567189b3","unresolved":false,"context_lines":[{"line_number":153,"context_line":"At a high level, the basic steps to booting an instance on a trunk are"},{"line_number":154,"context_line":"the following:"},{"line_number":155,"context_line":""},{"line_number":156,"context_line":"#. Create the trunk"},{"line_number":157,"context_line":"#. Add subports to the trunk"},{"line_number":158,"context_line":"#. Boot an instance on the trunk"},{"line_number":159,"context_line":""}],"source_content_type":"text/x-rst","patch_set":11,"id":"7a77a97e_5d03930d","line":156,"in_reply_to":"7a77a97e_cd7318e6","updated":"2016-11-21 18:53:57.000000000","message":"Done","commit_id":"9c063221237019b755bb53017c575f89949e3763"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"1b118a31eaa4a3236522e098383e8635466bcd23","unresolved":false,"context_lines":[{"line_number":164,"context_line":""},{"line_number":165,"context_line":"  .. code-block:: console"},{"line_number":166,"context_line":""},{"line_number":167,"context_line":"    $ openstack port create --network tenant-net trunk"},{"line_number":168,"context_line":"    +---------------------+-----------------------------------------------------------------------+"},{"line_number":169,"context_line":"    |Field                | Value                                                                 |"},{"line_number":170,"context_line":"    +---------------------+-----------------------------------------------------------------------+"}],"source_content_type":"text/x-rst","patch_set":11,"id":"7a77a97e_0d2c30aa","line":167,"range":{"start_line":167,"start_character":38,"end_line":167,"end_character":48},"updated":"2016-11-16 22:20:07.000000000","message":"this should really be tenant-net-A","commit_id":"9c063221237019b755bb53017c575f89949e3763"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"2897c480b71c312b6d9c521d0e8778ab66d62a1d","unresolved":false,"context_lines":[{"line_number":164,"context_line":""},{"line_number":165,"context_line":"  .. code-block:: console"},{"line_number":166,"context_line":""},{"line_number":167,"context_line":"    $ openstack port create --network tenant-net trunk"},{"line_number":168,"context_line":"    +---------------------+-----------------------------------------------------------------------+"},{"line_number":169,"context_line":"    |Field                | Value                                                                 |"},{"line_number":170,"context_line":"    +---------------------+-----------------------------------------------------------------------+"}],"source_content_type":"text/x-rst","patch_set":11,"id":"7a77a97e_f0f26bd1","line":167,"range":{"start_line":167,"start_character":38,"end_line":167,"end_character":48},"in_reply_to":"7a77a97e_0d2c30aa","updated":"2016-11-16 22:21:10.000000000","message":"discard this, though I think a diagram showing the network connectivity would be a killer!","commit_id":"9c063221237019b755bb53017c575f89949e3763"},{"author":{"_account_id":9515,"name":"Matthew Kassawara","email":"mkassawara@gmail.com","username":"ionosphere80"},"change_message_id":"efd8e228c004b4451d3de9c174910b3ba4bc5709","unresolved":false,"context_lines":[{"line_number":164,"context_line":""},{"line_number":165,"context_line":"  .. code-block:: console"},{"line_number":166,"context_line":""},{"line_number":167,"context_line":"    $ openstack port create --network tenant-net trunk"},{"line_number":168,"context_line":"    +---------------------+-----------------------------------------------------------------------+"},{"line_number":169,"context_line":"    |Field                | Value                                                                 |"},{"line_number":170,"context_line":"    +---------------------+-----------------------------------------------------------------------+"}],"source_content_type":"text/x-rst","patch_set":11,"id":"7a77a97e_86dd7ae2","line":167,"range":{"start_line":167,"start_character":38,"end_line":167,"end_character":48},"in_reply_to":"7a77a97e_66b78186","updated":"2016-11-17 01:24:33.000000000","message":"We also use \"project\" instead of \"tenant\".  Do these steps refer to a provider network or a self-service network... or does it matter?","commit_id":"9c063221237019b755bb53017c575f89949e3763"},{"author":{"_account_id":4187,"name":"Ryan Tidwell","email":"rtidwell@suse.com","username":"ryan-tidwell"},"change_message_id":"3f4310bbbb41173c6b76dd581373db3e567189b3","unresolved":false,"context_lines":[{"line_number":164,"context_line":""},{"line_number":165,"context_line":"  .. code-block:: console"},{"line_number":166,"context_line":""},{"line_number":167,"context_line":"    $ openstack port create --network tenant-net trunk"},{"line_number":168,"context_line":"    +---------------------+-----------------------------------------------------------------------+"},{"line_number":169,"context_line":"    |Field                | Value                                                                 |"},{"line_number":170,"context_line":"    +---------------------+-----------------------------------------------------------------------+"}],"source_content_type":"text/x-rst","patch_set":11,"id":"7a77a97e_dd6403e7","line":167,"range":{"start_line":167,"start_character":38,"end_line":167,"end_character":48},"in_reply_to":"7a77a97e_86dd7ae2","updated":"2016-11-21 18:53:57.000000000","message":"It doesn\u0027t really matter whether it\u0027s a self-service network or a provider network. I can change this to use project instead of tenant.\n\nAs far as diagrams go, I\u0027ll come back to that in a follow-up patch. I\u0027d like to get something posted for operators to have as a reference ASAP.","commit_id":"9c063221237019b755bb53017c575f89949e3763"},{"author":{"_account_id":9515,"name":"Matthew Kassawara","email":"mkassawara@gmail.com","username":"ionosphere80"},"change_message_id":"8d0a6ae67186c225c68bbe41ca19844135ff1886","unresolved":false,"context_lines":[{"line_number":164,"context_line":""},{"line_number":165,"context_line":"  .. code-block:: console"},{"line_number":166,"context_line":""},{"line_number":167,"context_line":"    $ openstack port create --network tenant-net trunk"},{"line_number":168,"context_line":"    +---------------------+-----------------------------------------------------------------------+"},{"line_number":169,"context_line":"    |Field                | Value                                                                 |"},{"line_number":170,"context_line":"    +---------------------+-----------------------------------------------------------------------+"}],"source_content_type":"text/x-rst","patch_set":11,"id":"7a77a97e_66b78186","line":167,"range":{"start_line":167,"start_character":38,"end_line":167,"end_character":48},"in_reply_to":"7a77a97e_f0f26bd1","updated":"2016-11-16 23:22:43.000000000","message":"Is this a hint? :)","commit_id":"9c063221237019b755bb53017c575f89949e3763"},{"author":{"_account_id":9515,"name":"Matthew Kassawara","email":"mkassawara@gmail.com","username":"ionosphere80"},"change_message_id":"efd8e228c004b4451d3de9c174910b3ba4bc5709","unresolved":false,"context_lines":[{"line_number":220,"context_line":"Add subports to the trunk"},{"line_number":221,"context_line":"-------------------------"},{"line_number":222,"context_line":""},{"line_number":223,"context_line":"Subports can be added to a trunk in two ways."},{"line_number":224,"context_line":""},{"line_number":225,"context_line":"#. Create trunk with subports:"},{"line_number":226,"context_line":""}],"source_content_type":"text/x-rst","patch_set":11,"id":"7a77a97e_a688b6c6","line":223,"updated":"2016-11-17 01:24:33.000000000","message":"Use of \"#.\" makes people follow each step in sequence, regardless of qualifiers/conditionals. You\u0027ll probably want to elaborate here regarding both options and use a \"*\" for each method.","commit_id":"9c063221237019b755bb53017c575f89949e3763"},{"author":{"_account_id":4187,"name":"Ryan Tidwell","email":"rtidwell@suse.com","username":"ryan-tidwell"},"change_message_id":"3f4310bbbb41173c6b76dd581373db3e567189b3","unresolved":false,"context_lines":[{"line_number":220,"context_line":"Add subports to the trunk"},{"line_number":221,"context_line":"-------------------------"},{"line_number":222,"context_line":""},{"line_number":223,"context_line":"Subports can be added to a trunk in two ways."},{"line_number":224,"context_line":""},{"line_number":225,"context_line":"#. Create trunk with subports:"},{"line_number":226,"context_line":""}],"source_content_type":"text/x-rst","patch_set":11,"id":"7a77a97e_fdb8df2c","line":223,"in_reply_to":"7a77a97e_a688b6c6","updated":"2016-11-21 18:53:57.000000000","message":"I\u0027ll clean that up a little bit so it\u0027s more clear.","commit_id":"9c063221237019b755bb53017c575f89949e3763"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"1b118a31eaa4a3236522e098383e8635466bcd23","unresolved":false,"context_lines":[{"line_number":371,"context_line":""},{"line_number":372,"context_line":"     $ openstack server create \\"},{"line_number":373,"context_line":"       --nic port-id\u003d73fb9d54-43a7-4bb1-a8dc-569e0e0a0a38 \\"},{"line_number":374,"context_line":"       --flavor 1 --image a6ece084-0db4-4cd2-893a-70b52ef5460a my-instance"},{"line_number":375,"context_line":""},{"line_number":376,"context_line":"Using trunks and subports inside an instance"},{"line_number":377,"context_line":"--------------------------------------------"}],"source_content_type":"text/x-rst","patch_set":11,"id":"7a77a97e_905bf72d","line":374,"updated":"2016-11-16 22:20:07.000000000","message":"can we add a note here that booting an instance on a sub-port has undetermined outcome? Please mention [1]\n\n[1] https://bugs.launchpad.net/neutron/+bug/1636485","commit_id":"9c063221237019b755bb53017c575f89949e3763"},{"author":{"_account_id":9515,"name":"Matthew Kassawara","email":"mkassawara@gmail.com","username":"ionosphere80"},"change_message_id":"efd8e228c004b4451d3de9c174910b3ba4bc5709","unresolved":false,"context_lines":[{"line_number":371,"context_line":""},{"line_number":372,"context_line":"     $ openstack server create \\"},{"line_number":373,"context_line":"       --nic port-id\u003d73fb9d54-43a7-4bb1-a8dc-569e0e0a0a38 \\"},{"line_number":374,"context_line":"       --flavor 1 --image a6ece084-0db4-4cd2-893a-70b52ef5460a my-instance"},{"line_number":375,"context_line":""},{"line_number":376,"context_line":"Using trunks and subports inside an instance"},{"line_number":377,"context_line":"--------------------------------------------"}],"source_content_type":"text/x-rst","patch_set":11,"id":"7a77a97e_c62db2a9","line":374,"in_reply_to":"7a77a97e_46f28570","updated":"2016-11-17 01:24:33.000000000","message":"We expect the audience to know how to launch an instance. All you need to do is tell them to use the relevant port ID to reach the goal of launching an instance with a VLAN-aware port.","commit_id":"9c063221237019b755bb53017c575f89949e3763"},{"author":{"_account_id":9515,"name":"Matthew Kassawara","email":"mkassawara@gmail.com","username":"ionosphere80"},"change_message_id":"fe807063d625a11d21c7b01e24267ca06ac02186","unresolved":false,"context_lines":[{"line_number":371,"context_line":""},{"line_number":372,"context_line":"     $ openstack server create \\"},{"line_number":373,"context_line":"       --nic port-id\u003d73fb9d54-43a7-4bb1-a8dc-569e0e0a0a38 \\"},{"line_number":374,"context_line":"       --flavor 1 --image a6ece084-0db4-4cd2-893a-70b52ef5460a my-instance"},{"line_number":375,"context_line":""},{"line_number":376,"context_line":"Using trunks and subports inside an instance"},{"line_number":377,"context_line":"--------------------------------------------"}],"source_content_type":"text/x-rst","patch_set":11,"id":"7a77a97e_dd916354","line":374,"in_reply_to":"7a77a97e_5ded5324","updated":"2016-11-21 19:01:55.000000000","message":"Yeah, someone has to maintain it.","commit_id":"9c063221237019b755bb53017c575f89949e3763"},{"author":{"_account_id":4187,"name":"Ryan Tidwell","email":"rtidwell@suse.com","username":"ryan-tidwell"},"change_message_id":"83713307a308f35846cf89913b7b5ed238f8fcd1","unresolved":false,"context_lines":[{"line_number":371,"context_line":""},{"line_number":372,"context_line":"     $ openstack server create \\"},{"line_number":373,"context_line":"       --nic port-id\u003d73fb9d54-43a7-4bb1-a8dc-569e0e0a0a38 \\"},{"line_number":374,"context_line":"       --flavor 1 --image a6ece084-0db4-4cd2-893a-70b52ef5460a my-instance"},{"line_number":375,"context_line":""},{"line_number":376,"context_line":"Using trunks and subports inside an instance"},{"line_number":377,"context_line":"--------------------------------------------"}],"source_content_type":"text/x-rst","patch_set":11,"id":"7a77a97e_46f28570","line":374,"in_reply_to":"7a77a97e_905bf72d","updated":"2016-11-16 23:22:12.000000000","message":"Ah, good catch","commit_id":"9c063221237019b755bb53017c575f89949e3763"},{"author":{"_account_id":4187,"name":"Ryan Tidwell","email":"rtidwell@suse.com","username":"ryan-tidwell"},"change_message_id":"3f4310bbbb41173c6b76dd581373db3e567189b3","unresolved":false,"context_lines":[{"line_number":371,"context_line":""},{"line_number":372,"context_line":"     $ openstack server create \\"},{"line_number":373,"context_line":"       --nic port-id\u003d73fb9d54-43a7-4bb1-a8dc-569e0e0a0a38 \\"},{"line_number":374,"context_line":"       --flavor 1 --image a6ece084-0db4-4cd2-893a-70b52ef5460a my-instance"},{"line_number":375,"context_line":""},{"line_number":376,"context_line":"Using trunks and subports inside an instance"},{"line_number":377,"context_line":"--------------------------------------------"}],"source_content_type":"text/x-rst","patch_set":11,"id":"7a77a97e_5ded5324","line":374,"in_reply_to":"7a77a97e_c62db2a9","updated":"2016-11-21 18:53:57.000000000","message":"Any harm in showing the command, even if we assume some basline of knowledge going in?","commit_id":"9c063221237019b755bb53017c575f89949e3763"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"1b118a31eaa4a3236522e098383e8635466bcd23","unresolved":false,"context_lines":[{"line_number":376,"context_line":"Using trunks and subports inside an instance"},{"line_number":377,"context_line":"--------------------------------------------"},{"line_number":378,"context_line":""},{"line_number":379,"context_line":"When configuring instances to use a subport, ensure that the interface on the"},{"line_number":380,"context_line":"instance is set to use the MAC address assigned to the port by neutron. When"},{"line_number":381,"context_line":"creating subports, the MAC address of the trunk parent port can be set on the"},{"line_number":382,"context_line":"subport. This will allow VLAN subinterfaces inside an instance booted on a"},{"line_number":383,"context_line":"trunk to be configured without explicitly setting a MAC address. Although"}],"source_content_type":"text/x-rst","patch_set":11,"id":"7a77a97e_303863a0","line":380,"range":{"start_line":379,"start_character":0,"end_line":380,"end_character":70},"updated":"2016-11-16 22:20:07.000000000","message":"I\u0027d also mention here that if the trunk is dynamically modified (ie. when the instance is attached), the guest is not made aware of any data plane changes. This is currently left outside the scope of the platform.\n\nAlso, let\u0027s consider the case where FIP traffic is required on multiple ports. See https://bugs.launchpad.net/neutron/+bug/1636484 for details.","commit_id":"9c063221237019b755bb53017c575f89949e3763"},{"author":{"_account_id":4187,"name":"Ryan Tidwell","email":"rtidwell@suse.com","username":"ryan-tidwell"},"change_message_id":"83713307a308f35846cf89913b7b5ed238f8fcd1","unresolved":false,"context_lines":[{"line_number":376,"context_line":"Using trunks and subports inside an instance"},{"line_number":377,"context_line":"--------------------------------------------"},{"line_number":378,"context_line":""},{"line_number":379,"context_line":"When configuring instances to use a subport, ensure that the interface on the"},{"line_number":380,"context_line":"instance is set to use the MAC address assigned to the port by neutron. When"},{"line_number":381,"context_line":"creating subports, the MAC address of the trunk parent port can be set on the"},{"line_number":382,"context_line":"subport. This will allow VLAN subinterfaces inside an instance booted on a"},{"line_number":383,"context_line":"trunk to be configured without explicitly setting a MAC address. Although"}],"source_content_type":"text/x-rst","patch_set":11,"id":"7a77a97e_66e94180","line":380,"range":{"start_line":379,"start_character":0,"end_line":380,"end_character":70},"in_reply_to":"7a77a97e_303863a0","updated":"2016-11-16 23:22:12.000000000","message":"Done","commit_id":"9c063221237019b755bb53017c575f89949e3763"},{"author":{"_account_id":9515,"name":"Matthew Kassawara","email":"mkassawara@gmail.com","username":"ionosphere80"},"change_message_id":"efd8e228c004b4451d3de9c174910b3ba4bc5709","unresolved":false,"context_lines":[{"line_number":387,"context_line":"of the trunk be re-used on all subports. See the following bugs:"},{"line_number":388,"context_line":""},{"line_number":389,"context_line":"* https://bugs.launchpad.net/neutron/+bug/1626010"},{"line_number":390,"context_line":"* https://bugs.launchpad.net/neutron/+bug/1593760"},{"line_number":391,"context_line":""},{"line_number":392,"context_line":"Pay attention to the ``state`` of a trunk:"},{"line_number":393,"context_line":""}],"source_content_type":"text/x-rst","patch_set":11,"id":"7a77a97e_292d5995","line":390,"updated":"2016-11-17 01:24:33.000000000","message":"If you include links to bugs, someone needs to periodically validate their relevance. For example, if they won\u0027t get fixed in the release to which this patch pertains, you should include their gist in a limitations/caveats section rather than links. At least put them all in one place.","commit_id":"9c063221237019b755bb53017c575f89949e3763"},{"author":{"_account_id":4187,"name":"Ryan Tidwell","email":"rtidwell@suse.com","username":"ryan-tidwell"},"change_message_id":"3f4310bbbb41173c6b76dd581373db3e567189b3","unresolved":false,"context_lines":[{"line_number":387,"context_line":"of the trunk be re-used on all subports. See the following bugs:"},{"line_number":388,"context_line":""},{"line_number":389,"context_line":"* https://bugs.launchpad.net/neutron/+bug/1626010"},{"line_number":390,"context_line":"* https://bugs.launchpad.net/neutron/+bug/1593760"},{"line_number":391,"context_line":""},{"line_number":392,"context_line":"Pay attention to the ``state`` of a trunk:"},{"line_number":393,"context_line":""}],"source_content_type":"text/x-rst","patch_set":11,"id":"7a77a97e_ddd96385","line":390,"in_reply_to":"7a77a97e_292d5995","updated":"2016-11-21 18:53:57.000000000","message":"Armando had a better suggestion below on L440, I\u0027ll re-work this.","commit_id":"9c063221237019b755bb53017c575f89949e3763"},{"author":{"_account_id":9515,"name":"Matthew Kassawara","email":"mkassawara@gmail.com","username":"ionosphere80"},"change_message_id":"efd8e228c004b4451d3de9c174910b3ba4bc5709","unresolved":false,"context_lines":[{"line_number":389,"context_line":"* https://bugs.launchpad.net/neutron/+bug/1626010"},{"line_number":390,"context_line":"* https://bugs.launchpad.net/neutron/+bug/1593760"},{"line_number":391,"context_line":""},{"line_number":392,"context_line":"Pay attention to the ``state`` of a trunk:"},{"line_number":393,"context_line":""},{"line_number":394,"context_line":"* ``ACTIVE``"},{"line_number":395,"context_line":""}],"source_content_type":"text/x-rst","patch_set":11,"id":"7a77a97e_295479fd","line":392,"updated":"2016-11-17 01:24:33.000000000","message":"I\u0027d probably move this into a section regarding states.","commit_id":"9c063221237019b755bb53017c575f89949e3763"},{"author":{"_account_id":4187,"name":"Ryan Tidwell","email":"rtidwell@suse.com","username":"ryan-tidwell"},"change_message_id":"3f4310bbbb41173c6b76dd581373db3e567189b3","unresolved":false,"context_lines":[{"line_number":389,"context_line":"* https://bugs.launchpad.net/neutron/+bug/1626010"},{"line_number":390,"context_line":"* https://bugs.launchpad.net/neutron/+bug/1593760"},{"line_number":391,"context_line":""},{"line_number":392,"context_line":"Pay attention to the ``state`` of a trunk:"},{"line_number":393,"context_line":""},{"line_number":394,"context_line":"* ``ACTIVE``"},{"line_number":395,"context_line":""}],"source_content_type":"text/x-rst","patch_set":11,"id":"7a77a97e_fde61f43","line":392,"in_reply_to":"7a77a97e_295479fd","updated":"2016-11-21 18:53:57.000000000","message":"Done","commit_id":"9c063221237019b755bb53017c575f89949e3763"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"1b118a31eaa4a3236522e098383e8635466bcd23","unresolved":false,"context_lines":[{"line_number":437,"context_line":""},{"line_number":438,"context_line":"* https://bugs.launchpad.net/neutron/+bug/1626010"},{"line_number":439,"context_line":"* https://bugs.launchpad.net/neutron/+bug/1593760"},{"line_number":440,"context_line":"* https://bugs.launchpad.net/neutron/+bug/1639186"},{"line_number":441,"context_line":""}],"source_content_type":"text/x-rst","patch_set":11,"id":"7a77a97e_0defd0b0","line":440,"updated":"2016-11-16 22:20:07.000000000","message":"I\u0027d use, which captures open bugs.\n\nhttps://bugs.launchpad.net/neutron/+bugs?field.tag\u003dtrunk","commit_id":"9c063221237019b755bb53017c575f89949e3763"},{"author":{"_account_id":4187,"name":"Ryan Tidwell","email":"rtidwell@suse.com","username":"ryan-tidwell"},"change_message_id":"83713307a308f35846cf89913b7b5ed238f8fcd1","unresolved":false,"context_lines":[{"line_number":437,"context_line":""},{"line_number":438,"context_line":"* https://bugs.launchpad.net/neutron/+bug/1626010"},{"line_number":439,"context_line":"* https://bugs.launchpad.net/neutron/+bug/1593760"},{"line_number":440,"context_line":"* https://bugs.launchpad.net/neutron/+bug/1639186"},{"line_number":441,"context_line":""}],"source_content_type":"text/x-rst","patch_set":11,"id":"7a77a97e_c6fe9537","line":440,"in_reply_to":"7a77a97e_0defd0b0","updated":"2016-11-16 23:22:12.000000000","message":"Done","commit_id":"9c063221237019b755bb53017c575f89949e3763"}]}