Information to include in help requests

[sacks]

When you are posting to the forums because you want help with an issue, please include as much of the following information as possible.

Before submitting a help request, please check to see if your question is already answered:

• Search the forums for similar issues
• Check the CIME troubleshooting guide to see if any suggestions there solve your problem
• Check any other relevant CESM documentation

What version of the code are you using?

• CESM staff members will mainly provide answers for supported model versions, as outlined in the CESM support policy, and can only provide limited help for versions that are no longer supported. You may ask questions about unsupported versions, but may need to rely on community answers.
• For CESM2.1.2 onwards run the script ./describe_version from the top level of your CESM clone to find the version
• From older model versions, provide the output from running the following commands from the top level of your CESM clone
  • git describe
  • ./manage_externals/checkout_externals --status --verbose

Have you made any changes to files in the source tree?

• Describe any changes (code, xml files, etc.)

Describe every step you took leading up to the problem:

• Describe every step you took, starting with the create_newcase command and including any changes you made to xml files, user_nl files, etc. Please try to reproduce the problem first using your own instructions.

If this is a port to a new machine: Please attach any files you added or changed for the machine port (e.g., config_compilers.xml, config_machines.xml, and config_batch.xml) and tell us the compiler version you are using on this machine.
Please attach any log files showing error messages or other useful information.

• If the error occurs during the build, please attach the appropriate build log file showing the compilation error message.
• If the error occurs during the run, please attach all log files from the run (cpl.log, cesm.log and all component log files).