@@ -19,6 +19,7 @@ answers for frequently asked questions.
1919* <<trb-security-kerberos>>
2020* <<trb-security-internalserver>>
2121* <<trb-security-setup>>
22+ * <<trb-security-path>>
2223
2324
2425To get help, see <<help>>.
@@ -512,3 +513,35 @@ Alternatively, set the `xpack.security.http.ssl.enabled` setting to `true`.
512513
513514For more information about these settings, see
514515{ref}/security-settings.html[Security Settings in {es}].
516+
517+ [[trb-security-path]]
518+ === Failures due to relocation of the configuration files
519+
520+ *Symptoms:*
521+
522+ * Active Directory or LDAP realms might stop working after upgrading to {es} 6.3
523+ or later releases. In 6.4 or later releases, you might see messages in the {es}
524+ log that indicate a config file is in a deprecated location.
525+
526+ *Resolution:*
527+
528+ By default, in 6.2 and earlier releases, the
529+ <<security-files,security configuration files>> are located in the
530+ `ES_PATH_CONF/x-pack` directory, where `ES_PATH_CONF` is an environment
531+ variable that defines the location of the
532+ {ref}/settings.html#config-files-location[config directory].
533+
534+ In 6.3 and later releases, the config directory no longer contains an `x-pack`
535+ directory. The files that were stored in this folder, such as the
536+ `log4js.properties`, `role_mapping.yml`, `roles.yml`, `users`, and `users_roles`
537+ files, now exist directly in the config directory.
538+
539+ IMPORTANT: If you upgraded to 6.3 or later releases, your old security
540+ configuration files still exist in an `x-pack` folder. That file path is
541+ deprecated, however, and you should move your files out of that folder.
542+
543+ In 6.3 and later releases, settings such as `files.role_mapping` default to
544+ `ES_PATH_CONF/role_mapping.yml`. If you do not want to use the default locations,
545+ you must update the settings appropriately. See
546+ {ref}/security-settings.html[Security settings in {es}].
547+
0 commit comments