Permalink
Browse files

Merge pull request #12480 from milljm/troubleshooting_12466

Improve the Troubleshooting help page
  • Loading branch information...
moosebuild committed Nov 16, 2018
2 parents f3d2653 + e04b1de commit 8c17339c057bef926eb46fdcc6f763e2556ab7a3
@@ -46,28 +46,6 @@ make -j4
If your application is working correctly, you should see one passing test. This indicates that your application is ready to be further developed.
## Learn More
TODO: talk about and link to examples and tutorial, etc.
## Join the Community
Join one of our mailing lists:
- [moose-users@googlegroups.com](https://groups.google.com/forum/#!forum/moose-users) - Technical Q&A (moderate traffic)
- [moose-announce@googlegroups.com](https://groups.google.com/forum/#!forum/moose-announce) - Announcements (very light traffic)
GMail users can just click the "Join group" button.
Everyone else can join by sending an email to:
- moose-users+subscribe@googlegroups.com
- moose-announce+subscribe@googlegroups.com
You may also want to follow MOOSE developers on Twitter:
- Derek Gaston: [@friedmud](https://twitter.com/@friedmud)
- Cody Permann: [@permcody](https://twitter.com/@permcody)
- John Peterson: [@peterson512](https://twitter.com/@peterson512)
- Jason Miller: [@mjmiller96](https://twitter.com/@mjmiller96)
- Andrew Slaughter: [@aeslaughter98](https://twitter.com/@aeslaughter98)
!include getting_started/installation/post_moose_install.md
!include getting_started/installation/installation_troubleshooting.md
@@ -9,7 +9,3 @@
!include getting_started/installation/post_package_install.md
!include getting_started/installation/install_moose.md
!include getting_started/installation/post_moose_install.md
!include getting_started/installation/installation_troubleshooting.md
@@ -9,7 +9,3 @@
!include getting_started/installation/post_package_install.md
!include getting_started/installation/install_moose.md
!include getting_started/installation/post_moose_install.md
!include getting_started/installation/installation_troubleshooting.md
@@ -1,3 +1,3 @@
## Troubleshooting
For issues encountered during this process, please see our [FAQ](help/faq.md) page for common issues. If your issue is not among our [FAQs](help/faq.md), this would be an excellent time to come join us on our [mailing list](https://groups.google.com/forum/#!forum/moose-users)!
Please see our [FAQ](help/faq.md) page for common issues. If your issue is not listed among our [FAQs](help/faq.md), this would be an excellent time to join us on our [mailing list](https://groups.google.com/forum/#!forum/moose-users) and ask for help!
@@ -7,7 +7,3 @@
!include getting_started/installation/post_package_install.md
!include getting_started/installation/install_moose.md
!include getting_started/installation/post_moose_install.md
!include getting_started/installation/installation_troubleshooting.md
@@ -9,7 +9,3 @@
!include getting_started/installation/post_package_install.md
!include getting_started/installation/install_moose.md
!include getting_started/installation/post_moose_install.md
!include getting_started/installation/installation_troubleshooting.md
@@ -9,7 +9,3 @@
!include getting_started/installation/post_package_install.md
!include getting_started/installation/install_moose.md
!include getting_started/installation/post_moose_install.md
!include getting_started/installation/installation_troubleshooting.md
@@ -1,5 +1,24 @@
## Now What?
## Learn More
Now that you have a working MOOSE Framework stack, there are several [examples](examples/index.md) you can peruse to familiarize yourself with the components of the input file. The input file is what you will use to build problems for your Application (and MOOSE) to solve.
You can also introduce yourself on our [moose-users@googlegroups.com](https://groups.google.com/forum/#!forum/moose-users) mailing list! We would love to hear how you plan to use MOOSE. The mailing list is also a good place to go for questions concerning MOOSE in general.
## Join the Community
Join one of our mailing lists:
- [moose-users@googlegroups.com](https://groups.google.com/forum/#!forum/moose-users) - Technical Q&A (moderate traffic)
- [moose-announce@googlegroups.com](https://groups.google.com/forum/#!forum/moose-announce) - Announcements (very light traffic)
GMail users can just click the "Join group" button.
Everyone else can join by sending an email to:
- moose-users+subscribe@googlegroups.com
- moose-announce+subscribe@googlegroups.com
You may also want to follow MOOSE developers on Twitter:
- Derek Gaston: [@friedmud](https://twitter.com/@friedmud)
- Cody Permann: [@permcody](https://twitter.com/@permcody)
- John Peterson: [@peterson512](https://twitter.com/@peterson512)
- Jason Miller: [@mjmiller96](https://twitter.com/@mjmiller96)
- Andrew Slaughter: [@aeslaughter98](https://twitter.com/@aeslaughter98)
@@ -9,7 +9,3 @@
!include getting_started/installation/post_package_install.md
!include getting_started/installation/install_moose.md
!include getting_started/installation/post_moose_install.md
!include getting_started/installation/installation_troubleshooting.md
@@ -38,4 +38,58 @@ Build issues are normally caused by an invalid environment, or perhaps an update
unset MOOSE_DIR
```
- Once completed, you should attempt to [rebuild libMesh](help/troubleshooting.md#libmesh) again.
- Try building a simple hello world example (copy and paste the entire box):
```bash
cd /tmp
cat << EOF > hello.C
#include <mpi.h>
#include <stdio.h>
int main(int argc, char** argv) {
// Initialize the MPI environment
MPI_Init(NULL, NULL);
// Get the number of processes
int world_size;
MPI_Comm_size(MPI_COMM_WORLD, &world_size);
// Get the rank of the process
int world_rank;
MPI_Comm_rank(MPI_COMM_WORLD, &world_rank);
// Get the name of the processor
char processor_name[MPI_MAX_PROCESSOR_NAME];
int name_len;
MPI_Get_processor_name(processor_name, &name_len);
// Print off a hello world message
printf("Hello world from processor %s, rank %d out of %d processors\n",
processor_name, world_rank, world_size);
// Finalize the MPI environment.
MPI_Finalize();
}
EOF
mpicxx -fopenmp hello.C
```
If the build failed, and you have the correct [Modules](help/troubleshooting.md#modules) environment loaded, then you should attempt to perform the 'Uggh! None of this is working' step in the [Modules](help/troubleshooting.md#modules) section. As it would seem, there is something else in your environment that is inhibiting your ability to compile simple programs.
If the build was successfull, attempt to execute the hello word example:
```bash
mpiexec -n 4 /tmp/a.out
```
You should receive a response similar to the following:
```bash
Hello world from processor my_hostname, rank 0 out of 4 processors
Hello world from processor my_hostname, rank 1 out of 4 processors
Hello world from processor my_hostname, rank 3 out of 4 processors
Hello world from processor my_hostname, rank 2 out of 4 processors
```
- If all of the above has succeeded, you should attempt to [rebuild libMesh](help/troubleshooting.md#libmesh) again.
@@ -1,25 +1,23 @@
# Frequently Asked Questions
- Q: +Do you have a mailing list where I can ask questions?+
## Do you have a mailing list where I can ask questions?
- A: We sure do: [mailing list](https://groups.google.com/forum/#!forum/moose-users)
- moose-users@googlegroups.com - Technical Q&A (moderate traffic)
- moose-announce@googlegroups.com - Announcements (very light traffic)
- You can also browse our [mailing list](https://groups.google.com/forum/#!forum/moose-users).
## I can not build my application
- Q: +I can't compile libMesh. What do I do?+
- Please see our [Build Issues](help/troubleshooting.md#buildissues) troubleshooting section.
- A: Please see our [libMesh](help/troubleshooting.md#libmesh) troubleshooting section.
## libMesh fails to compile
- Please see our [libMesh](help/troubleshooting.md#libmesh) troubleshooting section.
- Q: +I am getting a "gethostbyname failed, localhost (errno 3)" error when running tests!+
## gethostbyname failed, localhost (errno 3) error when running tests
- A: Please see our [Failing Tests](help/troubleshooting.md#failingtests) troubleshooting section.
- Please see 'gethostbyname' failure in our [Failing Tests](help/troubleshooting.md#failingtests) troubleshooting section.
## Some/All of my tests fail
- Q: +Some or all of my tests fail!+
- A: Please see our [Failing Tests](help/troubleshooting.md#failingtests) troubleshooting section.
- Q: +I can't build my application!+
- A: Please see our [Build Issues](help/troubleshooting.md#buildissues) troubleshooting section.
- Please see our [Failing Tests](help/troubleshooting.md#failingtests) troubleshooting section.

0 comments on commit 8c17339

Please sign in to comment.