)]}'
{"doc/source/devref/provisioning_blocks.rst":[{"author":{"_account_id":7787,"name":"Kevin Benton","email":"kevin@benton.pub","username":"blak111"},"change_message_id":"63e6b2b951ecdf2dfadd55108a5e040c12505ded","unresolved":false,"context_lines":[{"line_number":38,"context_line":"The main example of this is with ML2, the L2 agents and the DHCP agents."},{"line_number":39,"context_line":"When a port is created and bound to a host, it\u0027s placed in the DOWN"},{"line_number":40,"context_line":"status. The L2 agent now has to setup flows, security group rules, etc"},{"line_number":41,"context_line":"for the port and the DHCP agent has to setup a DHCP reservation for"},{"line_number":42,"context_line":"the port\u0027s IP and MAC. Before the transition to ACTIVE, both agents"},{"line_number":43,"context_line":"must complete their work or the port user (e.g. Nova) may attempt to"},{"line_number":44,"context_line":"use the port and not have connectivity. To solve this, the"}],"source_content_type":"text/x-rst","patch_set":1,"id":"dab17558_5f07a917","line":41,"updated":"2016-05-10 20:18:57.000000000","message":"This is covered in L101","commit_id":"9d82b5cd64d2b516c7350008edebddde7891446f"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"057cc9044ed2d9e8e830ff385693e2a886e28b4d","unresolved":false,"context_lines":[{"line_number":38,"context_line":"The main example of this is with ML2, the L2 agents and the DHCP agents."},{"line_number":39,"context_line":"When a port is created and bound to a host, it\u0027s placed in the DOWN"},{"line_number":40,"context_line":"status. The L2 agent now has to setup flows, security group rules, etc"},{"line_number":41,"context_line":"for the port and the DHCP agent has to setup a DHCP reservation for"},{"line_number":42,"context_line":"the port\u0027s IP and MAC. Before the transition to ACTIVE, both agents"},{"line_number":43,"context_line":"must complete their work or the port user (e.g. Nova) may attempt to"},{"line_number":44,"context_line":"use the port and not have connectivity. To solve this, the"}],"source_content_type":"text/x-rst","patch_set":1,"id":"dab17558_fdb0a08d","line":41,"updated":"2016-05-07 03:02:00.000000000","message":"would the existing provisioning block logic still work if dhcp was disabled in the first place or in the present of multiple dhcp agents?","commit_id":"9d82b5cd64d2b516c7350008edebddde7891446f"},{"author":{"_account_id":7787,"name":"Kevin Benton","email":"kevin@benton.pub","username":"blak111"},"change_message_id":"63e6b2b951ecdf2dfadd55108a5e040c12505ded","unresolved":false,"context_lines":[{"line_number":51,"context_line":""},{"line_number":52,"context_line":"To make use of the provisioning_blocks module, provisioning components"},{"line_number":53,"context_line":"should be added whenever there is work to be done by another entity"},{"line_number":54,"context_line":"before and object\u0027s status can transition to ACTIVE. This is"},{"line_number":55,"context_line":"accomplished by calling the add_provisioning_component method for"},{"line_number":56,"context_line":"each entity. Then as each entity finishes provisioning the object,"},{"line_number":57,"context_line":"the provisioning_complete must be called to lift the provisioning"}],"source_content_type":"text/x-rst","patch_set":1,"id":"dab17558_3f0c653a","line":54,"updated":"2016-05-10 20:18:57.000000000","message":"Done","commit_id":"9d82b5cd64d2b516c7350008edebddde7891446f"},{"author":{"_account_id":11682,"name":"Ryan Moats","email":"rmoats@us.ibm.com","username":"regXboi"},"change_message_id":"40355967f20a486405c4f6fd142115ecf45b549c","unresolved":false,"context_lines":[{"line_number":51,"context_line":""},{"line_number":52,"context_line":"To make use of the provisioning_blocks module, provisioning components"},{"line_number":53,"context_line":"should be added whenever there is work to be done by another entity"},{"line_number":54,"context_line":"before and object\u0027s status can transition to ACTIVE. This is"},{"line_number":55,"context_line":"accomplished by calling the add_provisioning_component method for"},{"line_number":56,"context_line":"each entity. Then as each entity finishes provisioning the object,"},{"line_number":57,"context_line":"the provisioning_complete must be called to lift the provisioning"}],"source_content_type":"text/x-rst","patch_set":1,"id":"1a122d0e_7cf04dca","line":54,"updated":"2016-04-21 13:02:05.000000000","message":"nit: an object\u0027s","commit_id":"9d82b5cd64d2b516c7350008edebddde7891446f"},{"author":{"_account_id":11682,"name":"Ryan Moats","email":"rmoats@us.ibm.com","username":"regXboi"},"change_message_id":"ce683bde59e90abd8e50506b4ae73868903268f3","unresolved":false,"context_lines":[{"line_number":79,"context_line":"   provisioning has completed for that object."},{"line_number":80,"context_line":"7. A subscriber to this event on the server will then update the status"},{"line_number":81,"context_line":"   of the object to ACTIVE to indicate that it is fully provisioned."},{"line_number":82,"context_line":""},{"line_number":83,"context_line":"For a more concrete example, see the section below."},{"line_number":84,"context_line":""},{"line_number":85,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"1a122d0e_6bb505cf","line":82,"updated":"2016-04-22 02:12:44.000000000","message":"My apologies for not being more clear - I wasn\u0027t as concerned about the specific L2/DHCP case below, but was looking for some text here about how to handle abnormal state transitions (i.e. if a provision entity encounters an error while provisioning an object, then what should happen)...","commit_id":"9d82b5cd64d2b516c7350008edebddde7891446f"},{"author":{"_account_id":7787,"name":"Kevin Benton","email":"kevin@benton.pub","username":"blak111"},"change_message_id":"3e7038eacb0cb9454c935b015599d4b8ad012ec4","unresolved":false,"context_lines":[{"line_number":79,"context_line":"   provisioning has completed for that object."},{"line_number":80,"context_line":"7. A subscriber to this event on the server will then update the status"},{"line_number":81,"context_line":"   of the object to ACTIVE to indicate that it is fully provisioned."},{"line_number":82,"context_line":""},{"line_number":83,"context_line":"For a more concrete example, see the section below."},{"line_number":84,"context_line":""},{"line_number":85,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"1a122d0e_16d443bb","line":82,"in_reply_to":"1a122d0e_6bb505cf","updated":"2016-04-23 09:39:54.000000000","message":"Ah, well it wouldn\u0027t update the server and the object would stay in its current state. Similar to how a PORT stays down if the L2 agent is MIA.","commit_id":"9d82b5cd64d2b516c7350008edebddde7891446f"},{"author":{"_account_id":7787,"name":"Kevin Benton","email":"kevin@benton.pub","username":"blak111"},"change_message_id":"63e6b2b951ecdf2dfadd55108a5e040c12505ded","unresolved":false,"context_lines":[{"line_number":111,"context_line":"1. If the port is not bound, nothing happens because we don\u0027t know yet"},{"line_number":112,"context_line":"   if an L2 agent is involved so we have to wait until a port update that"},{"line_number":113,"context_line":"   binds it."},{"line_number":114,"context_line":"2. Once, the port is bound, the agent based mechanism drivers will check"},{"line_number":115,"context_line":"   if they have an agent on the bound host and if the VNIC type belongs"},{"line_number":116,"context_line":"   to the mechanism driver, a provisioning block is added for the port"},{"line_number":117,"context_line":"   under the \u0027L2 Agent\u0027 entity."}],"source_content_type":"text/x-rst","patch_set":1,"id":"dab17558_9f159141","line":114,"updated":"2016-05-10 20:18:57.000000000","message":"Done","commit_id":"9d82b5cd64d2b516c7350008edebddde7891446f"},{"author":{"_account_id":11682,"name":"Ryan Moats","email":"rmoats@us.ibm.com","username":"regXboi"},"change_message_id":"40355967f20a486405c4f6fd142115ecf45b549c","unresolved":false,"context_lines":[{"line_number":111,"context_line":"1. If the port is not bound, nothing happens because we don\u0027t know yet"},{"line_number":112,"context_line":"   if an L2 agent is involved so we have to wait until a port update that"},{"line_number":113,"context_line":"   binds it."},{"line_number":114,"context_line":"2. Once, the port is bound, the agent based mechanism drivers will check"},{"line_number":115,"context_line":"   if they have an agent on the bound host and if the VNIC type belongs"},{"line_number":116,"context_line":"   to the mechanism driver, a provisioning block is added for the port"},{"line_number":117,"context_line":"   under the \u0027L2 Agent\u0027 entity."}],"source_content_type":"text/x-rst","patch_set":1,"id":"1a122d0e_1cc67949","line":114,"updated":"2016-04-21 13:02:05.000000000","message":"nit: Once the port is bound,","commit_id":"9d82b5cd64d2b516c7350008edebddde7891446f"},{"author":{"_account_id":7787,"name":"Kevin Benton","email":"kevin@benton.pub","username":"blak111"},"change_message_id":"63e6b2b951ecdf2dfadd55108a5e040c12505ded","unresolved":false,"context_lines":[{"line_number":134,"context_line":"update_port_status to set the port to ACTIVE."},{"line_number":135,"context_line":""},{"line_number":136,"context_line":"At this point the normal notification is emitted to Nova allowing the"},{"line_number":137,"context_line":"VM to be unpaused."},{"line_number":138,"context_line":""},{"line_number":139,"context_line":""},{"line_number":140,"context_line":"References"}],"source_content_type":"text/x-rst","patch_set":1,"id":"dab17558_7f126d58","line":137,"updated":"2016-05-10 20:18:57.000000000","message":"Done","commit_id":"9d82b5cd64d2b516c7350008edebddde7891446f"},{"author":{"_account_id":748,"name":"Armando Migliaccio","email":"armamig@gmail.com","username":"armando-migliaccio"},"change_message_id":"057cc9044ed2d9e8e830ff385693e2a886e28b4d","unresolved":false,"context_lines":[{"line_number":134,"context_line":"update_port_status to set the port to ACTIVE."},{"line_number":135,"context_line":""},{"line_number":136,"context_line":"At this point the normal notification is emitted to Nova allowing the"},{"line_number":137,"context_line":"VM to be unpaused."},{"line_number":138,"context_line":""},{"line_number":139,"context_line":""},{"line_number":140,"context_line":"References"}],"source_content_type":"text/x-rst","patch_set":1,"id":"dab17558_7d63101b","line":137,"updated":"2016-05-07 03:02:00.000000000","message":"can you elaborate on failure mode scenarios? E.g. across server or agent restarts during the provisioning operations?","commit_id":"9d82b5cd64d2b516c7350008edebddde7891446f"}]}
