Skip to content

Commit bc94cc1

Browse files
authored
Add entitlements known issues (#127061)
Add 2 known issues with workarounds for Entitlements.
1 parent 7e5dafa commit bc94cc1

File tree

1 file changed

+20
-0
lines changed

1 file changed

+20
-0
lines changed

docs/release-notes/known-issues.md

+20
Original file line numberDiff line numberDiff line change
@@ -7,3 +7,23 @@ mapped_pages:
77
# Elasticsearch known issues [elasticsearch-known-issues]
88
Known issues are significant defects or limitations that may impact your implementation. These issues are actively being worked on and will be addressed in a future release. Review the Elasticsearch known issues to help you make informed decisions, such as upgrading to a new version.
99

10+
## 9.0.0 [elasticsearch-9.0.0-known-issues]
11+
* Elasticsearch on Windows might fail to start, or might forbid some file-related operations, when referencing paths with a case different from the one stored by the filesystem. Windows treats paths as case-insensitive, but the filesystem stores them with case. Entitlements, the new security system used by Elasticsearch, treat all paths as case-sensitive, and can therefore prevent access to a path that should be accessible.
12+
13+
For example: If Elasticsearch is installed in `C:\ELK\elasticsearch`, and you try to launch it as `c:\elk\elasticsearch\bin\elasticsearch.bat`, you will get a `NotEntitledException` while booting. This is because Elasticsearch blocks access to `c:\elk\elasticsearch`, because does not match `C:\ELK\elasticsearch`. \
14+
This issue will be fixed in a future patch release (see [PR #126990](https://github.com./elastic/elasticsearch/pull/126990)).
15+
16+
As a workaround, make sure that all paths you specify have the same casing as the paths stored in the filesystem. Files and directory names should be entered as they appear in Windows Explorer or in a command prompt. This applies to paths specified in the command line, config files, environment variables and secure settings.
17+
18+
* Active Directory authentication is blocked by default. Entitlements, the new security system used by Elasticsearch, has a policy for the `x-pack-core` module that is too restrictive, and does not allow the LDAP library used for AD authentication to perform outbound network connections. This issue will be fixed in a future patch release (see [PR #126992](https://github.com./elastic/elasticsearch/pull/126992)).
19+
20+
As a workaround, you can temporarily patch the policy using a JVM option:
21+
22+
1. Create a file called `${ES_CONF_PATH}/jvm_options/workaround-127061.options`.
23+
2. Add the following line to the new file:
24+
25+
```
26+
-Des.entitlements.policy.x-pack-core=dmVyc2lvbnM6CiAgLSA4LjE4LjAKICAtIDkuMC4wCnBvbGljeToKICB1bmJvdW5kaWQubGRhcHNkazoKICAgIC0gc2V0X2h0dHBzX2Nvbm5lY3Rpb25fcHJvcGVydGllcwogICAgLSBvdXRib3VuZF9uZXR3b3Jr
27+
```
28+
29+
For information about editing your JVM settings, refer to [JVM settings](https://www.elastic.co/docs/reference/elasticsearch/jvm-settings).

0 commit comments

Comments
 (0)