mirror of
https://develop.openfoam.com/Development/openfoam.git
synced 2025-11-28 03:28:01 +00:00
CONFIG: refresh add-science-repo with gpg-auto-import-keys
DOC: mention debian as well as ubuntu. Mention v2306 in various places
Mark Olesen
@ -2,7 +2,7 @@
|
||||
# -----------------------------------------------------------------------------
|
||||
# Add openSUSE science repository
|
||||
#
|
||||
# Copyright (C) 2021-2022 OpenCFD Ltd.
|
||||
# Copyright (C) 2021-2023 OpenCFD Ltd.
|
||||
# SPDX-License-Identifier: (GPL-3.0+)
|
||||
#
|
||||
# Usage
|
||||
@ -42,7 +42,7 @@ fi
|
||||
|
||||
# Update
|
||||
echo -n "Running zypper refresh ${repo_name}... "
|
||||
zypper refresh "$repo_name"
|
||||
zypper -n --gpg-auto-import-keys refresh "$repo_name"
|
||||
|
||||
echo "$zypp_repo_file"
|
||||
echo
|
||||
|
||||
@ -18,7 +18,7 @@ Pre-compiled binaries are currently available for the following systems:
|
||||
|
||||
| System |
|
||||
|---------------|
|
||||
| [Ubuntu](/precompiled/debian) |
|
||||
| [Debian + **Ubuntu**](/precompiled/debian) |
|
||||
| [openSUSE](/precompiled/suse) |
|
||||
| [RedHat _derivatives_](/precompiled/redhat) |
|
||||
| [Windows](/precompiled/windows) |
|
||||
@ -68,6 +68,7 @@ until completion of a particular project.
|
||||
The system installation prefix `/usr/lib/openfoam` is used, below
|
||||
which individual versions are located.
|
||||
For example,
|
||||
- `/usr/lib/openfoam/openfoam2306/`
|
||||
- `/usr/lib/openfoam/openfoam2212/`
|
||||
- `/usr/lib/openfoam/openfoam2206/`
|
||||
- `/usr/lib/openfoam/openfoam2112/`
|
||||
@ -77,6 +78,7 @@ For example,
|
||||
|
||||
The OpenFOAM bash session wrapper will be created under `/usr/bin`.
|
||||
For example,
|
||||
- `/usr/bin/openfoam2306`
|
||||
- `/usr/bin/openfoam2212`
|
||||
- `/usr/bin/openfoam2206`
|
||||
- `/usr/bin/openfoam2112`
|
||||
@ -93,7 +95,7 @@ need"_ approach [more control, less diskspace]. Another group of users
|
||||
prefers the _"just install everything"_ approach [less control, more
|
||||
diskspace].
|
||||
We have attempted to strike a reasonable balance between both. For
|
||||
any given *base* package (e.g., `openfoam2212` etc), there are a variant
|
||||
any given *base* package (e.g., `openfoam2306` etc), there are a variant
|
||||
of sub-packages (_"only-what-I-need"_), but also a `default` package for
|
||||
the _"install-everything"_ folks.
|
||||
|
||||
@ -135,7 +137,7 @@ the same system, some installations use a meta-package structure:
|
||||
| openfoam2112 | The maintenance version for v2112 |
|
||||
| openfoam2106 | The maintenance version for v2106 |
|
||||
|
||||
The version-specific packages (eg, `openfoam2212`, `openfoam2206`, ...)
|
||||
The version-specific packages (eg, `openfoam2306`, `openfoam2212`, ...)
|
||||
install into distinct directories so that it is possible to have
|
||||
multiple versions available on your systems.
|
||||
The top-level `openfoam` package registers which of the
|
||||
@ -203,7 +205,7 @@ reference purposes, and to help when scripting:
|
||||
|
||||
----
|
||||
|
||||
Copyright (C) 2020-2022 OpenCFD Ltd.
|
||||
Copyright (C) 2020-2023 OpenCFD Ltd.
|
||||
|
||||
[foam-repo]: https://develop.openfoam.com/Development/openfoam/
|
||||
[foam-issues]: https://develop.openfoam.com/Development/openfoam/-/issues
|
||||
|
||||
@ -42,9 +42,9 @@ the container description files from the
|
||||
Select and edit the definitions to suit your purposes and build the
|
||||
image. For example,
|
||||
```
|
||||
apptainer build --fakeroot openfoam2212.sif openfoam-run_rocky.def
|
||||
apptainer build --fakeroot openfoam2306.sif openfoam-run_rocky.def
|
||||
```
|
||||
which will build the file `openfoam2212.sif` from the image
|
||||
which will build the file `openfoam2306.sif` from the image
|
||||
description file, using the [RockyLinux](rockylinux.org) base image.
|
||||
A `.sif` extension (singularity image format) is often used for the
|
||||
apptainer files but is not required.
|
||||
@ -69,7 +69,7 @@ path (eg, `$HOME/bin` etc) and use it.
|
||||
|
||||
For example,
|
||||
```
|
||||
$ openfoam2212.sif
|
||||
$ openfoam2306.sif
|
||||
```
|
||||
|
||||
This will open an interactive shell with the OpenFOAM environment
|
||||
@ -83,7 +83,7 @@ the default behaviour for the image and the internal run-script.
|
||||
|
||||
For example,
|
||||
```
|
||||
$ openfoam2212.sif
|
||||
$ openfoam2306.sif
|
||||
```
|
||||
|
||||
|
||||
@ -92,20 +92,20 @@ $ openfoam2212.sif
|
||||
It is also possible to use the image in batch mode.
|
||||
For example,
|
||||
```
|
||||
$ openfoam2212.sif blockMesh -help
|
||||
$ openfoam2306.sif blockMesh -help
|
||||
```
|
||||
|
||||
It is also possible to use as for running shell scripts.
|
||||
For example,
|
||||
```
|
||||
$ openfoam2212.sif -c './Allrun'
|
||||
$ openfoam2306.sif -c './Allrun'
|
||||
```
|
||||
|
||||
Note that the entry point within the image itself also has some option
|
||||
handling.
|
||||
For example,
|
||||
```
|
||||
$ openfoam2212.sif -help
|
||||
$ openfoam2306.sif -help
|
||||
```
|
||||
|
||||
|
||||
|
||||
@ -3,7 +3,7 @@
|
||||
[](/home)
|
||||
[](/precompiled)
|
||||
|
||||
_Precompiled packages (Ubuntu)_ <br>
|
||||
_Precompiled packages (Debian, Ubuntu)_ <br>
|
||||
***Quick-start***: <br>
|
||||
```
|
||||
# Add the repository
|
||||
@ -13,10 +13,10 @@ curl https://dl.openfoam.com/add-debian-repo.sh | sudo bash
|
||||
sudo apt-get update
|
||||
|
||||
# Install preferred package. Eg,
|
||||
sudo apt-get install openfoam2212-default
|
||||
sudo apt-get install openfoam2306-default
|
||||
|
||||
# Use the openfoam shell session. Eg,
|
||||
openfoam2212
|
||||
openfoam2306
|
||||
```
|
||||
|
||||
 The packages do ***not*** contain
