)]}'
{"doc/source/config.rst":[{"author":{"_account_id":6618,"name":"Ruby Loo","email":"opensrloo@gmail.com","username":"rloo"},"change_message_id":"e3ce015805997e4fb8f52127f0a32d762d557ae6","unresolved":false,"context_lines":[{"line_number":13,"context_line":"The **[DEFAULT]** section of the file configures overall defaults for Ironic."},{"line_number":14,"context_line":""},{"line_number":15,"context_line":"my_ip"},{"line_number":16,"context_line":"  The IP address of the host running Ironic. If unset, the default is FIXME."},{"line_number":17,"context_line":""},{"line_number":18,"context_line":"use_ipv6"},{"line_number":19,"context_line":"  A Boolean value indicating whether IPv6 should be used or not. It defaults to FIXME."}],"source_content_type":"text/x-rst","patch_set":1,"id":"AAAAWH%2F90Pk%3D","line":16,"updated":"2014-04-02 00:13:51.000000000","message":"It defaults to the IP of the machine. If that can\u0027t be determined, it uses 127.0.0.1.","commit_id":"41f43d396154e3024f7c3c1bf54fdb6aece00cc6"},{"author":{"_account_id":6618,"name":"Ruby Loo","email":"opensrloo@gmail.com","username":"rloo"},"change_message_id":"e3ce015805997e4fb8f52127f0a32d762d557ae6","unresolved":false,"context_lines":[{"line_number":16,"context_line":"  The IP address of the host running Ironic. If unset, the default is FIXME."},{"line_number":17,"context_line":""},{"line_number":18,"context_line":"use_ipv6"},{"line_number":19,"context_line":"  A Boolean value indicating whether IPv6 should be used or not. It defaults to FIXME."},{"line_number":20,"context_line":""},{"line_number":21,"context_line":"auth_strategy"},{"line_number":22,"context_line":"  The authentication strategy used by the API. Accepted values are \"noauth\" or \"keystone\". If set to \"keystone\", Keystone will be used for documentation. \"noauth\" will disable all authentication, and should not be used in a production environment."}],"source_content_type":"text/x-rst","patch_set":1,"id":"AAAAWH%2F90O8%3D","line":19,"updated":"2014-04-02 00:13:51.000000000","message":"defaults to False","commit_id":"41f43d396154e3024f7c3c1bf54fdb6aece00cc6"},{"author":{"_account_id":6618,"name":"Ruby Loo","email":"opensrloo@gmail.com","username":"rloo"},"change_message_id":"e3ce015805997e4fb8f52127f0a32d762d557ae6","unresolved":false,"context_lines":[{"line_number":19,"context_line":"  A Boolean value indicating whether IPv6 should be used or not. It defaults to FIXME."},{"line_number":20,"context_line":""},{"line_number":21,"context_line":"auth_strategy"},{"line_number":22,"context_line":"  The authentication strategy used by the API. Accepted values are \"noauth\" or \"keystone\". If set to \"keystone\", Keystone will be used for documentation. \"noauth\" will disable all authentication, and should not be used in a production environment."},{"line_number":23,"context_line":""},{"line_number":24,"context_line":"fatal_exception_format_errors"},{"line_number":25,"context_line":"  I have no idea what this does. FIXME!"}],"source_content_type":"text/x-rst","patch_set":1,"id":"AAAAWH%2F90OQ%3D","line":22,"updated":"2014-04-02 00:13:51.000000000","message":"\"Keystone will be used for authentication\" -- not \u0027documentation\u0027 ;)\n\nDefault is \u0027keystone\".","commit_id":"41f43d396154e3024f7c3c1bf54fdb6aece00cc6"},{"author":{"_account_id":6618,"name":"Ruby Loo","email":"opensrloo@gmail.com","username":"rloo"},"change_message_id":"e3ce015805997e4fb8f52127f0a32d762d557ae6","unresolved":false,"context_lines":[{"line_number":22,"context_line":"  The authentication strategy used by the API. Accepted values are \"noauth\" or \"keystone\". If set to \"keystone\", Keystone will be used for documentation. \"noauth\" will disable all authentication, and should not be used in a production environment."},{"line_number":23,"context_line":""},{"line_number":24,"context_line":"fatal_exception_format_errors"},{"line_number":25,"context_line":"  I have no idea what this does. FIXME!"},{"line_number":26,"context_line":""},{"line_number":27,"context_line":"hash_partition_exponent"},{"line_number":28,"context_line":"  Exponent to determine number of hash partitions to use when"}],"source_content_type":"text/x-rst","patch_set":1,"id":"AAAAWH%2F90OE%3D","line":25,"updated":"2014-04-02 00:13:51.000000000","message":"If you don\u0027t know, just copy the comment from the etc/ironic/ironic.conf.sample :-)  This is probably a good opportunity to update any comments. At the end of the day, it would be nice to just use the ironic.conf.sample as documentation.\n\nI think it means that exceptions are logged with log level\u003dFatal if this is set to True; otherwise they are logged with log level\u003dError.","commit_id":"41f43d396154e3024f7c3c1bf54fdb6aece00cc6"},{"author":{"_account_id":6618,"name":"Ruby Loo","email":"opensrloo@gmail.com","username":"rloo"},"change_message_id":"e3ce015805997e4fb8f52127f0a32d762d557ae6","unresolved":false,"context_lines":[{"line_number":39,"context_line":"  conductor instance is terminated. (integer value)"},{"line_number":40,"context_line":""},{"line_number":41,"context_line":"force_raw_images"},{"line_number":42,"context_line":"  It true, images backing Ironic deployments will be coerced"},{"line_number":43,"context_line":"  into raw format. (FIXME: what does this mean? Why would a user want one?)"},{"line_number":44,"context_line":""},{"line_number":45,"context_line":"pybasedir"}],"source_content_type":"text/x-rst","patch_set":1,"id":"AAAAWH%2F90DY%3D","line":42,"updated":"2014-04-02 00:13:51.000000000","message":"\"It\" -\u003e \"If\"\n\nMaybe put raw in quotes. There are different formats for disk images (see http://docs.openstack.org/image-guide/content/ch_introduction.html). So it means that if the image isn\u0027t in \"raw\" format and this is set to True, the image is converted to \"raw\" format ;)\n\nSo maybe something like \u0027If true, the backing image will be in \"raw\" disk format\u0027 ?","commit_id":"41f43d396154e3024f7c3c1bf54fdb6aece00cc6"},{"author":{"_account_id":6618,"name":"Ruby Loo","email":"opensrloo@gmail.com","username":"rloo"},"change_message_id":"e3ce015805997e4fb8f52127f0a32d762d557ae6","unresolved":false,"context_lines":[{"line_number":43,"context_line":"  into raw format. (FIXME: what does this mean? Why would a user want one?)"},{"line_number":44,"context_line":""},{"line_number":45,"context_line":"pybasedir"},{"line_number":46,"context_line":"  Explicitly set the directory where the Ironic Python module is"},{"line_number":47,"context_line":"  installed."},{"line_number":48,"context_line":""},{"line_number":49,"context_line":"bindir"}],"source_content_type":"text/x-rst","patch_set":1,"id":"AAAAWH%2F90C4%3D","line":46,"updated":"2014-04-02 00:13:51.000000000","message":"There is a default, so don\u0027t need to explicitly set this? Should mention the default.","commit_id":"41f43d396154e3024f7c3c1bf54fdb6aece00cc6"},{"author":{"_account_id":6618,"name":"Ruby Loo","email":"opensrloo@gmail.com","username":"rloo"},"change_message_id":"e3ce015805997e4fb8f52127f0a32d762d557ae6","unresolved":false,"context_lines":[{"line_number":47,"context_line":"  installed."},{"line_number":48,"context_line":""},{"line_number":49,"context_line":"bindir"},{"line_number":50,"context_line":"  Explicitly set the directory in which the Ironic binaries are installed. "},{"line_number":51,"context_line":""},{"line_number":52,"context_line":"state_path"},{"line_number":53,"context_line":"  Explicitly set the top-level directory where Ironic\u0027s state is kept."}],"source_content_type":"text/x-rst","patch_set":1,"id":"AAAAWH%2F90Co%3D","line":50,"updated":"2014-04-02 00:13:51.000000000","message":"There is a default, so don\u0027t need to explicitly set this? Am wondering about your use of \u0027explicit\u0027. Seems like if the user specifies any of the option values, they are explicitly setting it?\n\nShould mention the default.","commit_id":"41f43d396154e3024f7c3c1bf54fdb6aece00cc6"},{"author":{"_account_id":6618,"name":"Ruby Loo","email":"opensrloo@gmail.com","username":"rloo"},"change_message_id":"e3ce015805997e4fb8f52127f0a32d762d557ae6","unresolved":false,"context_lines":[{"line_number":50,"context_line":"  Explicitly set the directory in which the Ironic binaries are installed. "},{"line_number":51,"context_line":""},{"line_number":52,"context_line":"state_path"},{"line_number":53,"context_line":"  Explicitly set the top-level directory where Ironic\u0027s state is kept."},{"line_number":54,"context_line":""},{"line_number":55,"context_line":"policy_file"},{"line_number":56,"context_line":"  A JSON file representing policy. (FIXME: What type of policy? When"}],"source_content_type":"text/x-rst","patch_set":1,"id":"AAAAWH%2F9z%2BA%3D","line":53,"updated":"2014-04-02 00:13:51.000000000","message":"Default \u003d ?","commit_id":"41f43d396154e3024f7c3c1bf54fdb6aece00cc6"},{"author":{"_account_id":6618,"name":"Ruby Loo","email":"opensrloo@gmail.com","username":"rloo"},"change_message_id":"e3ce015805997e4fb8f52127f0a32d762d557ae6","unresolved":false,"context_lines":[{"line_number":53,"context_line":"  Explicitly set the top-level directory where Ironic\u0027s state is kept."},{"line_number":54,"context_line":""},{"line_number":55,"context_line":"policy_file"},{"line_number":56,"context_line":"  A JSON file representing policy. (FIXME: What type of policy? When"},{"line_number":57,"context_line":"  would a user modifty this?)"},{"line_number":58,"context_line":""},{"line_number":59,"context_line":"policy_default_rule"}],"source_content_type":"text/x-rst","patch_set":1,"id":"AAAAWH%2F9z7w%3D","line":56,"updated":"2014-04-02 00:13:51.000000000","message":"Good question. I did a quick look and found this for glance: http://docs.openstack.org/developer/glance/policies.html. Seems like there should be something better. \n\nFor ironic, the policy.json file that we provide basically says that only users in an \"admin\" or \"administrator\" role can do anything. I guess we probably ought to document policy.json somewhere and maybe put a link to it here?","commit_id":"41f43d396154e3024f7c3c1bf54fdb6aece00cc6"},{"author":{"_account_id":6618,"name":"Ruby Loo","email":"opensrloo@gmail.com","username":"rloo"},"change_message_id":"e3ce015805997e4fb8f52127f0a32d762d557ae6","unresolved":false,"context_lines":[{"line_number":57,"context_line":"  would a user modifty this?)"},{"line_number":58,"context_line":""},{"line_number":59,"context_line":"policy_default_rule"},{"line_number":60,"context_line":"  Sets what rule should be checked when the requested rule is not found."},{"line_number":61,"context_line":""},{"line_number":62,"context_line":"periodic_interval"},{"line_number":63,"context_line":"  The number of seconds between runs of periodic tasks."}],"source_content_type":"text/x-rst","patch_set":1,"id":"AAAAWH%2F9z6k%3D","line":60,"updated":"2014-04-02 00:13:51.000000000","message":"Before you ask me :-), the value for this is a rule (name) in the policy_file. If you look in etc/ironic/policy.json, you\u0027ll see 3 rules: \u0027admin\u0027, \u0027admin_api\u0027, and \u0027default\u0027. The default value for this is \u0027default\u0027.","commit_id":"41f43d396154e3024f7c3c1bf54fdb6aece00cc6"},{"author":{"_account_id":6618,"name":"Ruby Loo","email":"opensrloo@gmail.com","username":"rloo"},"change_message_id":"e3ce015805997e4fb8f52127f0a32d762d557ae6","unresolved":false,"context_lines":[{"line_number":60,"context_line":"  Sets what rule should be checked when the requested rule is not found."},{"line_number":61,"context_line":""},{"line_number":62,"context_line":"periodic_interval"},{"line_number":63,"context_line":"  The number of seconds between runs of periodic tasks."},{"line_number":64,"context_line":""},{"line_number":65,"context_line":"host"},{"line_number":66,"context_line":"  The name of the Ironic node. Using a hostname or IP address is recommended,"}],"source_content_type":"text/x-rst","patch_set":1,"id":"AAAAWH%2F9z48%3D","line":63,"updated":"2014-04-02 00:13:51.000000000","message":"Oh boy, this isn\u0027t quite true any more. Well, maybe we should pretend it is true so I don\u0027t have to try to word it. Or maybe someone else can...","commit_id":"41f43d396154e3024f7c3c1bf54fdb6aece00cc6"}]}
