Update Installation and Testing authored by Kummer, Florian's avatar Kummer, Florian
......@@ -16,12 +16,12 @@ Within this chapter, we will briefly outline the steps required to get started w
The advantage of C#, resp. .NET is that _the executable is platform-independent_. This implies that an executable compiled on a Windows/Mac laptop can be copied to a Linux/Unix HPC system and executed there without re-compilation. As discussed in [Section 2.2](../Part-I-Getting-Started/2.-Core-concepts#22-c-net-and-mono), this obviously requires some _middleware_ and some libraries to be present on the target computer. In the following, we will thus summarize some best practices for the installation of the [pre-compiled BoSSS binaries](https://github.com/FDYdarmstadt/BoSSS/releases) on different operating systems.
---
### Windows
To install on Windows, just o execute the BoSSS Windows installer.
Afterwards, you can test installation [Section 3.2](../Part-I-Getting-Started/3a.-Installation-and-Testing#32-testing-the-installation).
Afterwards, you can [test the installation](Testing-the-Installation).
The BoSSS installer already includes all required native libraries and prerequisites. These are:
......@@ -31,7 +31,6 @@ The BoSSS installer already includes all required native libraries and prerequis
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
......@@ -44,7 +43,6 @@ The steps for installing BoSSS on Linux are:
* 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'll need to compile them yourself, the source code can be found at `https://github.com/FDYdarmstadt/BoSSS-native`resp. `git@github.com:FDYdarmstadt/BoSSS-native.git`.
---
### Mac OS X
......@@ -52,7 +50,9 @@ 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 guidlines.
The first step would be to compile the Native Libraries (https://github.com/FDYdarmstadt/BoSSS-native, https://git.rwth-aachen.de/kummer/BoSSS-native)
The first step would be to compile the Native Libraries (https://github.com/FDYdarmstadt/BoSSS-native, https://git.rwth-aachen.de/kummer/BoSSS-native).
For this, we reccomend 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.
## Testing the Installation
......
......