Difference between revisions of "Reporting OpenVZ problem"

From OpenVZ Virtuozzo Containers Wiki
Jump to: navigation, search
(add 'translate' tags)
(Marked this version for translation)
Line 1: Line 1:
 
<translate>
 
<translate>
 +
<!--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]. 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.
 
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]. 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-->
 
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.
 
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 ==
+
== You should always report == <!--T:3-->
 
* clear problem description
 
* clear problem description
 
It is necessary not just to describe the problem, but also post real commands,
 
It is necessary not just to describe the problem, but also post real commands,
Line 26: Line 28:
 
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 they exist.
  
== A program fails to run ==
+
== A program fails to run == <!--T:4-->
 
The most helpful tool here is <code>strace</code>. See [[stracing a program]].
 
The most helpful tool here is <code>strace</code>. See [[stracing a program]].
  
== Network related problem ==
+
== Network related problem == <!--T:5-->
 
* interface/routing/filter configuration
 
* interface/routing/filter configuration
 
You should run these commands in [[container]] '''and''' on [[HN]]
 
You should run these commands in [[container]] '''and''' on [[HN]]
Line 41: Line 43:
 
* see also required information in [http://forum.openvz.org/index.php?t=tree&goto=27545&S=37542b6163cbf0da10ebc21fdd10b471#msg_27545 post on forum]
 
* see also required information in [http://forum.openvz.org/index.php?t=tree&goto=27545&S=37542b6163cbf0da10ebc21fdd10b471#msg_27545 post on forum]
  
 +
<!--T:6-->
 
{{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.}}
 
{{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.}}
  
== Kernel Oops ==
+
== Kernel Oops == <!--T:7-->
 
"[[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.
 
"[[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.
  
== Access to the node ==
+
== Access to the node == <!--T:8-->
 
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]].
 
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]].
  
 +
<!--T:9-->
 
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 case you can provide an access, post login information via forum PM or by 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.)}}
 
{{Warning|Do not post any sensitive information (like login details to public forums, mailing lists etc.)}}
  
== External resources ==
+
== External resources == <!--T:11-->
  
 +
<!--T:12-->
 
* [https://bugs.openvz.org/ OpenVZ bugtracker]
 
* [https://bugs.openvz.org/ OpenVZ bugtracker]
 
</translate>
 
</translate>
  
 
[[Category: QA]]
 
[[Category: QA]]

Revision as of 08:36, 26 December 2015

<translate> To support OpenVZ users we maintain Support forum and Users mailing list. 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.

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

  • clear problem description

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 --verbose option.

  • Kernel information
    • kernel version, architecture and flavour (uname -a)
    • origin of your binary kernel (RPM from openvz.org, other repository, compiled from sources, ...)
    • .config file (if you compiled the kernel)
  • Linux distribution used on HN
  • console tools information
    • vzctl --version
  • OpenVZ/Virtuozzo environment information
    • Virtuozzo version cat /etc/virtuozzo-release
    • /etc/vz/vz.conf file
    • /etc/vz/<veid>.conf file, where <veid> is an id of container in question.
  • Various log files
    • /var/log/messages
    • /var/log/vzctl.log
    • Virtuozzo allows to gather all useful logs into single report. Execute prlsrvctl problem-report --send and prlctl problem-report [CTUID|VMUID] --send and specify problem report ID number in bug.
    • Other

If other programs are involved in your problem, try to run they with increased verbosity and attach appropriate log files, if they exist.

A program fails to run

The most helpful tool here is strace. See stracing a program.

Network related problem

  • interface/routing/filter configuration

You should run these commands in container and on HN

# ip a l
# ip r l
# iptables -L
# iptables -t nat -L
# cat /proc/sys/net/ipv4/ip_forwarding
Yellowpin.svg 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.

Kernel Oops

"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 /var/log/messages file or dmesg 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.

Access to the node

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 sudo) to the hardware node.

In case you can provide an access, post login information via forum PM or by e-mail, or ask for a public SSH key.

Warning.svg Warning: Do not post any sensitive information (like login details to public forums, mailing lists etc.)

External resources

</translate>