Skip to content

Commit 0f2e06d

Browse files
committed
[DOCS] Add security troubleshooting item
1 parent 7b5b3f9 commit 0f2e06d

File tree

1 file changed

+33
-0
lines changed

1 file changed

+33
-0
lines changed

docs/en/stack/security/troubleshooting.asciidoc

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -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

2425
To get help, see <<help>>.
@@ -512,3 +513,35 @@ Alternatively, set the `xpack.security.http.ssl.enabled` setting to `true`.
512513

513514
For 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

Comments
 (0)