Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

TroubleShooting Guide for students, later to transfer for DEVELOPER Guide.md as single source of truth #3759

Open
Aigerim-ai opened this issue Mar 31, 2023 · 2 comments
Labels
enhancement New feature or request OSCI Open Source Contributor Initiative

Comments

@Aigerim-ai
Copy link
Contributor

Aigerim-ai commented Mar 31, 2023

Dear Fellow Developers and Mentors,
Here I have collected all of the issues which appeared from current students at our program
Please add comments on this issue, if you had troubles with installing application and managed to solve the issue. We follow specific format - Error(with screenshots), Description, Solution

Error: There appears to be trouble with your network connection. Retrying...
Description: This error is because you have low speed network connection.
Try with —network-timeout 1000000:
Solution:
yarn osd bootstrap —network-timeout 1000000
Author: Alexei Karikov @Nicksqain

Error: max virtual memory areas vm.max_map_count [65530] is too low, increase to at least [262144]
Description: This error is because there is not enough memory so more memory must be allowed to be used
Solution: sudo sysctl -w vm.max_map_count=262144
For Windows:

  1. wsl -d docker-desktop

  2. sysctl -w vm.max_map_count=262144
    Author: Alexei Karikov @Nicksqain

Error: Execution failed for task 'server:compileJava'.
Description: This error can be caused by JDK 14.
Solved by changing runtime to JDK 11 or JDK 17.
Solution:
Change the RUNTIME_JAVA_HOME in /etc/environment by
sudo nano /etc/environment
Set the value pointing to JDK 11 or JDK 17 home directory
Example: RUNTIME_JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64
Author: Saadat Nursultan @nurSaadat

Error: server crashed
Description: Server crashes when we run yarn start:docker, after opening localhost server crashes
Solution: yarn osd clean, yarn osd bootstrap in your second terminal where docker container was opened, then run yarn opensearch snapshot
Solution 2: clearing cache helps
Author: Aigerim Suleimenova @Aigerim-ai

@Aigerim-ai Aigerim-ai added the enhancement New feature or request label Mar 31, 2023
@joshuarrrr joshuarrrr added OSCI Open Source Contributor Initiative and removed untriaged labels Mar 31, 2023
@joshuarrrr
Copy link
Member

@Aigerim-ai Thanks for compiling!

I added numbers to make it easier to reference them.

  1. Interesting finding - wasn't aware of this, and think it should be added to the developer guide
  2. Yep, this is a known limitation and should definitely be in the developer guide. The additional docker/windows details are a nice tip
  3. Definitely a good tip - one consideration in this one is whether it makes more sense to add this tip to the Opensearch repo instead of OpenSearch Dashboards
  4. It seems like this one has a root cause we may be able to fix in the docker setup itself

So 1. and 2. are definitely good candidates for PRs to the developer guide. For the others let's see if we can think of any solutions that strike closer to the root.

@Aigerim-ai
Copy link
Contributor Author

Hi! thank you for your reference numbers and your guidance, let me create one for Opensearch repo?
Can I have this issue open, in case there will be problems specifically for OpenSearch-Dashboards Developers guide.

@Nicksqain Nicksqain mentioned this issue Apr 1, 2023
10 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request OSCI Open Source Contributor Initiative
Projects
None yet
Development

No branches or pull requests

2 participants