diff --git a/docs/_content/installation.md b/docs/_content/installation.md index 4744194..9a418a1 100644 --- a/docs/_content/installation.md +++ b/docs/_content/installation.md @@ -65,7 +65,7 @@ so make sure your computer is online at that time. *In order to successfuly build eAST it is mandatory that you set the options listed below when using `cmake` to build Geant4*. As you can see from the table, if you start from scratch you may need to install the prerequisits first such as X11, Qt5, OpenGL and Xerces-C++ libraries. -Please see the [Appendix](/content/installation.html#appendix-geant4-dependencies) for comments and some practical +Please see the [Appendix](/content/installation.html#appendix) for comments and some practical advice about how to proceed. @@ -147,15 +147,17 @@ path the the HepMC3 libraries. This can be done after sourcing the Geant4 --- -## Appendix (GEANT4 dependencies) +## Appendix -### Xerces +### GEANT4 dependencies + +#### Xerces The [Xerces build and intallation webpage](https://xerces.apache.org/xerces-c/build-3.html#UNIXl){:target="_blank"} mentions cmake -- although the latter is not explicitly invoked, and you only need to run `configure` and `make`. Read the web page carefully. -### Qt +#### Qt The Qt installation procedure has evolved over the years. Using the GUI installer provided by the developer appears to frequently cause problems. At the time of writing, @@ -168,13 +170,13 @@ sudo apt-get -y install build-essential openssl libssl-dev libssl1.0 libgl1-mesa sudo apt-get install qtbase5-dev sudo apt-get install qtdeclarative5-dev ``` -### libxmu +#### libxmu ```bash sudo apt-get install -y libxmu-dev ``` -### Passing options to "make" +#### Passing options to "make" On many Linux platforms, `cmake` is relying on `make` for the build step. It is possible in these cases to pass helpful options (such as use multiple cores @@ -184,4 +186,13 @@ for compilation) to `make` by setting an environment variable: export MAKEFLAGS=-j4 ``` +### Running Geant4 graphics under WSL2 + +In some cases an extra step is needed to get the graphics driver to work correctly, +for example in WSL2 the following setting is helpful: + +```bash +export LIBGL_ALWAYS_INDIRECT= +``` + diff --git a/docs/_content/manual.md b/docs/_content/manual.md index 8edf176..072c906 100644 --- a/docs/_content/manual.md +++ b/docs/_content/manual.md @@ -14,7 +14,7 @@ name: manual --- -## Setting up the environemt +## Setting up the environment * Source the Geant4 [post-installation script](https://geant4-userdoc.web.cern.ch/UsersGuides/InstallationGuide/html/postinstall.html){:target="_blank"}. * Add the location of the _HepMC3_ libraries to the environment variable `LD_LIBRARY_PATH` @@ -29,6 +29,12 @@ export LD_LIBRARY_PATH=/opt/hepmc3/lib:$LD_LIBRARY_PATH export PATH=/opt/east/bin/:$PATH ``` +When using WSL2 and requiring graphics capability in Geant4, the following setting +helps to get the graphcis working correctly: +```bash +export LIBGL_ALWAYS_INDIRECT= +``` + ## Starting eAST *eAST* runs both in batch mode and interactive mode. To run it in batch mode, execute the application with a macro file,