|
||||
@ -29,7 +29,7 @@ see the [corresponding **FAQ**](/precompiled#frequently-asked-questions)
|
||||
[[_TOC_]]
|
||||
|
||||
|
||||
##  Ubuntu
|
||||
##  Debian / Ubuntu
|
||||
|
||||
For Debian and Ubuntu, OpenCFD works actively with the
|
||||
[Debian (science)](https://salsa.debian.org/science-team/)
|
||||
@ -39,10 +39,10 @@ For Linux newcomers: _Ubuntu_ is a _Debian_-derivative and thus its
|
||||
repositories invariably contain references to _deb_ or _debian_.
|
||||
|
||||
|
||||
###  OpenFOAM Ubuntu repository
|
||||
###  OpenFOAM repository
|
||||
<a name="debian-openfoam"></a>
|
||||
|
||||
To use the [OpenFOAM early-release Ubuntu repository](https://dl.openfoam.com/repos/deb),
|
||||
To use the [OpenFOAM early-release debian/ubuntu repository](https://dl.openfoam.com/repos/deb),
|
||||
you will need to add the signing key and the repository location(s) to your system.
|
||||
This typically only needs to be done once per distribution.
|
||||
The most convenient way is to use the
|
||||
@ -58,7 +58,7 @@ which conveniently [bundles several operations](#description-install-script).
|
||||
After this you should immediately be able to install your preferred
|
||||
OpenFOAM package. For example,
|
||||
```
|
||||
sudo apt-get install openfoam2212-default
|
||||
sudo apt-get install openfoam2306-default
|
||||
```
|
||||
If your Ubuntu installation is a somewhat older, you may also need to
|
||||
update the signing certificates first:
|
||||
@ -69,7 +69,7 @@ sudo apt-get update
|
||||
After migrating from one version to another, you can remove the old
|
||||
version with the usual commands. For example,
|
||||
```
|
||||
sudo apt-get autoremove openfoam2212-default
|
||||
sudo apt-get autoremove openfoam2306-default
|
||||
```
|
||||
|
||||
### Supported versions and distributions
|
||||
@ -93,9 +93,9 @@ descriptions, the following represent typical installation commands:
|
||||
|
||||
|User Group | Command |
|
||||
|---------------|------------------|
|
||||
| minimalist | `sudo apt-get install openfoam2212` |
|
||||
| traditional | `sudo apt-get install openfoam2212-dev` |
|
||||
| everything | `sudo apt-get install openfoam2212-default` |
|
||||
| minimalist | `sudo apt-get install openfoam2306` |
|
||||
| traditional | `sudo apt-get install openfoam2306-dev` |
|
||||
| everything | `sudo apt-get install openfoam2306-default` |
|
||||
|
||||
|
||||
### Installation locations
|
||||
@ -112,7 +112,7 @@ As documented in [precompiled packages - OpenFOAM environment](/precompiled#envi
|
||||
|
||||
After adding the repositories and installing a particular version of
|
||||
OpenFOAM, upgrade notifications should also appear
|
||||
(for example for `openfoam2212`):
|
||||
(for example for `openfoam2306`):
|
||||
|
||||
|
||||
|
||||
@ -155,7 +155,7 @@ export WM_PROJECT_DIR=/usr/share/openfoam
|
||||
which means you should immediately be able to install
|
||||
your preferred OpenFOAM package. For example,
|
||||
```
|
||||
sudo apt-get install openfoam2212-default
|
||||
sudo apt-get install openfoam2306-default
|
||||
```
|
||||
|
||||
- <em>Cannot find MPI library</em><br/>
|
||||
|
||||
@ -64,7 +64,7 @@ corresponding [packaging/containers][packaging-containers] files.
|
||||
OpenFOAM versions and image _flavours_. For example,
|
||||
```
|
||||
$ chmod +x openfoam-docker
|
||||
$ ln -sf openfoam-docker openfoam2212-run
|
||||
$ ln -sf openfoam-docker openfoam2306-run
|
||||
```
|
||||
- Verify that the script (or link) can be executed,
|
||||
and take a look at some of the available options:
|
||||
@ -85,7 +85,7 @@ been made, calling it without any arguments will bind in the local
|
||||
directory and start the image with an OpenFOAM environment.
|
||||
Eg,
|
||||
```
|
||||
$ openfoam2212-run
|
||||
$ openfoam2306-run
|
||||
```
|
||||
|
||||
This will open an interactive shell with the OpenFOAM environment
|
||||
@ -186,9 +186,9 @@ Some possible commands after installing (Linux only):
|
||||
shows the local images available. For example,
|
||||
```
|
||||
REPOSITORY TAG IMAGE ID CREATED SIZE
|
||||
opencfd/openfoam-run 2212 abcxxxxxxxxx N days ago 640MB
|
||||
opencfd/openfoam-run 2306 abcxxxxxxxxx N days ago 640MB
|
||||
opencfd/openfoam-run latest abcxxxxxxxxx N days ago 640MB
|
||||
opencfd/openfoam-dev 2212 defxxxxxxxxx N days ago 1.38GB
|
||||
opencfd/openfoam-dev 2306 defxxxxxxxxx N days ago 1.38GB
|
||||
opencfd/openfoam-dev latest defxxxxxxxxx N days ago 1.38GB
|
||||
...
|
||||
```
|
||||
|
||||
@ -13,7 +13,7 @@ see the [corresponding **FAQ**](/precompiled#frequently-asked-questions)
|
||||
[[_TOC_]]
|
||||
|
||||
|
||||
##  CentOS/RedHat/Rocky/Fedora
|
||||
##  Rocky/Fedora/CentOS/RedHat
|
||||
|
||||
For RedHat-based systems, OpenCFD Ltd. current uses the
|
||||
[_copr_](https://copr.fedorainfracloud.org/) infrastructure to provide
|
||||
@ -77,9 +77,9 @@ descriptions, the following represent typical installation commands:
|
||||
|
||||
|User Group | Command |
|
||||
|---------------|------------------|
|
||||
| minimalist | `sudo yum install openfoam2212` |
|
||||
| traditional | `sudo yum install openfoam2212-devel` |
|
||||
| everything | `sudo yum install openfoam2212-default` |
|
||||
| minimalist | `sudo yum install openfoam2306` |
|
||||
| traditional | `sudo yum install openfoam2306-devel` |
|
||||
| everything | `sudo yum install openfoam2306-default` |
|
||||
|
||||
|
||||
### Installation locations
|
||||
@ -100,7 +100,7 @@ As documented in [precompiled packages - OpenFOAM environment](/precompiled#envi
|
||||
|
||||
|
||||
---
|
||||
Copyright (C) 2020-2022 OpenCFD Ltd.
|
||||
Copyright (C) 2020-2023 OpenCFD Ltd.
|
||||
|
||||
[link paraview]: https://www.paraview.org/download/
|
||||
[faq paraview]: https://discourse.paraview.org/t/i-want-to-visualize-my-openfoam-simulation-results-with-paraview-but-im-confused-which-version-should-i-use
|
||||
|
||||
@ -12,10 +12,10 @@ _Precompiled packages (openSUSE)_ <br>
|
||||
sudo zypper refresh
|
||||
|
||||
# Install preferred package. Eg,
|
||||
sudo zypper install openfoam2212-default
|
||||
sudo zypper install openfoam2306-default
|
||||
|
||||
# Use the openfoam shell session. Eg,
|
||||
openfoam2212
|
||||
openfoam2306
|
||||
```
|
||||
|
||||
 The packages do ***not*** contain
|
||||
@ -40,7 +40,7 @@ https://software.opensuse.org//download.html?project=science&package=openfoam
|
||||
and follow the instructions there.
|
||||
Note that this is a meta-package and individual version downloads are also possible.
|
||||
For example,
|
||||
https://software.opensuse.org//download.html?project=science&package=openfoam2212
|
||||
https://software.opensuse.org//download.html?project=science&package=openfoam2306
|
||||
|
||||
If you already have the _Science_ repository registered on your system,
|
||||
you should be able to install it directly with `zypper`:
|
||||
@ -69,9 +69,9 @@ descriptions, the following represent typical installation commands:
|
||||
|
||||
|User Group | Command |
|
||||
|---------------|------------------|
|
||||
| minimalist | `sudo zypper install openfoam2212` |
|
||||
| traditional | `sudo zypper install openfoam2212-devel` |
|
||||
| everything | `sudo zypper install openfoam2212-default` |
|
||||
| minimalist | `sudo zypper install openfoam2306` |
|
||||
| traditional | `sudo zypper install openfoam2306-devel` |
|
||||
| everything | `sudo zypper install openfoam2306-default` |
|
||||
|
||||
|
||||
### Installation locations
|
||||
|
||||
@ -21,10 +21,11 @@ openfoam
|
||||
openfoam2112
|
||||
openfoam2206
|
||||
openfoam2212
|
||||
openfoam2306
|
||||
```
|
||||
To set a particular version
|
||||
```
|
||||
$ openfoam-selector --set openfoam2206
|
||||
$ openfoam-selector --set openfoam2306
|
||||
```
|
||||
To query the current selection:
|
||||
```
|
||||
@ -44,9 +45,9 @@ next full login. This is to avoid a possible clash of environments
|
||||
when a parallel job still being launched. Of course, you can still
|
||||
simply source the corresponding `bashrc` file directly. For example,
|
||||
```
|
||||
$ source /usr/lib/openfoam/openfoam2206/etc/bashrc
|
||||
$ source /usr/lib/openfoam/openfoam2306/etc/bashrc
|
||||
```
|
||||
|
||||
----
|
||||
|
||||
Copyright (C) 2020-2022 OpenCFD Ltd.
|
||||
Copyright (C) 2020-2023 OpenCFD Ltd.
|
||||
|
||||
@ -12,7 +12,8 @@
|
||||
Depending on your packaging system (or system administrator),
|
||||
various OpenFOAM shell sessions may be available. For example,
|
||||
```
|
||||
/usr/bin/openfoam -> openfoam2212
|
||||
/usr/bin/openfoam -> openfoam2306
|
||||
/usr/bin/openfoam2306
|
||||
/usr/bin/openfoam2212
|
||||
/usr/bin/openfoam2206
|
||||
/usr/bin/openfoam2112
|
||||
@ -22,7 +23,7 @@ can be used for an _interactive_ bash session, or to run a single
|
||||
OpenFOAM command within the OpenFOAM environment.
|
||||
|
||||
Using the `-help` option for the respective shell session
|
||||
(e.g., `openfoam2212 -help`) displays some useful information.
|
||||
(e.g., `openfoam2306 -help`) displays some useful information.
|
||||
|
||||
|
||||
## Purpose
|
||||
@ -48,14 +49,14 @@ For example,
|
||||
```
|
||||
$ openfoam
|
||||
|
||||
* Using: OpenFOAM-2212 (2212) - visit www.openfoam.com
|
||||
* Using: OpenFOAM-2306 (2306) - visit www.openfoam.com
|
||||
* Build: ...
|
||||
* Arch: label=32;scalar=64
|
||||
* Platform: linux64GccDPInt32Opt (mpi=sys-openmpi)
|
||||
|
||||
OpenFOAM shell session - use 'exit' to quit
|
||||
|
||||
openfoam2212:~/
|
||||
openfoam2306:~/
|
||||
mark$
|
||||
```
|
||||
|
||||
@ -86,9 +87,9 @@ It is also possible to execute arbitrary shell sequences with the
|
||||
well-known `-c` option. For example,
|
||||
|
||||
```
|
||||
$ openfoam2212 -c 'echo "openfoam=$WM_PROJECT_DIR uses $WM_OPTIONS"'
|
||||
$ openfoam2306 -c 'echo "openfoam=$WM_PROJECT_DIR uses $WM_OPTIONS"'
|
||||
```
|
||||
yields: `openfoam=/usr/lib/openfoam/openfoam2212 uses linux64GccDPInt32Opt`
|
||||
yields: `openfoam=/usr/lib/openfoam/openfoam2306 uses linux64GccDPInt32Opt`
|
||||
|
||||
|
||||
## Notes
|
||||
@ -100,4 +101,4 @@ yields: `openfoam=/usr/lib/openfoam/openfoam2212 uses linux64GccDPInt32Opt`
|
||||
|
||||
----
|
||||
|
||||
Copyright (C) 2020-2022 OpenCFD Ltd.
|
||||
Copyright (C) 2020-2023 OpenCFD Ltd.
|
||||
|
||||
Reference in New Issue
Block a user