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.

Sign up for GitHub

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

Update system guides #179

Merged
merged 15 commits into from
Aug 13, 2022
Merged

Update system guides #179

Show file tree
Hide file tree
Changes from 4 commits
Commits
Show all changes
15 commits
Select commit Hold shift + click to select a range
403ecae
Remove Ubuntu 16.04, add warning for 18.04
MakisH Jul 4, 2022
ff0e636
System guides: Add hint for Ubuntu 22.04
MakisH Jul 4, 2022
00f9be6
Update Ubuntu version in CalculiX adapter, add hint
MakisH Jul 4, 2022
3edfdf4
Installation-packages: Bump Ubuntu version
MakisH Jul 4, 2022
2c9cd21
Update installation instructions on OpenSUSE
boris-martin Jul 5, 2022
16168be
Update installation-source-dependencies.md
boris-martin Jul 5, 2022
098b8de
Update Fedora dependencies guide
MakisH Jul 5, 2022
1cf8977
Fedora: document hdf5-openmpi-devel
MakisH Aug 9, 2022
21fa86c
Swap Ubuntu 22.04 and 20.04
MakisH Aug 9, 2022
9b22abf
Update macOS instructions
MakisH Aug 9, 2022
236e254
Update CentOS guides
MakisH Aug 9, 2022
27366d2
Merge branch 'master' into update-system-guides
MakisH Aug 9, 2022
6075dc8
Add Rocky Linux 9
MakisH Aug 10, 2022
7fbbca3
Merge branch 'update-system-guides' of github.com:precice/precice.git…
MakisH Aug 10, 2022
cd3351e
Fix Markdown
MakisH Aug 10, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 7 additions & 3 deletions pages/docs/adapters/calculix/adapter-calculix-get-adapter.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,15 +13,19 @@ There are two ways to get the adapter: (a) get a binary package (Ubuntu-only), o

You can download version-specific Ubuntu (Debian) packages from each [adapter release](https://github.com/precice/calculix-adapter/releases/latest). To install, simply open it in your software center.

Alternatively, download & install it from the command line. For Ubuntu 20.04 (focal):
Alternatively, download & install it from the command line. For Ubuntu 22.04 (jammy):

```bash
wget https://github.com/precice/calculix-adapter/releases/download/v{{ site.calculix_adapter_version }}/calculix-precice2_{{ site.calculix_adapter_version }}-1_amd64_focal.deb
sudo apt install ./calculix-precice2_{{ site.calculix_adapter_version }}-1_amd64_focal.deb
wget https://github.com/precice/calculix-adapter/releases/download/v{{ site.calculix_adapter_version }}/calculix-precice2_{{ site.calculix_adapter_version }}-1_amd64_jammy.deb
sudo apt install ./calculix-precice2_{{ site.calculix_adapter_version }}-1_amd64_jammy.deb
```
MakisH marked this conversation as resolved.
Show resolved Hide resolved

This requires that also preCICE itself has been installed from a Debian package.

{% tip %}
Replace `jammy` with `focal` to get the package for Ubuntu 20.04.
{% endtip %}

{% note %}
We started offering Debian packages for the CalculiX adapter since v2.19.0. Please [give us your feedback](community-channels.html)!
{% endnote %}
Expand Down
10 changes: 5 additions & 5 deletions pages/docs/installation/installation-packages.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,18 +12,18 @@ This section lists systems and instructions on how to install these packages.
You can download version-specific Ubuntu (Debian) packages from each [GitHub release](https://github.com/precice/precice/releases/latest).
To install, simply open it in your software center.

Alternatively, download & install it from the command line. For **Ubuntu 20.04 (focal)**:
Alternatively, download & install it from the command line. For **Ubuntu 22.04 (jammy)**:

```bash
wget https://github.com/precice/precice/releases/download/v{{ site.precice_version }}/libprecice2_{{ site.precice_version }}_focal.deb
sudo apt install ./libprecice2_{{ site.precice_version }}_focal.deb
wget https://github.com/precice/precice/releases/download/v{{ site.precice_version }}/libprecice2_{{ site.precice_version }}_jammy.deb
sudo apt install ./libprecice2_{{ site.precice_version }}_jammy.deb
```
MakisH marked this conversation as resolved.
Show resolved Hide resolved

We support the latest two Ubuntu LTS versions, as well as the latest normal Ubuntu release.
Check the [official release-cyle](https://ubuntu.com/about/release-cycle) for more information and the version code names.
As an example, change `focal` to `hirsute` for 21.04, `groovy` for 20.10, or to `bionic` for 18.04.
As an example, change `jammy` to `focal` for 20.04.

Is a newer preCICE release out and we have not yet updated the above links? Please [edit this page](https://github.com/precice/precice.github.io_future/blob/master/pages/docs/installation/installation-packages.md).
Is a newer preCICE release out and we have not yet updated the above links? Please edit this page.

## Arch Linux / Manjaro

Expand Down
28 changes: 8 additions & 20 deletions pages/docs/installation/installation-source-dependencies.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -262,6 +262,10 @@ If you want build preCICE on your own computer and you are using one of the foll

Other modern versions of popular Linux distributions are also perfectly compatible, here we just list a few popular options. Since our users have tried preCICE on various distributions, you may as well ask on our [forum](https://precice.discourse.group/) for any questions.

### Ubuntu 22.04 LTS Jammy Jellyfish

Follow the instructions as for Ubuntu 20.04.
MakisH marked this conversation as resolved.
Show resolved Hide resolved

### Ubuntu 20.04 LTS Focal Fossa

With every release, we also ship [binary packages for Ubuntu 20.04](https://github.com/precice/precice/releases). However, if you still want to build from source, everything is available through the distribution's repositories:
Expand All @@ -275,6 +279,10 @@ The same instructions apply for later Ubuntu releases.

### Ubuntu 18.04 Bionic Beaver

{% warning %}
The last release of preCICE to support Ubuntu 18.04 was [preCICE v2.3.0](https://github.com/precice/precice/releases/tag/v2.3.0).
{% endwarning %}

With every release, we also ship [binary packages for Ubuntu 18.04](https://github.com/precice/precice/releases).
However, if you still want to build from source, almost everything is available through the distribution's repositories:

Expand All @@ -286,26 +294,6 @@ sudo apt install build-essential cmake libeigen3-dev libxml2-dev libboost-all-de
If you don't plan to use RBF mappings in large parallel cases you can continue without installing PETSc and build with `-DPRECICE_PETScMapping=OFF`.
If you need PETSc, follow the steps in the [PETSc](#petsc) section and you are done.

### Ubuntu 16.04 Xenial Xerus

In Ubuntu 16.04, only a fraction of packages is available through the distribution's repositories.
Further packages needs to be build from source.
First install the available packages:

```bash
sudo apt update && \
sudo apt install build-essential g++-5 libxml2-dev python3-dev python3-numpy
```

Next, you need to install [CMake](#cmake), [Eigen](#eigen) and [boost](#boost) as descibed in their respective sections.

If you don't plan to use RBF mappings in large parallel cases you can continue without installing PETSc and [build with `-DPRECICE_PETScMapping=OFF`](Building:-Using-CMake#options).
If you need PETSc, follow the steps in the [PETSc](#petsc) section and you are done.

{% note %}
The repositories contain a package `libeigen3-dev`, however, unsing it results in [issues with nearest-projection mapping](https://github.com/precice/precice/issues/603#issuecomment-573139840).
{% endnote %}

### Debian 11 Bullseye

Everything is available from the distribution's repositories:
Expand Down