Troubleshooting

Problem 1: ".fatal error: boost/config/compiler/gcc.hpp: No such file or directory" Is Displayed During Compilation

Symptom

When Allwmake is run to compile the Computational Geometry Algorithms Library (CGAL), the compilation fails and ".fatal error: boost/config/compiler/gcc.hpp: No such file or directory" is displayed.

Possible Cause

The CGAL fails to be installed due to environment variable or CMake installation failure. If the error occurs during the installation of a module of OpenFOAM, you only need to install the module again.

Procedure

1. Delete the installed executable file and path.

   rm -rf /path/to/OPENFOAM/OpenFOAM-v1906/platform/arch/boost_1_64_0

2. Install the script independently when running Thirdparty-v1906.

   cd /path/to/OPENFOAM/Thirdparty-v1906
   ./makeCGAL

Problem 2: "*esmump.h* No such file or directory" Is Displayed During Compilation

Symptom

When Allwmake is run to compile Scotch, the compilation fails and "*esmump.h* No such file or directory" is displayed.

Possible Cause

An error occurs during script running. As a result, esmump fails to be installed.

Procedure

1. Go to the Scotch directory and manually compile esmumps.

   cd /path/to/OPENFOAM/ThirdParty-v1906/scotch_6.0.6/src
   make esmumps

2. Run the Allwmake script again to continue the compilation and installation.

   foam
   ./Allwmake -j

Problem 3: " cannot stat `../bin/d[agm]*'" Is Displayed During Compilation

Symptom

When Allwmake is run to compile Scotch, the compilation fails and the following message is displayed:

cp: cannot stat `../bin/d[agm]*': No such file or directory

make: [install] Error 1 (ignored)

Possible Cause

This problem is not caused by d[agm]. Generally, this problem occurs when the Scotch directory is not cleared before the installation program is rerun. You can run the make distclean command in the Scotch source code directory and then manually install the Scotch program.

Procedure

1. Delete the directory generated by the failed installation.
   

   linuxARM64GccDPInt32 is named based on the installation environment architecture and compiler. You need to change it to the actual path.

   rm -rf /path/to/OPENFOAM/ThirdParty-v1906/platforms/linuxARM64GccDPInt32/scotch_6.0.6/

2. Go to the Scotch source-code directory and manually compile and install the software.
   

   To manually install Scotch, you need to set the installation path to the installation path that is deleted previously.

   make scotch
   make esmumps
   make ptscotch
   make prefix=/path/to/OPENFOAM/ThirdParty-v1906/platforms/linuxARM64GccDPInt32/scotch_6.0.6/ install

3. Run the Allwmake script again to continue the compilation and installation.

   foam
   ./Allwmake -j

Problem 4: The Case Cannot Stop Properly and "ls: cannot access processor*: No such file or directory" Is Displayed

Symptom

Generally, case running takes several minutes. If the case is stopped within one minute, open the log file to check whether the computing is running properly. If the log file contains the error information, "mpirun has detected an attempt to run as root." is displayed.

Possible Cause

When running the mpirun command as the root user, you need to add a parameter.

Procedure

1. Modify the RunFunctions file.

   vi /path/to/OPENFOAM/OpenFOAM-v1906/bin/tools/RunFunctions

2. Press i to enter the insert mode and add --allow-run-as-root to the end of the mpirun command.
3. Press Esc, type :wq!, and press Enter to save the changes and exit.
4. Run the test case again.

   ./Allclean
   ./Allrun