@@ -19,6 +19,7 @@ answers for frequently asked questions.
19
19
* <<trb-security-kerberos>>
20
20
* <<trb-security-internalserver>>
21
21
* <<trb-security-setup>>
22
+ * <<trb-security-path>>
22
23
23
24
24
25
To get help, see <<help>>.
@@ -512,3 +513,35 @@ Alternatively, set the `xpack.security.http.ssl.enabled` setting to `true`.
512
513
513
514
For more information about these settings, see
514
515
{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