... | ... | @@ -27,7 +27,7 @@ For Debian and Ubuntu, OpenCFD works actively with the |
|
|
[Debian (science)](https://salsa.debian.org/science-team/)
|
|
|
maintainers to [improve the packaging](https://salsa.debian.org/science-team/openfoam),
|
|
|
but also provides its own [early-release Ubuntu repository](https://dl.openfoam.com/repos/deb)
|
|
|
For Linux newcomers, note Ubuntu _is_ a Debian-derivative and thus its
|
|
|
For Linux newcomers: _Ubuntu_ is a _Debian_-derivative and thus its
|
|
|
repositories invariably contain references to _deb_ or _debian_.
|
|
|
|
|
|
|
... | ... | @@ -46,25 +46,17 @@ curl -s https://dl.openfoam.com/add-debian-repo.sh | sudo bash |
|
|
```
|
|
|
wget -q -O - https://dl.openfoam.com/add-debian-repo.sh | sudo bash
|
|
|
```
|
|
|
|
|
|
This performs three things:
|
|
|
|
|
|
1. Adds the https://dl.openfoam.com/pubkey.gpg signing key for the repository
|
|
|
2. Adds repository information for a given distribution (eg, _buster_, _focal_, etc.):
|
|
|
```
|
|
|
deb [arch=amd64] https://dl.openfoam.com/repos/deb DIST main
|
|
|
which conveniently [bundles several operations](#description-install-script).
|
|
|
After this you should immediately be able to install your preferred
|
|
|
OpenFOAM package. For example,
|
|
|
```
|
|
|
3. Invokes `apt-get update` to refresh the repositories,
|
|
|
which means you should immediately be able to install
|
|
|
your preferred OpenFOAM package. For example,
|
|
|
```
|
|
|
sudo apt-get install openfoam2106-default
|
|
|
sudo apt-get install openfoam2112-default
|
|
|
```
|
|
|
|
|
|
After migrating from one version to another, you can remove the old
|
|
|
version with the usual commands. For example,
|
|
|
```
|
|
|
sudo apt-get autoremove openfoam2106-default
|
|
|
sudo apt-get autoremove openfoam2112-default
|
|
|
```
|
|
|
|
|
|
### Supported versions and distributions
|
... | ... | @@ -88,9 +80,9 @@ descriptions, the following represent typical installation commands: |
|
|
|
|
|
|User Group | Command |
|
|
|
|---------------|------------------|
|
|
|
| minimalist | `sudo apt-get install openfoam2106` |
|
|
|
| traditional | `sudo apt-get install openfoam2106-dev` |
|
|
|
| everything | `sudo apt-get install openfoam2106-default` |
|
|
|
| minimalist | `sudo apt-get install openfoam2112` |
|
|
|
| traditional | `sudo apt-get install openfoam2112-dev` |
|
|
|
| everything | `sudo apt-get install openfoam2112-default` |
|
|
|
|
|
|
|
|
|
### Installation locations
|
... | ... | @@ -135,38 +127,52 @@ export WM_PROJECT_DIR=/usr/share/openfoam |
|
|
- Archived [installer script](/packaging/debian/add-debian-repo.sh) contents that should appear on dl.openfoam.com/
|
|
|
|
|
|
|
|
|
## Known problems
|
|
|
|
|
|
### Cannot find MPI library
|
|
|
|
|
|
This is a [very strange issue](https://develop.openfoam.com/Development/openfoam/-/issues/1817#note_49023)
|
|
|
in which the Ubuntu triggers fails to properly link the mpi libraries.
|
|
|
|
|
|
Contents for `libopenmpi-dev` exist:
|
|
|
```
|
|
|
$ dpkg-query -L libopenmpi-dev | grep libmpi
|
|
|
|
|
|
/usr/lib/x86_64-linux-gnu/openmpi/lib/libmpi.so
|
|
|
/usr/lib/x86_64-linux-gnu/openmpi/lib/libmpi_cxx.so
|
|
|
...
|
|
|
```
|
|
|
Reverse lookup is also correct:
|
|
|
```
|
|
|
$ dpkg-query -S /usr/lib/x86_64-linux-gnu/openmpi/lib/libmpi.so
|
|
|
|
|
|
libopenmpi-dev:amd64: /usr/lib/x86_64-linux-gnu/openmpi/lib/libmpi.so
|
|
|
```
|
|
|
Except that ***none*** of the links actually exist on the regular
|
|
|
Ubuntu install (the docker install is OK for some unknown reason).
|
|
|
_It appears that the triggers for `libopenmpi-dev` might be run too soon._
|
|
|
|
|
|
The following brute-force method (there might be a cleaner way) seems
|
|
|
to work to retrigger things properly.
|
|
|
```
|
|
|
$ sudo dpkg --remove --force-all libopenmpi-dev
|
|
|
$ sudo apt install libopenmpi-dev
|
|
|
```
|
|
|
After this all of the `.so` links exist as expected.
|
|
|
## Frequently Asked Questions
|
|
|
|
|
|
- <em>What does the [installer script](https://dl.openfoam.com/add-debian-repo.sh)
|
|
|
actually do?</em><br/>
|
|
|
<a name="description-install-script"></a>
|
|
|
- Adds the https://dl.openfoam.com/pubkey.gpg signing key for the repository
|
|
|
- Adds repository information for a given distribution (eg, _buster_, _focal_, etc.):
|
|
|
```
|
|
|
deb [arch=amd64] https://dl.openfoam.com/repos/deb DIST main
|
|
|
```
|
|
|
- Invokes `apt-get update` to refresh the repositories,
|
|
|
which means you should immediately be able to install
|
|
|
your preferred OpenFOAM package. For example,
|
|
|
```
|
|
|
sudo apt-get install openfoam2112-default
|
|
|
```
|
|
|
|
|
|
- <em>Cannot find MPI library</em><br/>
|
|
|
This is a [very strange issue](https://develop.openfoam.com/Development/openfoam/-/issues/1817#note_49023)
|
|
|
in which the Ubuntu triggers fails to properly link the mpi libraries.
|
|
|
|
|
|
The contents for `libopenmpi-dev` exist:
|
|
|
```
|
|
|
$ dpkg-query -L libopenmpi-dev | grep libmpi
|
|
|
|
|
|
/usr/lib/x86_64-linux-gnu/openmpi/lib/libmpi.so
|
|
|
/usr/lib/x86_64-linux-gnu/openmpi/lib/libmpi_cxx.so
|
|
|
...
|
|
|
```
|
|
|
Reverse lookup is also correct:
|
|
|
```
|
|
|
$ dpkg-query -S /usr/lib/x86_64-linux-gnu/openmpi/lib/libmpi.so
|
|
|
|
|
|
libopenmpi-dev:amd64: /usr/lib/x86_64-linux-gnu/openmpi/lib/libmpi.so
|
|
|
```
|
|
|
Except that ***none*** of the links actually exist on the regular
|
|
|
Ubuntu install (the docker install is OK for some unknown reason).
|
|
|
_It appears that the triggers for `libopenmpi-dev` might be run too soon._
|
|
|
|
|
|
The following brute-force method (there might be a cleaner way) seems
|
|
|
to work to retrigger things properly.
|
|
|
```
|
|
|
$ sudo dpkg --remove --force-all libopenmpi-dev
|
|
|
$ sudo apt install libopenmpi-dev
|
|
|
```
|
|
|
After this all of the `.so` links exist as expected.
|
|
|
|
|
|
|
|
|
---
|
... | ... | |