nut/docs/support.txt

112 lines
3.5 KiB
Text
Raw Normal View History

2011-01-26 09:35:08 +00:00
ifdef::website[]
Support instructions
====================
endif::website[]
There are various ways to obtain support for NUT.
Documentation
-------------
- First, be sure to read the link:docs/FAQ.html[FAQ]. The most common problems are already
addressed there.
ifdef::website[]
- Else, you can read the link:docs/user-manual.chunked/index.html[NUT User Manual].
endif::website[]
ifndef::website[]
- Else, you can read the linkdoc:user-manual[NUT user manual].
endif::website[]
It also covers many areas about installing, configuring and using NUT.
The specific steps on system integration are also discussed.
- Finally, link:docs/man/index.html#User_man[User manual pages] will also
complete the User Manual provided information. At least, read the manual
page related to your driver(s).
Mailing lists
-------------
If you have still not found a solution, you should search the lists before
posting a question.
Someone may have already solved the problem:
ifdef::backend-xhtml11[]
++++++++++++++++++++++++++++++++++++++
<form action="http://www.google.com/search" method="get">
<input maxlength="2048" name="as_q" size="25" type="text">
<input name="as_oq" type="hidden" value="nut-upsuser nut-upsdev">
<input name="domains" value="lists.alioth.debian.org" type="hidden">
<input name="sitesearch" value="lists.alioth.debian.org" type="hidden">
<input name="btnG" value="Search NUT lists" type="submit">
</form>
++++++++++++++++++++++++++++++++++++++
endif::backend-xhtml11[]
ifndef::backend-xhtml11[]
link:http://www.google.com/search?as_q=&as_oq=nut-upsuser+nut-upsdev&domains=lists.alioth.debian.org&sitesearch=lists.alioth.debian.org&btnG=Search+NUT+lists[search on the NUT lists using Google]
endif::backend-xhtml11[]
Finally, you can *subscribe* to a NUT mailing list to:
Request help
~~~~~~~~~~~~
Use the link:http://lists.alioth.debian.org/mailman/listinfo/nut-upsuser[NUT Users]
mailing list.
In this case, be sure to include the following information:
- OS name and version,
- exact NUT version,
2012-01-24 10:22:33 +00:00
- NUT installation method: from source tarball, package or Subversion,
2011-01-26 09:35:08 +00:00
- exact device name and related information (manufacturing date, web pointers, ...),
2012-01-24 10:22:33 +00:00
- complete problem description, with any relevant traces, like system log excerpts,
and driver debug output. You can obtain the latter using the following command,
2011-01-26 09:35:08 +00:00
as root and after having stopped NUT:
2012-01-24 10:22:33 +00:00
/path/to/driver -DD -a <upsname>
2011-01-26 09:35:08 +00:00
If you don't include the above information in your help request, we will not be
able to help you!
Post a patch, ask a development question, ...
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Use the link:http://lists.alioth.debian.org/mailman/listinfo/nut-upsdev[NUT Developers]
mailing list.
Refer to the
ifdef::website[]
link:docs/developer-guide.chunked/index.html[NUT Developer Guide]
for more information, and the chapter on how to
link:docs/developer-guide.chunked/ar01s03.html#_submitting_patches[submit patches].
endif::website[]
ifndef::website[]
linkdoc:developer-guide[NUT Developer Guide]
for more information, and the chapter on how to
link:../developer-guide.chunked/ar01s03.html#_submitting_patches[submit patches].
endif::website[]
Discuss packaging and related topics
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Use the link:http://lists.alioth.debian.org/mailman/listinfo/nut-packaging[NUT Packagers]
mailing list.
Refer to the
ifdef::website[]
link:docs/packager-guide.chunked/index.html[NUT Packager Guide]
endif::website[]
ifndef::website[]
linkdoc:packager-guide[NUT Packager Guide]
endif::website[]
for more information.