User Tools

Site Tools

:: Version 2.6.0 ::

2_6_0:admin:configuration_editor

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

2_6_0:admin:configuration_editor [2019/01/09 16:40] (current)
Line 1: Line 1:
 +====== Configuration Editor ======
  
 +Newcomers should read the [[2_6_0:​admin:​settings|Configuration overview]]
 +
 +Check this page for **[[2_6_0:​admin:​itop_configuration_file|usage of all parameters]]** which can be set within this file.
 +
 +<note tip>Some parameters are brought by some extensions/​plugins and therefore are not mentionned in this reference guide.</​note>​
 +
 +===== Online editor =====
 +
 +This tool **is available only to the iTop administrators**.
 +It is a shortcut to edit the configuration file ''<​itop-root>/​conf/​production/​config-itop''​.
 +This tool also secures the process in that the changes will not be saved if any syntax error is found.
 +
 +<note important>​It is highly recommended to keep a copy of the configuration file prior to doing any change.</​note>​
 +
 +<note warning>​Do NOT edit the lower part of the file. This part starts with the comment: ''​Data model modules to be loaded''​.</​note>​
 +
 +<note warning>​Some changes made in the configuration may cause iTop to be inoperant. In such a case, right after the change is submitted, you would get an error, and it would not be possible to access this GUI to rollback your changes. The settings that are the most sensitive are the credentials to the MySQL server.</​note>​
 +
 +<note tip>​Since the iTop configuration is stored - and processed - as a PHP document, PHP code injection //is// possible via the configuration editor. If you think that letting iTop administrators interactively edit the configuration file is too risky (for example if iTop is installed on a server shared with other applications),​ you can completely disable the interactive configuration editor. To disable the interactive editor, set the following configuration parameter (in the '​module_settings'​ section of the configuration file):
 +
 +<​code>​
 +'​itop-config'​ => array(
 +    '​config_editor'​ => '​disabled',​
 +)
 +</​code>​
 +
 +</​note>​
 +
 +
 +The editor is accessible from the "Admin tools / Configuration"​ menu:
 +
 +{{ config-menu.png?​nolink |}}
 +
 +It has syntax hightlighting and some 
 +
 +{{ config-editor.png?​nolink |}}
 +
 +Here are the possible actions :
 +
 +  * Find using Ctrl+F
 +  * Find and replace using Ctrl+H
 +  * **Apply** button or Ctrl+S shortcut to save
 +  * The **Reset** button reloads the page and the config to its persisted state (discard non persisted changes)
 +
 +If a syntax error is found, save cannot be done, and an annotation is displayed on each concerned lines :
 +
 +{{ config-issue.png?​nolink |}}
 +
 +<note tip>​Sometimes,​ the typo resides one line above the incriminated line.</​note>​
 +
 +Upon saving, and if no syntax error is encountered,​ then a green banner is shown:
 +
 +{{ config-ok.png?​nolink |}}
 +
 +<note warning>​Note that the new configuration takes effect when a page gets loaded again. So in order to see the effect of the modified configuration you have to navigate to another page in iTop.</​note>​
2_6_0/admin/configuration_editor.txt ยท Last modified: 2019/01/09 16:40 (external edit)

";