#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: horizon 24.1.0.dev46\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2024-06-07 20:45+0000\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../source/configuration/branding.rst:3
msgid "Branding Horizon"
msgstr ""
#: ../../source/configuration/branding.rst:5
msgid ""
"As of the Liberty release, Horizon has begun to conform more strictly to "
"Bootstrap standards in an effort to embrace more responsive web design as "
"well as alleviate the future need to re-brand new functionality for every "
"release."
msgstr ""
#: ../../source/configuration/branding.rst:10
msgid "Supported Components"
msgstr ""
#: ../../source/configuration/branding.rst:11
msgid ""
"The following components, organized by release, are the only ones that make "
"full use of the Bootstrap theme architecture."
msgstr ""
#: ../../source/configuration/branding.rst:14
msgid "8.0.0 (Liberty)"
msgstr ""
#: ../../source/configuration/branding.rst:16
msgid "`Top Navbar`_"
msgstr ""
#: ../../source/configuration/branding.rst:17
msgid "`Side Nav`_"
msgstr ""
#: ../../source/configuration/branding.rst:18
msgid "`Pie Charts`_"
msgstr ""
#: ../../source/configuration/branding.rst:20
msgid "9.0.0 (Mitaka)"
msgstr ""
#: ../../source/configuration/branding.rst:22
msgid "Tables_"
msgstr ""
#: ../../source/configuration/branding.rst:23
msgid "`Bar Charts`_"
msgstr ""
#: ../../source/configuration/branding.rst:24
msgid "Login_"
msgstr ""
#: ../../source/configuration/branding.rst:25
msgid "Tabs_"
msgstr ""
#: ../../source/configuration/branding.rst:26
msgid "Alerts_"
msgstr ""
#: ../../source/configuration/branding.rst:27
msgid "Checkboxes_"
msgstr ""
#: ../../source/configuration/branding.rst:30
msgid "Step 1"
msgstr ""
#: ../../source/configuration/branding.rst:32
msgid ""
"The first step needed to create a custom branded theme for Horizon is to "
"create a custom Bootstrap theme. There are several tools to aid in this. "
"Some of the more useful ones include:"
msgstr ""
#: ../../source/configuration/branding.rst:36
msgid "`Bootswatchr`_"
msgstr ""
#: ../../source/configuration/branding.rst:37
msgid "`Paintstrap`_"
msgstr ""
#: ../../source/configuration/branding.rst:38
msgid "`Bootstrap`_"
msgstr ""
#: ../../source/configuration/branding.rst:42
msgid ""
"Bootstrap uses LESS by default, but we use SCSS. All of the above tools "
"will provide the ``variables.less`` file, which will need to be converted to "
"``_variables.scss``"
msgstr ""
#: ../../source/configuration/branding.rst:47
msgid "Top Navbar"
msgstr ""
#: ../../source/configuration/branding.rst:49
msgid ""
"The top navbar in Horizon now uses a native Bootstrap ``navbar``. There are "
"a number of variables that can be used to customize this element. Please "
"see the **Navbar** section of your variables file for specifics on what can "
"be set: any variables that use ``navbar-default``."
msgstr ""
#: ../../source/configuration/branding.rst:54
msgid ""
"It is important to also note that the navbar now uses native Bootstrap "
"dropdowns, which are customizable with variables. Please see the "
"**Dropdowns** section of your variables file."
msgstr ""
#: ../../source/configuration/branding.rst:58
msgid ""
"The top navbar is now responsive on smaller screens. When the window size "
"hits your ``$screen-sm`` value, the topbar will compress into a design that "
"is better suited for small screens."
msgstr ""
#: ../../source/configuration/branding.rst:63
msgid "Side Nav"
msgstr ""
#: ../../source/configuration/branding.rst:65
msgid ""
"The side navigation component has been refactored to use the native Stacked "
"Pills element from Bootstrap. See **Pills** section of your variables file "
"for specific variables to customize."
msgstr ""
#: ../../source/configuration/branding.rst:70
msgid "Charts"
msgstr ""
#: ../../source/configuration/branding.rst:73
msgid "Pie Charts"
msgstr ""
#: ../../source/configuration/branding.rst:75
msgid ""
"Pie Charts are SVG elements. SVG elements allow CSS customizations for only "
"a basic element's look and feel (i.e. colors, size)."
msgstr ""
#: ../../source/configuration/branding.rst:78
msgid ""
"Since there is no native element in Bootstrap specifically for pie charts, "
"the look and feel of the charts are inheriting from other elements of the "
"theme. Please see ``_pie_charts.scss`` for specifics."
msgstr ""
#: ../../source/configuration/branding.rst:85
msgid "Bar Charts"
msgstr ""
#: ../../source/configuration/branding.rst:87
msgid ""
"Bar Charts can be either a Bootstrap Progress Bar or an SVG element. Either "
"implementation will use the Bootstrap Progress Bar styles."
msgstr ""
#: ../../source/configuration/branding.rst:90
msgid ""
"The SVG implementation will not make use of the customized Progress Bar "
"height though, so it is recommended that Bootstrap Progress Bars are used "
"whenever possible."
msgstr ""
#: ../../source/configuration/branding.rst:94
msgid ""
"Please see ``_bar_charts.scss`` for specifics on what can be customized for "
"SVGs. See the **Progress bars** section of your variables file for specific "
"variables to customize."
msgstr ""
#: ../../source/configuration/branding.rst:99
msgid "Tables"
msgstr ""
#: ../../source/configuration/branding.rst:101
msgid ""
"The standard Django tables now make use of the native Bootstrap table markup."
" See **Tables** section of your variables file for variables to customize."
msgstr ""
#: ../../source/configuration/branding.rst:104
msgid ""
"The standard Bootstrap tables will be borderless by default. If you wish to "
"add a border, like the ``default`` theme, see ``openstack_dashboard/themes/"
"default/horizon/components/_tables.scss``"
msgstr ""
#: ../../source/configuration/branding.rst:111
msgid "Login"
msgstr ""
#: ../../source/configuration/branding.rst:114
msgid "Login Splash Page"
msgstr ""
#: ../../source/configuration/branding.rst:116
msgid ""
"The login splash page now uses a standard Bootstrap panel in its "
"implementation. See the **Panels** section in your variables file to "
"variables to easily customize."
msgstr ""
#: ../../source/configuration/branding.rst:121
msgid "Modal Login"
msgstr ""
#: ../../source/configuration/branding.rst:123
msgid ""
"The modal login experience, as used when switching regions, uses a standard "
"Bootstrap dialog. See the **Modals** section of your variables file for "
"specific variables to customize."
msgstr ""
#: ../../source/configuration/branding.rst:128
msgid "Tabs"
msgstr ""
#: ../../source/configuration/branding.rst:130
msgid "The standard tabs make use of the native Bootstrap tab markup."
msgstr ""
#: ../../source/configuration/branding.rst:132
msgid ""
"See **Tabs** section of your variables file for variables to customize."
msgstr ""
#: ../../source/configuration/branding.rst:135
msgid "Alerts"
msgstr ""
#: ../../source/configuration/branding.rst:137
msgid ""
"Alerts use the basic Bootstrap brand colors. See **Colors** section of your "
"variables file for specifics."
msgstr ""
#: ../../source/configuration/branding.rst:141
msgid "Checkboxes"
msgstr ""
#: ../../source/configuration/branding.rst:143
msgid ""
"Horizon uses icon fonts to represent checkboxes. In order to customize "
"this, you simply need to override the standard scss. For an example of "
"this, see themes/material/static/horizon/components/_checkboxes.scss"
msgstr ""
#: ../../source/configuration/branding.rst:148
msgid "Bootswatch and Material Design"
msgstr ""
#: ../../source/configuration/branding.rst:150
msgid ""
"`Bootswatch`_ is a collection of free themes for Bootstrap and is now "
"available for use in Horizon."
msgstr ""
#: ../../source/configuration/branding.rst:153
msgid ""
"In order to showcase what can be done to enhance an existing Bootstrap "
"theme, Horizon now includes a secondary theme, roughly based on `Google's "
"Material Design`_ called ``material``. Bootswatch's **Paper** is a simple "
"Bootstrap implementation of Material Design and is used by ``material``."
msgstr ""
#: ../../source/configuration/branding.rst:158
msgid ""
"Bootswatch provides a number of other themes, that once Horizon is fully "
"theme compliant, will allow easy toggling and customizations for darker or "
"accessibility driven experiences."
msgstr ""
#: ../../source/configuration/branding.rst:163
msgid "Development Tips"
msgstr ""
#: ../../source/configuration/branding.rst:165
msgid ""
"When developing a new theme for Horizon, it is required that the dynamically "
"generated `static` directory be cleared after each change and the server "
"restarted. This is not always ideal. If you wish to develop and not have "
"to restart the server each time, it is recommended that you configure your "
"development environment to not run in OFFLINE mode. Simply verify the "
"following settings in your local_settings.py::"
msgstr ""
#: ../../source/configuration/customizing.rst:5
msgid "Customizing Horizon"
msgstr ""
#: ../../source/configuration/customizing.rst:9
msgid "You may also be interested in :doc:`themes` and :doc:`branding`."
msgstr ""
#: ../../source/configuration/customizing.rst:12
msgid "Changing the Site Title"
msgstr ""
#: ../../source/configuration/customizing.rst:14
msgid ""
"The OpenStack Dashboard Site Title branding (i.e. \"**OpenStack** "
"Dashboard\") can be overwritten by adding the attribute ``SITE_BRANDING`` to "
"``local_settings.py`` with the value being the desired name."
msgstr ""
#: ../../source/configuration/customizing.rst:18
msgid ""
"The file ``local_settings.py`` can be found at the Horizon directory path of "
"``openstack_dashboard/local/local_settings.py``."
msgstr ""
#: ../../source/configuration/customizing.rst:22
msgid "Changing the Brand Link"
msgstr ""
#: ../../source/configuration/customizing.rst:24
msgid ""
"The logo also acts as a hyperlink. The default behavior is to redirect to "
"``horizon:user_home``. By adding the attribute ``SITE_BRANDING_LINK`` with "
"the desired url target e.g., ``http://sample-company.com`` in "
"``local_settings.py``, the target of the hyperlink can be changed."
msgstr ""
#: ../../source/configuration/customizing.rst:30
msgid "Customizing the Footer"
msgstr ""
#: ../../source/configuration/customizing.rst:32
msgid ""
"It is possible to customize the global and login footers by using Django's "
"recursive inheritance to extend the ``base.html``, ``auth/login.html``, and "
"``auth/_login_form.html`` templates. You do this by naming your template the "
"same name as the template you wish to extend and only overriding the blocks "
"you wish to change."
msgstr ""
#: ../../source/configuration/customizing.rst:38
#: ../../source/configuration/customizing.rst:425
#: ../../source/configuration/customizing.rst:454
#: ../../source/configuration/customizing.rst:473
msgid "Your theme's ``base.html``::"
msgstr ""
#: ../../source/configuration/customizing.rst:46
msgid "Your theme's ``auth/login.html``::"
msgstr ""
#: ../../source/configuration/customizing.rst:54
msgid "Your theme's ``auth/_login_form.html``::"
msgstr ""
#: ../../source/configuration/customizing.rst:66
#: ../../source/configuration/customizing.rst:433
#: ../../source/configuration/customizing.rst:462
#: ../../source/configuration/customizing.rst:481
msgid "See the ``example`` theme for a working theme that uses these blocks."
msgstr ""
#: ../../source/configuration/customizing.rst:70
msgid "Modifying Existing Dashboards and Panels"
msgstr ""
#: ../../source/configuration/customizing.rst:72
msgid ""
"If you wish to alter dashboards or panels which are not part of your "
"codebase, you can specify a custom python module which will be loaded after "
"the entire Horizon site has been initialized, but prior to the URLconf "
"construction. This allows for common site-customization requirements such as:"
""
msgstr ""
#: ../../source/configuration/customizing.rst:77
msgid "Registering or unregistering panels from an existing dashboard."
msgstr ""
#: ../../source/configuration/customizing.rst:78
msgid "Changing the names of dashboards and panels."
msgstr ""
#: ../../source/configuration/customizing.rst:79
msgid "Re-ordering panels within a dashboard or panel group."
msgstr ""
#: ../../source/configuration/customizing.rst:81
msgid ""
"Default Horizon panels are loaded based upon files within the "
"openstack_dashboard/enabled/ folder. These files are loaded based upon the "
"filename order, with space left for more files to be added. There are some "
"example files available within this folder, with the .example suffix added. "
"Developers and deployers should strive to use this method of customization "
"as much as possible, and support for this is given preference over more "
"exotic methods such as monkey patching and overrides files."
msgstr ""
#: ../../source/configuration/customizing.rst:92
msgid "Horizon customization module (overrides)"
msgstr ""
#: ../../source/configuration/customizing.rst:94
msgid ""
"Horizon has a global overrides mechanism available to perform customizations "
"that are not yet customizable via configuration settings. This file can "
"perform monkey patching and other forms of customization which are not "
"possible via the enabled folder's customization method."
msgstr ""
#: ../../source/configuration/customizing.rst:99
msgid ""
"This method of customization is meant to be available for deployers of "
"Horizon, and use of this should be avoided by Horizon plugins at all cost. "
"Plugins needing this level of monkey patching and flexibility should instead "
"look for changing their __init__.py file and performing customizations "
"through other means."
msgstr ""
#: ../../source/configuration/customizing.rst:105
msgid ""
"To specify the python module containing your modifications, add the key "
"``customization_module`` to your ``HORIZON_CONFIG`` dictionary in "
"``local_settings.py``. The value should be a string containing the path to "
"your module in dotted python path notation. Example::"
msgstr ""
#: ../../source/configuration/customizing.rst:112
msgid ""
"You can do essentially anything you like in the customization module. For "
"example, you could change the name of a panel::"
msgstr ""
#: ../../source/configuration/customizing.rst:124
msgid "Or get the instances panel::"
msgstr ""
#: ../../source/configuration/customizing.rst:129
msgid "Or just remove it entirely::"
msgstr ""
#: ../../source/configuration/customizing.rst:133
msgid ""
"You cannot unregister a ``default_panel``. If you wish to remove a "
"``default_panel``, you need to make a different panel in the dashboard as a "
"``default_panel`` and then unregister the former. For example, if you wished "
"to remove the ``overview_panel`` from the ``Project`` dashboard, you could "
"do the following::"
msgstr ""
#: ../../source/configuration/customizing.rst:144
msgid "You can also override existing methods with your own versions::"
msgstr ""
#: ../../source/configuration/customizing.rst:155
msgid ""
"You could also customize what columns are displayed in an existing table, by "
"redefining the ``columns`` attribute of its ``Meta`` class. This can be "
"achieved in 3 steps:"
msgstr ""
#: ../../source/configuration/customizing.rst:159
msgid "Extend the table that you wish to modify"
msgstr ""
#: ../../source/configuration/customizing.rst:160
msgid ""
"Redefine the ``columns`` attribute under the ``Meta`` class for this new "
"table"
msgstr ""
#: ../../source/configuration/customizing.rst:162
msgid ""
"Modify the ``table_class`` attribute for the related view so that it points "
"to the new table"
msgstr ""
#: ../../source/configuration/customizing.rst:166
msgid ""
"For example, if you wished to remove the Admin State column from the :class:"
"`~openstack_dashboard.dashboards.admin.networks.tables.NetworksTable`, you "
"could do the following::"
msgstr ""
#: ../../source/configuration/customizing.rst:180
msgid ""
"If you want to add a column you can override the parent table in a similar "
"way, add the new column definition and then use the ``Meta`` ``columns`` "
"attribute to control the column order as needed."
msgstr ""
#: ../../source/configuration/customizing.rst:186
msgid ""
"``my_project.overrides`` needs to be importable by the python process "
"running Horizon. If your module is not installed as a system-wide python "
"package, you can either make it installable (e.g., with a setup.py) or you "
"can adjust the python path used by your WSGI server to include its location."
msgstr ""
#: ../../source/configuration/customizing.rst:192
msgid ""
"Probably the easiest way is to add a ``python-path`` argument to the "
"``WSGIDaemonProcess`` line in Apache's Horizon config."
msgstr ""
#: ../../source/configuration/customizing.rst:195
msgid ""
"Assuming your ``my_project`` module lives in ``/opt/python/my_project``, "
"you'd make it look like the following::"
msgstr ""
#: ../../source/configuration/customizing.rst:202
msgid "Customize the project and user table columns"
msgstr ""
#: ../../source/configuration/customizing.rst:205
msgid ""
"Keystone V3 has a place to store extra information regarding project and "
"user. Using the override mechanism described in :ref:`horizon-customization-"
"module`, Horizon is able to show these extra information as a custom column. "
"For example, if a user in Keystone has an attribute ``phone_num``, you could "
"define new column::"
msgstr ""
#: ../../source/configuration/customizing.rst:231
msgid "Customize Angular dashboards"
msgstr ""
#: ../../source/configuration/customizing.rst:233
msgid ""
"In Angular, you may write a plugin to extend certain features. Two "
"components in the Horizon framework that make this possible are the "
"extensibility service and the resource type registry service. The "
"``extensibleService`` allows certain Horizon elements to be extended "
"dynamically, including add, remove, and replace. The "
"``resourceTypeRegistry`` service provides methods to set and get information "
"pertaining to a resource type object. We use Heat type names like ``OS::"
"Glance::Image`` as our reference name."
msgstr ""
#: ../../source/configuration/customizing.rst:241
msgid "Some information you may place in the registry include:"
msgstr ""
#: ../../source/configuration/customizing.rst:243
msgid "API to fetch data from"
msgstr ""
#: ../../source/configuration/customizing.rst:244
msgid "Property names"
msgstr ""
#: ../../source/configuration/customizing.rst:245
msgid "Actions (e.g. \"Create Volume\")"
msgstr ""
#: ../../source/configuration/customizing.rst:246
msgid "URL paths to detail view or detail drawer"
msgstr ""
#: ../../source/configuration/customizing.rst:247
msgid "Property information like labels or formatting for property values"
msgstr ""
#: ../../source/configuration/customizing.rst:249
msgid ""
"These properties in the registry use the extensibility service (as of Newton "
"release):"
msgstr ""
#: ../../source/configuration/customizing.rst:252
msgid "globalActions"
msgstr ""
#: ../../source/configuration/customizing.rst:253
msgid "batchActions"
msgstr ""
#: ../../source/configuration/customizing.rst:254
msgid "itemActions"
msgstr ""
#: ../../source/configuration/customizing.rst:255
msgid "detailViews"
msgstr ""
#: ../../source/configuration/customizing.rst:256
msgid "tableColumns"
msgstr ""
#: ../../source/configuration/customizing.rst:257
msgid "filterFacets"
msgstr ""
#: ../../source/configuration/customizing.rst:259
msgid ""
"Using the information from the registry, we can build out our dashboard "
"panels. Panels use the high-level directive ``hzResourceTable`` that "
"replaces common templates so we do not need to write boilerplate HTML and "
"controller code. It gives developers a quick way to build a new table or "
"change an existing table."
msgstr ""
#: ../../source/configuration/customizing.rst:266
msgid ""
"You may still choose to use the HTML template for complete control of form "
"and functionality. For example, you may want to create a custom footer. You "
"may also use the ``hzDynamicTable`` directive (what ``hzResourceTable`` uses "
"under the hood) directly. However, neither of these is extensible. You would "
"need to override the panel completely."
msgstr ""
#: ../../source/configuration/customizing.rst:272
msgid ""
"This is a sample module file to demonstrate how to make some customizations "
"to the Images Panel.::"
msgstr ""
#: ../../source/configuration/customizing.rst:324
msgid ""
"Additionally, you should have content defined in ``detail.html`` and "
"``drawer.html``, as well as define the ``surpriseService`` which is based "
"off the ``actions`` directive and needs allowed and perform methods defined."
msgstr ""
#: ../../source/configuration/customizing.rst:330
msgid "Icons"
msgstr ""
#: ../../source/configuration/customizing.rst:332
msgid ""
"Horizon uses font icons from Font Awesome. Please see `Font Awesome`_ for "
"instructions on how to use icons in the code."
msgstr ""
#: ../../source/configuration/customizing.rst:335
msgid "To add icon to Table Action, use icon property. Example:"
msgstr ""
#: ../../source/configuration/customizing.rst:344
msgid ""
"Additionally, the site-wide default button classes can be configured by "
"setting ``ACTION_CSS_CLASSES`` to a tuple of the classes you wish to appear "
"on all action buttons in your ``local_settings.py`` file."
msgstr ""
#: ../../source/configuration/customizing.rst:350
msgid "Custom Stylesheets"
msgstr ""
#: ../../source/configuration/customizing.rst:352
msgid ""
"It is possible to define custom stylesheets for your dashboards. Horizon's "
"base template ``openstack_dashboard/templates/base.html`` defines multiple "
"blocks that can be overridden."
msgstr ""
#: ../../source/configuration/customizing.rst:356
msgid ""
"To define custom css files that apply only to a specific dashboard, create a "
"base template in your dashboard's templates folder, which extends Horizon's "
"base template e.g. ``openstack_dashboard/dashboards/my_custom_dashboard/ "
"templates/my_custom_dashboard/base.html``."
msgstr ""
#: ../../source/configuration/customizing.rst:361
msgid ""
"In this template, redefine ``block css``. (Don't forget to include "
"``_stylesheets.html`` which includes all Horizon's default stylesheets.)::"
msgstr ""
#: ../../source/configuration/customizing.rst:375
msgid ""
"The custom stylesheets then reside in the dashboard's own ``static`` folder "
"``openstack_dashboard/dashboards/my_custom_dashboard/static/"
"my_custom_dashboard/scss/my_custom_dashboard.scss``."
msgstr ""
#: ../../source/configuration/customizing.rst:378
msgid "All dashboard's templates have to inherit from dashboard's base.html::"
msgstr ""
#: ../../source/configuration/customizing.rst:385
msgid "Custom Javascript"
msgstr ""
#: ../../source/configuration/customizing.rst:387
msgid ""
"Similarly to adding custom styling (see above), it is possible to include "
"custom javascript files."
msgstr ""
#: ../../source/configuration/customizing.rst:390
msgid ""
"All Horizon's javascript files are listed in the ``openstack_dashboard/"
"templates/horizon/_scripts.html`` partial template, which is included in "
"Horizon's base template in ``block js``."
msgstr ""
#: ../../source/configuration/customizing.rst:394
msgid ""
"To add custom javascript files, create an ``_scripts.html`` partial template "
"in your dashboard ``openstack_dashboard/dashboards/my_custom_dashboard/"
"templates/my_custom_dashboard/_scripts.html`` which extends ``horizon/"
"_scripts.html``. In this template override the ``block custom_js_files`` "
"including your custom javascript files::"
msgstr ""
#: ../../source/configuration/customizing.rst:407
msgid ""
"In your dashboard's own base template ``openstack_dashboard/dashboards/ "
"my_custom_dashboard/templates/my_custom_dashboard/base.html`` override "
"``block js`` with inclusion of dashboard's own ``_scripts.html``::"
msgstr ""
#: ../../source/configuration/customizing.rst:415
msgid ""
"The result is a single compressed js file consisting both Horizon and "
"dashboard's custom scripts."
msgstr ""
#: ../../source/configuration/customizing.rst:419
msgid "Custom Head js"
msgstr ""
#: ../../source/configuration/customizing.rst:421
msgid ""
"Additionally, some scripts require you to place them within the page's "
"
tag. To do this, recursively extend the ``base.html`` template in "
"your theme to override the ``custom_head_js`` block."
msgstr ""
#: ../../source/configuration/customizing.rst:437
msgid ""
"Don't use the ``custom_head_js`` block for analytics tracking. See below."
msgstr ""
#: ../../source/configuration/customizing.rst:440
msgid "Custom Analytics"
msgstr ""
#: ../../source/configuration/customizing.rst:442
msgid ""
"For analytics or tracking scripts you should avoid the ``custom_head_js`` "
"block. We have a specific block instead called ``custom_analytics``. Much "
"like the ``custom_head_js`` block this inserts additional content into the "
"head of the ``base.html`` template and it will be on all pages."
msgstr ""
#: ../../source/configuration/customizing.rst:447
msgid ""
"The reason for an analytics specific block is that for security purposes we "
"want to be able to turn off tracking on certain pages that we deem sensitive."
" This is done for the safety of the users and the cloud admins. By using "
"this block instead, pages using ``base.html`` can override it themselves "
"when they want to avoid tracking. They can't simply override the custom js "
"because it may be non-tracking code."
msgstr ""
#: ../../source/configuration/customizing.rst:465
msgid "Customizing Meta Attributes"
msgstr ""
#: ../../source/configuration/customizing.rst:467
msgid ""
"To add custom metadata attributes to your project's base template use the "
"``custom_metadata`` block. To do this, recursively extend the ``base.html`` "
"template in your theme to override the ``custom_metadata`` block. The "
"contents of this block will be inserted into the page's just after "
"the default Horizon meta tags."
msgstr ""
#: ../../source/configuration/index.rst:3
msgid "Configuration Guide"
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:5
msgid "Pluggable Panels and Groups"
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:8
#: ../../source/configuration/settings.rst:8
msgid "Introduction"
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:10
msgid ""
"Horizon allows dashboards, panels and panel groups to be added without "
"modifying the default settings. Pluggable settings are a mechanism to allow "
"settings to be stored in separate files. Those files are read at startup "
"and used to modify the default settings."
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:15
msgid ""
"The default location for the dashboard configuration files is "
"``openstack_dashboard/enabled``, with another directory, "
"``openstack_dashboard/local/enabled`` for local overrides. Both sets of "
"files will be loaded, but the settings in ``openstack_dashboard/local/"
"enabled`` will overwrite the default ones. The settings are applied in "
"alphabetical order of the filenames. If the same dashboard has configuration "
"files in ``enabled`` and ``local/enabled``, the local name will be used. "
"Note, that since names of python modules can't start with a digit, the files "
"are usually named with a leading underscore and a number, so that you can "
"control their order easily."
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:26
msgid "General Pluggbale Settings"
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:28
msgid ""
"Before we describe the specific use cases, the following keys can be used in "
"any pluggable settings file:"
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:32
msgid "``ADD_EXCEPTIONS``"
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:36
msgid ""
"A dictionary of exception classes to be added to ``HORIZON['exceptions']``."
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:39
msgid "``ADD_INSTALLED_APPS``"
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:43
msgid ""
"A list of applications to be prepended to ``INSTALLED_APPS``. This is needed "
"to expose static files from a plugin."
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:47
msgid "``ADD_ANGULAR_MODULES``"
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:51
#: ../../source/configuration/settings.rst:322
msgid ""
"A list of AngularJS modules to be loaded when Angular bootstraps. These "
"modules are added as dependencies on the root Horizon application "
"``horizon``."
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:55
msgid "``ADD_JS_FILES``"
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:59
msgid ""
"A list of javascript source files to be included in the compressed set of "
"files that are loaded on every page. This is needed for AngularJS modules "
"that are referenced in ``ADD_ANGULAR_MODULES`` and therefore need to be "
"included in every page."
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:65
msgid "``ADD_JS_SPEC_FILES``"
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:69
#: ../../source/configuration/settings.rst:414
msgid ""
"A list of javascript spec files to include for integration with the Jasmine "
"spec runner. Jasmine is a behavior-driven development framework for testing "
"JavaScript code."
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:74
msgid "``ADD_SCSS_FILES``"
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:78
msgid ""
"A list of scss files to be included in the compressed set of files that are "
"loaded on every page. We recommend one scss file per dashboard, use @import "
"if you need to include additional scss files for panels."
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:84
msgid "``ADD_XSTATIC_MODULES``"
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:88
msgid ""
"A list of xstatic modules containing javascript and scss files to be "
"included in the compressed set of files that are loaded on every page. "
"Related files specified in ``ADD_XSTATIC_MODULES`` do not need to be "
"included in ``ADD_JS_FILES``. This option expects a list of tuples, each "
"consists of a xstatic module and a list of javascript files to be loaded if "
"any. For more details, please check the comment of ``BASE_XSTATIC_MODULES`` "
"in openstack_dashboard/utils/settings.py."
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:96
#: ../../source/configuration/pluggable_panels.rst:149
#: ../../source/configuration/pluggable_panels.rst:186
#: ../../source/configuration/settings.rst:1220
#: ../../source/configuration/settings.rst:1345
#: ../../source/configuration/settings.rst:1356
#: ../../source/configuration/settings.rst:1690
#: ../../source/configuration/settings.rst:1817
#: ../../source/configuration/settings.rst:2008
#: ../../source/configuration/settings.rst:2050
msgid "Example:"
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:108
msgid "``AUTO_DISCOVER_STATIC_FILES``"
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:112
msgid ""
"If set to ``True``, JavaScript files and static angular html template files "
"will be automatically discovered from the `static` folder in each apps "
"listed in ADD_INSTALLED_APPS."
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:116
msgid ""
"JavaScript source files will be ordered based on naming convention: files "
"with extension `.module.js` listed first, followed by other JavaScript "
"source files."
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:119
msgid ""
"JavaScript files for testing will also be ordered based on naming convention:"
" files with extension `.mock.js` listed first, followed by files with "
"extension `.spec.js`."
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:123
msgid ""
"If ADD_JS_FILES and/or ADD_JS_SPEC_FILES are also specified, files manually "
"listed there will be appended to the auto-discovered files."
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:127
msgid "``DISABLED``"
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:131
msgid ""
"If set to ``True``, this settings file will not be added to the settings."
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:134
msgid "``EXTRA_STEPS``"
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:138
msgid ""
"Extra workflow steps can be added to a workflow in horizon or other horizon "
"plugins by using this setting. Extra steps will be shown after default steps "
"defined in a corresponding workflow."
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:142
msgid ""
"This is a dict setting. A key of the dict specifies a workflow which extra "
"step(s) are added. The key must match a full class name of the target "
"workflow."
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:145
msgid ""
"A value of the dict is a list of full name of an extra step classes (where a "
"module name and a class name must be delimiteed by a period). Steps "
"specified via ``EXTRA_STEPS`` will be displayed in the order of being "
"registered."
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:164
msgid "``EXTRA_TABS``"
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:168
msgid ""
"Extra tabs can be added to a tab group implemented in horizon or other "
"horizon plugins by using this setting. Extra tabs will be shown after "
"default tabs defined in a corresponding tab group."
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:172
msgid ""
"This is a dict setting. A key of the dict specifies a tab group which extra "
"tab(s) are added. The key must match a full class name of the target tab "
"group."
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:175
msgid ""
"A value of the dict is a list of full name of an extra tab classes (where a "
"module name and a class name must be delimiteed by a period). Tabs specified "
"via ``EXTRA_TABS`` will be displayed in the order of being registered."
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:179
msgid ""
"There might be cases where you would like to specify the order of the extra "
"tabs as multiple horizon plugins can register extra tabs. You can specify a "
"priority of each tab in ``EXTRA_TABS`` by using a tuple of priority and a "
"tab class as an element of a dict value instead of a full name of an extra "
"tab. Priority is an integer of a tab and a tab with a lower value will be "
"displayed first. If a priority of an extra tab is omitted, ``0`` is assumed "
"as a priority."
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:197
msgid "Example (with priority):"
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:209
msgid "``UPDATE_HORIZON_CONFIG``"
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:213
msgid ""
"A dictionary of values that will replace the values in ``HORIZON_CONFIG``."
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:217
msgid "Pluggable Settings for Dashboards"
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:221
msgid "The following keys are specific to registering a dashboard:"
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:225
msgid "``DASHBOARD``"
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:229
msgid ""
"The slug of the dashboard to be added to ``HORIZON['dashboards']``. Required."
""
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:232
msgid "``DEFAULT``"
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:236
msgid ""
"If set to ``True``, this dashboard will be set as the default dashboard."
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:240
#: ../../source/configuration/pluggable_panels.rst:318
#: ../../source/configuration/pluggable_panels.rst:379
msgid "Examples"
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:242
msgid ""
"To disable a dashboard locally, create a file ``openstack_dashboard/local/"
"enabled/_40_dashboard-name.py`` with the following content::"
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:249
msgid ""
"To add a Tuskar-UI (Infrastructure) dashboard, you have to install it, and "
"then create a file ``openstack_dashboard/local/enabled/_50_tuskar.py`` with::"
""
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:266
msgid "Pluggable Settings for Panels"
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:270
msgid "The following keys are specific to registering or removing a panel:"
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:273
msgid "``PANEL``"
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:277
msgid "The slug of the panel to be added to ``HORIZON_CONFIG``. Required."
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:280
msgid "``PANEL_DASHBOARD``"
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:284
msgid "The slug of the dashboard the ``PANEL`` associated with. Required."
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:288
#: ../../source/configuration/pluggable_panels.rst:356
msgid "``PANEL_GROUP``"
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:292
msgid ""
"The slug of the panel group the ``PANEL`` is associated with. If you want "
"the panel to show up without a panel group, use the panel group \"default\"."
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:296
msgid "``DEFAULT_PANEL``"
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:300
msgid "If set, it will update the default panel of the ``PANEL_DASHBOARD``."
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:303
msgid "``ADD_PANEL``"
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:307
msgid "Python panel class of the ``PANEL`` to be added."
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:310
msgid "``REMOVE_PANEL``"
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:314
msgid ""
"If set to ``True``, the PANEL will be removed from PANEL_DASHBOARD/"
"PANEL_GROUP."
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:320
msgid ""
"To add a new panel to the Admin panel group in Admin dashboard, create a "
"file ``openstack_dashboard/local/enabled/_60_admin_add_panel.py`` with the "
"following content::"
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:329
msgid ""
"To remove Info panel from Admin panel group in Admin dashboard locally, "
"create a file ``openstack_dashboard/local/enabled/_70_admin_remove_panel."
"py`` with the following content::"
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:338
msgid ""
"To change the default panel of Admin dashboard to Instances panel, create a "
"file ``openstack_dashboard/local/enabled/_80_admin_default_panel.py`` with "
"the following content::"
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:348
msgid "Pluggable Settings for Panel Groups"
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:353
msgid "The following keys are specific to registering a panel group:"
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:360
msgid ""
"The slug of the panel group to be added to ``HORIZON_CONFIG``. Required."
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:363
msgid "``PANEL_GROUP_NAME``"
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:367
msgid "The display name of the PANEL_GROUP. Required."
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:370
msgid "``PANEL_GROUP_DASHBOARD``"
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:374
msgid ""
"The slug of the dashboard the ``PANEL_GROUP`` associated with. Required."
msgstr ""
#: ../../source/configuration/pluggable_panels.rst:381
msgid ""
"To add a new panel group to the Admin dashboard, create a file "
"``openstack_dashboard/local/enabled/_90_admin_add_panel_group.py`` with the "
"following content::"
msgstr ""
#: ../../source/configuration/settings.rst:5
msgid "Settings Reference"
msgstr ""
#: ../../source/configuration/settings.rst:10
msgid "Horizon's settings broadly fall into four categories:"
msgstr ""
#: ../../source/configuration/settings.rst:12
msgid ""
"`General Settings`_: this includes visual settings like the modal backdrop "
"style, bug url and theme configuration, as well as settings that affect "
"every service, such as page sizes on API requests."
msgstr ""
#: ../../source/configuration/settings.rst:15
msgid ""
"`Service-specific Settings`_: Many services that Horizon consumes, such as "
"Nova and Neutron, don't advertise their capabilities via APIs, so Horizon "
"carries configuration for operators to enable or disable many items. This "
"section covers all settings that are specific to a single service."
msgstr ""
#: ../../source/configuration/settings.rst:19
msgid ""
"`Django Settings`_, which are common to all Django applications. The only "
"ones documented here are those that Horizon alters by default; however, you "
"should read the `Django settings documentation `_ to see the other options available to you."
msgstr ""
#: ../../source/configuration/settings.rst:24
msgid ""
"`Other Settings`_: settings which do not fall into any of the above "
"categories."
msgstr ""
#: ../../source/configuration/settings.rst:27
msgid "To modify your settings, you have two options:"
msgstr ""
#: ../../source/configuration/settings.rst:29
msgid ""
"**Preferred:** Add ``.py`` settings snippets to the ``openstack_dashboard/"
"local/local_settings.d/`` directory. Several example files (appended with ``."
"example``) can be found there. These must start with an underscore, and are "
"evaluated alphabetically, after ``local_settings.py``."
msgstr ""
#: ../../source/configuration/settings.rst:34
msgid ""
"Modify your ``openstack_dashboard/local/local_settings.py``. There is an "
"file found at ``openstack_dashboard/local/local_settings.py.example``."
msgstr ""
#: ../../source/configuration/settings.rst:38
msgid "General Settings"
msgstr ""
#: ../../source/configuration/settings.rst:43
msgid "ANGULAR_FEATURES"
msgstr ""
#: ../../source/configuration/settings.rst:48
msgid ""
"The Django version of the Images, Keypairs, and Roles panels are deprecated. "
"As a result, \"images_panel\", \"key_pairs_panel\" and \"roles_panel\" keys "
"in this setting are deprecated. Consider switching to the AngujarJS version "
"by setting corresponding entries to True (the default value)."
msgstr ""
#: ../../source/configuration/settings.rst:54
#: ../../source/configuration/settings.rst:105
#: ../../source/configuration/settings.rst:151
#: ../../source/configuration/settings.rst:223
#: ../../source/configuration/settings.rst:265
#: ../../source/configuration/settings.rst:330
#: ../../source/configuration/settings.rst:371
#: ../../source/configuration/settings.rst:447
#: ../../source/configuration/settings.rst:511
#: ../../source/configuration/settings.rst:750
#: ../../source/configuration/settings.rst:821
#: ../../source/configuration/settings.rst:851
#: ../../source/configuration/settings.rst:882
#: ../../source/configuration/settings.rst:1026
#: ../../source/configuration/settings.rst:1115
#: ../../source/configuration/settings.rst:1160
#: ../../source/configuration/settings.rst:1233
#: ../../source/configuration/settings.rst:1277
#: ../../source/configuration/settings.rst:1429
#: ../../source/configuration/settings.rst:1479
#: ../../source/configuration/settings.rst:1647
#: ../../source/configuration/settings.rst:1803
#: ../../source/configuration/settings.rst:1837
#: ../../source/configuration/settings.rst:2129
#: ../../source/configuration/settings.rst:2227
#: ../../source/configuration/settings.rst:2395
msgid "Default:"
msgstr ""
#: ../../source/configuration/settings.rst:68
msgid ""
"A dictionary of currently available AngularJS features. This allows simple "
"toggling of legacy or rewritten features, such as new panels, workflows etc."
msgstr ""
#: ../../source/configuration/settings.rst:73
msgid ""
"If you toggle ``domains_panel`` to ``True``, you also need to enable the "
"setting of `OPENSTACK_KEYSTONE_DEFAULT_DOMAIN`_ and add "
"`OPENSTACK_KEYSTONE_DEFAULT_DOMAIN`_ to `REST_API_REQUIRED_SETTINGS`_."
msgstr ""
#: ../../source/configuration/settings.rst:78
msgid "API_RESULT_LIMIT"
msgstr ""
#: ../../source/configuration/settings.rst:82
msgid "Default: ``1000``"
msgstr ""
#: ../../source/configuration/settings.rst:84
msgid ""
"The maximum number of objects (e.g. Swift objects or Glance images) to "
"display on a single page before providing a paging element (a \"more\" link) "
"to paginate results."
msgstr ""
#: ../../source/configuration/settings.rst:89
msgid "API_RESULT_PAGE_SIZE"
msgstr ""
#: ../../source/configuration/settings.rst:93
msgid "Default: ``20``"
msgstr ""
#: ../../source/configuration/settings.rst:95
msgid ""
"Similar to ``API_RESULT_LIMIT``. This setting controls the number of items "
"to be shown per page if API pagination support for this exists."
msgstr ""
#: ../../source/configuration/settings.rst:101
msgid "AVAILABLE_THEMES"
msgstr ""
#: ../../source/configuration/settings.rst:114
msgid "This setting tells Horizon which themes to use."
msgstr ""
#: ../../source/configuration/settings.rst:116
msgid ""
"A list of tuples which define multiple themes. The tuple format is ``('{{ "
"theme_name }}', '{{ theme_label }}', '{{ theme_path }}')``."
msgstr ""
#: ../../source/configuration/settings.rst:119
msgid ""
"The ``theme_name`` is the name used to define the directory which the theme "
"is collected into, under ``/{{ THEME_COLLECTION_DIR }}``. It also specifies "
"the key by which the selected theme is stored in the browser's cookie."
msgstr ""
#: ../../source/configuration/settings.rst:124
msgid ""
"The ``theme_label`` is the user-facing label that is shown in the theme "
"picker. The theme picker is only visible if more than one theme is "
"configured, and shows under the topnav's user menu."
msgstr ""
#: ../../source/configuration/settings.rst:128
msgid ""
"By default, the ``theme path`` is the directory that will serve as the "
"static root of the theme and the entire contents of the directory is served "
"up at ``/{{ THEME_COLLECTION_DIR }}/{{ theme_name }}``. If you wish to "
"include content other than static files in a theme directory, but do not "
"wish that content to be served up, then you can create a sub directory named "
"``static``. If the theme folder contains a sub-directory with the name "
"``static``, then ``static/custom/static`` will be used as the root for the "
"content served at ``/static/custom``."
msgstr ""
#: ../../source/configuration/settings.rst:138
msgid ""
"The static root of the theme folder must always contain a _variables.scss "
"file and a _styles.scss file. These must contain or import all the "
"bootstrap and horizon specific variables and styles which are used to style "
"the GUI. For example themes, see: /horizon/openstack_dashboard/themes/"
msgstr ""
#: ../../source/configuration/settings.rst:143
msgid ""
"Horizon ships with two themes configured. 'default' is the default theme, "
"and 'material' is based on Google's Material Design."
msgstr ""
#: ../../source/configuration/settings.rst:147
msgid "DEFAULT_POLICY_FILES"
msgstr ""
#: ../../source/configuration/settings.rst:163
msgid ""
"This is a mapping from service types to YAML files including default policy "
"definitions. Values of this mapping should be relative paths to "
"`POLICY_FILES_PATH`_ or absolute paths. Policy files specified in this "
"setting are generated from default policies of back-end services, so you "
"rarely need to configure it. If you would like to override the default "
"policies, consider customizing files under `POLICY_FILES`_."
msgstr ""
#: ../../source/configuration/settings.rst:171
msgid "DEFAULT_THEME"
msgstr ""
#: ../../source/configuration/settings.rst:175
msgid "Default: ``\"default\"``"
msgstr ""
#: ../../source/configuration/settings.rst:177
msgid ""
"This setting tells Horizon which theme to use if the user has not yet "
"selected a theme through the theme picker and therefore set the cookie value."
" This value represents the ``theme_name`` key that is used from "
"`AVAILABLE_THEMES`_. To use this setting, the theme must also be configured "
"inside of ``AVAILABLE_THEMES``. Your default theme must be configured as "
"part of `SELECTABLE_THEMES`_. If it is not, then your ``DEFAULT_THEME`` "
"will default to the first theme in ``SELECTABLE_THEMES``."
msgstr ""
#: ../../source/configuration/settings.rst:187
msgid "DISALLOW_IFRAME_EMBED"
msgstr ""
#: ../../source/configuration/settings.rst:191
#: ../../source/configuration/settings.rst:922
#: ../../source/configuration/settings.rst:1264
#: ../../source/configuration/settings.rst:1370
#: ../../source/configuration/settings.rst:1783
#: ../../source/configuration/settings.rst:1910
#: ../../source/configuration/settings.rst:1953
#: ../../source/configuration/settings.rst:1964
#: ../../source/configuration/settings.rst:1974
#: ../../source/configuration/settings.rst:2263
#: ../../source/configuration/settings.rst:2324
#: ../../source/configuration/settings.rst:2334
#: ../../source/configuration/settings.rst:2344
#: ../../source/configuration/settings.rst:2429
#: ../../source/configuration/settings.rst:2462
#: ../../source/configuration/settings.rst:2557
msgid "Default: ``True``"
msgstr ""
#: ../../source/configuration/settings.rst:193
msgid ""
"This setting can be used to defend against Clickjacking and prevent Horizon "
"from being embedded within an iframe. Legacy browsers are still vulnerable "
"to a Cross-Frame Scripting (XFS) vulnerability, so this option allows extra "
"security hardening where iframes are not used in deployment. When set to "
"true, a ``\"frame-buster\"`` script is inserted into the template header "
"that prevents the web page from being framed and therefore defends against "
"clickjacking."
msgstr ""
#: ../../source/configuration/settings.rst:200
msgid "For more information see: http://tinyurl.com/anticlickjack"
msgstr ""
#: ../../source/configuration/settings.rst:204
msgid ""
"If your deployment requires the use of iframes, you can set this setting to "
"``False`` to exclude the frame-busting code and allow iframe embedding."
msgstr ""
#: ../../source/configuration/settings.rst:208
msgid "DROPDOWN_MAX_ITEMS"
msgstr ""
#: ../../source/configuration/settings.rst:212
msgid "Default: ``30``"
msgstr ""
#: ../../source/configuration/settings.rst:214
msgid ""
"This setting sets the maximum number of items displayed in a dropdown. "
"Dropdowns that limit based on this value need to support a way to observe "
"the entire list."
msgstr ""
#: ../../source/configuration/settings.rst:219
msgid "FILTER_DATA_FIRST"
msgstr ""
#: ../../source/configuration/settings.rst:235
msgid ""
"If the dict key-value is True, when the view loads, an empty table will be "
"rendered and the user will be asked to provide a search criteria first (in "
"case no search criteria was provided) before loading any data."
msgstr ""
#: ../../source/configuration/settings.rst:239
msgid "Examples:"
msgstr ""
#: ../../source/configuration/settings.rst:241
msgid "Override the dict:"
msgstr ""
#: ../../source/configuration/settings.rst:253
msgid "Or, if you want to turn this on for an specific panel/view do:"
msgstr ""
#: ../../source/configuration/settings.rst:260
msgid "HORIZON_CONFIG"
msgstr ""
#: ../../source/configuration/settings.rst:262
msgid ""
"A dictionary of some Horizon configuration values. These are primarily "
"separated for historic design reasons."
msgstr ""
#: ../../source/configuration/settings.rst:295
msgid "ajax_poll_interval"
msgstr ""
#: ../../source/configuration/settings.rst:299
msgid "Default: ``2500``"
msgstr ""
#: ../../source/configuration/settings.rst:301
msgid ""
"How frequently resources in transition states should be polled for updates, "
"expressed in milliseconds."
msgstr ""
#: ../../source/configuration/settings.rst:305
msgid "ajax_queue_limit"
msgstr ""
#: ../../source/configuration/settings.rst:309
msgid "Default: ``10``"
msgstr ""
#: ../../source/configuration/settings.rst:311
msgid ""
"The maximum number of simultaneous AJAX connections the dashboard may try to "
"make. This is particularly relevant when monitoring a large number of "
"instances, volumes, etc. which are all actively trying to update/change "
"state."
msgstr ""
#: ../../source/configuration/settings.rst:316
msgid "angular_modules"
msgstr ""
#: ../../source/configuration/settings.rst:320
#: ../../source/configuration/settings.rst:400
#: ../../source/configuration/settings.rst:412
#: ../../source/configuration/settings.rst:1181
#: ../../source/configuration/settings.rst:2025
#: ../../source/configuration/settings.rst:2755
msgid "Default: ``[]``"
msgstr ""
#: ../../source/configuration/settings.rst:326
msgid "auto_fade_alerts"
msgstr ""
#: ../../source/configuration/settings.rst:340
msgid ""
"If provided, will auto-fade the alert types specified. Valid alert types "
"include: ['alert-default', 'alert-success', 'alert-info', 'alert-warning', "
"'alert-danger'] Can also define the delay before the alert fades and the "
"fade out duration."
msgstr ""
#: ../../source/configuration/settings.rst:346
msgid "bug_url"
msgstr ""
#: ../../source/configuration/settings.rst:350
#: ../../source/configuration/settings.rst:390
#: ../../source/configuration/settings.rst:480
#: ../../source/configuration/settings.rst:544
#: ../../source/configuration/settings.rst:581
#: ../../source/configuration/settings.rst:603
#: ../../source/configuration/settings.rst:639
#: ../../source/configuration/settings.rst:706
#: ../../source/configuration/settings.rst:1210
#: ../../source/configuration/settings.rst:1317
#: ../../source/configuration/settings.rst:1739
#: ../../source/configuration/settings.rst:1759
msgid "Default: ``None``"
msgstr ""
#: ../../source/configuration/settings.rst:352
msgid ""
"If provided, a \"Report Bug\" link will be displayed in the site header "
"which links to the value of this setting (ideally a URL containing "
"information on how to report issues)."
msgstr ""
#: ../../source/configuration/settings.rst:357
msgid "disable_password_reveal"
msgstr ""
#: ../../source/configuration/settings.rst:361
#: ../../source/configuration/settings.rst:615
#: ../../source/configuration/settings.rst:720
#: ../../source/configuration/settings.rst:730
#: ../../source/configuration/settings.rst:1195
#: ../../source/configuration/settings.rst:1380
#: ../../source/configuration/settings.rst:1496
#: ../../source/configuration/settings.rst:1509
#: ../../source/configuration/settings.rst:1521
#: ../../source/configuration/settings.rst:1585
#: ../../source/configuration/settings.rst:1602
#: ../../source/configuration/settings.rst:1670
#: ../../source/configuration/settings.rst:1726
#: ../../source/configuration/settings.rst:1880
#: ../../source/configuration/settings.rst:1896
#: ../../source/configuration/settings.rst:1927
#: ../../source/configuration/settings.rst:1941
#: ../../source/configuration/settings.rst:2254
#: ../../source/configuration/settings.rst:2273
#: ../../source/configuration/settings.rst:2284
#: ../../source/configuration/settings.rst:2294
#: ../../source/configuration/settings.rst:2304
#: ../../source/configuration/settings.rst:2314
#: ../../source/configuration/settings.rst:2710
msgid "Default: ``False``"
msgstr ""
#: ../../source/configuration/settings.rst:363
msgid ""
"Setting this to True will disable the reveal button for password fields, "
"including on the login form."
msgstr ""
#: ../../source/configuration/settings.rst:367
msgid "exceptions"
msgstr ""
#: ../../source/configuration/settings.rst:381
msgid ""
"A dictionary containing classes of exceptions which Horizon's centralized "
"exception handling should be aware of. Based on these exception categories, "
"Horizon will handle the exception and display a message to the user."
msgstr ""
#: ../../source/configuration/settings.rst:386
msgid "help_url"
msgstr ""
#: ../../source/configuration/settings.rst:392
msgid ""
"If provided, a \"Help\" link will be displayed in the site header which "
"links to the value of this setting (ideally a URL containing help "
"information)."
msgstr ""
#: ../../source/configuration/settings.rst:396
msgid "js_files"
msgstr ""
#: ../../source/configuration/settings.rst:402
msgid ""
"A list of javascript source files to be included in the compressed set of "
"files that are loaded on every page. This is needed for AngularJS modules "
"that are referenced in ``angular_modules`` and therefore need to be include "
"in every page."
msgstr ""
#: ../../source/configuration/settings.rst:408
msgid "js_spec_files"
msgstr ""
#: ../../source/configuration/settings.rst:419
msgid "modal_backdrop"
msgstr ""
#: ../../source/configuration/settings.rst:423
msgid "Default: ``\"static\"``"
msgstr ""
#: ../../source/configuration/settings.rst:425
msgid ""
"Controls how bootstrap backdrop element outside of modals looks and feels. "
"Valid values are ``\"true\"`` (show backdrop element outside the modal, "
"close the modal after clicking on backdrop), ``\"false\"`` (do not show "
"backdrop element, do not close the modal after clicking outside of it) and "
"``\"static\"`` (show backdrop element outside the modal, do not close the "
"modal after clicking on backdrop)."
msgstr ""
#: ../../source/configuration/settings.rst:433
msgid "password_autocomplete"
msgstr ""
#: ../../source/configuration/settings.rst:437
msgid "Default: ``\"off\"``"
msgstr ""
#: ../../source/configuration/settings.rst:439
msgid ""
"Controls whether browser autocompletion should be enabled on the login form. "
"Valid values are ``\"on\"`` and ``\"off\"``."
msgstr ""
#: ../../source/configuration/settings.rst:443
msgid "password_validator"
msgstr ""
#: ../../source/configuration/settings.rst:456
msgid ""
"A dictionary containing a regular expression which will be used for password "
"validation and help text which will be displayed if the password does not "
"pass validation. The help text should describe the password requirements if "
"there are any."
msgstr ""
#: ../../source/configuration/settings.rst:461
msgid ""
"This setting allows you to set rules for passwords if your organization "
"requires them."
msgstr ""
#: ../../source/configuration/settings.rst:465
msgid "user_home"
msgstr ""
#: ../../source/configuration/settings.rst:469
msgid "Default: ``settings.LOGIN_REDIRECT_URL``"
msgstr ""
#: ../../source/configuration/settings.rst:471
msgid ""
"This can be either a literal URL path (such as the default), or Python's "
"dotted string notation representing a function which will evaluate what URL "
"a user should be redirected to based on the attributes of that user."
msgstr ""
#: ../../source/configuration/settings.rst:476
msgid "MESSAGES_PATH"
msgstr ""
#: ../../source/configuration/settings.rst:482
msgid "The absolute path to the directory where message files are collected."
msgstr ""
#: ../../source/configuration/settings.rst:484
msgid ""
"When the user logins to horizon, the message files collected are processed "
"and displayed to the user. Each message file should contain a JSON formatted "
"data and must have a .json file extension. For example:"
msgstr ""
#: ../../source/configuration/settings.rst:495
msgid ""
"Possible values for level are: ``success``, ``info``, ``warning`` and "
"``error``."
msgstr ""
#: ../../source/configuration/settings.rst:499
msgid "NG_TEMPLATE_CACHE_AGE"
msgstr ""
#: ../../source/configuration/settings.rst:503
msgid ""
"Angular Templates are cached using this duration (in seconds) if `DEBUG`_ is "
"set to ``False``. Default value is ``2592000`` (or 30 days)."
msgstr ""
#: ../../source/configuration/settings.rst:507
msgid "OPENSTACK_API_VERSIONS"
msgstr ""
#: ../../source/configuration/settings.rst:521
msgid ""
"Overrides for OpenStack API versions. Use this setting to force the "
"OpenStack dashboard to use a specific API version for a given service API."
msgstr ""
#: ../../source/configuration/settings.rst:526
msgid ""
"The version should be formatted as it appears in the URL for the service API."
" For example, the identity service APIs have inconsistent use of the decimal "
"point, so valid options would be \"3\". For example:"
msgstr ""
#: ../../source/configuration/settings.rst:540
msgid "OPENSTACK_CLOUDS_YAML_CUSTOM_TEMPLATE"
msgstr ""
#: ../../source/configuration/settings.rst:546
msgid "Example:: ``my-clouds.yaml.template``"
msgstr ""
#: ../../source/configuration/settings.rst:548
msgid ""
"A template name for a custom user's ``clouds.yaml`` file. ``None`` means the "
"default template for ``clouds.yaml`` is used."
msgstr ""
#: ../../source/configuration/settings.rst:551
msgid ""
"If the default template is not suitable for your deployment, you can provide "
"your own clouds.yaml by specifying this setting."
msgstr ""
#: ../../source/configuration/settings.rst:554
msgid ""
"The default template is defined as :opendev-repo:`clouds.yaml.template "
"` and available context "
"parameters are found in ``_get_openrc_credentials()`` and "
"``download_clouds_yaml_file()`` functions in :opendev-repo:"
"`openstack_dashboard/dashboards/project/api_access/views.py `"
msgstr ""
#: ../../source/configuration/settings.rst:563
msgid ""
"Your template needs to be placed in the search paths of Django templates. "
"You may need to configure `ADD_TEMPLATE_DIRS`_ setting to contain a path "
"where your template exists."
msgstr ""
#: ../../source/configuration/settings.rst:568
msgid "OPENSTACK_CLOUDS_YAML_NAME"
msgstr ""
#: ../../source/configuration/settings.rst:572
msgid "Default: ``\"openstack\"``"
msgstr ""
#: ../../source/configuration/settings.rst:574
msgid "The name of the entry to put into the user's clouds.yaml file."
msgstr ""
#: ../../source/configuration/settings.rst:577
msgid "OPENSTACK_CLOUDS_YAML_PROFILE"
msgstr ""
#: ../../source/configuration/settings.rst:583
msgid "If set, the name of the `vendor profile`_ from `os-client-config`_."
msgstr ""
#: ../../source/configuration/settings.rst:589
msgid "OPENSTACK_ENDPOINT_TYPE"
msgstr ""
#: ../../source/configuration/settings.rst:593
msgid "Default: ``\"publicURL\"``"
msgstr ""
#: ../../source/configuration/settings.rst:595
msgid ""
"A string which specifies the endpoint type to use for the endpoints in the "
"Keystone service catalog."
msgstr ""
#: ../../source/configuration/settings.rst:599
msgid "OPENSTACK_KEYSTONE_ENDPOINT_TYPE"
msgstr ""
#: ../../source/configuration/settings.rst:605
msgid ""
"A string which specifies the endpoint type to use for the Keystone "
"(identity) endpoint when looking it up in the service catalog. This "
"overrides the ``OPENSTACK_ENDPOINT_TYPE`` parameter. If set to ``None``, "
"``OPENSTACK_ENDPOINT_TYPE`` is used for the identity endpoint."
msgstr ""
#: ../../source/configuration/settings.rst:611
msgid "OPENSTACK_KEYSTONE_MFA_TOTP_ENABLED"
msgstr ""
#: ../../source/configuration/settings.rst:617
msgid ""
"A boolean to activate TOTP support. If activated, the plugin must be present "
"in ``AUTHENTICATION_PLUGINS``."
msgstr ""
#: ../../source/configuration/settings.rst:621
msgid "OPENSTACK_HOST"
msgstr ""
#: ../../source/configuration/settings.rst:625
msgid "Default: ``\"127.0.0.1\"``"
msgstr ""
#: ../../source/configuration/settings.rst:627
msgid ""
"The hostname of the Keystone server used for authentication if you only have "
"one region. This is often the **only** setting that needs to be set for a "
"basic deployment."
msgstr ""
#: ../../source/configuration/settings.rst:631
msgid ""
"If you have multiple regions you should use the `AVAILABLE_REGIONS`_ setting "
"instead."
msgstr ""
#: ../../source/configuration/settings.rst:635
msgid "OPENRC_CUSTOM_TEMPLATE"
msgstr ""
#: ../../source/configuration/settings.rst:641
msgid "Example:: ``my-openrc.sh.template``"
msgstr ""
#: ../../source/configuration/settings.rst:643
msgid ""
"A template name for a custom user's ``openrc`` file. ``None`` means the "
"default template for ``openrc`` is used."
msgstr ""
#: ../../source/configuration/settings.rst:646
msgid ""
"If the default template is not suitable for your deployment, for example, if "
"your deployment uses saml2, openid and so on for authentication, the default "
"``openrc`` would not be sufficient. You can provide your own clouds.yaml by "
"specifying this setting."
msgstr ""
#: ../../source/configuration/settings.rst:651
msgid ""
"The default template is defined as :opendev-repo:`openrc.sh.template "
"` and available context "
"parameters are found in ``_get_openrc_credentials()`` and "
"``download_rc_file()`` functions in :opendev-repo:`openstack_dashboard/"
"dashboards/project/api_access/views.py `"
msgstr ""
#: ../../source/configuration/settings.rst:660
msgid ""
"Your template needs to be placed in the search paths of Django templates. "
"Check ``TEMPLATES[0]['DIRS']``. You may need to specify somewhere your "
"template exist to ``DIRS`` in ``TEMPLATES`` setting."
msgstr ""
#: ../../source/configuration/settings.rst:666
msgid "OPENSTACK_PROFILER"
msgstr ""
#: ../../source/configuration/settings.rst:670
msgid "Default: ``{\"enabled\": False}``"
msgstr ""
#: ../../source/configuration/settings.rst:672
msgid ""
"Various settings related to integration with osprofiler library. Since it is "
"a developer feature, it starts as disabled. To enable it, more than a single "
"``\"enabled\"`` key should be specified. Additional keys that should be "
"specified in that dictionary are:"
msgstr ""
#: ../../source/configuration/settings.rst:677
msgid ""
"``\"keys\"`` is a list of strings, which are secret keys used to encode/"
"decode the profiler data contained in request headers. Encryption is used "
"for security purposes, other OpenStack components that are expected to "
"profile themselves with osprofiler using the data from the request that "
"Horizon initiated must share a common set of keys with the ones in Horizon "
"config. List of keys is used so that security keys could be changed in non-"
"obtrusive manner for every component in the cloud. Example: ``\"keys\": "
"[\"SECRET_KEY\", \"MORE_SECRET_KEY\"]``. For more details see `osprofiler "
"documentation`_."
msgstr ""
#: ../../source/configuration/settings.rst:686
msgid ""
"``\"notifier_connection_string\"`` is a url to which trace messages are sent "
"by Horizon. For other components it is usually the only URL specified in "
"config, because other components act mostly as traces producers. Example: "
"``\"notifier_connection_string\": \"mongodb://%s\" % OPENSTACK_HOST``."
msgstr ""
#: ../../source/configuration/settings.rst:690
msgid ""
"``\"receiver_connection_string\"`` is a url from which traces are retrieved "
"by Horizon, needed because Horizon is not only the traces producer, but also "
"a consumer. Having 2 settings which usually contain the same value is legacy "
"feature from older versions of osprofiler when OpenStack components could "
"use oslo.messaging for notifications and the trace client used ceilometer as "
"a receiver backend. By default Horizon uses the same URL pointing to a "
"MongoDB cluster for both purposes. Example: ``\"receiver_connection_string\":"
" \"mongodb://%s\" % OPENSTACK_HOST``."
msgstr ""
#: ../../source/configuration/settings.rst:702
msgid "OPENSTACK_SSL_CACERT"
msgstr ""
#: ../../source/configuration/settings.rst:708
msgid ""
"When unset or set to ``None`` the default CA certificate on the system is "
"used for SSL verification."
msgstr ""
#: ../../source/configuration/settings.rst:711
msgid ""
"When set with the path to a custom CA certificate file, this overrides use "
"of the default system CA certificate. This custom certificate is used to "
"verify all connections to openstack services when making API calls."
msgstr ""
#: ../../source/configuration/settings.rst:716
msgid "OPENSTACK_SSL_NO_VERIFY"
msgstr ""
#: ../../source/configuration/settings.rst:722
msgid ""
"Disable SSL certificate checks in the OpenStack clients (useful for self-"
"signed certificates)."
msgstr ""
#: ../../source/configuration/settings.rst:726
msgid "OPERATION_LOG_ENABLED"
msgstr ""
#: ../../source/configuration/settings.rst:732
msgid ""
"This setting can be used to enable logging of all operations carried out by "
"users of Horizon. The format of the logs is configured via "
"`OPERATION_LOG_OPTIONS`_"
msgstr ""
#: ../../source/configuration/settings.rst:738
msgid ""
"If you use this feature, you need to configure the logger setting like an "
"outputting path for operation log in ``local_settings.py``."
msgstr ""
#: ../../source/configuration/settings.rst:742
msgid "OPERATION_LOG_OPTIONS"
msgstr ""
#: ../../source/configuration/settings.rst:748
msgid ""
"Added ``ignored_urls`` parameter and added ``%(client_ip)s`` to ``format``"
msgstr ""
#: ../../source/configuration/settings.rst:764
msgid "This setting controls the behavior of the operation log."
msgstr ""
#: ../../source/configuration/settings.rst:766
msgid ""
"``mask_fields`` is a list of keys of post data which should be masked from "
"the point of view of security. Fields like ``password`` should be included. "
"The fields specified in ``mask_fields`` are logged as ``********``."
msgstr ""
#: ../../source/configuration/settings.rst:769
msgid ""
"``target_methods`` is a request method which is logged to an operation log. "
"The valid methods are ``POST``, ``GET``, ``PUT``, ``DELETE``."
msgstr ""
#: ../../source/configuration/settings.rst:771
msgid "``ignored_urls`` is a list of request URLs to be hidden from a log."
msgstr ""
#: ../../source/configuration/settings.rst:772
msgid ""
"``format`` defines the operation log format. Currently you can use the "
"following keywords. The default value contains all keywords."
msgstr ""
#: ../../source/configuration/settings.rst:776
msgid "``%(client_ip)s``"
msgstr ""
#: ../../source/configuration/settings.rst:777
msgid "``%(domain_name)s``"
msgstr ""
#: ../../source/configuration/settings.rst:778
msgid "``%(domain_id)s``"
msgstr ""
#: ../../source/configuration/settings.rst:779
msgid "``%(project_name)s``"
msgstr ""
#: ../../source/configuration/settings.rst:780
msgid "``%(project_id)s``"
msgstr ""
#: ../../source/configuration/settings.rst:781
msgid "``%(user_name)s``"
msgstr ""
#: ../../source/configuration/settings.rst:782
msgid "``%(user_id)s``"
msgstr ""
#: ../../source/configuration/settings.rst:783
msgid "``%(request_scheme)s``"
msgstr ""
#: ../../source/configuration/settings.rst:784
msgid "``%(referer_url)s``"
msgstr ""
#: ../../source/configuration/settings.rst:785
msgid "``%(request_url)s``"
msgstr ""
#: ../../source/configuration/settings.rst:786
msgid "``%(message)s``"
msgstr ""
#: ../../source/configuration/settings.rst:787
msgid "``%(method)s``"
msgstr ""
#: ../../source/configuration/settings.rst:788
msgid "``%(http_status)s``"
msgstr ""
#: ../../source/configuration/settings.rst:789
msgid "``%(param)s``"
msgstr ""
#: ../../source/configuration/settings.rst:792
msgid "OVERVIEW_DAYS_RANGE"
msgstr ""
#: ../../source/configuration/settings.rst:796
msgid "Default:: ``1``"
msgstr ""
#: ../../source/configuration/settings.rst:798
msgid ""
"When set to an integer N (as by default), the start date in the Overview "
"panel meters will be today minus N days. This setting is used to limit the "
"amount of data fetched by default when rendering the Overview panel. If set "
"to ``None`` (which corresponds to the behavior in past Horizon versions), "
"the start date will be from the beginning of the current month until the "
"current date. The legacy behaviour is not recommended for large deployments "
"as Horizon suffers significant lag in this case."
msgstr ""
#: ../../source/configuration/settings.rst:807
msgid "POLICY_CHECK_FUNCTION"
msgstr ""
#: ../../source/configuration/settings.rst:811
msgid "Default:: ``openstack_auth.policy.check``"
msgstr ""
#: ../../source/configuration/settings.rst:813
msgid ""
"This value should not be changed, although removing it or setting it to "
"``None`` would be a means to bypass all policy checks."
msgstr ""
#: ../../source/configuration/settings.rst:817
msgid "POLICY_DIRS"
msgstr ""
#: ../../source/configuration/settings.rst:830
msgid ""
"Specifies a list of policy directories per service types. The directories "
"are relative to `POLICY_FILES_PATH`_. Services whose additional policies are "
"defined here must be defined in `POLICY_FILES`_ too. Otherwise, additional "
"policies specified in ``POLICY_DIRS`` are not loaded."
msgstr ""
#: ../../source/configuration/settings.rst:837
msgid ""
"``cinder_policy.d`` and ``nova_policy.d`` are registered by default to "
"maintain policies which have ben dropped from nova and cinder but horizon "
"still uses. We recommend not to drop them."
msgstr ""
#: ../../source/configuration/settings.rst:842
msgid "POLICY_FILES"
msgstr ""
#: ../../source/configuration/settings.rst:848
msgid ""
"The default files are changed to YAML format. JSON format still continues to "
"be supported."
msgstr ""
#: ../../source/configuration/settings.rst:863
msgid ""
"This should essentially be the mapping of the contents of "
"`POLICY_FILES_PATH`_ to service types. When policy files are added to "
"`POLICY_FILES_PATH`_, they should be included here too."
msgstr ""
#: ../../source/configuration/settings.rst:868
msgid "POLICY_FILES_PATH"
msgstr ""
#: ../../source/configuration/settings.rst:872
msgid "Default: ``os.path.join(ROOT_PATH, \"conf\")``"
msgstr ""
#: ../../source/configuration/settings.rst:874
msgid ""
"Specifies where service based policy files are located. These are used to "
"define the policy rules actions are verified against."
msgstr ""
#: ../../source/configuration/settings.rst:878
msgid "REST_API_REQUIRED_SETTINGS"
msgstr ""
#: ../../source/configuration/settings.rst:897
msgid ""
"This setting allows you to expose configuration values over Horizons "
"internal REST API, so that the AngularJS panels can access them. Please be "
"cautious about which values are listed here (and thus exposed on the "
"frontend). For security purpose, this exposure of settings should be "
"recognized explicitly by operator. So ``REST_API_REQUIRED_SETTINGS`` is not "
"set by default. Please refer ``local_settings.py.example`` and confirm your "
"``local_settings.py``."
msgstr ""
#: ../../source/configuration/settings.rst:905
msgid "SELECTABLE_THEMES"
msgstr ""
#: ../../source/configuration/settings.rst:909
msgid "Default: ``AVAILABLE_THEMES``"
msgstr ""
#: ../../source/configuration/settings.rst:911
msgid ""
"This setting tells Horizon which themes to expose to the user as selectable "
"in the theme picker widget. This value defaults to all themes configured in "
"`AVAILABLE_THEMES`_, but a brander may wish to simply inherit from an "
"existing theme and not allow that parent theme to be selected by the user. "
"``SELECTABLE_THEMES`` takes the exact same format as ``AVAILABLE_THEMES``."
msgstr ""
#: ../../source/configuration/settings.rst:918
msgid "SESSION_REFRESH"
msgstr ""
#: ../../source/configuration/settings.rst:924
msgid ""
"Control whether the SESSION_TIMEOUT period is refreshed due to activity. If "
"False, SESSION_TIMEOUT acts as a hard limit."
msgstr ""
#: ../../source/configuration/settings.rst:928
msgid "SESSION_TIMEOUT"
msgstr ""
#: ../../source/configuration/settings.rst:932
msgid "Default: ``\"3600\"``"
msgstr ""
#: ../../source/configuration/settings.rst:934
msgid ""
"This SESSION_TIMEOUT is a method to supercede the token timeout with a "
"shorter horizon session timeout (in seconds). If SESSION_REFRESH is True "
"(the default) SESSION_TIMEOUT acts like an idle timeout rather than being a "
"hard limit, but will never exceed the token expiry. If your token expires in "
"60 minutes, a value of 1800 will log users out after 30 minutes of "
"inactivity, or 60 minutes with activity. Setting SESSION_REFRESH to False "
"will make SESSION_TIMEOUT act like a hard limit on session times."
msgstr ""
#: ../../source/configuration/settings.rst:944
msgid "MEMOIZED_MAX_SIZE_DEFAULT"
msgstr ""
#: ../../source/configuration/settings.rst:948
msgid "Default: ``\"25\"``"
msgstr ""
#: ../../source/configuration/settings.rst:950
msgid ""
"MEMOIZED_MAX_SIZE_DEFAULT allows setting a global default to help control "
"memory usage when caching. It should at least be 2 x the number of threads "
"with a little bit of extra buffer."
msgstr ""
#: ../../source/configuration/settings.rst:955
msgid "SHOW_OPENRC_FILE"
msgstr ""
#: ../../source/configuration/settings.rst:959
#: ../../source/configuration/settings.rst:973
msgid "Default:: ``True``"
msgstr ""
#: ../../source/configuration/settings.rst:961
msgid ""
"Controls whether the keystone openrc file is accesible from the user menu "
"and the api access panel."
msgstr ""
#: ../../source/configuration/settings.rst:966
msgid "`OPENRC_CUSTOM_TEMPLATE`_ to provide a custom ``openrc``."
msgstr ""
#: ../../source/configuration/settings.rst:969
msgid "SHOW_OPENSTACK_CLOUDS_YAML"
msgstr ""
#: ../../source/configuration/settings.rst:975
msgid ""
"Controls whether clouds.yaml is accesible from the user menu and the api "
"access panel."
msgstr ""
#: ../../source/configuration/settings.rst:980
msgid ""
"`OPENSTACK_CLOUDS_YAML_CUSTOM_TEMPLATE`_ to provide a custom ``clouds.yaml``."
""
msgstr ""
#: ../../source/configuration/settings.rst:984
msgid "SIMULTANEOUS_SESSIONS"
msgstr ""
#: ../../source/configuration/settings.rst:988
msgid "Default: ``allow``"
msgstr ""
#: ../../source/configuration/settings.rst:990
msgid ""
"Controls whether a user can have multiple simultaneous sessions. Valid "
"values are ``allow`` and ``disconnect``."
msgstr ""
#: ../../source/configuration/settings.rst:993
msgid ""
"The value ``allow`` enables more than one simultaneous sessions for a user. "
"The Value ``disconnect`` disables more than one simultaneous sessions for a "
"user. Only one active session is allowed. The newer session will be "
"considered as the valid one and any existing session will be disconnected "
"after a subsequent successful login."
msgstr ""
#: ../../source/configuration/settings.rst:1000
msgid "THEME_COLLECTION_DIR"
msgstr ""
#: ../../source/configuration/settings.rst:1004
msgid "Default: ``\"themes\"``"
msgstr ""
#: ../../source/configuration/settings.rst:1006
msgid ""
"This setting tells Horizon which static directory to collect the available "
"themes into, and therefore which URL points to the theme collection root. "
"For example, the default theme would be accessible via ``/{{ STATIC_URL }}/"
"themes/default``."
msgstr ""
#: ../../source/configuration/settings.rst:1012
msgid "THEME_COOKIE_NAME"
msgstr ""
#: ../../source/configuration/settings.rst:1016
msgid "Default: ``\"theme\"``"
msgstr ""
#: ../../source/configuration/settings.rst:1018
msgid ""
"This setting tells Horizon in which cookie key to store the currently set "
"theme. The cookie expiration is currently set to a year."
msgstr ""
#: ../../source/configuration/settings.rst:1022
msgid "USER_MENU_LINKS"
msgstr ""
#: ../../source/configuration/settings.rst:1038
msgid ""
"This setting controls the additional links on the user drop down menu. A "
"list of dictionaries defining all of the links should be provided. This "
"defaults to the standard OpenStack RC files."
msgstr ""
#: ../../source/configuration/settings.rst:1042
msgid "Each dictionary should contain these values:"
msgstr ""
#: ../../source/configuration/settings.rst:1045
msgid "The name of the link"
msgstr ""
#: ../../source/configuration/settings.rst:1045
msgid "name"
msgstr ""
#: ../../source/configuration/settings.rst:1048
msgid "Either the reversible Django url name or an absolute url"
msgstr ""
#: ../../source/configuration/settings.rst:1048
msgid "url"
msgstr ""
#: ../../source/configuration/settings.rst:1051
msgid "True for absolute URLs, False for django urls."
msgstr ""
#: ../../source/configuration/settings.rst:1051
msgid "external"
msgstr ""
#: ../../source/configuration/settings.rst:1054
msgid ""
"A list of classes for the icon next to the link. If 'None' or an empty list "
"is provided a download icon will show"
msgstr ""
#: ../../source/configuration/settings.rst:1055
msgid "icon_classes"
msgstr ""
#: ../../source/configuration/settings.rst:1058
msgid "WEBROOT"
msgstr ""
#: ../../source/configuration/settings.rst:1062
msgid "Default: ``\"/\"``"
msgstr ""
#: ../../source/configuration/settings.rst:1064
msgid ""
"Specifies the location where the access to the dashboard is configured in "
"the web server."
msgstr ""
#: ../../source/configuration/settings.rst:1067
msgid ""
"For example, if you're accessing the Dashboard via ``https:///"
"dashboard``, you would set this to ``\"/dashboard/\"``."
msgstr ""
#: ../../source/configuration/settings.rst:1072
msgid ""
"Additional settings may be required in the config files of your webserver of "
"choice. For example to make ``\"/dashboard/\"`` the web root in Apache, the "
"``\"sites-available/horizon.conf\"`` requires a couple of additional aliases "
"set::"
msgstr ""
#: ../../source/configuration/settings.rst:1081
msgid ""
"Apache also requires changing your WSGIScriptAlias to reflect the desired "
"path. For example, you'd replace ``/`` with ``/dashboard`` for the alias."
msgstr ""
#: ../../source/configuration/settings.rst:1088
msgid "Service-specific Settings"
msgstr ""
#: ../../source/configuration/settings.rst:1090
msgid ""
"The following settings inform the OpenStack Dashboard of information about "
"the other OpenStack projects which are part of this cloud and control the "
"behavior of specific dashboards, panels, API calls, etc."
msgstr ""
#: ../../source/configuration/settings.rst:1095
msgid "Cinder"
msgstr ""
#: ../../source/configuration/settings.rst:1098
msgid "OPENSTACK_CINDER_FEATURES"
msgstr ""
#: ../../source/configuration/settings.rst:1102
msgid "Default: ``{'enable_backup': False}``"
msgstr ""
#: ../../source/configuration/settings.rst:1104
msgid ""
"A dictionary of settings which can be used to enable optional services "
"provided by cinder. Currently only the backup service is available."
msgstr ""
#: ../../source/configuration/settings.rst:1108
msgid "Glance"
msgstr ""
#: ../../source/configuration/settings.rst:1111
msgid "CREATE_IMAGE_DEFAULTS"
msgstr ""
#: ../../source/configuration/settings.rst:1123
msgid "A dictionary of default settings for create image modal."
msgstr ""
#: ../../source/configuration/settings.rst:1125
msgid ""
"The ``image_visibility`` setting specifies the default visibility option. "
"Valid values are ``\"public\"`` and ``\"private\"``. By default, the "
"visibility option is public on create image modal. If it's set to "
"``\"private\"``, the default visibility option is private."
msgstr ""
#: ../../source/configuration/settings.rst:1131
msgid "HORIZON_IMAGES_UPLOAD_MODE"
msgstr ""
#: ../../source/configuration/settings.rst:1135
msgid "Default: ``\"legacy\"``"
msgstr ""
#: ../../source/configuration/settings.rst:1137
msgid ""
"Valid values are ``\"direct\"``, ``\"legacy\"`` (default) and ``\"off\"``. "
"``\"off\"`` disables the ability to upload images via Horizon. ``legacy`` "
"enables local file upload by piping the image file through the Horizon's web-"
"server. ``direct`` sends the image file directly from the web browser to "
"Glance. This bypasses Horizon web-server which both reduces network hops and "
"prevents filling up Horizon web-server's filesystem. ``direct`` is the "
"preferred mode, but due to the following requirements it is not the default. "
"The ``direct`` setting requires a modern web browser, network access from "
"the browser to the public Glance endpoint, and CORS support to be enabled on "
"the Glance API service. Without CORS support, the browser will forbid the "
"PUT request to a location different than the Horizon server. To enable CORS "
"support for Glance API service, you will need to edit [cors] section of "
"glance-api.conf file (see `here`_ how to do it). Set `allowed_origin` to the "
"full hostname of Horizon web-server (e.g. http:///dashboard) and "
"restart glance-api process."
msgstr ""
#: ../../source/configuration/settings.rst:1156
msgid "IMAGE_CUSTOM_PROPERTY_TITLES"
msgstr ""
#: ../../source/configuration/settings.rst:1173
msgid ""
"Used to customize the titles for image custom property attributes that "
"appear on image detail pages."
msgstr ""
#: ../../source/configuration/settings.rst:1177
msgid "IMAGE_RESERVED_CUSTOM_PROPERTIES"
msgstr ""
#: ../../source/configuration/settings.rst:1183
msgid ""
"A list of image custom property keys that should not be displayed in the "
"Update Metadata tree."
msgstr ""
#: ../../source/configuration/settings.rst:1186
msgid ""
"This setting can be used in the case where a separate panel is used for "
"managing a custom property or if a certain custom property should never be "
"edited."
msgstr ""
#: ../../source/configuration/settings.rst:1191
msgid "IMAGES_ALLOW_LOCATION"
msgstr ""
#: ../../source/configuration/settings.rst:1197
msgid ""
"If set to ``True``, this setting allows users to specify an image location "
"(URL) as the image source when creating or updating images. Depending on the "
"Glance version, the ability to set an image location is controlled by "
"policies and/or the Glance configuration. Therefore IMAGES_ALLOW_LOCATION "
"should only be set to ``True`` if Glance is configured to allow specifying a "
"location. This setting has no effect when the Keystone catalog doesn't "
"contain a Glance v2 endpoint."
msgstr ""
#: ../../source/configuration/settings.rst:1206
msgid "IMAGES_LIST_FILTER_TENANTS"
msgstr ""
#: ../../source/configuration/settings.rst:1212
msgid ""
"A list of dictionaries to add optional categories to the image fixed filters "
"in the Images panel, based on project ownership."
msgstr ""
#: ../../source/configuration/settings.rst:1215
msgid ""
"Each dictionary should contain a `tenant` attribute with the project id, and "
"optionally a `text` attribute specifying the category name, and an `icon` "
"attribute that displays an icon in the filter button. The icon names are "
"based on the default icon theme provided by Bootstrap."
msgstr ""
#: ../../source/configuration/settings.rst:1229
msgid "OPENSTACK_IMAGE_BACKEND"
msgstr ""
#: ../../source/configuration/settings.rst:1253
msgid ""
"Used to customize features related to the image service, such as the list of "
"supported image formats."
msgstr ""
#: ../../source/configuration/settings.rst:1257
msgid "Keystone"
msgstr ""
#: ../../source/configuration/settings.rst:1260
msgid "ALLOW_USERS_CHANGE_EXPIRED_PASSWORD"
msgstr ""
#: ../../source/configuration/settings.rst:1266
msgid ""
"When enabled, this setting lets users change their password after it has "
"expired or when it is required to be changed on first use. Disabling it will "
"force such users to either use the command line interface to change their "
"password, or contact the system administrator."
msgstr ""
#: ../../source/configuration/settings.rst:1273
msgid "AUTHENTICATION_PLUGINS"
msgstr ""
#: ../../source/configuration/settings.rst:1286
msgid ""
"A list of authentication plugins to be used. In most cases, there is no need "
"to configure this."
msgstr ""
#: ../../source/configuration/settings.rst:1289
msgid ""
"If ``OPENSTACK_KEYSTONE_MFA_TOTP_ENABLED`` is true, then this should look "
"like this:"
msgstr ""
#: ../../source/configuration/settings.rst:1302
msgid "AUTHENTICATION_URLS"
msgstr ""
#: ../../source/configuration/settings.rst:1306
msgid "Default: ``['openstack_auth.urls']``"
msgstr ""
#: ../../source/configuration/settings.rst:1308
msgid ""
"A list of modules from which to collate authentication URLs from. The "
"default option adds URLs from the django-openstack-auth module however "
"others will be required for additional authentication mechanisms."
msgstr ""
#: ../../source/configuration/settings.rst:1313
msgid "AVAILABLE_REGIONS"
msgstr ""
#: ../../source/configuration/settings.rst:1319
msgid ""
"A list of tuples which define multiple regions. The tuple format is ``('http:"
"//{{ keystone_host }}/identity/v3', '{{ region_name }}')``. If any regions "
"are specified the login form will have a dropdown selector for "
"authenticating to the appropriate region, and there will be a region "
"switcher dropdown in the site header when logged in."
msgstr ""
#: ../../source/configuration/settings.rst:1325
msgid ""
"You should also define `OPENSTACK_KEYSTONE_URL`_ to indicate which of the "
"regions is the default one."
msgstr ""
#: ../../source/configuration/settings.rst:1330
msgid "DEFAULT_SERVICE_REGIONS"
msgstr ""
#: ../../source/configuration/settings.rst:1334
#: ../../source/configuration/settings.rst:1568
#: ../../source/configuration/settings.rst:1628
#: ../../source/configuration/settings.rst:1681
#: ../../source/configuration/settings.rst:1987
#: ../../source/configuration/settings.rst:2041
#: ../../source/configuration/settings.rst:2490
msgid "Default: ``{}``"
msgstr ""
#: ../../source/configuration/settings.rst:1336
msgid ""
"The default service region is set on a per-endpoint basis, meaning that once "
"the user logs into some Keystone endpoint, if a default service region is "
"defined for it in this setting and exists within Keystone catalog, it will "
"be set as the initial service region in this endpoint. By default it is an "
"empty dictionary because upstream can neither predict service region names "
"in a specific deployment, nor tell whether this behavior is desired. The key "
"of the dictionary is a full url of a Keystone endpoint with version suffix, "
"the value is a region name."
msgstr ""
#: ../../source/configuration/settings.rst:1353
msgid ""
"As of Rocky you can optionally you can set ``'*'`` as the key, and if no "
"matching endpoint is found this will be treated as a global default."
msgstr ""
#: ../../source/configuration/settings.rst:1366
msgid "ENABLE_CLIENT_TOKEN"
msgstr ""
#: ../../source/configuration/settings.rst:1372
msgid ""
"This setting will Enable/Disable access to the Keystone Token to the browser."
""
msgstr ""
#: ../../source/configuration/settings.rst:1376
msgid "ENFORCE_PASSWORD_CHECK"
msgstr ""
#: ../../source/configuration/settings.rst:1382
msgid ""
"This setting will display an 'Admin Password' field on the Change Password "
"form to verify that it is indeed the admin logged-in who wants to change the "
"password."
msgstr ""
#: ../../source/configuration/settings.rst:1387
msgid "KEYSTONE_PROVIDER_IDP_ID"
msgstr ""
#: ../../source/configuration/settings.rst:1391
msgid "Default: ``\"localkeystone\"``"
msgstr ""
#: ../../source/configuration/settings.rst:1393
msgid ""
"This ID is only used for comparison with the service provider IDs. This ID "
"should not match any service provider IDs."
msgstr ""
#: ../../source/configuration/settings.rst:1397
msgid "KEYSTONE_PROVIDER_IDP_NAME"
msgstr ""
#: ../../source/configuration/settings.rst:1401
msgid "Default: ``\"Local Keystone\"``"
msgstr ""
#: ../../source/configuration/settings.rst:1403
msgid ""
"The Keystone Provider drop down uses Keystone to Keystone federation to "
"switch between Keystone service providers. This sets the display name for "
"the Identity Provider (dropdown display name)."
msgstr ""
#: ../../source/configuration/settings.rst:1408
msgid "OPENSTACK_KEYSTONE_ADMIN_ROLES"
msgstr ""
#: ../../source/configuration/settings.rst:1412
msgid "Default: ``[\"admin\"]``"
msgstr ""
#: ../../source/configuration/settings.rst:1414
msgid ""
"The list of roles that have administrator privileges in this OpenStack "
"installation. This check is very basic and essentially only works with "
"keystone v3 with the default policy file. The setting assumes there is a "
"common ``admin`` like role(s) across services. Example uses of this setting "
"are:"
msgstr ""
#: ../../source/configuration/settings.rst:1420
msgid "to rename the ``admin`` role to ``cloud-admin``"
msgstr ""
#: ../../source/configuration/settings.rst:1421
msgid ""
"allowing multiple roles to have administrative privileges, like "
"``[\"admin\", \"cloud-admin\", \"net-op\"]``"
msgstr ""
#: ../../source/configuration/settings.rst:1425
msgid "OPENSTACK_KEYSTONE_BACKEND"
msgstr ""
#: ../../source/configuration/settings.rst:1442
msgid ""
"A dictionary containing settings which can be used to identify the "
"capabilities of the auth backend for Keystone."
msgstr ""
#: ../../source/configuration/settings.rst:1445
msgid ""
"If Keystone has been configured to use LDAP as the auth backend then set "
"``can_edit_user`` and ``can_edit_project`` to ``False`` and name to "
"``\"ldap\"``."
msgstr ""
#: ../../source/configuration/settings.rst:1449
msgid "OPENSTACK_KEYSTONE_DEFAULT_DOMAIN"
msgstr ""
#: ../../source/configuration/settings.rst:1453
msgid "Default: ``\"Default\"``"
msgstr ""
#: ../../source/configuration/settings.rst:1455
msgid ""
"Overrides the default domain used when running on single-domain model with "
"Keystone V3. All entities will be created in the default domain."
msgstr ""
#: ../../source/configuration/settings.rst:1459
msgid "OPENSTACK_KEYSTONE_DEFAULT_ROLE"
msgstr ""
#: ../../source/configuration/settings.rst:1465
msgid "Default: ``\"member\"``"
msgstr ""
#: ../../source/configuration/settings.rst:1467
msgid ""
"The default value is changed from ``_member_`` to ``member`` to conform with "
"what keystone-bootstrap creates."
msgstr ""
#: ../../source/configuration/settings.rst:1470
msgid ""
"The name of the role which will be assigned to a user when added to a "
"project. This value must correspond to an existing role name in Keystone. In "
"general, the value should match the ``member_role_name`` defined in "
"``keystone.conf``."
msgstr ""
#: ../../source/configuration/settings.rst:1475
msgid "OPENSTACK_KEYSTONE_DOMAIN_CHOICES"
msgstr ""
#: ../../source/configuration/settings.rst:1487
msgid ""
"If `OPENSTACK_KEYSTONE_DOMAIN_DROPDOWN`_ is enabled, this option can be used "
"to set the available domains to choose from. This is a list of pairs whose "
"first value is the domain name and the second is the display name."
msgstr ""
#: ../../source/configuration/settings.rst:1492
msgid "OPENSTACK_KEYSTONE_DOMAIN_DROPDOWN"
msgstr ""
#: ../../source/configuration/settings.rst:1498
msgid ""
"Set this to True if you want available domains displayed as a dropdown menu "
"on the login screen. It is strongly advised NOT to enable this for public "
"clouds, as advertising enabled domains to unauthenticated customers "
"irresponsibly exposes private information. This should only be used for "
"private clouds where the dashboard sits behind a corporate firewall."
msgstr ""
#: ../../source/configuration/settings.rst:1505
msgid "OPENSTACK_KEYSTONE_FEDERATION_MANAGEMENT"
msgstr ""
#: ../../source/configuration/settings.rst:1511
msgid ""
"Set this to True to enable panels that provide the ability for users to "
"manage Identity Providers (IdPs) and establish a set of rules to map "
"federation protocol attributes to Identity API attributes. This extension "
"requires v3.0+ of the Identity API."
msgstr ""
#: ../../source/configuration/settings.rst:1517
msgid "OPENSTACK_KEYSTONE_MULTIDOMAIN_SUPPORT"
msgstr ""
#: ../../source/configuration/settings.rst:1523
msgid ""
"Set this to True if running on multi-domain model. When this is enabled, it "
"will require user to enter the Domain name in addition to username for login."
""
msgstr ""
#: ../../source/configuration/settings.rst:1527
msgid "OPENSTACK_KEYSTONE_URL"
msgstr ""
#: ../../source/configuration/settings.rst:1533
msgid ""
"The default value was changed to ``\"http://%s/identity/v3\" % "
"OPENSTACK_HOST``"
msgstr ""
#: ../../source/configuration/settings.rst:1537
msgid "Horizon's `OPENSTACK_HOST`_ documentation"
msgstr ""
#: ../../source/configuration/settings.rst:1539
msgid "Default: ``\"http://%s/identity/v3\" % OPENSTACK_HOST``"
msgstr ""
#: ../../source/configuration/settings.rst:1541
msgid ""
"The full URL for the Keystone endpoint used for authentication. Unless you "
"are using HTTPS, running your Keystone server on a nonstandard port, or "
"using a nonstandard URL scheme you shouldn't need to touch this setting."
msgstr ""
#: ../../source/configuration/settings.rst:1546
msgid "PASSWORD_EXPIRES_WARNING_THRESHOLD_DAYS"
msgstr ""
#: ../../source/configuration/settings.rst:1550
msgid "Default: ``-1``"
msgstr ""
#: ../../source/configuration/settings.rst:1552
msgid ""
"Password will have an expiration date when using keystone v3 and enabling "
"the feature. This setting allows you to set the number of days that the user "
"will be alerted prior to the password expiration. Once the password expires "
"keystone will deny the access and users must contact an admin to change "
"their password. Setting this value to ``N`` days means the user will be "
"alerted when the password expires in less than ``N+1`` days. ``-1`` disables "
"the feature."
msgstr ""
#: ../../source/configuration/settings.rst:1560
msgid "PROJECT_TABLE_EXTRA_INFO"
msgstr ""
#: ../../source/configuration/settings.rst:1566
msgid "`USER_TABLE_EXTRA_INFO`_ for the equivalent setting on the Users table"
msgstr ""
#: ../../source/configuration/settings.rst:1570
msgid ""
"Adds additional information for projects as extra attributes. Projects can "
"have extra attributes as defined by Keystone v3. This setting allows those "
"attributes to be shown in Horizon."
msgstr ""
#: ../../source/configuration/settings.rst:1574
#: ../../source/configuration/settings.rst:1634
msgid "For example:"
msgstr ""
#: ../../source/configuration/settings.rst:1583
msgid "SECURE_PROXY_ADDR_HEADER"
msgstr ""
#: ../../source/configuration/settings.rst:1587
msgid ""
"If horizon is behind a proxy server and the proxy is configured, the IP "
"address from request is passed using header variables inside the request. "
"The header name depends on a proxy or a load-balancer. This setting "
"specifies the name of the header with remote IP address. The main use is for "
"authentication log (success or fail) displaing the IP address of the user. "
"The commom value for this setting is ``HTTP_X_REAL_IP`` or "
"``HTTP_X_FORWARDED_FOR``. If not present, then ``REMOTE_ADDR`` header is "
"used. (``REMOTE_ADDR`` is the field of Django HttpRequest object which "
"contains IP address of the client.)"
msgstr ""
#: ../../source/configuration/settings.rst:1598
msgid "TOKEN_DELETION_DISABLED"
msgstr ""
#: ../../source/configuration/settings.rst:1604
msgid ""
"This setting allows deployers to control whether a token is deleted on log "
"out. This can be helpful when there are often long running processes being "
"run in the Horizon environment."
msgstr ""
#: ../../source/configuration/settings.rst:1609
msgid "TOKEN_TIMEOUT_MARGIN"
msgstr ""
#: ../../source/configuration/settings.rst:1611
msgid "Default: ``0``"
msgstr ""
#: ../../source/configuration/settings.rst:1613
msgid ""
"A time margin in seconds to subtract from the real token's validity. An "
"example use case is that the token can be valid once the middleware passed, "
"and invalid (timed-out) during a view rendering and this generates "
"authorization errors during the view rendering. By setting this value to a "
"few seconds, you can avoid token expiration during a view rendering."
msgstr ""
#: ../../source/configuration/settings.rst:1620
msgid "USER_TABLE_EXTRA_INFO"
msgstr ""
#: ../../source/configuration/settings.rst:1626
msgid ""
"`PROJECT_TABLE_EXTRA_INFO`_ for the equivalent setting on the Projects table"
msgstr ""
#: ../../source/configuration/settings.rst:1630
msgid ""
"Adds additional information for users as extra attributes. Users can have "
"extra attributes as defined by Keystone v3. This setting allows those "
"attributes to be shown in Horizon."
msgstr ""
#: ../../source/configuration/settings.rst:1643
msgid "WEBSSO_CHOICES"
msgstr ""
#: ../../source/configuration/settings.rst:1657
msgid ""
"This is the list of authentication mechanisms available to the user. It "
"includes Keystone federation protocols such as OpenID Connect and SAML, and "
"also keys that map to specific identity provider and federation protocol "
"combinations (as defined in `WEBSSO_IDP_MAPPING`_). The list of choices is "
"completely configurable, so as long as the id remains intact. Do not remove "
"the credentials mechanism unless you are sure. Once removed, even admins "
"will have no way to log into the system via the dashboard."
msgstr ""
#: ../../source/configuration/settings.rst:1666
msgid "WEBSSO_ENABLED"
msgstr ""
#: ../../source/configuration/settings.rst:1672
msgid ""
"Enables keystone web single-sign-on if set to True. For this feature to "
"work, make sure that you are using Keystone V3 and Django OpenStack Auth V1."
"2.0 or later."
msgstr ""
#: ../../source/configuration/settings.rst:1677
msgid "WEBSSO_IDP_MAPPING"
msgstr ""
#: ../../source/configuration/settings.rst:1683
msgid ""
"A dictionary of specific identity provider and federation protocol "
"combinations. From the selected authentication mechanism, the value will be "
"looked up as keys in the dictionary. If a match is found, it will redirect "
"the user to a identity provider and federation protocol specific WebSSO "
"endpoint in keystone, otherwise it will use the value as the protocol_id "
"when redirecting to the WebSSO by protocol endpoint."
msgstr ""
#: ../../source/configuration/settings.rst:1709
msgid ""
"The value is expected to be a tuple formatted as: (, )"
msgstr ""
#: ../../source/configuration/settings.rst:1712
msgid "WEBSSO_INITIAL_CHOICE"
msgstr ""
#: ../../source/configuration/settings.rst:1716
msgid "Default: ``\"credentials\"``"
msgstr ""
#: ../../source/configuration/settings.rst:1718
msgid ""
"Specifies the default authentication mechanism. When user lands on the login "
"page, this is the first choice they will see."
msgstr ""
#: ../../source/configuration/settings.rst:1722
msgid "WEBSSO_DEFAULT_REDIRECT"
msgstr ""
#: ../../source/configuration/settings.rst:1728
msgid ""
"Allows to redirect on login to the IdP provider defined on PROTOCOL and "
"REGION In cases you have a single IdP providing websso, in order to improve "
"user experience, you can redirect on the login page to the IdP directly by "
"specifying WEBSSO_DEFAULT_REDIRECT_PROTOCOL and "
"WEBSSO_DEFAULT_REDIRECT_REGION variables."
msgstr ""
#: ../../source/configuration/settings.rst:1735
msgid "WEBSSO_DEFAULT_REDIRECT_PROTOCOL"
msgstr ""
#: ../../source/configuration/settings.rst:1741
msgid ""
"Allows to specify the protocol for the IdP to contact if the "
"WEBSSO_DEFAULT_REDIRECT is set to True"
msgstr ""
#: ../../source/configuration/settings.rst:1745
msgid "WEBSSO_DEFAULT_REDIRECT_REGION"
msgstr ""
#: ../../source/configuration/settings.rst:1749
msgid "Default: ``OPENSTACK_KEYSTONE_URL``"
msgstr ""
#: ../../source/configuration/settings.rst:1751
msgid ""
"Allows to specify thee region of the IdP to contact if the "
"WEBSSO_DEFAULT_REDIRECT is set to True"
msgstr ""
#: ../../source/configuration/settings.rst:1755
msgid "WEBSSO_DEFAULT_REDIRECT_LOGOUT"
msgstr ""
#: ../../source/configuration/settings.rst:1761
msgid ""
"Allows to specify a callback to the IdP to cleanup the SSO resources. Once "
"the user logs out it will redirect to the IdP log out method."
msgstr ""
#: ../../source/configuration/settings.rst:1765
msgid "WEBSSO_KEYSTONE_URL"
msgstr ""
#: ../../source/configuration/settings.rst:1769
msgid "Default: None"
msgstr ""
#: ../../source/configuration/settings.rst:1771
msgid ""
"The full auth URL for the Keystone endpoint used for web single-sign-on "
"authentication. Use this when ``OPENSTACK_KEYSTONE_URL`` is set to an "
"internal Keystone endpoint and is not reachable from the external network "
"where the identity provider lives. This URL will take precedence over "
"``OPENSTACK_KEYSTONE_URL`` if the login choice is an external identity "
"provider (IdP)."
msgstr ""
#: ../../source/configuration/settings.rst:1779
msgid "WEBSSO_USE_HTTP_REFERER"
msgstr ""
#: ../../source/configuration/settings.rst:1785
msgid ""
"For use in cases of web single-sign-on authentication when the control plane "
"has no outbound connectivity to the external service endpoints. By default "
"the HTTP_REFERER is used to derive the Keystone endpoint to pass requests to."
" As previous requests to an external IdP will be using Keystone's external "
"endpoint, this HTTP_REFERER will be Keystone's external endpoint. When "
"Horizon is unable to connect to Keystone's external endpoint in this setup "
"this leads to a time out. ``WEBSSO_USE_HTTP_REFERER`` can be set to False to "
"use the ``OPENSTACK_KEYSTONE_URL`` instead, which should be set to an "
"internal Keystone endpoint, so that this request will succeed."
msgstr ""
#: ../../source/configuration/settings.rst:1796
msgid "Neutron"
msgstr ""
#: ../../source/configuration/settings.rst:1799
msgid "ALLOWED_PRIVATE_SUBNET_CIDR"
msgstr ""
#: ../../source/configuration/settings.rst:1812
msgid ""
"A dictionary used to restrict user private subnet CIDR range. An empty list "
"means that user input will not be restricted for a corresponding IP version. "
"By default, there is no restriction for both IPv4 and IPv6."
msgstr ""
#: ../../source/configuration/settings.rst:1833
msgid "OPENSTACK_NEUTRON_NETWORK"
msgstr ""
#: ../../source/configuration/settings.rst:1859
msgid ""
"A dictionary of settings which can be used to enable optional services "
"provided by Neutron and configure Neutron specific features. The following "
"options are available."
msgstr ""
#: ../../source/configuration/settings.rst:1864
msgid "default_dns_nameservers"
msgstr ""
#: ../../source/configuration/settings.rst:1868
msgid "Default: ``None`` (Empty)"
msgstr ""
#: ../../source/configuration/settings.rst:1870
msgid ""
"Default DNS servers you would like to use when a subnet is created. This is "
"only a default. Users can still choose a different list of dns servers."
msgstr ""
#: ../../source/configuration/settings.rst:1873
msgid "Example: ``[\"8.8.8.8\", \"8.8.4.4\", \"208.67.222.222\"]``"
msgstr ""
#: ../../source/configuration/settings.rst:1876
msgid "enable_auto_allocated_network"
msgstr ""
#: ../../source/configuration/settings.rst:1882
msgid ""
"Enable or disable Nova and Neutron 'get-me-a-network' feature. This sets up "
"a neutron network topology for a project if there is no network in the "
"project. It simplifies the workflow when launching a server. Horizon checks "
"if both nova and neutron support the feature and enable it only when "
"supported. However, whether the feature works properly depends on "
"deployments, so this setting is disabled by default. (The detail on the "
"required preparation is described in `the Networking Guide `__.)"
msgstr ""
#: ../../source/configuration/settings.rst:1892
msgid "enable_distributed_router"
msgstr ""
#: ../../source/configuration/settings.rst:1898
msgid ""
"Enable or disable Neutron distributed virtual router (DVR) feature in the "
"Router panel. For the DVR feature to be enabled, this option needs to be set "
"to True and your Neutron deployment must support DVR. Even when your Neutron "
"plugin (like ML2 plugin) supports DVR feature, DVR feature depends on l3-"
"agent configuration, so deployers should set this option appropriately "
"depending on your deployment."
msgstr ""
#: ../../source/configuration/settings.rst:1906
msgid "enable_fip_topology_check"
msgstr ""
#: ../../source/configuration/settings.rst:1912
msgid ""
"The Default Neutron implementation needs a router with a gateway to "
"associate a FIP. So by default a topology check will be performed by horizon "
"to list only VM ports attached to a network which is itself attached to a "
"router with an external gateway. This is to prevent from setting a FIP to a "
"port which will fail with an error. Some Neutron vendors do not require it. "
"Some can even attach a FIP to any port (e.g.: OpenContrail) owned by a "
"tenant. Set to False if you want to be able to associate a FIP to an "
"instance on a subnet with no router if your Neutron backend allows it."
msgstr ""
#: ../../source/configuration/settings.rst:1923
msgid "enable_ha_router"
msgstr ""
#: ../../source/configuration/settings.rst:1929
msgid ""
"Enable or disable HA (High Availability) mode in Neutron virtual router in "
"the Router panel. For the HA router mode to be enabled, this option needs to "
"be set to True and your Neutron deployment must support HA router mode. Even "
"when your Neutron plugin (like ML2 plugin) supports HA router mode, the "
"feature depends on l3-agent configuration, so deployers should set this "
"option appropriately depending on your deployment."
msgstr ""
#: ../../source/configuration/settings.rst:1937
msgid "enable_ipv6"
msgstr ""
#: ../../source/configuration/settings.rst:1943
msgid ""
"Enable or disable IPv6 support in the Network panels. When disabled, Horizon "
"will only expose IPv4 configuration for networks."
msgstr ""
#: ../../source/configuration/settings.rst:1947
msgid "enable_quotas"
msgstr ""
#: ../../source/configuration/settings.rst:1951
msgid "The default value was changed to ``True``"
msgstr ""
#: ../../source/configuration/settings.rst:1955
msgid ""
"Enable support for Neutron quotas feature. To make this feature work "
"appropriately, you need to use Neutron plugins with quotas extension support "
"and quota_driver should be DbQuotaDriver (default config)."
msgstr ""
#: ../../source/configuration/settings.rst:1960
msgid "enable_rbac_policy"
msgstr ""
#: ../../source/configuration/settings.rst:1966
msgid ""
"Set this to True to enable RBAC Policies panel that provide the ability for "
"users to use RBAC function. This option only affects when Neutron is enabled."
""
msgstr ""
#: ../../source/configuration/settings.rst:1970
msgid "enable_router"
msgstr ""
#: ../../source/configuration/settings.rst:1976
msgid ""
"Enable (``True``) or disable (``False``) the panels and menus related to "
"router and Floating IP features. This option only affects when Neutron is "
"enabled. If your Neutron deployment has no support for Layer-3 features, or "
"you do not wish to provide the Layer-3 features through the Dashboard, this "
"should be set to ``False``."
msgstr ""
#: ../../source/configuration/settings.rst:1983
msgid "extra_provider_types"
msgstr ""
#: ../../source/configuration/settings.rst:1989
msgid ""
"For use with the provider network extension. This is a dictionary to define "
"extra provider network definitions. Network types supported by Neutron "
"depend on the configured plugin. Horizon has predefined provider network "
"types but horizon cannot cover all of them. If you are using a provider "
"network type not defined in advance, you can add a definition through this "
"setting."
msgstr ""
#: ../../source/configuration/settings.rst:1996
msgid ""
"The **key** name of each item in this must be a network type used in the "
"Neutron API. **value** should be a dictionary which contains the following "
"items:"
msgstr ""
#: ../../source/configuration/settings.rst:2000
msgid "``display_name``: string displayed in the network creation form."
msgstr ""
#: ../../source/configuration/settings.rst:2001
msgid ""
"``require_physical_network``: a boolean parameter which indicates this "
"network type requires a physical network."
msgstr ""
#: ../../source/configuration/settings.rst:2003
msgid ""
"``require_segmentation_id``: a boolean parameter which indicates this "
"network type requires a segmentation ID. If True, a valid segmentation ID "
"range must be configured in ``segmentation_id_range`` settings above."
msgstr ""
#: ../../source/configuration/settings.rst:2021
msgid "physical_networks"
msgstr ""
#: ../../source/configuration/settings.rst:2027
msgid ""
"Default to an empty list and the physical network field on the admin create "
"network modal will be a regular input field where users can type in the name "
"of the physical network to be used. If it is set to a list of available "
"physical networks, the physical network field will be shown as a dropdown "
"menu where users can select a physical network to be used."
msgstr ""
#: ../../source/configuration/settings.rst:2034
msgid "Example: ``['default', 'test']``"
msgstr ""
#: ../../source/configuration/settings.rst:2037
msgid "segmentation_id_range"
msgstr ""
#: ../../source/configuration/settings.rst:2043
msgid ""
"For use with the provider network extension. This is a dictionary where each "
"key is a provider network type and each value is a list containing two "
"numbers. The first number is the minimum segmentation ID that is valid. The "
"second number is the maximum segmentation ID. Pertains only to the vlan, "
"gre, and vxlan network types. By default this option is not provided and "
"each minimum and maximum value will be the default for the provider network "
"type."
msgstr ""
#: ../../source/configuration/settings.rst:2060
msgid "supported_provider_types"
msgstr ""
#: ../../source/configuration/settings.rst:2064
msgid "Default: ``[\"*\"]``"
msgstr ""
#: ../../source/configuration/settings.rst:2066
msgid ""
"For use with the provider network extension. Use this to explicitly set "
"which provider network types are supported. Only the network types in this "
"list will be available to choose from when creating a network. Network types "
"defined in Horizon or defined in `extra_provider_types`_ settings can be "
"specified in this list. As of the Newton release, the network types defined "
"in Horizon include network types supported by Neutron ML2 plugin with Open "
"vSwitch driver (``local``, ``flat``, ``vlan``, ``gre``, ``vxlan`` and "
"``geneve``) and supported by Midonet plugin (``midonet`` and ``uplink``). "
"``[\"*\"]`` means that all provider network types supported by Neutron ML2 "
"plugin will be available to choose from."
msgstr ""
#: ../../source/configuration/settings.rst:2078
msgid "Example: ``['local', 'flat', 'gre']``"
msgstr ""
#: ../../source/configuration/settings.rst:2081
msgid "supported_vnic_types"
msgstr ""
#: ../../source/configuration/settings.rst:2087
msgid ""
"Added ``virtio-forwarder`` VNIC type Clarified VNIC type availability for "
"users and operators"
msgstr ""
#: ../../source/configuration/settings.rst:2091
msgid "Default ``['*']``"
msgstr ""
#: ../../source/configuration/settings.rst:2093
msgid ""
"For use with the port binding extension. Use this to explicitly set which "
"VNIC types are available for users to choose from, when creating or editing "
"a port. The VNIC types actually supported are determined by resource "
"availability and Neutron ML2 plugin support. Currently, error reporting for "
"users selecting an incompatible or unavailable VNIC type is restricted to "
"receiving a message from the scheduler that the instance cannot spawn "
"because of insufficient resources. VNIC types include ``normal``, "
"``direct``, ``direct-physical``, ``macvtap``, ``baremetal`` and ``virtio-"
"forwarder``. By default all VNIC types will be available to choose from."
msgstr ""
#: ../../source/configuration/settings.rst:2104
msgid "Example: ``['normal', 'direct']``"
msgstr ""
#: ../../source/configuration/settings.rst:2106
msgid ""
"To disable VNIC type selection, set an empty list (``[]``) or ``None``."
msgstr ""
#: ../../source/configuration/settings.rst:2109
msgid "show_agents_column"
msgstr ""
#: ../../source/configuration/settings.rst:2113
msgid "Default ``True``"
msgstr ""
#: ../../source/configuration/settings.rst:2115
msgid ""
"Decides whether the DHCP Agents column should be shown on the Admin Networks "
"panel. Retrieving data for that column takes time, and it may be advisable "
"to disable it on large deployments with a large number on networks to speed "
"up displaying of that view."
msgstr ""
#: ../../source/configuration/settings.rst:2122
msgid "Nova"
msgstr ""
#: ../../source/configuration/settings.rst:2125
msgid "CREATE_INSTANCE_FLAVOR_SORT"
msgstr ""
#: ../../source/configuration/settings.rst:2137
msgid ""
"When launching a new instance the default flavor is sorted by RAM usage in "
"ascending order. You can customize the sort order by: id, name, ram, disk "
"and vcpus. Additionally, you can insert any custom callback function. You "
"can also provide a flag for reverse sort. See the description in "
"local_settings.py.example for more information."
msgstr ""
#: ../../source/configuration/settings.rst:2144
msgid "This example sorts flavors by vcpus in descending order:"
msgstr ""
#: ../../source/configuration/settings.rst:2154
msgid "CONSOLE_TYPE"
msgstr ""
#: ../../source/configuration/settings.rst:2160
msgid "Added the ``None`` option, which deactivates the in-browser console"
msgstr ""
#: ../../source/configuration/settings.rst:2164
msgid "Added the ``SERIAL`` option"
msgstr ""
#: ../../source/configuration/settings.rst:2168
msgid "Added the ``MKS`` option"
msgstr ""
#: ../../source/configuration/settings.rst:2170
msgid "Default: ``\"AUTO\"``"
msgstr ""
#: ../../source/configuration/settings.rst:2172
msgid ""
"This setting specifies the type of in-browser console used to access the VMs."
" Valid values are ``\"AUTO\"``, ``\"VNC\"``, ``\"SPICE\"``, ``\"RDP\"``, "
"``\"SERIAL\"``, ``\"MKS\"``, and ``None``."
msgstr ""
#: ../../source/configuration/settings.rst:2177
msgid "DEFAULT_BOOT_SOURCE"
msgstr ""
#: ../../source/configuration/settings.rst:2181
msgid "Default: ``image``"
msgstr ""
#: ../../source/configuration/settings.rst:2183
msgid "A default instance boot source. Allowed values are:"
msgstr ""
#: ../../source/configuration/settings.rst:2185
msgid "``image`` - boot instance from image (default option)"
msgstr ""
#: ../../source/configuration/settings.rst:2186
msgid "``snapshot`` - boot instance from instance snapshot"
msgstr ""
#: ../../source/configuration/settings.rst:2187
msgid "``volume`` - boot instance from volume"
msgstr ""
#: ../../source/configuration/settings.rst:2188
msgid "``volume_snapshot`` - boot instance from volume snapshot"
msgstr ""
#: ../../source/configuration/settings.rst:2191
msgid "INSTANCE_LOG_LENGTH"
msgstr ""
#: ../../source/configuration/settings.rst:2195
msgid "Default: ``35``"
msgstr ""
#: ../../source/configuration/settings.rst:2197
msgid ""
"This setting enables you to change the default number of lines displayed for "
"the log of an instance. Valid value must be a positive integer."
msgstr ""
#: ../../source/configuration/settings.rst:2202
msgid "LAUNCH_INSTANCE_DEFAULTS"
msgstr ""
#: ../../source/configuration/settings.rst:2208
msgid ""
"Added the ``disable_image``, ``disable_instance_snapshot``, "
"``disable_volume`` and ``disable_volume_snapshot`` options."
msgstr ""
#: ../../source/configuration/settings.rst:2213
msgid "Added the ``create_volume`` option."
msgstr ""
#: ../../source/configuration/settings.rst:2217
msgid "Added the ``hide_create_volume`` option."
msgstr ""
#: ../../source/configuration/settings.rst:2221
msgid "Added the ``default_availability_zone`` option."
msgstr ""
#: ../../source/configuration/settings.rst:2225
msgid "Added the ``enable_metadata``, ``enable_net_ports`` options."
msgstr ""
#: ../../source/configuration/settings.rst:2245
msgid ""
"A dictionary of settings which can be used to provide the default values for "
"properties found in the Launch Instance modal. An explanation of each "
"setting is provided below."
msgstr ""
#: ../../source/configuration/settings.rst:2250
msgid "config_drive"
msgstr ""
#: ../../source/configuration/settings.rst:2256
msgid ""
"This setting specifies the default value for the Configuration Drive "
"property."
msgstr ""
#: ../../source/configuration/settings.rst:2259
msgid "create_volume"
msgstr ""
#: ../../source/configuration/settings.rst:2265
msgid ""
"This setting allows you to specify the default value for the option of "
"creating a new volume in the workflow for image and instance snapshot "
"sources."
msgstr ""
#: ../../source/configuration/settings.rst:2269
msgid "hide_create_volume"
msgstr ""
#: ../../source/configuration/settings.rst:2275
msgid ""
"This setting allows you to hide the \"Create New Volume\" option and rely on "
"the default value you select with ``create_volume`` to be the most suitable "
"for your users."
msgstr ""
#: ../../source/configuration/settings.rst:2280
msgid "disable_image"
msgstr ""
#: ../../source/configuration/settings.rst:2286
msgid ""
"This setting disables Images as a valid boot source for launching instances. "
"Image sources won't show up in the Launch Instance modal."
msgstr ""
#: ../../source/configuration/settings.rst:2290
msgid "disable_instance_snapshot"
msgstr ""
#: ../../source/configuration/settings.rst:2296
msgid ""
"This setting disables Snapshots as a valid boot source for launching "
"instances. Snapshots sources won't show up in the Launch Instance modal."
msgstr ""
#: ../../source/configuration/settings.rst:2300
msgid "disable_volume"
msgstr ""
#: ../../source/configuration/settings.rst:2306
msgid ""
"This setting disables Volumes as a valid boot source for launching instances."
" Volumes sources won't show up in the Launch Instance modal."
msgstr ""
#: ../../source/configuration/settings.rst:2310
msgid "disable_volume_snapshot"
msgstr ""
#: ../../source/configuration/settings.rst:2316
msgid ""
"This setting disables Volume Snapshots as a valid boot source for launching "
"instances. Volume Snapshots sources won't show up in the Launch Instance "
"modal."
msgstr ""
#: ../../source/configuration/settings.rst:2320
msgid "enable_scheduler_hints"
msgstr ""
#: ../../source/configuration/settings.rst:2326
msgid ""
"This setting specifies whether or not Scheduler Hints can be provided when "
"launching an instance."
msgstr ""
#: ../../source/configuration/settings.rst:2330
msgid "enable_metadata"
msgstr ""
#: ../../source/configuration/settings.rst:2336
msgid ""
"This setting specifies whether or not Metadata can be provided when "
"launching an instance."
msgstr ""
#: ../../source/configuration/settings.rst:2340
msgid "enable_net_ports"
msgstr ""
#: ../../source/configuration/settings.rst:2346
msgid ""
"This setting specifies whether or not Network Ports can be selected when "
"launching an instance."
msgstr ""
#: ../../source/configuration/settings.rst:2350
msgid "default_availability_zone"
msgstr ""
#: ../../source/configuration/settings.rst:2354
msgid "Default: ``Any``"
msgstr ""
#: ../../source/configuration/settings.rst:2356
msgid ""
"This setting allows an administrator to specify a default availability zone "
"for a new server creation. The valid value is ``Any`` or availability zone "
"list. If ``Any`` is specified, the default availability zone is decided by "
"the nova scheduler. If one of availability zones is specified, the specified "
"availability zone is used as the default availability zone. If a value "
"specified in this setting is not found in the availability zone list, the "
"setting will be ignored and the behavior will be same as when ``Any`` is "
"specified."
msgstr ""
#: ../../source/configuration/settings.rst:2366
msgid "OPENSTACK_SERVER_DEFAULT_USER_DATA"
msgstr ""
#: ../../source/configuration/settings.rst:2370
#: ../../source/configuration/settings.rst:2727
#: ../../source/configuration/settings.rst:2741
msgid "Default: ``\"\"``"
msgstr ""
#: ../../source/configuration/settings.rst:2372
msgid ""
"An administrator can specify a default user data (e.g. comments or "
"instructions for cloudinit) via this settings. It can be a string or "
"template string that accepts a request object."
msgstr ""
#: ../../source/configuration/settings.rst:2377
msgid "OPENSTACK_ENABLE_PASSWORD_RETRIEVE"
msgstr ""
#: ../../source/configuration/settings.rst:2381
msgid "Default: ``\"False\"``"
msgstr ""
#: ../../source/configuration/settings.rst:2383
msgid ""
"When set, enables the instance action \"Retrieve password\" allowing "
"password retrieval from metadata service."
msgstr ""
#: ../../source/configuration/settings.rst:2387
msgid "OPENSTACK_HYPERVISOR_FEATURES"
msgstr ""
#: ../../source/configuration/settings.rst:2393
msgid ""
"``can_set_mount_point`` and ``can_set_password`` now default to ``False``"
msgstr ""
#: ../../source/configuration/settings.rst:2406
msgid ""
"A dictionary containing settings which can be used to identify the "
"capabilities of the hypervisor for Nova."
msgstr ""
#: ../../source/configuration/settings.rst:2409
msgid ""
"The Xen Hypervisor has the ability to set the mount point for volumes "
"attached to instances (other Hypervisors currently do not). Setting "
"``can_set_mount_point`` to ``True`` will add the option to set the mount "
"point from the UI."
msgstr ""
#: ../../source/configuration/settings.rst:2414
msgid ""
"Setting ``can_set_password`` to ``True`` will enable the option to set an "
"administrator password when launching or rebuilding an instance."
msgstr ""
#: ../../source/configuration/settings.rst:2417
msgid ""
"Setting ``requires_keypair`` to ``True`` will require users to select a key "
"pair when launching an instance."
msgstr ""
#: ../../source/configuration/settings.rst:2420
msgid ""
"Setting ``enable_quotas`` to ``False`` will make Horizon treat all Nova "
"quotas as disabled, thus it won't try to modify them. By default, quotas are "
"enabled."
msgstr ""
#: ../../source/configuration/settings.rst:2425
msgid "OPENSTACK_INSTANCE_RETRIEVE_IP_ADDRESSES"
msgstr ""
#: ../../source/configuration/settings.rst:2431
msgid ""
"This settings controls whether IP addresses of servers are retrieved from "
"neutron in the project instance table. Setting this to ``False`` may "
"mitigate a performance issue in the project instance table in large "
"deployments."
msgstr ""
#: ../../source/configuration/settings.rst:2435
msgid ""
"If your deployment has no support of floating IP like provider network "
"scenario, you can set this to ``False`` in most cases. If your deployment "
"supports floating IP, read the detail below and understand the under-the-"
"hood before setting this to ``False``."
msgstr ""
#: ../../source/configuration/settings.rst:2440
msgid ""
"Nova has a mechanism to cache network info but it is not fast enough in some "
"cases. For example, when a user associates a floating IP or updates an IP "
"address of an server port, it is not reflected to the nova network info "
"cache immediately. This means an action which a user makes from the horizon "
"instance table is not reflected into the table content just after the action."
" To avoid this, horizon retrieves IP address info from neutron when "
"retrieving a list of servers from nova."
msgstr ""
#: ../../source/configuration/settings.rst:2448
msgid ""
"On the other hand, this operation requires a full list of neutron ports and "
"can potentially lead to a performance issue in large deployments (:launchpad:"
"`bug 1722417`). This issue can be avoided by skipping "
"querying IP addresses to neutron and setting this to ``False`` achieves this."
" Note that when disabling the query to neutron it takes some time until "
"associated floating IPs are visible in the project instance table and users "
"may reload the table to check them."
msgstr ""
#: ../../source/configuration/settings.rst:2458
msgid "OPENSTACK_USE_SIMPLE_TENANT_USAGE"
msgstr ""
#: ../../source/configuration/settings.rst:2464
msgid ""
"This setting controls whether ``SimpleTenantUsage`` nova API is used in the "
"usage overview. According to feedbacks to the horizon team, the usage of "
"``SimpleTenantUsage`` can cause performance issues in the nova API in larger "
"deployments. Try to set this to ``False`` for such cases."
msgstr ""
#: ../../source/configuration/settings.rst:2470
msgid "Swift"
msgstr ""
#: ../../source/configuration/settings.rst:2473
msgid "SWIFT_FILE_TRANSFER_CHUNK_SIZE"
msgstr ""
#: ../../source/configuration/settings.rst:2477
msgid "Default: ``512 * 1024``"
msgstr ""
#: ../../source/configuration/settings.rst:2479
msgid ""
"This setting specifies the size of the chunk (in bytes) for downloading "
"objects from Swift. Do not make it very large (higher than several dozens of "
"Megabytes, exact number depends on your connection speed), otherwise you may "
"encounter socket timeout. The default value is 524288 bytes (or 512 "
"Kilobytes)."
msgstr ""
#: ../../source/configuration/settings.rst:2486
msgid "SWIFT_STORAGE_POLICY_DISPLAY_NAMES"
msgstr ""
#: ../../source/configuration/settings.rst:2492
msgid ""
"A dictionary mapping from the swift storage policy name to an alternate, "
"user friendly display name which will be rendered on the dashboard. If no "
"display is specified for a storage policy, the storage policy name will be "
"used verbatim."
msgstr ""
#: ../../source/configuration/settings.rst:2498
msgid "Django Settings"
msgstr ""
#: ../../source/configuration/settings.rst:2502
msgid ""
"This is not meant to be anywhere near a complete list of settings for Django."
" You should always consult the `upstream documentation `_, especially with regards to "
"deployment considerations and security best-practices."
msgstr ""
#: ../../source/configuration/settings.rst:2508
msgid "ADD_INSTALLED_APPS"
msgstr ""
#: ../../source/configuration/settings.rst:2514
msgid ""
"`Django's INSTALLED_APPS documentation `_"
msgstr ""
#: ../../source/configuration/settings.rst:2517
msgid ""
"A list of Django applications to be prepended to the ``INSTALLED_APPS`` "
"setting. Allows extending the list of installed applications without having "
"to override it completely."
msgstr ""
#: ../../source/configuration/settings.rst:2522
msgid "ALLOWED_HOSTS"
msgstr ""
#: ../../source/configuration/settings.rst:2528
msgid ""
"`Django's ALLOWED_HOSTS documentation `_"
msgstr ""
#: ../../source/configuration/settings.rst:2531
msgid "Default: ``['localhost']``"
msgstr ""
#: ../../source/configuration/settings.rst:2533
msgid ""
"This list should contain names (or IP addresses) of the host running the "
"dashboard; if it's being accessed via name, the DNS name (and probably short-"
"name) should be added, if it's accessed via IP address, that should be added."
" The setting may contain more than one entry."
msgstr ""
#: ../../source/configuration/settings.rst:2540
msgid ""
"ALLOWED_HOSTS is required. If Horizon is running in production (DEBUG is "
"False), set this with the list of host/domain names that the application can "
"serve. For more information see `Django's Allowed Hosts documentation `_"
msgstr ""
#: ../../source/configuration/settings.rst:2548
msgid "DEBUG"
msgstr ""
#: ../../source/configuration/settings.rst:2554
msgid ""
"`Django's DEBUG documentation `_"
msgstr ""
#: ../../source/configuration/settings.rst:2559
msgid ""
"Controls whether unhandled exceptions should generate a generic 500 response "
"or present the user with a pretty-formatted debug information page."
msgstr ""
#: ../../source/configuration/settings.rst:2562
msgid "When set, `CACHED_TEMPLATE_LOADERS`_ will not be cached."
msgstr ""
#: ../../source/configuration/settings.rst:2564
msgid ""
"This setting should **always** be set to ``False`` for production "
"deployments as the debug page can display sensitive information to users and "
"attackers alike."
msgstr ""
#: ../../source/configuration/settings.rst:2569
msgid "SECRET_KEY"
msgstr ""
#: ../../source/configuration/settings.rst:2575
msgid ""
"`Django's SECRET_KEY documentation `_"
msgstr ""
#: ../../source/configuration/settings.rst:2578
msgid ""
"This should absolutely be set to a unique (and secret) value for your "
"deployment. Unless you are running a load-balancer with multiple Horizon "
"installations behind it, each Horizon instance should have a unique secret "
"key."
msgstr ""
#: ../../source/configuration/settings.rst:2584
msgid "Setting a custom secret key:"
msgstr ""
#: ../../source/configuration/settings.rst:2586
msgid ""
"You can either set it to a specific value or you can let Horizon generate a "
"default secret key that is unique on this machine, regardless of the amount "
"of Python WSGI workers (if used behind Apache+mod_wsgi). However, there may "
"be situations where you would want to set this explicitly, e.g. when "
"multiple dashboard instances are distributed on different machines (usually "
"behind a load-balancer). Either you have to make sure that a session gets "
"all requests routed to the same dashboard instance or you set the same "
"SECRET_KEY for all of them."
msgstr ""
#: ../../source/configuration/settings.rst:2602
msgid ""
"The ``local_settings.py.example`` file includes a quick-and-easy way to "
"generate a secret key for a single installation."
msgstr ""
#: ../../source/configuration/settings.rst:2606
msgid "STATIC_ROOT"
msgstr ""
#: ../../source/configuration/settings.rst:2612
msgid ""
"`Django's STATIC_ROOT documentation `_"
msgstr ""
#: ../../source/configuration/settings.rst:2615
msgid "Default: ``/static``"
msgstr ""
#: ../../source/configuration/settings.rst:2617
msgid ""
"The absolute path to the directory where static files are collected when "
"collectstatic is run."
msgstr ""
#: ../../source/configuration/settings.rst:2621
msgid "STATIC_URL"
msgstr ""
#: ../../source/configuration/settings.rst:2627
msgid ""
"`Django's STATIC_URL documentation `_"
msgstr ""
#: ../../source/configuration/settings.rst:2630
msgid "Default: ``/static/``"
msgstr ""
#: ../../source/configuration/settings.rst:2632
msgid "URL that refers to files in `STATIC_ROOT`_."
msgstr ""
#: ../../source/configuration/settings.rst:2634
msgid "By default this value is ``WEBROOT/static/``."
msgstr ""
#: ../../source/configuration/settings.rst:2636
msgid ""
"This value can be changed from the default. When changed, the alias in your "
"webserver configuration should be updated to match."
msgstr ""
#: ../../source/configuration/settings.rst:2641
msgid "The value for STATIC_URL must end in '/'."
msgstr ""
#: ../../source/configuration/settings.rst:2643
msgid ""
"This value is also available in the scss namespace with the variable name "
"$static_url. Make sure you run ``python manage.py collectstatic`` and "
"``python manage.py compress`` after any changes to this value in settings.py."
""
msgstr ""
#: ../../source/configuration/settings.rst:2648
msgid "TEMPLATES"
msgstr ""
#: ../../source/configuration/settings.rst:2654
msgid ""
"`Django's TEMPLATES documentation `_"
msgstr ""
#: ../../source/configuration/settings.rst:2657
msgid ""
"Horizon's usage of the ``TEMPLATES`` involves 3 further settings below; it "
"is generally advised to use those before attempting to alter the "
"``TEMPLATES`` setting itself."
msgstr ""
#: ../../source/configuration/settings.rst:2662
msgid "ADD_TEMPLATE_DIRS"
msgstr ""
#: ../../source/configuration/settings.rst:2666
msgid ""
"Template directories defined here will be added to ``DIRS`` option of Django "
"``TEMPLATES`` setting. It is useful when you would like to load deployment-"
"specific templates."
msgstr ""
#: ../../source/configuration/settings.rst:2671
msgid "ADD_TEMPLATE_LOADERS"
msgstr ""
#: ../../source/configuration/settings.rst:2675
msgid ""
"Template loaders defined here will be loaded at the end of "
"`TEMPLATE_LOADERS`_, after the `CACHED_TEMPLATE_LOADERS`_ and will never "
"have a cached output."
msgstr ""
#: ../../source/configuration/settings.rst:2679
msgid "CACHED_TEMPLATE_LOADERS"
msgstr ""
#: ../../source/configuration/settings.rst:2683
msgid ""
"Template loaders defined here will have their output cached if `DEBUG`_ is "
"set to ``False``."
msgstr ""
#: ../../source/configuration/settings.rst:2687
msgid "TEMPLATE_LOADERS"
msgstr ""
#: ../../source/configuration/settings.rst:2691
msgid ""
"These template loaders will be the first loaders and get loaded before the "
"CACHED_TEMPLATE_LOADERS. Use ADD_TEMPLATE_LOADERS if you want to add loaders "
"at the end and not cache loaded templates. After the whole settings process "
"has gone through, TEMPLATE_LOADERS will be:"
msgstr ""
#: ../../source/configuration/settings.rst:2703
msgid "Other Settings"
msgstr ""
#: ../../source/configuration/settings.rst:2706
msgid "KUBECONFIG_ENABLED"
msgstr ""
#: ../../source/configuration/settings.rst:2712
msgid ""
"Kubernetes clusters can use Keystone as an external identity provider. "
"Horizon can generate a ``kubeconfig`` file from the application credentials "
"control panel which can be used for authenticating with a Kubernetes cluster."
" This setting enables this behavior."
msgstr ""
#: ../../source/configuration/settings.rst:2719
msgid ""
"`KUBECONFIG_KUBERNETES_URL`_ and `KUBECONFIG_CERTIFICATE_AUTHORITY_DATA`_ to "
"provide parameters for the ``kubeconfig`` file."
msgstr ""
#: ../../source/configuration/settings.rst:2723
msgid "KUBECONFIG_KUBERNETES_URL"
msgstr ""
#: ../../source/configuration/settings.rst:2729
msgid ""
"A Kubernetes API endpoint URL to be included in the generated ``kubeconfig`` "
"file."
msgstr ""
#: ../../source/configuration/settings.rst:2734
#: ../../source/configuration/settings.rst:2748
msgid "`KUBECONFIG_ENABLED`_ to enable the ``kubeconfig`` file generation."
msgstr ""
#: ../../source/configuration/settings.rst:2737
msgid "KUBECONFIG_CERTIFICATE_AUTHORITY_DATA"
msgstr ""
#: ../../source/configuration/settings.rst:2743
msgid ""
"Kubernetes API endpoint certificate authority data to be included in the "
"generated ``kubeconfig`` file."
msgstr ""
#: ../../source/configuration/settings.rst:2752
msgid "SYSTEM_SCOPE_SERVICES"
msgstr ""
#: ../../source/configuration/settings.rst:2757
msgid ""
"A list of names of services for which the system scope token should be used. "
"If empty, system scope will be removed from the context switching menu. If "
"not empty, the context switching menu will show a \"system scope\" option, "
"and the admin panels for the services listed will be moved to that context, "
"no longer showing up in the project context."
msgstr ""
#: ../../source/configuration/themes.rst:3
msgid "Themes"
msgstr ""
#: ../../source/configuration/themes.rst:5
msgid ""
"As of the Kilo release, styling for the OpenStack Dashboard can be altered "
"through the use of a theme. A theme is a directory containing a ``_variables."
"scss`` file to override the color codes used throughout the SCSS and a "
"``_styles.scss`` file with additional styles to load after dashboard styles "
"have loaded."
msgstr ""
#: ../../source/configuration/themes.rst:11
msgid ""
"As of the Mitaka release, Horizon can be configured to run with multiple "
"themes available at run time. It uses a browser cookie to allow users to "
"toggle between the configured themes. By default, Horizon is configured "
"with the two standard themes available: 'default' and 'material'."
msgstr ""
#: ../../source/configuration/themes.rst:16
msgid ""
"To configure or alter the available themes, set ``AVAILABLE_THEMES`` in "
"``local_settings.py`` to a list of tuples, such that ``('name', 'label', "
"'path')``"
msgstr ""
#: ../../source/configuration/themes.rst:21
msgid "The key by which the theme value is stored within the cookie"
msgstr ""
#: ../../source/configuration/themes.rst:21
msgid "``name``"
msgstr ""
#: ../../source/configuration/themes.rst:24
msgid "The label shown in the theme toggle under the User Menu"
msgstr ""
#: ../../source/configuration/themes.rst:24
msgid "``label``"
msgstr ""
#: ../../source/configuration/themes.rst:27
msgid ""
"The directory location for the theme. The path must be relative to the "
"``openstack_dashboard`` directory or an absolute path to an accessible "
"location on the file system"
msgstr ""
#: ../../source/configuration/themes.rst:29
msgid "``path``"
msgstr ""
#: ../../source/configuration/themes.rst:31
msgid ""
"To use a custom theme, set ``AVAILABLE_THEMES`` in ``local_settings.py`` to "
"a list of themes. If you wish to run in a mode similar to legacy Horizon, "
"set ``AVAILABLE_THEMES`` with a single tuple, and the theme toggle will not "
"be available at all through the application to allow user configuration "
"themes."
msgstr ""
#: ../../source/configuration/themes.rst:36
msgid "For example, a configuration with multiple themes::"
msgstr ""
#: ../../source/configuration/themes.rst:43
msgid "A configuration with a single theme::"
msgstr ""
#: ../../source/configuration/themes.rst:49
msgid ""
"Both the Dashboard custom variables and Bootstrap variables can be "
"overridden. For a full list of the Dashboard SCSS variables that can be "
"changed, see the variables file at ``openstack_dashboard/static/dashboard/"
"scss/_variables.scss``."
msgstr ""
#: ../../source/configuration/themes.rst:54
msgid ""
"In order to build a custom theme, both ``_variables.scss`` and ``_styles."
"scss`` are required and ``_variables.scss`` must provide all the default "
"Bootstrap variables."
msgstr ""
#: ../../source/configuration/themes.rst:59
msgid "Inherit from an Existing Theme"
msgstr ""
#: ../../source/configuration/themes.rst:61
msgid ""
"Custom themes must implement all of the Bootstrap variables required by "
"Horizon in ``_variables.scss`` and ``_styles.scss``. To make this easier, "
"you can inherit the variables needed in the default theme and only override "
"those that you need to customize. To inherit from the default theme, put "
"this in your theme's ``_variables.scss``::"
msgstr ""
#: ../../source/configuration/themes.rst:69
msgid ""
"Once you have made your changes you must re-generate the static files with:"
msgstr ""
#: ../../source/configuration/themes.rst:75
msgid ""
"By default, all of the themes configured by ``AVAILABLE_THEMES`` setting are "
"collected by horizon during the `collectstatic` process. By default, the "
"themes are collected into the dynamic `static/themes` directory, but this "
"location can be customized via the ``local_settings.py`` variable: "
"``THEME_COLLECTION_DIR``"
msgstr ""
#: ../../source/configuration/themes.rst:80
msgid ""
"Once collected, any theme configured via ``AVAILABLE_THEMES`` is available "
"to inherit from by importing its variables and styles from its collection "
"directory. The following is an example of inheriting from the material "
"theme::"
msgstr ""
#: ../../source/configuration/themes.rst:87
msgid ""
"All themes will need to be configured in ``AVAILABLE_THEMES`` to allow "
"inheritance. If you wish to inherit from a theme, but not show that theme "
"as a selectable option in the theme picker widget, then simply configure the "
"``SELECTABLE_THEMES`` to exclude the parent theme. ``SELECTABLE_THEMES`` "
"must be of the same format as ``AVAILABLE_THEMES``. It defaults to "
"``AVAILABLE_THEMES`` if it is not set explicitly."
msgstr ""
#: ../../source/configuration/themes.rst:95
msgid "Bootswatch"
msgstr ""
#: ../../source/configuration/themes.rst:97
msgid ""
"Horizon packages the Bootswatch SCSS files for use with its ``material`` "
"theme. Because of this, it is simple to use an existing Bootswatch theme as "
"a base. This is due to the fact that Bootswatch is loaded as a 3rd party "
"static asset, and therefore is automatically collected into the `static` "
"directory in `/horizon/lib/`. The following is an example of how to inherit "
"from Bootswatch's ``darkly`` theme::"
msgstr ""
#: ../../source/configuration/themes.rst:109
msgid "Organizing Your Theme Directory"
msgstr ""
#: ../../source/configuration/themes.rst:111
msgid ""
"A custom theme directory can be organized differently, depending on the "
"level of customization that is desired, as it can include static files as "
"well as Django templates. It can include special subdirectories that will "
"be used differently: ``static``, ``templates`` and ``img``."
msgstr ""
#: ../../source/configuration/themes.rst:117
msgid "The ``static`` Folder"
msgstr ""
#: ../../source/configuration/themes.rst:119
msgid ""
"If the theme folder contains a sub-folder called ``static``, then that sub "
"folder will be used as the **static root of the theme**. I.e., Horizon will "
"look in that sub-folder for the _variables.scss and _styles.scss files. The "
"contents of this folder will also be served up at ``/static/custom``."
msgstr ""
#: ../../source/configuration/themes.rst:125
msgid "The ``templates`` Folder"
msgstr ""
#: ../../source/configuration/themes.rst:127
msgid ""
"If the theme folder contains a sub-folder ``templates``, then the path to "
"that sub-folder will be prepended to the ``TEMPLATE_DIRS`` tuple to allow "
"for theme specific template customizations."
msgstr ""
#: ../../source/configuration/themes.rst:132
msgid "Using the ``templates`` Folder"
msgstr ""
#: ../../source/configuration/themes.rst:134
msgid ""
"Any Django template that is used in Horizon can be overridden through a "
"theme. This allows highly customized user experiences to exist within the "
"scope of different themes. Any template that is overridden must adhere to "
"the same directory structure that the extending template expects."
msgstr ""
#: ../../source/configuration/themes.rst:139
msgid ""
"For example, if you wish to customize the sidebar, Horizon expects the "
"template to live at ``horizon/_sidebar.html``. You would need to duplicate "
"that directory structure under your templates directory, such that your "
"override would live at ``{ theme_path }/templates/horizon/_sidebar.html``."
msgstr ""
#: ../../source/configuration/themes.rst:145
msgid "The ``img`` Folder"
msgstr ""
#: ../../source/configuration/themes.rst:147
msgid ""
"If the static root of the theme folder contains an ``img`` directory, then "
"all images that make use of the {% themable_asset %} templatetag can be "
"overridden."
msgstr ""
#: ../../source/configuration/themes.rst:151
msgid ""
"These assets include logo.svg, splash-logo.svg and favicon.ico, however "
"overriding the SVG/GIF assets used by Heat within the `dashboard/img` folder "
"is not currently supported."
msgstr ""
#: ../../source/configuration/themes.rst:156
msgid "Customizing the Logo"
msgstr ""
#: ../../source/configuration/themes.rst:159
msgid "Simple"
msgstr ""
#: ../../source/configuration/themes.rst:161
msgid ""
"If you wish to customize the logo that is used on the splash screen or in "
"the top navigation bar, then you need to create an ``img`` directory under "
"your theme's static root directory and place your custom ``logo.svg`` or "
"``logo-splash.svg`` within it."
msgstr ""
#: ../../source/configuration/themes.rst:166
msgid ""
"If you wish to override the ``logo.svg`` using the previous method, and if "
"the image used is larger than the height of the top navigation, then the "
"image will be constrained to fit within the height of nav. You can "
"customize the height of the top navigation bar by customizing the SCSS "
"variable: ``$navbar-height``. If the image's height is smaller than the "
"navbar height, then the image will retain its original resolution and size, "
"and simply be centered vertically in the available space."
msgstr ""
#: ../../source/configuration/themes.rst:174
msgid ""
"Prior to the Kilo release the images files inside of Horizon needed to be "
"replaced by your images files or the Horizon stylesheets needed to be "
"altered to point to the location of your image."
msgstr ""
#: ../../source/configuration/themes.rst:179
msgid "Advanced"
msgstr ""
#: ../../source/configuration/themes.rst:181
msgid ""
"If you need to do more to customize the logo than simply replacing the "
"existing SVG, then you can also override the _brand.html through a custom "
"theme. To use this technique, simply add a ``templates/header/_brand.html`` "
"to the root of your custom theme, and add markup directly to the file. For "
"an example of how to do this, see ``openstack_dashboard/themes/material/"
"templates/header/_brand.html``."
msgstr ""
#: ../../source/configuration/themes.rst:188
msgid ""
"The splash / login panel can also be customized by adding ``templates/auth/"
"_splash.html``. See ``openstack_dashboard/themes/material/templates/auth/"
"_splash.html`` for an example."
msgstr ""