Editing Reporting OpenVZ problem

Jump to: navigation, search

Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
Latest revision Your text
Line 1: Line 1:
<translate>
+
To support OpenVZ users we maintain [http://forum.openvz.org/index.php?t=thread&frm_id=2& Support forum] and [mailto:users@openvz.org Users mailing list]. If you analyze an activity at the forum, then you'll find out, that the very big part of all messages there are requests to users to provide an additional information about their environments. Because of it the time between the report of a problem and its solution is sometimes much more longer, than it could be.
<!--T:1-->
 
To support OpenVZ users we maintain [http://forum.openvz.org/index.php?t=thread&frm_id=2 Support forum] and [http://openvz.org/mailman/listinfo/users Users mailing list]. For reporting bugs use [https://bugs.openvz.org/ OpenVZ bugtracker]. If you analyze an activity at the forum, then you'll find out that the substantial portion of all the messages are requests to users to provide an additional information about their environments. Because of this, the time between the report of a problem and its solution is sometimes much longer than it could be.
 
  
<!--T:2-->
+
The aim of this article is to clue up users, what information they should report when they encounter OpenVZ related problem. We hope that it will make our support service more effective.
This article described which information a user should report when reporting OpenVZ-related problem. We hope that it will make our support service more effective.
 
  
== You should always report == <!--T:3-->
+
== You should always report ==
* Clear problem description
+
* clear problem description
: It is necessary not just to describe the problem, but also post real commands you entered and their real output. It is useful to run commands with <code>--verbose</code> option.
+
It is necessary not just to describe the problem, but also post real commands,
 +
and real output on console. It is useful to run commands with <code>--verbose</code> option.
 
* Kernel information
 
* Kernel information
** Kernel version, architecture and flavour (<code>uname -a</code>)
+
** kernel version, architecture and flavour (<code>uname -a</code>)
** Origin of your binary kernel (RPM from openvz.org, other repository, compiled from sources, ...)
+
** origin of your binary kernel (RPM from openvz.org, other repository, compiled from sources, ...)
 
** .config file (if you compiled the kernel)
 
** .config file (if you compiled the kernel)
 
* Linux distribution used on [[HN]]
 
* Linux distribution used on [[HN]]
* Console tools information
+
* vzctl information
 
** <code>vzctl --version</code>
 
** <code>vzctl --version</code>
* OpenVZ/Virtuozzo environment information
+
* OpenVZ environment information
** Virtuozzo version <code>cat /etc/virtuozzo-release</code>
 
 
** <code>/etc/vz/vz.conf</code> file
 
** <code>/etc/vz/vz.conf</code> file
** <code>/etc/vz/<veid>.conf</code> file, where <code><veid></code> is an id of container in question.
+
** <code>/etc/vz/<veid>.conf</code> file, where <code><veid></code> is an id of VE in question.
 
* Various log files
 
* Various log files
 
** <code>/var/log/messages</code>
 
** <code>/var/log/messages</code>
 
** <code>/var/log/vzctl.log</code>
 
** <code>/var/log/vzctl.log</code>
** Virtuozzo allows to gather all useful logs into single report. Execute <code>prlsrvctl problem-report --send</code> and <code>prlctl problem-report [CTUID|VMUID] --send</code> and specify problem report ID number in bug.
 
 
** Other
 
** Other
:: If other programs are involved in your problem, try to run they with increased verbosity and attach appropriate log files, if they exist.
+
If other programs are involved in your problem, try to run they with increased verbosity and attach appropriate log files, if exist.
  
== A program fails to run == <!--T:4-->
+
== A program fails to run ==
The most helpful tool here is <code>strace</code>. See [[stracing a program]].
+
The most viable tool here is <code>strace</code>. See[[stracing a program]].
  
== Network related problem == <!--T:5-->
+
== Network related problem ==
 
* interface/routing/filter configuration
 
* interface/routing/filter configuration
You should run these commands in [[container]] '''and''' on [[HN]]
+
You should run these commands in [[VE]] '''and''' on [[HN]]
 
<pre>
 
<pre>
 
# ip a l
 
# ip a l
Line 40: Line 36:
 
# cat /proc/sys/net/ipv4/ip_forwarding
 
# cat /proc/sys/net/ipv4/ip_forwarding
 
</pre>
 
</pre>
* see also required information in [http://forum.openvz.org/index.php?t=tree&goto=27545&S=37542b6163cbf0da10ebc21fdd10b471#msg_27545 post on forum]
+
Of course, if you have public IPs you  should carefully mask them. For example: 194.85.83.97 -> X.Y.83.97.
  
<!--T:6-->
+
== Kernel Oops ==
{{Note|if you have public IP addresses, you should carefully mask them in a report. For example: 194.85.83.97 -> X.Y.83.97.}}
+
"[[When you have an oops]]" article explains how to identify Oops and what you should do when it happens. The key moment is that you should send us the '''full''' Ooops text. Sometimes it can be easily obtained from <code>/var/log/messages</code> file or <code>dmesg</code>, but sometimes, you see Oops on the screen and the system is completely stuck. In such situation you should produce [[Remote console setup]]. Actually each production server should have setuped remote console.
  
== Kernel Oops == <!--T:7-->
+
== Access to the node ==
"[[When you have an oops]]" article explains how to identify Oops and what you should do when it happens. The key moment is that you should send us the '''full''' Ooops text. Sometimes it can be easily obtained from <code>/var/log/messages</code> file or <code>dmesg</code> output. In other cases, you can only see an Oops message on the monitor, and the system is completely stuck. In such a situation you should implement [[Remote console setup]]. As a rule, each production server should have a remote console set up.
+
In some cases, a remote access to the problem node is the fastest way to diagnose and fix a problem, so sometimes an OpenVZ developer can request such access from you. Note that in should be a root access (either directly, or via <code>sudo</code>) to the [[hardware node]].
  
== Access to the node == <!--T:8-->
+
In case you can provide an access, post login information via forum PM or by e-mail, or ask for a public SSH key.
In some cases, a remote access to the problem node is the fastest way to diagnose and fix a problem, so sometimes an OpenVZ developer can request such access from you. Note that in should be root access to the [[hardware node]] — either directly, or via <code>su</code> or <code>sudo</code>.
 
  
<!--T:9-->
+
{{Warning|Do not post any login details to public forums, mailing lists etc.}}
In case you can provide access, post login information via forum PM or e-mail, or ask for a public SSH key.
 
 
 
<!--T:10-->
 
{{Warning|Do not post any sensitive information (like login details) to public forums, mailing lists etc.}}
 
 
 
== External resources == <!--T:11-->
 
 
 
<!--T:12-->
 
* [https://bugs.openvz.org/ OpenVZ bugtracker]
 
</translate>
 
 
 
[[Category: QA]]
 

Please note that all contributions to OpenVZ Virtuozzo Containers Wiki may be edited, altered, or removed by other contributors. If you don't want your writing to be edited mercilessly, then don't submit it here.
If you are going to add external links to an article, read the External links policy first!

To edit this page, please answer the question that appears below (more info):

Cancel Editing help (opens in new window)

Templates used on this page: