Skip to content
Snippets Groups Projects
Commit 4e0222f8 authored by Mark OLESEN's avatar Mark OLESEN Committed by Andrew Heather
Browse files

DOC: relocated OpenFOAM etc/README.md to doc/Config.md 

- relocated BuildIssues.txt -> doc/BuildIssues.md
parent f05ff817
Branches
Tags
No related merge requests found
Hide whitespace changes
Inline Side-by-side
README.md
+ 2
− 2
View file @ 4e0222f8
...@@ -33,9 +33,9 @@ Please see the relevant guides: ...@@ -33,9 +33,9 @@ Please see the relevant guides:
[repo openfoam]: https://develop.openfoam.com/Development/OpenFOAM-plus/ [repo openfoam]: https://develop.openfoam.com/Development/OpenFOAM-plus/
[repo third]: https://develop.openfoam.com/Development/ThirdParty-plus/ [repo third]: https://develop.openfoam.com/Development/ThirdParty-plus/
[link openfoam-issues]: https://develop.openfoam.com/Development/OpenFOAM-plus/blob/develop/BuildIssues.txt
[link openfoam-readme]: https://develop.openfoam.com/Development/OpenFOAM-plus/blob/develop/README.md [link openfoam-readme]: https://develop.openfoam.com/Development/OpenFOAM-plus/blob/develop/README.md
[link openfoam-config]: https://develop.openfoam.com/Development/OpenFOAM-plus/blob/develop/etc/README.md [link openfoam-issues]: https://develop.openfoam.com/Development/OpenFOAM-plus/blob/develop/doc/BuildIssues.md
[link openfoam-config]: https://develop.openfoam.com/Development/OpenFOAM-plus/blob/develop/doc/Config.md
[link openfoam-build]: https://develop.openfoam.com/Development/OpenFOAM-plus/blob/develop/doc/Build.md [link openfoam-build]: https://develop.openfoam.com/Development/OpenFOAM-plus/blob/develop/doc/Build.md
[link openfoam-require]: https://develop.openfoam.com/Development/OpenFOAM-plus/blob/develop/doc/Requirements.md [link openfoam-require]: https://develop.openfoam.com/Development/OpenFOAM-plus/blob/develop/doc/Requirements.md
[link third-readme]: https://develop.openfoam.com/Development/ThirdParty-plus/blob/develop/README.md [link third-readme]: https://develop.openfoam.com/Development/ThirdParty-plus/blob/develop/README.md
......
doc/Build.md
+ 8
− 6
View file @ 4e0222f8
...@@ -15,7 +15,8 @@ The [third-party][repo third] directory includes a ...@@ -15,7 +15,8 @@ The [third-party][repo third] directory includes a
[build guide][link third-build]. [build guide][link third-build].
Some known build issues related to specific compiler and VTK library versions Some known build issues related to specific compiler and VTK library versions
can be found in the [$WM_PROJECT_DIR/BuildIssues.txt][link openfoam-issues] file. can be found in the [$WM_PROJECT_DIR/doc/BuildIssues.md][link openfoam-issues]
file.
If you need to change the default versions for third-party libraries, If you need to change the default versions for third-party libraries,
or use system libraries for some components, please some additional or use system libraries for some components, please some additional
...@@ -94,10 +95,10 @@ simpleFoam ...@@ -94,10 +95,10 @@ simpleFoam
OpenFOAM ships with ParaView sources for post-processing OpenFOAM OpenFOAM ships with ParaView sources for post-processing OpenFOAM
field results. However, the paraview version distributed with field results. However, the paraview version distributed with
the operating system or a [binary package][download ParaView] the operating system or a [binary package][download ParaView]
will be sufficient, and avoids additional compilation complexity. will often be sufficient, and avoids additional compilation complexity.
If do you wish to compile ParaView from sources, it is recommended If you do wish to compile ParaView from source, it is recommended
that you do so *after* completing an initial compilation of OpenFOAM. that you do so ***after*** completing an initial compilation of OpenFOAM.
This gets the process started much more quickly. At a later stage, This gets the process started much more quickly. At a later stage,
OpenFOAM can be updated to compile with paraview. Only the affected OpenFOAM can be updated to compile with paraview. Only the affected
applications will be compiled (eg, the blockMesh reader module) and the applications will be compiled (eg, the blockMesh reader module) and the
...@@ -123,8 +124,9 @@ More details in the [ThirdParty build guide][link third-build]. ...@@ -123,8 +124,9 @@ More details in the [ThirdParty build guide][link third-build].
[repo openfoam]: https://develop.openfoam.com/Development/OpenFOAM-plus/ [repo openfoam]: https://develop.openfoam.com/Development/OpenFOAM-plus/
[repo third]: https://develop.openfoam.com/Development/ThirdParty-plus/ [repo third]: https://develop.openfoam.com/Development/ThirdParty-plus/
[link openfoam-issues]: https://develop.openfoam.com/Development/OpenFOAM-plus/blob/develop/BuildIssues.txt [link openfoam-readme]: https://develop.openfoam.com/Development/OpenFOAM-plus/blob/develop/README.md
[link openfoam-config]: https://develop.openfoam.com/Development/OpenFOAM-plus/blob/develop/etc/README.md [link openfoam-issues]: https://develop.openfoam.com/Development/OpenFOAM-plus/blob/develop/doc/BuildIssues.md
[link openfoam-config]: https://develop.openfoam.com/Development/OpenFOAM-plus/blob/develop/doc/Config.md
[link openfoam-build]: https://develop.openfoam.com/Development/OpenFOAM-plus/blob/develop/doc/Build.md [link openfoam-build]: https://develop.openfoam.com/Development/OpenFOAM-plus/blob/develop/doc/Build.md
[link openfoam-require]: https://develop.openfoam.com/Development/OpenFOAM-plus/blob/develop/doc/Requirements.md [link openfoam-require]: https://develop.openfoam.com/Development/OpenFOAM-plus/blob/develop/doc/Requirements.md
[link third-readme]: https://develop.openfoam.com/Development/ThirdParty-plus/blob/develop/README.md [link third-readme]: https://develop.openfoam.com/Development/ThirdParty-plus/blob/develop/README.md
......
BuildIssues.txt → doc/BuildIssues.md
+ 111
− 0
View file @ 4e0222f8
OpenFOAM-1712 ## Known Build Issues (OpenFOAM-v1906)
==================
Known Build Issues
==================
--------------------- ### Intel MPI with Gcc/Clang)
Intel MPI (Gcc/Clang)
---------------------
Either I_MPI_ROOT or MPI_ROOT can be used to specify the Intel-MPI Either `I_MPI_ROOT` (preferred) or `MPI_ROOT` can be used to specify
installation directory path. the Intel-MPI installation directory path.
The ThirdParty build of ptscotch uses `mpiicc` for Intel-MPI instead
of the usual `mpicc`. When gcc or clang are used, it is quite likely
that the `I_MPI_CC` environment variable also needs to be set
accordingly.
See `mpiicc -help` for more information about environment variables.
The ThirdParty build of ptscotch uses `mpiicc` for Intel-MPI
instead of the usual `mpicc`.
When gcc or clang are used, it is highly likely that the
I_MPI_CC environment variable also needs to be set accordingly.
See `mpiicc -help` for more information about environment variables. ### VTK
--------------
Intel Compiler
--------------
Since OpenFOAM uses C++11, a fairly recent version is required.
The Intel compiler - icc (ICC) 17.0.1 20161005 is ok, but the
initial release - icc (ICC) 17.0.0 20160721 - has a bug that
will result in these types of error messages.
MatrixSpaceI.H(492): error: no instance of overloaded function
"Foam::MatrixSpace<Form, Cmpt, Mrows, Ncols>::Block<SubTensor,
BRowStart, BColStart>::operator=" matches the specified type
---
VTK
---
If using the runTimePostProcessing to create on-the-fly images, you If using the runTimePostProcessing to create on-the-fly images, you
can simply just compile ParaView and these libraries will be used. can simply just compile ParaView and these libraries will be used.
If you elect to use a separate VTK compilation (for example for If you elect to use a separate VTK compilation (for example for
off-screen rendering), it is advisable to reuse the VTK libraries that off-screen rendering), it is advisable to reuse the VTK libraries that
are provided with ParaView by making an appropriate symlink are provided with ParaView by making an appropriate symlink
prior to using makeVTK. This doesn't just reduce disk-space, but works prior to using makeVTK. This doesn't just reduce disk-space, but works
much better than using the VTK tar file. much better than using the VTK tar file.
Using runTimePostProcessing with the 'plain' VTK libraries does Using runTimePostProcessing with the *plain* VTK libraries does
generally work, but does not exit cleanly: generally work, but may not exit cleanly:
```
symbol lookup error: .../linux64Gcc/VTK-7.1.0/lib/libvtkCommonExecutionModel-7.1.so.1:
undefined symbol: _ZN33vtkFilteringInformationKeyManager13ClassFinalizeEv
symbol lookup error: .../linux64Gcc/VTK-7.1.0/lib/libvtkCommonExecutionModel-7.1.so.1: symbol lookup error: .../linux64Gcc/VTK-7.1.0/lib/libvtkCommonDataModel-7.1.so.1:
undefined symbol: _ZN33vtkFilteringInformationKeyManager13ClassFinalizeEv undefined symbol: _ZN49vtkInformationQuadratureSchemeDefinitionVectorKeyD1Ev
```
symbol lookup error: .../linux64Gcc/VTK-7.1.0/lib/libvtkCommonDataModel-7.1.so.1: This error appears to be suppressed if VTK is compiled with a `Debug` build-type.
undefined symbol: _ZN49vtkInformationQuadratureSchemeDefinitionVectorKeyD1Ev
This error appears to be suppressed if VTK is compiled with a Debug build-type.
### Building on older systems
-------------------------
Building on older systems
-------------------------
If the system gcc is too old for building OpenFOAM, a third-party gcc or If the system gcc is too old for building OpenFOAM, a third-party gcc or
clang/llvm installation can be used. If building clang/llvm, note that clang/llvm installation can be used. If building clang/llvm, note that
there are also minimum gcc/g++ requirements there: there are also minimum gcc/g++ requirements as listed in the
detailed [build guide][link third-build].
Min gcc/g++
=========== ==========
4.4 llvm-3.4.2
4.7 llvm-3.5.2 - llvm-3.7.0
If your system compiler is too old to build the minimum required gcc or If your system compiler is too old to build the minimum required gcc or
clang/llvm, it is just simply too old. clang/llvm, it is just simply too old.
--------------------------------- ### ThirdParty clang without gmp/mpfr
ThirdParty clang without gmp/mpfr
---------------------------------
If using ThirdParty clang without gmp/mpfr, the ThirdParty makeCGAL If using ThirdParty clang without gmp/mpfr, the ThirdParty makeCGAL
script will need to be run manually and specify that there is no script will need to be run manually and specify that there is no
gmp/mpfr. Eg, gmp/mpfr. Eg,
```
cd $WM_THIRD_PARTY_DIR cd $WM_THIRD_PARTY_DIR
./makeCGAL gmp-none mpfr-none ./makeCGAL gmp-none mpfr-none
```
Subequent compilation with Allwmake will now run largely without any Subequent compilation with Allwmake will now run largely without any
problems, except that the components linking against CGAL problems, except that the components linking against CGAL
(foamyMesh and surfaceBooleanFeatures) will also try to link against (foamyMesh and surfaceBooleanFeatures) will also try to link against
a nonexistent mpfr library. As a workaround, the link-dependency can a nonexistent mpfr library. As a workaround, the link-dependency can
be removed in wmake/rules/General/CGAL : be removed in wmake/rules/General/CGAL :
```
CGAL_LIBS = \
-L$(BOOST_ARCH_PATH)/lib \
-L$(BOOST_ARCH_PATH)/lib$(WM_COMPILER_LIB_ARCH) \
-L$(CGAL_ARCH_PATH)/lib \
-L$(CGAL_ARCH_PATH)/lib$(WM_COMPILER_LIB_ARCH) \
-lCGAL
```
CGAL_LIBS = \ A robuster solution is still being sought.
-L$(BOOST_ARCH_PATH)/lib \
-L$(BOOST_ARCH_PATH)/lib$(WM_COMPILER_LIB_ARCH) \
-L$(CGAL_ARCH_PATH)/lib \
-L$(CGAL_ARCH_PATH)/lib$(WM_COMPILER_LIB_ARCH) \
-lCGAL
This is a temporary inconvenience until a more robust solution is found.
------------------------- ### Building with spack
Building with spack
-------------------------
If you are building with spack, note that the depends_on for paraview If you are building with spack, note that the `depends_on` for paraview
resolves poorly. The +qt dependency (for building the reader module) resolves poorly. The `+qt` dependency (for building the reader module)
may need to be specified as a preference by including the following in may need to be specified as a preference by including the following in
your `~/.spack/packages.yaml` file: your `~/.spack/packages.yaml` file:
```
packages:
paraview:
variants: +qt
```
It appears that spack will otherwise ignore any `paraview+qt` version
and attempt to install a `paraview~qt` version instead.
packages: --
paraview: <!-- Links -->
variants: +qt
It appears that spack will otherwise ignore any paraview+qt version [page ParaView]: http://www.paraview.org/
and attempt to install a paraview~qt version instead. [download ParaView]: https://www.paraview.org/download/
--
<!-- OpenFOAM -->
[repo openfoam]: https://develop.openfoam.com/Development/OpenFOAM-plus/
[repo third]: https://develop.openfoam.com/Development/ThirdParty-plus/
[link openfoam-readme]: https://develop.openfoam.com/Development/OpenFOAM-plus/blob/develop/README.md
[link openfoam-issues]: https://develop.openfoam.com/Development/OpenFOAM-plus/blob/develop/doc/BuildIssues.md
[link openfoam-config]: https://develop.openfoam.com/Development/OpenFOAM-plus/blob/develop/doc/Config.md
[link openfoam-build]: https://develop.openfoam.com/Development/OpenFOAM-plus/blob/develop/doc/Build.md
[link openfoam-require]: https://develop.openfoam.com/Development/OpenFOAM-plus/blob/develop/doc/Requirements.md
[link third-readme]: https://develop.openfoam.com/Development/ThirdParty-plus/blob/develop/README.md
[link third-build]: https://develop.openfoam.com/Development/ThirdParty-plus/blob/develop/BUILD.md
[link third-require]: https://develop.openfoam.com/Development/ThirdParty-plus/blob/develop/Requirements.md
---
Copyright 2019 OpenCFD Ltd
etc/README.md → doc/Config.md
+ 0
− 0
View file @ 4e0222f8
File moved
doc/Requirements.md
+ 7
− 2
View file @ 4e0222f8
...@@ -10,15 +10,21 @@ OpenFOAM requires a functioning C++11 compiler and `make` build toolchain. ...@@ -10,15 +10,21 @@ OpenFOAM requires a functioning C++11 compiler and `make` build toolchain.
- fftw: 3.3.7 (recommended - required for FFT-related functionality) - fftw: 3.3.7 (recommended - required for FFT-related functionality)
- paraview: 5.5.2 (for visualization) - paraview: 5.5.2 (for visualization)
If using the Intel&reg; compiler, `17.0.1 20161005` is the minimum
usable version.
To check the installed versions To check the installed versions
| Program | To check the version | | Program | To check the version |
|---------------|-----------------------| |---------------|-----------------------|
| gcc | gcc --version | | gcc | gcc --version |
| icc | icc --version |
| cmake | cmake --version | | cmake | cmake --version |
| openmpi | orterun --version | | openmpi | orterun --version |
### Additional utilities ### Additional utilities
- flex - flex
...@@ -81,7 +87,6 @@ sudo zypper install cmake boost-devel mpfr-devel gmp-devel openmpi-devel gnuplot ...@@ -81,7 +87,6 @@ sudo zypper install cmake boost-devel mpfr-devel gmp-devel openmpi-devel gnuplot
This installs This installs
| Program | openSUSE | Program version | | Program | openSUSE | Program version |
|-----------|-----------|-----------------| |-----------|-----------|-----------------|
| gcc | 15.0 | 7.4.3 | | gcc | 15.0 | 7.4.3 |
...@@ -157,7 +162,7 @@ A partial list is given in the [ThirdParty requirements][link third-require]. ...@@ -157,7 +162,7 @@ A partial list is given in the [ThirdParty requirements][link third-require].
<!-- OpenFOAM --> <!-- OpenFOAM -->
[link openfoam-readme]: https://develop.openfoam.com/Development/OpenFOAM-plus/blob/develop/README.md [link openfoam-readme]: https://develop.openfoam.com/Development/OpenFOAM-plus/blob/develop/README.md
[link openfoam-config]: https://develop.openfoam.com/Development/OpenFOAM-plus/blob/develop/etc/README.md [link openfoam-config]: https://develop.openfoam.com/Development/OpenFOAM-plus/blob/develop/doc/Config.md
[link openfoam-build]: https://develop.openfoam.com/Development/OpenFOAM-plus/blob/develop/doc/Build.md [link openfoam-build]: https://develop.openfoam.com/Development/OpenFOAM-plus/blob/develop/doc/Build.md
[link openfoam-require]: https://develop.openfoam.com/Development/OpenFOAM-plus/blob/develop/doc/Requirements.md [link openfoam-require]: https://develop.openfoam.com/Development/OpenFOAM-plus/blob/develop/doc/Requirements.md
[link third-readme]: https://develop.openfoam.com/Development/ThirdParty-plus/blob/develop/README.md [link third-readme]: https://develop.openfoam.com/Development/ThirdParty-plus/blob/develop/README.md
......
etc/config.csh/vtk
+ 1
− 1
View file @ 4e0222f8
...@@ -25,7 +25,7 @@ ...@@ -25,7 +25,7 @@
# #
# It is recommended to use VTK sources from ParaView (5.0.1 or later) # It is recommended to use VTK sources from ParaView (5.0.1 or later)
# #
# See BuildIssues.txt about problems that can be encountered when using # See doc/BuildIssues.md about problems that can be encountered when using
# the 'plain' VTK sources. # the 'plain' VTK sources.
#------------------------------------------------------------------------------ #------------------------------------------------------------------------------
# USER EDITABLE PART: Changes made here may be lost with the next upgrade # USER EDITABLE PART: Changes made here may be lost with the next upgrade
......
etc/config.sh/vtk
+ 1
− 1
View file @ 4e0222f8
...@@ -26,7 +26,7 @@ ...@@ -26,7 +26,7 @@
# #
# It is recommended to use VTK sources from ParaView (5.0.1 or later) # It is recommended to use VTK sources from ParaView (5.0.1 or later)
# #
# See BuildIssues.txt about problems that can be encountered when using # See doc/BuildIssues.md about problems that can be encountered when using
# the 'plain' VTK sources. # the 'plain' VTK sources.
#------------------------------------------------------------------------------ #------------------------------------------------------------------------------
# USER EDITABLE PART: Changes made here may be lost with the next upgrade # USER EDITABLE PART: Changes made here may be lost with the next upgrade
......
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Please register or to comment