"Ayuda autonómica", problemas de reportaje y apoyo

TurnKey Linux se esfuerza por ser impresionante. Y nos gusta pensar que la mayoría es. Sin embargo, los problemas ocurren a veces. A veces es malentendido; a veces es confuso (o falta de) documentación o a veces es un error. Tal vez es un error en nuestro software o pre-configuración, o un error en software empaquetado por Debian o quizás incluso el desarrollador de software original (es decir, "upstream")!?

Esta página es para darle algunos puntos para hacer su solución de problemas más rápida y fácil y/o hacer que sea más fácil para alguien que intenta ayudar.

¡Revise los registros!

A menudo, los errores de registros de software en mayor detalle de lo que proporciona en pantalla. La ubicación predeterminada de los registros en TurnKey (y Linux en general) es /var/log. Busque un archivo o directorio con el nombre de la aplicación que está buscando. A veces puede ser un archivo justo ahí, a veces estará en un sub directorio. Generalmente la mayoría de software que se instala desde Debian tendrá sus registros allí.

Como regla, cualquier aplicación que no se inicie directamente a /var/log, tratamos de proporcionar simlinks de conveniencia de /var/log a los archivos de registro real (para facilitar su búsqueda) pero Lamentablemente eso no se aplica a todos los appliances (a la vez). Así que el software instalado de otras fuentes puede tenerlo en otro lugar. Otros lugares a buscar están dentro del directorio de instalación de software. Por ejemplo /var/www/ seleccion de software-nombre de usuario/log o /opt/ seleccion desoftware-nombre de usuario/log - dependiendo del appliance. Compruebe la página individual appliance para ver si observa una ubicación de instalación.

Por favor, informe (ya sea a través de foros y/o en nuestro issue tracker) cualquier lugar de registro no estándar, o problemas que usted tiene encontrar registros particulares. Entonces podemos estar conscientes del problema y el objetivo de fijarlo en la próxima liberación.

Google su problema.

Este es bastante obvio, pero siempre vale la pena ir a buscar como primer paso para resolver problemas.

TurnKey se basa en Debian (v14.x = Debian 8/Jessie; v15.x = Debian 9/Stretch) y sigue siendo compatible con binario. Así que la mayoría de las instrucciones Debian, deben ser relevantes para TurnKey. En general, debe haber información en línea para muchos problemas comunes que los usuarios puedan enfrentar, especialmente en lo que respecta al software instalado desde el repos predeterminado Debian. Ubuntu también está basado en Debian así que a veces puede ser útil también, pero tenga cuidado porque Ubuntu no es compatible con Debian. Evite agregar Ubuntu repos en su servidor TurnKey!

Si hay mensajes de error que se muestran en algún lugar, y/o encuentra errores en sus registros, prueba agujerear el mensaje de error específico y literal. Quitar cualquier tempo como es poco probable que coincida. Los caminos de explicit también pueden no coincidir (recomiendo incluirlos inicialmente, pero eliminar si nada útil aparece). Si eso todavía no consigue resultados útiles, trate de hacerlo más general (por ejemplo, si cita números de línea en el mensaje de error, eliminarlos de su búsqueda, eliminar caminos, etc).

Si encuentra una solución a su problema en algún otro lugar que TurnKey, por favor considere publicarlo en nuestro foros De todos modos. Es posible que si tuvieras el problema y no supieras qué hacer, que otros estén o estarán en la misma posición!

¡Empieza tu propio hilo!

Si aún no puedes resolver tu problema, por favor, ponte en el correo foros. Tenga en cuenta que si no es un usuario, necesitará registro para una cuenta. También vale la pena señalar que a veces nuestros filtros de spam pueden ser un poco agresivos (y sin embargo algunos spammers todavía consiguen a través de alguna manera?!). Si se encuentra en esa situación, por favor publique un hilo existente, como este y o enviarnos un correo electrónico y vamos a blanquear su cuenta de usuario.

Al publicar en los foros, como regla general, debe comenzar un nuevo hilo. A menos que haya un hilo muy reciente que EXACTLY describe su problema, es mejor comenzar su propio hilo. Si hay otros hilos que describen problemas similares (pero no son los mismos y/o los hilos antiguos) entonces sugiero añadir un breve post (en los otros hilos) con un enlace a su (nuevo) hilo. Eso llamará la atención de los carteles anteriores a ese hilo sin secuestrarlo completamente.

La razón detrás de esa sugerencia es porque los errores que aparecen similares pueden tener a menudo causas diferentes. Eso es especialmente el caso con software antiguo (las versiones de software más reciente a menudo tienen los errores antiguos fijos - por lo que un error similar tendrá una causa diferente). Tener tu propio hilo hace la vida mejor para todos, especialmente si el problema termina siendo diferente. Si el problema termina siendo el mismo, siempre podemos cruzar los enlaces de correos, o incluso combinar los hilos.

¡Sé verbose!

A menudo la gente tiene miedo de ser demasiado verbosa, especialmente en línea. Yo diría que usted puede nunca jamás nunca jamás nunca jamás jamás jamás nunca jamás jamás jamás jamás jamás jamás jamás nunca jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás jamás ¡Sé demasiado verboso cuando describa errores o problemas! Aunque no sienta que algo es completamente relevante, por favor no dude en incluir cualquier información que tenga. Es mucho más fácil para alguien ignorar la información que no es relevante, pero mucho más difícil leer su mente! :)

