)]}'
{"doc/admin-guide/source/compute-cpu-topologies.rst":[{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"cd062c69347a0033670373c9ffd7dd92a519682a","unresolved":false,"context_lines":[{"line_number":4,"context_line":"CPU topologies"},{"line_number":5,"context_line":"\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 NUMA topology and CPU pinning features in OpenStack provide high level"},{"line_number":8,"context_line":"control over how instances run on hypervisor CPUs and the topology of virtual"},{"line_number":9,"context_line":"CPUs available to instances. These features help minimize latency and maximize"},{"line_number":10,"context_line":"performance."}],"source_content_type":"text/x-rst","patch_set":3,"id":"3ac371cc_aa34eefa","line":7,"range":{"start_line":7,"start_character":64,"end_line":7,"end_character":74},"updated":"2016-08-16 12:48:59.000000000","message":"high-level","commit_id":"f5fb84f5f20060a9c0b6adb07b0cd725a18b1afd"},{"author":{"_account_id":15334,"name":"Stephen Finucane","display_name":"stephenfin","email":"stephenfin@redhat.com","username":"sfinucan"},"change_message_id":"e315db34ec88caf7c19e31c652fbe70e2490a0d6","unresolved":false,"context_lines":[{"line_number":4,"context_line":"CPU topologies"},{"line_number":5,"context_line":"\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 NUMA topology and CPU pinning features in OpenStack provide high level"},{"line_number":8,"context_line":"control over how instances run on hypervisor CPUs and the topology of virtual"},{"line_number":9,"context_line":"CPUs available to instances. These features help minimize latency and maximize"},{"line_number":10,"context_line":"performance."}],"source_content_type":"text/x-rst","patch_set":3,"id":"3ac371cc_7783f356","line":7,"range":{"start_line":7,"start_character":64,"end_line":7,"end_character":74},"in_reply_to":"3ac371cc_aa34eefa","updated":"2016-08-16 14:49:22.000000000","message":"Done","commit_id":"f5fb84f5f20060a9c0b6adb07b0cd725a18b1afd"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"146254dc8df66a65aa8cc3d6017bd6f0e7bd6d1f","unresolved":false,"context_lines":[{"line_number":12,"context_line":"SMP, NUMA, and SMT"},{"line_number":13,"context_line":"~~~~~~~~~~~~~~~~~~"},{"line_number":14,"context_line":""},{"line_number":15,"context_line":"Symmetric multiprocessing (SMP) is a design found in many modern multi-core"},{"line_number":16,"context_line":"systems. In an SMP system, there are two or more CPUs and these CPUs are"},{"line_number":17,"context_line":"connected by some interconnect. This provides CPUs with equal access to"},{"line_number":18,"context_line":"system resources like memory and input/output ports."}],"source_content_type":"text/x-rst","patch_set":3,"id":"3ac371cc_183da3bb","line":15,"range":{"start_line":15,"start_character":0,"end_line":15,"end_character":31},"updated":"2016-08-16 09:52:05.000000000","message":"I think it would be beneficial to have the three (SMP, NUMA, SMT) in definition lists. Just a suggestion.","commit_id":"f5fb84f5f20060a9c0b6adb07b0cd725a18b1afd"},{"author":{"_account_id":15334,"name":"Stephen Finucane","display_name":"stephenfin","email":"stephenfin@redhat.com","username":"sfinucan"},"change_message_id":"e315db34ec88caf7c19e31c652fbe70e2490a0d6","unresolved":false,"context_lines":[{"line_number":12,"context_line":"SMP, NUMA, and SMT"},{"line_number":13,"context_line":"~~~~~~~~~~~~~~~~~~"},{"line_number":14,"context_line":""},{"line_number":15,"context_line":"Symmetric multiprocessing (SMP) is a design found in many modern multi-core"},{"line_number":16,"context_line":"systems. In an SMP system, there are two or more CPUs and these CPUs are"},{"line_number":17,"context_line":"connected by some interconnect. This provides CPUs with equal access to"},{"line_number":18,"context_line":"system resources like memory and input/output ports."}],"source_content_type":"text/x-rst","patch_set":3,"id":"3ac371cc_779c93c0","line":15,"range":{"start_line":15,"start_character":0,"end_line":15,"end_character":31},"in_reply_to":"3ac371cc_183da3bb","updated":"2016-08-16 14:49:22.000000000","message":"Done","commit_id":"f5fb84f5f20060a9c0b6adb07b0cd725a18b1afd"},{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"cd062c69347a0033670373c9ffd7dd92a519682a","unresolved":false,"context_lines":[{"line_number":22,"context_line":"into cells or nodes that are associated with particular CPUs. Requests for"},{"line_number":23,"context_line":"memory on other nodes are possible through an interconnect bus. However,"},{"line_number":24,"context_line":"bandwidth across this shared bus is limited. As a result, competition for this"},{"line_number":25,"context_line":"this resource can incur performance penalties."},{"line_number":26,"context_line":""},{"line_number":27,"context_line":"Simultaneous Multi-Threading (SMT) is a design complementary to SMP. Whereas"},{"line_number":28,"context_line":"CPUs in SMP systems share a bus and some memory, CPUs in SMT systems share"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3ac371cc_2a78fe2a","line":25,"range":{"start_line":25,"start_character":0,"end_line":25,"end_character":4},"updated":"2016-08-16 12:48:59.000000000","message":"Please remove extra \"this\".","commit_id":"f5fb84f5f20060a9c0b6adb07b0cd725a18b1afd"},{"author":{"_account_id":15334,"name":"Stephen Finucane","display_name":"stephenfin","email":"stephenfin@redhat.com","username":"sfinucan"},"change_message_id":"e315db34ec88caf7c19e31c652fbe70e2490a0d6","unresolved":false,"context_lines":[{"line_number":22,"context_line":"into cells or nodes that are associated with particular CPUs. Requests for"},{"line_number":23,"context_line":"memory on other nodes are possible through an interconnect bus. However,"},{"line_number":24,"context_line":"bandwidth across this shared bus is limited. As a result, competition for this"},{"line_number":25,"context_line":"this resource can incur performance penalties."},{"line_number":26,"context_line":""},{"line_number":27,"context_line":"Simultaneous Multi-Threading (SMT) is a design complementary to SMP. Whereas"},{"line_number":28,"context_line":"CPUs in SMP systems share a bus and some memory, CPUs in SMT systems share"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3ac371cc_37bb3b29","line":25,"range":{"start_line":25,"start_character":0,"end_line":25,"end_character":4},"in_reply_to":"3ac371cc_2a78fe2a","updated":"2016-08-16 14:49:22.000000000","message":"Done","commit_id":"f5fb84f5f20060a9c0b6adb07b0cd725a18b1afd"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"146254dc8df66a65aa8cc3d6017bd6f0e7bd6d1f","unresolved":false,"context_lines":[{"line_number":30,"context_line":"All CPUs appear as usable CPUs on the system and can execute workloads in"},{"line_number":31,"context_line":"parallel. However, as with NUMA, threads compete for shared resources."},{"line_number":32,"context_line":""},{"line_number":33,"context_line":"In OpenStack, SMP CPUs are known as *cores*, NUMA cells or nodes are known as"},{"line_number":34,"context_line":"*sockets*, and SMT CPUs are known as *threads*. For example, a quad-socket,"},{"line_number":35,"context_line":"eight-core system with SMT would contain four sockets, eight cores per"},{"line_number":36,"context_line":"socket and threads per core, for a total of 64 CPUs."}],"source_content_type":"text/x-rst","patch_set":3,"id":"3ac371cc_18abe3d7","line":33,"range":{"start_line":33,"start_character":36,"end_line":33,"end_character":43},"updated":"2016-08-16 09:52:05.000000000","message":"`cores`","commit_id":"f5fb84f5f20060a9c0b6adb07b0cd725a18b1afd"},{"author":{"_account_id":15334,"name":"Stephen Finucane","display_name":"stephenfin","email":"stephenfin@redhat.com","username":"sfinucan"},"change_message_id":"e315db34ec88caf7c19e31c652fbe70e2490a0d6","unresolved":false,"context_lines":[{"line_number":30,"context_line":"All CPUs appear as usable CPUs on the system and can execute workloads in"},{"line_number":31,"context_line":"parallel. However, as with NUMA, threads compete for shared resources."},{"line_number":32,"context_line":""},{"line_number":33,"context_line":"In OpenStack, SMP CPUs are known as *cores*, NUMA cells or nodes are known as"},{"line_number":34,"context_line":"*sockets*, and SMT CPUs are known as *threads*. For example, a quad-socket,"},{"line_number":35,"context_line":"eight-core system with SMT would contain four sockets, eight cores per"},{"line_number":36,"context_line":"socket and threads per core, for a total of 64 CPUs."}],"source_content_type":"text/x-rst","patch_set":3,"id":"3ac371cc_17527fdd","line":33,"range":{"start_line":33,"start_character":36,"end_line":33,"end_character":43},"in_reply_to":"3ac371cc_18abe3d7","updated":"2016-08-16 14:49:22.000000000","message":"Are you sure? None of these terms are code, and the use of italics is good enough to distinguish the terms from surrounding text, IMO","commit_id":"f5fb84f5f20060a9c0b6adb07b0cd725a18b1afd"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"146254dc8df66a65aa8cc3d6017bd6f0e7bd6d1f","unresolved":false,"context_lines":[{"line_number":31,"context_line":"parallel. However, as with NUMA, threads compete for shared resources."},{"line_number":32,"context_line":""},{"line_number":33,"context_line":"In OpenStack, SMP CPUs are known as *cores*, NUMA cells or nodes are known as"},{"line_number":34,"context_line":"*sockets*, and SMT CPUs are known as *threads*. For example, a quad-socket,"},{"line_number":35,"context_line":"eight-core system with SMT would contain four sockets, eight cores per"},{"line_number":36,"context_line":"socket and threads per core, for a total of 64 CPUs."},{"line_number":37,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"3ac371cc_b8828f50","line":34,"range":{"start_line":34,"start_character":1,"end_line":34,"end_character":9},"updated":"2016-08-16 09:52:05.000000000","message":"`sockets`","commit_id":"f5fb84f5f20060a9c0b6adb07b0cd725a18b1afd"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"146254dc8df66a65aa8cc3d6017bd6f0e7bd6d1f","unresolved":false,"context_lines":[{"line_number":31,"context_line":"parallel. However, as with NUMA, threads compete for shared resources."},{"line_number":32,"context_line":""},{"line_number":33,"context_line":"In OpenStack, SMP CPUs are known as *cores*, NUMA cells or nodes are known as"},{"line_number":34,"context_line":"*sockets*, and SMT CPUs are known as *threads*. For example, a quad-socket,"},{"line_number":35,"context_line":"eight-core system with SMT would contain four sockets, eight cores per"},{"line_number":36,"context_line":"socket and threads per core, for a total of 64 CPUs."},{"line_number":37,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"3ac371cc_d87f8b64","line":34,"range":{"start_line":34,"start_character":37,"end_line":34,"end_character":47},"updated":"2016-08-16 09:52:05.000000000","message":"`threads`","commit_id":"f5fb84f5f20060a9c0b6adb07b0cd725a18b1afd"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"146254dc8df66a65aa8cc3d6017bd6f0e7bd6d1f","unresolved":false,"context_lines":[{"line_number":66,"context_line":"   node that the device is associated with will be used. This can provide"},{"line_number":67,"context_line":"   important performance improvements. However, booting a large number of"},{"line_number":68,"context_line":"   similar instances can result in unbalanced NUMA node usage. Care should"},{"line_number":69,"context_line":"   be taken to mitigate this issue. See this `discussion`_ for more details."},{"line_number":70,"context_line":""},{"line_number":71,"context_line":".. caution::"},{"line_number":72,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"3ac371cc_d8a2eb4a","line":69,"range":{"start_line":69,"start_character":36,"end_line":69,"end_character":76},"updated":"2016-08-16 09:52:05.000000000","message":"I don\u0027t necessarily agree with including the email thread in this document.","commit_id":"f5fb84f5f20060a9c0b6adb07b0cd725a18b1afd"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"146254dc8df66a65aa8cc3d6017bd6f0e7bd6d1f","unresolved":false,"context_lines":[{"line_number":206,"context_line":""},{"line_number":207,"context_line":"   There is no correlation required between the NUMA topology exposed in the"},{"line_number":208,"context_line":"   instance and how the instance is actually pinned on the host. This is by"},{"line_number":209,"context_line":"   design. See this `bug \u003chttps://bugs.launchpad.net/nova/+bug/1466780\u003e`_ for"},{"line_number":210,"context_line":"   more information."},{"line_number":211,"context_line":""},{"line_number":212,"context_line":"For more information about image metadata, refer to the `Image metadata`_"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3ac371cc_78f2d7d3","line":209,"range":{"start_line":209,"start_character":21,"end_line":209,"end_character":72},"updated":"2016-08-16 09:52:05.000000000","message":"I would not recommend referring to this bug. As of 2016-02-24 the bug has been marked invalid as the released patch was later reverted.","commit_id":"f5fb84f5f20060a9c0b6adb07b0cd725a18b1afd"},{"author":{"_account_id":15334,"name":"Stephen Finucane","display_name":"stephenfin","email":"stephenfin@redhat.com","username":"sfinucan"},"change_message_id":"e315db34ec88caf7c19e31c652fbe70e2490a0d6","unresolved":false,"context_lines":[{"line_number":206,"context_line":""},{"line_number":207,"context_line":"   There is no correlation required between the NUMA topology exposed in the"},{"line_number":208,"context_line":"   instance and how the instance is actually pinned on the host. This is by"},{"line_number":209,"context_line":"   design. See this `bug \u003chttps://bugs.launchpad.net/nova/+bug/1466780\u003e`_ for"},{"line_number":210,"context_line":"   more information."},{"line_number":211,"context_line":""},{"line_number":212,"context_line":"For more information about image metadata, refer to the `Image metadata`_"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3ac371cc_3705fbbb","line":209,"range":{"start_line":209,"start_character":21,"end_line":209,"end_character":72},"in_reply_to":"3ac371cc_78f2d7d3","updated":"2016-08-16 14:49:22.000000000","message":"This was my point exactly: it\u0027s a feature, not a bug. Added word \"invalid\" to clarify","commit_id":"f5fb84f5f20060a9c0b6adb07b0cd725a18b1afd"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"146254dc8df66a65aa8cc3d6017bd6f0e7bd6d1f","unresolved":false,"context_lines":[{"line_number":222,"context_line":""},{"line_number":223,"context_line":"In addition to configuring how an instance is scheduled on host CPUs, it is"},{"line_number":224,"context_line":"possible to configure how CPUs are represented in the instance itself. By"},{"line_number":225,"context_line":"default, when instance NUMA placement is not specified, a topology of N"},{"line_number":226,"context_line":"sockets, each with one core and one thread, is used for an instance. When"},{"line_number":227,"context_line":"instance NUMA placement is specified, the number of sockets is fixed to the"},{"line_number":228,"context_line":"number of host NUMA nodes to use and the total number of instance CPUs is split"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3ac371cc_d8b78bf3","line":225,"range":{"start_line":225,"start_character":70,"end_line":225,"end_character":71},"updated":"2016-08-16 09:52:05.000000000","message":"N?","commit_id":"f5fb84f5f20060a9c0b6adb07b0cd725a18b1afd"},{"author":{"_account_id":15334,"name":"Stephen Finucane","display_name":"stephenfin","email":"stephenfin@redhat.com","username":"sfinucan"},"change_message_id":"e315db34ec88caf7c19e31c652fbe70e2490a0d6","unresolved":false,"context_lines":[{"line_number":222,"context_line":""},{"line_number":223,"context_line":"In addition to configuring how an instance is scheduled on host CPUs, it is"},{"line_number":224,"context_line":"possible to configure how CPUs are represented in the instance itself. By"},{"line_number":225,"context_line":"default, when instance NUMA placement is not specified, a topology of N"},{"line_number":226,"context_line":"sockets, each with one core and one thread, is used for an instance. When"},{"line_number":227,"context_line":"instance NUMA placement is specified, the number of sockets is fixed to the"},{"line_number":228,"context_line":"number of host NUMA nodes to use and the total number of instance CPUs is split"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3ac371cc_37ca1b6e","line":225,"range":{"start_line":225,"start_character":70,"end_line":225,"end_character":71},"in_reply_to":"3ac371cc_d8b78bf3","updated":"2016-08-16 14:49:22.000000000","message":"Done","commit_id":"f5fb84f5f20060a9c0b6adb07b0cd725a18b1afd"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"146254dc8df66a65aa8cc3d6017bd6f0e7bd6d1f","unresolved":false,"context_lines":[{"line_number":251,"context_line":"   if specifying any one of these values or the multiple of two values, the"},{"line_number":252,"context_line":"   values must be a factor of the number of instance vCPUs to prevent an"},{"line_number":253,"context_line":"   exception. For example, specifying ``hw:cpu_sockets\u003d2`` on a host with an"},{"line_number":254,"context_line":"   odd number of cores fails. Similarly, specifying ``hw:cpu_cores\u003d2`` and"},{"line_number":255,"context_line":"   ``hw:cpu_threads\u003d4`` on a host with ten cores fails."},{"line_number":256,"context_line":""},{"line_number":257,"context_line":"For more information about the syntax for ``hw:cpu_sockets``, ``hw:cpu_cores``"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3ac371cc_18912353","line":254,"range":{"start_line":254,"start_character":30,"end_line":254,"end_character":40},"updated":"2016-08-16 09:52:05.000000000","message":"avoid using the same word twice. Reads confusingly","commit_id":"f5fb84f5f20060a9c0b6adb07b0cd725a18b1afd"},{"author":{"_account_id":15334,"name":"Stephen Finucane","display_name":"stephenfin","email":"stephenfin@redhat.com","username":"sfinucan"},"change_message_id":"e315db34ec88caf7c19e31c652fbe70e2490a0d6","unresolved":false,"context_lines":[{"line_number":251,"context_line":"   if specifying any one of these values or the multiple of two values, the"},{"line_number":252,"context_line":"   values must be a factor of the number of instance vCPUs to prevent an"},{"line_number":253,"context_line":"   exception. For example, specifying ``hw:cpu_sockets\u003d2`` on a host with an"},{"line_number":254,"context_line":"   odd number of cores fails. Similarly, specifying ``hw:cpu_cores\u003d2`` and"},{"line_number":255,"context_line":"   ``hw:cpu_threads\u003d4`` on a host with ten cores fails."},{"line_number":256,"context_line":""},{"line_number":257,"context_line":"For more information about the syntax for ``hw:cpu_sockets``, ``hw:cpu_cores``"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3ac371cc_179c3f68","line":254,"range":{"start_line":254,"start_character":30,"end_line":254,"end_character":40},"in_reply_to":"3ac371cc_18912353","updated":"2016-08-16 14:49:22.000000000","message":"Done","commit_id":"f5fb84f5f20060a9c0b6adb07b0cd725a18b1afd"}],"doc/admin-guide/source/compute-numa-cpu-pinning.rst":[{"author":{"_account_id":22165,"name":"caoyuan","email":"cao.yingjunz@gmail.com","username":"caoyuan"},"change_message_id":"adf4c2aa83777373376d871dacdeab0ef310ba3e","unresolved":false,"context_lines":[{"line_number":234,"context_line":""},{"line_number":235,"context_line":".. code-block:: console"},{"line_number":236,"context_line":""},{"line_number":237,"context_line":"   # openstack flavor set [IMAGE_ID] --property hw:cpu_sockets\u003d2"},{"line_number":238,"context_line":""},{"line_number":239,"context_line":"Similarly, to configure a flavor to use one core and one thread, run:"},{"line_number":240,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"9ad45d7e_ecacaca0","line":237,"range":{"start_line":237,"start_character":26,"end_line":237,"end_character":36},"updated":"2016-08-12 06:12:03.000000000","message":"Here the [IMAGE_ID] is a typo?\n \nusage: openstack flavor set [-h] [--property \u003ckey\u003dvalue\u003e] \u003cflavor\u003e","commit_id":"7b5bc9ee7f20587a59cf24fab9504b87e43650a0"},{"author":{"_account_id":15334,"name":"Stephen Finucane","display_name":"stephenfin","email":"stephenfin@redhat.com","username":"sfinucan"},"change_message_id":"fb66798602aef7b840078c2e39ce275297a0551b","unresolved":false,"context_lines":[{"line_number":234,"context_line":""},{"line_number":235,"context_line":".. code-block:: console"},{"line_number":236,"context_line":""},{"line_number":237,"context_line":"   # openstack flavor set [IMAGE_ID] --property hw:cpu_sockets\u003d2"},{"line_number":238,"context_line":""},{"line_number":239,"context_line":"Similarly, to configure a flavor to use one core and one thread, run:"},{"line_number":240,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"9ad45d7e_13866213","line":237,"range":{"start_line":237,"start_character":26,"end_line":237,"end_character":36},"in_reply_to":"9ad45d7e_ecacaca0","updated":"2016-08-12 14:47:25.000000000","message":"Done","commit_id":"7b5bc9ee7f20587a59cf24fab9504b87e43650a0"},{"author":{"_account_id":22165,"name":"caoyuan","email":"cao.yingjunz@gmail.com","username":"caoyuan"},"change_message_id":"adf4c2aa83777373376d871dacdeab0ef310ba3e","unresolved":false,"context_lines":[{"line_number":279,"context_line":""},{"line_number":280,"context_line":".. code-block:: console"},{"line_number":281,"context_line":""},{"line_number":282,"context_line":"   # openstack image set [IMAGE_ID] \\"},{"line_number":283,"context_line":"       --property hw_cpu_sockets\u003d2 \\"},{"line_number":284,"context_line":"       --property hw_cpu_cores\u003d4"},{"line_number":285,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"9ad45d7e_0cd020c8","line":282,"range":{"start_line":282,"start_character":24,"end_line":282,"end_character":35},"updated":"2016-08-12 06:12:03.000000000","message":"\u003cimage\u003e  is more accurater ，image_id and image_name is all work :) \nFYI thanks","commit_id":"7b5bc9ee7f20587a59cf24fab9504b87e43650a0"},{"author":{"_account_id":15334,"name":"Stephen Finucane","display_name":"stephenfin","email":"stephenfin@redhat.com","username":"sfinucan"},"change_message_id":"fb66798602aef7b840078c2e39ce275297a0551b","unresolved":false,"context_lines":[{"line_number":279,"context_line":""},{"line_number":280,"context_line":".. code-block:: console"},{"line_number":281,"context_line":""},{"line_number":282,"context_line":"   # openstack image set [IMAGE_ID] \\"},{"line_number":283,"context_line":"       --property hw_cpu_sockets\u003d2 \\"},{"line_number":284,"context_line":"       --property hw_cpu_cores\u003d4"},{"line_number":285,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"9ad45d7e_f3b46ed5","line":282,"range":{"start_line":282,"start_character":24,"end_line":282,"end_character":35},"in_reply_to":"9ad45d7e_0cd020c8","updated":"2016-08-12 14:47:25.000000000","message":"I\u0027m keeping this consistent with the rest of the docs, but I\u0027ll fix in a follow-up patch","commit_id":"7b5bc9ee7f20587a59cf24fab9504b87e43650a0"},{"author":{"_account_id":22165,"name":"caoyuan","email":"cao.yingjunz@gmail.com","username":"caoyuan"},"change_message_id":"adf4c2aa83777373376d871dacdeab0ef310ba3e","unresolved":false,"context_lines":[{"line_number":289,"context_line":""},{"line_number":290,"context_line":".. code-block:: console"},{"line_number":291,"context_line":""},{"line_number":292,"context_line":"   # openstack image set [IMAGE_ID] \\"},{"line_number":293,"context_line":"       --property hw_cpu_max_sockets\u003d2 \\"},{"line_number":294,"context_line":"       --property hw_cpu_max_threads\u003d1"},{"line_number":295,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"9ad45d7e_4cde98dd","line":292,"range":{"start_line":292,"start_character":25,"end_line":292,"end_character":35},"updated":"2016-08-12 06:12:03.000000000","message":"diito","commit_id":"7b5bc9ee7f20587a59cf24fab9504b87e43650a0"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"5cc4f06c139e572adc33e818b47c218de1683b22","unresolved":false,"context_lines":[{"line_number":32,"context_line":"however, as with NUMA, threads compete for shared resources."},{"line_number":33,"context_line":""},{"line_number":34,"context_line":"In OpenStack, SMP CPUs are known as \"cores\", NUMA cells or nodes are known as"},{"line_number":35,"context_line":"sockets, and SMT CPUs are known as \"threads\". For example, a quad-socket, eight"},{"line_number":36,"context_line":"core system with Hyper-Threading would have four sockets, eight cores per"},{"line_number":37,"context_line":"socket and threads per core, for a total of 64 CPUs."},{"line_number":38,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"3ac371cc_b0c82676","line":35,"range":{"start_line":35,"start_character":0,"end_line":35,"end_character":7},"updated":"2016-08-15 08:20:03.000000000","message":"Do we need to put the word in quotes for consistency with other items? -\u003e \"sockets\"","commit_id":"32f74faa73f5ea691dfd2dfd62bb8b6daae3371b"},{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"5b634afb0954c01e37a1f3858aed4f02e5fa8eaf","unresolved":false,"context_lines":[{"line_number":32,"context_line":"however, as with NUMA, threads compete for shared resources."},{"line_number":33,"context_line":""},{"line_number":34,"context_line":"In OpenStack, SMP CPUs are known as \"cores\", NUMA cells or nodes are known as"},{"line_number":35,"context_line":"sockets, and SMT CPUs are known as \"threads\". For example, a quad-socket, eight"},{"line_number":36,"context_line":"core system with Hyper-Threading would have four sockets, eight cores per"},{"line_number":37,"context_line":"socket and threads per core, for a total of 64 CPUs."},{"line_number":38,"context_line":""},{"line_number":39,"context_line":"Customizing instance NUMA placement policies"}],"source_content_type":"text/x-rst","patch_set":2,"id":"9ad45d7e_82d95d86","line":36,"range":{"start_line":35,"start_character":74,"end_line":36,"end_character":4},"updated":"2016-08-12 15:10:57.000000000","message":"eight-core","commit_id":"32f74faa73f5ea691dfd2dfd62bb8b6daae3371b"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"5cc4f06c139e572adc33e818b47c218de1683b22","unresolved":false,"context_lines":[{"line_number":220,"context_line":"   The functionality described below is currently only supported by the"},{"line_number":221,"context_line":"   libvirt/KVM driver."},{"line_number":222,"context_line":""},{"line_number":223,"context_line":"In addition to configuring how an instance is scheduled on host CPUs, it is"},{"line_number":224,"context_line":"possible to configure how CPUs are represented in the instance itself. By"},{"line_number":225,"context_line":"default, when instance NUMA placement is not specified, a topology of N"},{"line_number":226,"context_line":"sockets, each with one core and one thread, is used for an instance. When"},{"line_number":227,"context_line":"instance NUMA placement is specified, the number of sockets is fixed to the"}],"source_content_type":"text/x-rst","patch_set":2,"id":"3ac371cc_b0b94631","line":224,"range":{"start_line":223,"start_character":70,"end_line":224,"end_character":11},"updated":"2016-08-15 08:20:03.000000000","message":"Optional: change to \u0027you can\u0027.","commit_id":"32f74faa73f5ea691dfd2dfd62bb8b6daae3371b"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"5cc4f06c139e572adc33e818b47c218de1683b22","unresolved":false,"context_lines":[{"line_number":225,"context_line":"default, when instance NUMA placement is not specified, a topology of N"},{"line_number":226,"context_line":"sockets, each with one core and one thread, is used for an instance. When"},{"line_number":227,"context_line":"instance NUMA placement is specified, the number of sockets is fixed to the"},{"line_number":228,"context_line":"number of host NUMA nodes to use and the total number of instance CPUs is split"},{"line_number":229,"context_line":"over these sockets."},{"line_number":230,"context_line":""},{"line_number":231,"context_line":"Some workloads benefit from a custom topology. For example, in some operating"}],"source_content_type":"text/x-rst","patch_set":2,"id":"3ac371cc_70dd0e70","line":228,"range":{"start_line":228,"start_character":32,"end_line":228,"end_character":33},"updated":"2016-08-15 08:20:03.000000000","message":"comma","commit_id":"32f74faa73f5ea691dfd2dfd62bb8b6daae3371b"},{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"5b634afb0954c01e37a1f3858aed4f02e5fa8eaf","unresolved":false,"context_lines":[{"line_number":246,"context_line":""},{"line_number":247,"context_line":".. caution::"},{"line_number":248,"context_line":""},{"line_number":249,"context_line":"   Where all values are specified, sockets * cores * threads must equal the"},{"line_number":250,"context_line":"   number of CPUs on the instance. Similarly, when any one of these values, or"},{"line_number":251,"context_line":"   the multiple of two values, are specified, the values must be a factor of"},{"line_number":252,"context_line":"   the number of CPUs on the instance. If this is not true, an exception will"}],"source_content_type":"text/x-rst","patch_set":2,"id":"9ad45d7e_22cfd1b4","line":249,"range":{"start_line":249,"start_character":43,"end_line":249,"end_character":52},"updated":"2016-08-12 15:10:57.000000000","message":"*cores*","commit_id":"32f74faa73f5ea691dfd2dfd62bb8b6daae3371b"},{"author":{"_account_id":6772,"name":"Stephen Gordon","email":"sgordon@redhat.com","username":"sgordon"},"change_message_id":"460cb1c71100ab60f87151e635494ceafd1b07de","unresolved":false,"context_lines":[{"line_number":246,"context_line":""},{"line_number":247,"context_line":".. caution::"},{"line_number":248,"context_line":""},{"line_number":249,"context_line":"   Where all values are specified, sockets * cores * threads must equal the"},{"line_number":250,"context_line":"   number of CPUs on the instance. Similarly, when any one of these values, or"},{"line_number":251,"context_line":"   the multiple of two values, are specified, the values must be a factor of"},{"line_number":252,"context_line":"   the number of CPUs on the instance. If this is not true, an exception will"}],"source_content_type":"text/x-rst","patch_set":2,"id":"9ad45d7e_d8e69515","line":249,"updated":"2016-08-12 19:18:45.000000000","message":"I believe the intent here is not to add emphasis but to indicate multiplication.","commit_id":"32f74faa73f5ea691dfd2dfd62bb8b6daae3371b"},{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"290f468a04288ffe77ceae6c1af8cd1d93844e97","unresolved":false,"context_lines":[{"line_number":246,"context_line":""},{"line_number":247,"context_line":".. caution::"},{"line_number":248,"context_line":""},{"line_number":249,"context_line":"   Where all values are specified, sockets * cores * threads must equal the"},{"line_number":250,"context_line":"   number of CPUs on the instance. Similarly, when any one of these values, or"},{"line_number":251,"context_line":"   the multiple of two values, are specified, the values must be a factor of"},{"line_number":252,"context_line":"   the number of CPUs on the instance. If this is not true, an exception will"}],"source_content_type":"text/x-rst","patch_set":2,"id":"3ac371cc_b37e6dac","line":249,"in_reply_to":"9ad45d7e_d8e69515","updated":"2016-08-15 10:10:51.000000000","message":"Ah, I see. Then we can use multiplication symbols. Please see: http://docs.openstack.org/contributor-guide/writing-style/num_and_units_of_measure.html or just say \"multiplied by\"","commit_id":"32f74faa73f5ea691dfd2dfd62bb8b6daae3371b"},{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"5b634afb0954c01e37a1f3858aed4f02e5fa8eaf","unresolved":false,"context_lines":[{"line_number":254,"context_line":"   odd number of cores will fail. Similarly, specifying ``hw:cpu_cores\u003d2`` and"},{"line_number":255,"context_line":"   ``hw:cpu_threads\u003d4`` on a system with ten cores will fail."},{"line_number":256,"context_line":""},{"line_number":257,"context_line":"For more information about the syntax for ``hw:cpu_sockets``, ``hw:cpu_cores``"},{"line_number":258,"context_line":"and ``hw:cpu_threads``, refer to the `Flavors`_ guide."},{"line_number":259,"context_line":""},{"line_number":260,"context_line":"It is also possible to set upper limits on the number of sockets, cores and"}],"source_content_type":"text/x-rst","patch_set":2,"id":"9ad45d7e_82c03d7e","line":257,"range":{"start_line":257,"start_character":62,"end_line":257,"end_character":78},"updated":"2016-08-12 15:10:57.000000000","message":"``hw:cpu_cores``,","commit_id":"32f74faa73f5ea691dfd2dfd62bb8b6daae3371b"},{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"5b634afb0954c01e37a1f3858aed4f02e5fa8eaf","unresolved":false,"context_lines":[{"line_number":257,"context_line":"For more information about the syntax for ``hw:cpu_sockets``, ``hw:cpu_cores``"},{"line_number":258,"context_line":"and ``hw:cpu_threads``, refer to the `Flavors`_ guide."},{"line_number":259,"context_line":""},{"line_number":260,"context_line":"It is also possible to set upper limits on the number of sockets, cores and"},{"line_number":261,"context_line":"threads used. Unlike the hard values seen above, it is not necessary for this"},{"line_number":262,"context_line":"exact number to used: it is merely a limit. This can be used to allow for some"},{"line_number":263,"context_line":"flexibility in scheduling, while ensuring certains limits are not exceeded. For"}],"source_content_type":"text/x-rst","patch_set":2,"id":"9ad45d7e_023bad9d","line":260,"range":{"start_line":260,"start_character":66,"end_line":260,"end_character":71},"updated":"2016-08-12 15:10:57.000000000","message":"cores,","commit_id":"32f74faa73f5ea691dfd2dfd62bb8b6daae3371b"},{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"5b634afb0954c01e37a1f3858aed4f02e5fa8eaf","unresolved":false,"context_lines":[{"line_number":259,"context_line":""},{"line_number":260,"context_line":"It is also possible to set upper limits on the number of sockets, cores and"},{"line_number":261,"context_line":"threads used. Unlike the hard values seen above, it is not necessary for this"},{"line_number":262,"context_line":"exact number to used: it is merely a limit. This can be used to allow for some"},{"line_number":263,"context_line":"flexibility in scheduling, while ensuring certains limits are not exceeded. For"},{"line_number":264,"context_line":"example, to ensure no more than two sockets are defined in the instance"},{"line_number":265,"context_line":"topology, run:"}],"source_content_type":"text/x-rst","patch_set":2,"id":"9ad45d7e_82479d1c","line":262,"range":{"start_line":262,"start_character":13,"end_line":262,"end_character":20},"updated":"2016-08-12 15:10:57.000000000","message":"to be used ?","commit_id":"32f74faa73f5ea691dfd2dfd62bb8b6daae3371b"},{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"5b634afb0954c01e37a1f3858aed4f02e5fa8eaf","unresolved":false,"context_lines":[{"line_number":260,"context_line":"It is also possible to set upper limits on the number of sockets, cores and"},{"line_number":261,"context_line":"threads used. Unlike the hard values seen above, it is not necessary for this"},{"line_number":262,"context_line":"exact number to used: it is merely a limit. This can be used to allow for some"},{"line_number":263,"context_line":"flexibility in scheduling, while ensuring certains limits are not exceeded. For"},{"line_number":264,"context_line":"example, to ensure no more than two sockets are defined in the instance"},{"line_number":265,"context_line":"topology, run:"},{"line_number":266,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"9ad45d7e_e25499cb","line":263,"range":{"start_line":263,"start_character":49,"end_line":263,"end_character":50},"updated":"2016-08-12 15:10:57.000000000","message":"certain","commit_id":"32f74faa73f5ea691dfd2dfd62bb8b6daae3371b"},{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"5b634afb0954c01e37a1f3858aed4f02e5fa8eaf","unresolved":false,"context_lines":[{"line_number":275,"context_line":"Applications are frequently packaged as images. For applications that prefer"},{"line_number":276,"context_line":"certain CPU topologies, configure image metadata to hint that created instances"},{"line_number":277,"context_line":"should have a given topology regardless of flavor. To configure an image to"},{"line_number":278,"context_line":"request a two socket, four core per socket topology, run:"},{"line_number":279,"context_line":""},{"line_number":280,"context_line":".. code-block:: console"},{"line_number":281,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"9ad45d7e_c268758a","line":278,"range":{"start_line":278,"start_character":10,"end_line":278,"end_character":20},"updated":"2016-08-12 15:10:57.000000000","message":"two-socket","commit_id":"32f74faa73f5ea691dfd2dfd62bb8b6daae3371b"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"5cc4f06c139e572adc33e818b47c218de1683b22","unresolved":false,"context_lines":[{"line_number":296,"context_line":"Image metadata takes precedence over flavor extra specs: configuring competing"},{"line_number":297,"context_line":"constraints will result in an exception. By setting a ``max`` value for"},{"line_number":298,"context_line":"sockets, cores or threads, administrators can prevent users configuring"},{"line_number":299,"context_line":"topologies that might, for example, incur an additional licensing fees."},{"line_number":300,"context_line":""},{"line_number":301,"context_line":"For more information about image metadata, refer to the `Image metadata`_"},{"line_number":302,"context_line":"guide."}],"source_content_type":"text/x-rst","patch_set":2,"id":"3ac371cc_9031aaef","line":299,"range":{"start_line":299,"start_character":42,"end_line":299,"end_character":70},"updated":"2016-08-15 08:20:03.000000000","message":"either \u0027additional licensing fees\u0027 or \u0027an additional licensing fee\u0027.","commit_id":"32f74faa73f5ea691dfd2dfd62bb8b6daae3371b"},{"author":{"_account_id":15334,"name":"Stephen Finucane","display_name":"stephenfin","email":"stephenfin@redhat.com","username":"sfinucan"},"change_message_id":"66e8508b9505e126a39b77b4c3cb6fbc0c272ec1","unresolved":false,"context_lines":[{"line_number":235,"context_line":""},{"line_number":236,"context_line":".. code-block:: console"},{"line_number":237,"context_line":""},{"line_number":238,"context_line":"   # openstack flavor set m1.large --property hw:cpu_sockets\u003d2"},{"line_number":239,"context_line":""},{"line_number":240,"context_line":"Similarly, to configure a flavor to use one core and one thread, run:"},{"line_number":241,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"3ac371cc_1a48e65a","line":238,"range":{"start_line":238,"start_character":3,"end_line":238,"end_character":62},"updated":"2016-08-16 14:59:03.000000000","message":"I used the wrong style to keep consistent with the rest of the file. Fixed in the follow up patch","commit_id":"a0d046f15b7ca2fd3099bbf3a77effe4fe6fbb56"}]}