installation update authored by Kummer, Florian's avatar Kummer, Florian
......@@ -26,15 +26,18 @@ The advantage of C#, resp. .NET is that _the executable is platform-independent_
### Windows
To install on Windows:
1. Download and install [.NET6 SDK](https://dotnet.microsoft.com/download/dotnet/6.0)
1. Download and install
[.NET6 SDK](https://dotnet.microsoft.com/download/dotnet/6.0)
2. Execute the BoSSS Windows installer.
Afterwards, you can [test the installation](#testing-the-installation).
The BoSSS installer already includes all required native libraries and prerequisites. These are:
1. Microsoft Visual C++ Redistributable (x64)
2. [Microsoft MPI](https://msdn.microsoft.com/en-us/library/bb524831(v=vs.85).aspx). Check the MPI installation by executing the command `mpiexec` in a console window
3. ~~The~~ [~~.NET framework~~](https://www.microsoft.com/net/download/framework) ~~is installed The BoSSS Installer checks whether these components are in place and installs them, if required. In the case of some problem, one can also download and install these items manually.~~
2. [Microsoft MPI](https://msdn.microsoft.com/en-us/library/bb524831(v=vs.85).aspx).
Check the MPI installation by executing the command `mpiexec` in a console window.
3. ~~The~~ [~~.NET framework~~](https://www.microsoft.com/net/download/framework)
~~is installed The BoSSS Installer checks whether these components are in place and installs them, if required. In the case of some problem, one can also download and install these items manually.~~
### Linux
......@@ -42,13 +45,21 @@ The BoSSS group maintains basic packages of the [native libraries](#notes-on-thi
The steps for installing BoSSS on Linux are:
1. Extensive notes on the installation of .NET [here](/bosss1/experimental/-/wikis/Getting-Started/NET5-Upgrade#installation-of-net-5-in-linux); In short: Download and install [.NET6 SDK](https://dotnet.microsoft.com/download/dotnet/6.0), see also <https://docs.microsoft.com/de-de/dotnet/core/install/linux> for the most recent versions and best practices for your system. ~~Obtain~~ [~~Mono~~](https://fdy-tuda.openproject.com/www.mono-project.com) ~~(version 6.0 or higher), either by installing a~~ [~~pre-built package~~](https://fdy-tuda.openproject.com/www.mono-project.com/download/) ~~or by~~ [~~compiling~~](https://fdy-tuda.openproject.com/www.mono-project.com/docs/compiling-mono/linux/) ~~it from a~~ [~~tarball~~](https://download.mono-project.com/sources/mono/)~~.~~
1. Extensive notes on the installation of
.NET [here](/NET6-Upgrade#installation-of-net-6-in-linux); In short: Download and install [.NET6 SDK](https://dotnet.microsoft.com/download/dotnet/6.0), see also <https://docs.microsoft.com/de-de/dotnet/core/install/linux> for the most recent versions and best practices for your system. ~~Obtain~~ [~~Mono~~](https://fdy-tuda.openproject.com/www.mono-project.com) ~~(version 6.0 or higher), either by installing a~~ [~~pre-built package~~](https://fdy-tuda.openproject.com/www.mono-project.com/download/) ~~or by~~ [~~compiling~~](https://fdy-tuda.openproject.com/www.mono-project.com/docs/compiling-mono/linux/) ~~it from a~~ [~~tarball~~](https://download.mono-project.com/sources/mono/)~~.~~
2. Obtain/install/load OpenMPI
3. Obtain/install/load native libraries `libBoSSSnative_seq.so`, `libBoSSSnative_omp.so` and `libBoSSSnative_mpi.so` \* Pre-compiled versions of these shared libraries for Linux can be found in the Windows installation, in the directory `$BOSSS_INSTALL/bin/native/linux/amd64-openmpi`. (There should also be a `zip`-File that you can unpack on any system.) \* If these pre-build libraries are not compatible with your system (we do our best, but binary compatibility across distributions is quite difficult on Linux), you will need to compile them yourself, the source code can be found at <https://github.com/FDYdarmstadt/BoSSS-native>, resp. <https://git.rwth-aachen.de/kummer/BoSSS-native>
### Mac OS X
Since Mac OS X is a Unix system, most things should work similar to Linux. There has been, however, no interest so far for running BoSSS on Apple Computers, therefore we do not provide official guidelines.
Since Mac OS X is a Unix system, most things should work similar to Linux.
There has been, however, no interest so far for running BoSSS on Apple Computers, therefore we do not provide official guidelines.
**For any new Apple computer using an Apple Silicone chip
(M1, M2, i.e. some ARM-Mac)
one major obstacle for running BoSSS is that no PARDISO solver is available.
PARDISO is non-free software and its source code is not available;
binaries are, however available for older Macs (x86_64 architecture).**
The first step would be to compile the [Native Libraries](#notes-on-third-party-libraries). For this, we recommend that users should try either Mac Ports (<https://www.macports.org/>) or Homebrew (<https://brew.sh/>) to have a system which close to Linux (i.e. has `gcc`, `gfortran`, etc.). Using only Mac OS tools might be even harder. After you have compiled the library, you can proceed analogously to the procedure under Linux.
......
......