Dale a tu hilo un tema breve pero descriptivo.

Esto probablemente no es tan importante cuando se publica en TurnKey en comparación con otros foros, pero todavía ayuda.

Ejemplos de líneas de sujeto inalterables:

"¡HELP!"
"Mi servidor está roto"
"No trabajas"

Ejemplos de mejores temas:

"WordPress no actualizará"
"No se puede conectar a HTTPS en Redmine"
"Error 504 cuando se conecta a Drupal site"

Dale tus etiquetas relevantes de hilo.

Los hilos de etiquetado no son necesarios, pero hace que sea mucho más útil para otros usuarios. También nos ayuda a agregar puntos de dolor de usuario y errores.

Tanto como sea posible, trate de reutilizar las etiquetas existentes en lugar de hacer nuevas. Cuando empiece a escribir, nuestro sitio web debe proporcionar opciones completas de automóviles que deben ayudar allí. Recuerde que las etiquetas pueden incluir espacios, y las etiquetas deben ser separadas con comas.

Al menos sugiero que usted etiqueta su post con la versión TurnKey (por ejemplo, "14.0" o "14.1" - ver abajo) y el nombre appliance (por ejemplo, "redmine" o "lamp"). Si es una pieza particular de software que usted está teniendo problemas con entonces etiqueta que también (por ejemplo, "Webmin" o "TKLBAM"). Las etiquetas siempre se puede editar más tarde, así que no tengas miedo!

¿Qué versión de TurnKey es?

Los errores casi siempre se aplican a una versión particular (o versiones) de software. Así que para dar a los que podrían querer ayudarle a salir de la cabeza, proporcionar la versión de TurnKey que tiene. Si no estás 100% seguro, hay una manera muy fácil de comprobar desde la línea de comandos:

turnkey-version

Debe producir un resultado como este (v15.1 LAMP appliance):

turnkey-lamp-15.1-stretch-amd64

¿Dónde está corriendo?

TurnKey produce una gama de construyes. Todos están construidos desde el ISO originalmente, así que generalmente debe compartir errores a través de plataformas. Sin embargo, ese no siempre es el caso, ya que cada construcción diferente tiene cierto grado de personalización. También diferentes plataformas tienen sus peculiaridades e idiosincrasias de las que los recién llegados y/o desarrolladores pueden no estar siempre conscientes. Así que para ayudar a reducir la fricción, indicando dónde está funcionando su appliance también puede ser útil.

t2.small server on the TurnKey Hub

OVA en VirtualBox v6.0.4 en Windows 10

etc...

¿Qué intentas lograr?

Generalmente es útil entender lo que estaba tratando de hacer cuando ocurrió el comportamiento inesperado. A veces puede iluminar un malentendido en su nombre (tal vez el problema se espera que el comportamiento del comando que está usando)? Si no lo declaras, tu objetivo previsto puede no ser obvio. También como casi siempre hay múltiples maneras de "secar un gato", tal vez podría haber una manera mejor/más fácil para lograr sus fines deseados?

¿Qué has intentado hasta ahora?

Si sigues algunas instrucciones que has encontrado en línea (por ejemplo, un blog aleatorio o un StackOverflow Q Puls, pon un enlace a él. Eso podría ayudarnos a entender por qué no funcionó. ¿Quizá no sea compatible con la versión actual? Por ejemplo, las instrucciones se aplican a una versión anterior de Debian/TurnKey que ya no se aplica o es irrelevante para su situación.

¿Cuál fue el resultado?
I.e. ¿Cuál es la naturaleza exacta del error/problema?

Este no necesita mucha explicación. Si hubo un mensaje de error específico, póngalo en su correo. Si encontró algunos problemas en sus registros, publique las partes pertinentes. Para grandes registros largos, considere adjuntarlos a su correo, en lugar de copiarlos/pasarlos. Esa es otra razón para comenzar tu propio hilo; sólo el primer post puede tener apegos! Por favor, siéntete libre de modificar cualquier contenido que puedas pensar es sensible o privado, pero por favor note los cambios que has hecho a los registros, mensajes de error, etc.

Capturas de pantalla de problemas también pueden ser útiles (especialmente los errores visuales de contenido web dentro de su navegador web), sin embargo si usted está compartiendo un mensaje de error es mucho mejor publicar el texto del error como texto. Hace más fácil agitar los mensajes de error y también hace mucho más fácil para Google encontrar su hilo en el futuro (para ayudar a otros).

¿Qué otras cosas has hecho recientemente?

También es bueno notar qué otros ajustes has hecho recientemente dentro de TurnKey (incluso si crees que es irrelevante - ver arriba punto re verbosidad). A veces las cosas que has cambiado tienen consecuencias indeseadas y a veces una combinación de ajustes aparentemente inconectados puede causar problemas. A menudo no, pero la información más que proporcionas es más fácil que te ayude!

¿Hora de publicar un error?

Si usted está seguro de que usted está "haciendo bien" pero recibiendo el resultado equivocado entonces puede ser un error legítimo. Si usted piensa así, por favor post en nuestro issue tracker. De nuevo proporcionar información sobre su versión TurnKey, lo que hizo y lo que esperaba, etc.

Si no estás seguro, es probable que sea mejor publicar en los Foros de Apoyo primero, pero no importa realmente. ¡Cerrar errores (que no son realmente errores) es fácil! :)