"Autoajuda", relatando problemas e recebendo suporte

TurnKey Linux se esforça para ser incrível. E nós gostamos de pensar que a maioria é. No entanto, problemas às vezes ocorrem. Às vezes é mal-entendido; às vezes é confuso (ou falta de) documentação ou às vezes é um bug. Talvez seja um bug em nosso software ou pré-configuração, ou um bug em software embalado pelo Debian ou talvez até mesmo o desenvolvedor de software original (ou seja, "upstream")!?

Esta página é para lhe dar algumas dicas para tornar a sua solução de problemas mais rápida e fácil e / ou torná-lo mais fácil para alguém tentando ajudá-lo.

Vejam os registos!

Muitas vezes, os erros de registros de software em maior detalhe do que o fornecido na tela. O local padrão para registros em TurnKey (e Linux em geral) é /var/log. Procure um ficheiro ou directório com o nome da aplicação que procura. Às vezes, poderá ser um ficheiro mesmo ali, às vezes estará numa sub- directório. Geralmente a maioria do software que é instalado a partir de Debian terá seus logs lá.

Como regra, quaisquer aplicativos que não se logar diretamente no /var/log, tentamos fornecer links simbólicos de conveniência do /var/log para os arquivos de log reais (para torná-los mais fáceis de encontrar) mas Infelizmente isso não se aplica a todos os appliances (ainda). Assim, o software instalado de outras fontes pode tê-lo em outro lugar. Outros lugares para olhar estão dentro do diretório de instalação de software. Por exemplo, /var/www/<software-name>/log ou /opt/<software-name>/log - dependendo do appliance. Verifique a página appliance individual para ver se ele observa um local de instalação.

Por favor, informe (ou através do fóruns e/ou em nossa localizador de emissão) quaisquer locais de log não padrão, ou problemas que você tem encontrando logs particulares. Então, podemos estar cientes do problema e objetivar corrigi-lo na próxima versão.

Pesquise no Google o seu problema.

Este é bastante óbvio, mas vale sempre a pena pesquisar no Google como um primeiro passo para solucionar problemas.

TurnKey é baseado em Debian (v14.x = Debian 8/Jessie; v15.x = Debian 9/Stretch) e permanece compatível com binários. Assim, a maioria das instruções Debian, deve ser relevante para TurnKey. Geralmente deve haver informações on-line para muitos problemas comuns que os usuários podem enfrentar, particularmente no que diz respeito ao software instalado a partir do padrão Debian repos. O Ubuntu também é baseado no Debian, então às vezes também pode ser útil, mas tenha cuidado porque o Ubuntu não é binário compatível com o Debian. Evite adicionar os repos do Ubuntu no seu servidor TurnKey!

Se houver mensagens de erro sendo exibidas em algum lugar, e/ou você encontrar erros em seus registros, tente pesquisar no Google a mensagem de erro específica, verbatim. Remova quaisquer datas, uma vez que não é provável que correspondam. Os caminhos explícitos também podem não corresponder (recomendo incluí- los inicialmente, mas remova se nada de útil aparecer). Se isso ainda não tiver resultados úteis, tente torná-lo mais geral (por exemplo, se ele cita números de linha na mensagem de erro, exclua-os de sua pesquisa, remova caminhos, etc).

Se você encontrar uma solução para o seu problema em algum lugar diferente do TurnKey, por favor considere postar sobre ele em nosso fóruns De qualquer forma, as chances são que se você tivesse o problema e não soubesse o que fazer, que outros estão ou estarão na mesma posição!

Começa o teu próprio fio!

Se você ainda não pode resolver o seu problema, então por favor publique no fóruns. Note que se você não é já um usuário, você precisará registo para uma conta. Também vale a pena notar que às vezes nossos filtros de spam podem ser um pouco agressivos (e ainda alguns spammers ainda passam de alguma forma?!). Se você se encontrar nessa situação, por favor, publique em um tópico existente, como este aqui e ou nos envie um e-mail e nós vamos listar sua conta de usuário.

Ao postar nos fóruns, como regra geral, você deve iniciar um novo tópico. A menos que haja um tópico realmente recente que EXACTLY descreve seu problema, é melhor iniciar seu próprio tópico. Se existem outros threads descrevendo questões semelhantes (mas não exatamente os mesmos e/ou os tópicos antigos) então eu sugiro adicionar um post breve (no outro thread(s)) com um link para o seu (novo) fio. Isso vai chamar a atenção dos cartazes anteriores para esse fio sem sequestrá-lo completamente.

A razão por trás dessa sugestão é porque bugs que parecem similares podem muitas vezes ter causas diferentes. Esse é especialmente o caso com software mais antigo (novas versões de software muitas vezes têm os erros antigos corrigidos - então um erro semelhante terá uma causa diferente). Ter o seu próprio fio torna a vida melhor para todos, especialmente se o problema acabar sendo diferente. Se o problema acabar sendo o mesmo, podemos sempre cruzar links de post, ou até mesmo combinar threads.

Sejam verboso!

Muitas vezes as pessoas estão com medo de ser muito verbose, especialmente online. Eu diria que você pode nunca ser muito verbose ao descrever erros ou problemas! Mesmo que você pode não sentir algo é completamente relevante, por favor, não hesite em incluir qualquer informação que você tem. É muito mais fácil para alguém desconsiderar informações que são irrelevantes, mas muito mais difíceis de ler sua mente! :)

Dê ao seu tópico um assunto breve, mas descritivo.

Isso provavelmente não é tão importante quando postar no TurnKey em comparação com outros fóruns, mas ainda ajuda.

Exemplos de linhas de assunto inúteis:

"HELP!"
"O meu servidor está avariado"
"Não funciona"

Exemplos de assuntos melhores:

"WordPress não vai atualizar"
"Não consigo ligar ao HTTPS no Redmine"
"Erro 504 ao ligar-se ao local Drupal"

Dê as suas tags relevantes.

Os tópicos de marcação não são necessários, mas torna-o muito mais útil para outros usuários. Também nos ajuda a agregar pontos de dor e bugs do usuário.

Tanto quanto possível, tente reutilizar as etiquetas existentes em vez de fazer novas. Quando você começar a digitar, nosso site deve fornecer opções completas auto que devem ajudar lá. Lembre-se que as tags podem incluir espaços, e as tags devem ser separadas com vírgulas.

No mínimo, sugiro que você marque seu post com a versão TurnKey (por exemplo, "14.0" ou "14.1" - veja abaixo) e o nome appliance (por exemplo, "redmine" ou "lamp"). Se é um determinado pedaço de software com o qual você está tendo problemas, então marque isso também (por exemplo, "Webmin" ou "TKLBAM"). Tags podem sempre ser editados mais tarde, então não tenha medo!

Que versão do TurnKey é?

Os bugs quase sempre se aplicam a uma versão específica (ou versões) do software. Assim, para dar a quem quiser ajudar você a começar, forneça a versão do TurnKey que você tem. Se você não tem 100% de certeza, há uma maneira muito fácil de verificar a partir da linha de comando:

turnkey-version

Deve produzir um resultado como este (v15.1 LAMP appliance):

turnkey-lamp-15.1-stretch-amd64

Para onde é que está a correr?

TurnKey produz uma gama de compila. Eles são todos construídos a partir do ISO originalmente, então geralmente deve compartilhar bugs em plataformas. No entanto, nem sempre é assim, uma vez que cada construção diferente tem algum grau de personalização. Também diferentes plataformas têm suas peculiaridades e idiossincrasias que os recém-chegados e/ou desenvolvedores podem nem sempre estar cientes. Assim, para ajudar a reduzir o atrito, indicando onde seu appliance está rodando também pode ser útil. Por exemplo:

t2.pequeno servidor no TurnKey Hub

OVA em VirtualBox v6.0.4 no Windows 10

etc...

O que estás a tentar alcançar?

Geralmente é útil entender o que você estava tentando fazer quando o comportamento inesperado ocorreu. Às vezes, pode iluminar um mal-entendido em seu nome (talvez o problema seja realmente o comportamento esperado do comando que você está usando)? Se não o disser, o seu objectivo não será óbvio. Também como há quase sempre múltiplas maneiras de "pegar um gato", talvez haja uma maneira melhor / mais fácil de alcançar seus fins desejados?

O que tentaste até agora?

Se você seguiu algumas instruções que encontrou online (por exemplo, uma publicação aleatória do blog ou uma pergunta de StackOverflow), publique um link para ele. Isso pode nos ajudar a entender por que não funcionou. Talvez não seja compatível com a versão atual? Por exemplo, as instruções se aplicam a uma versão mais antiga do Debian/TurnKey que não se aplica mais ou é irrelevante para a sua situação.

Qual foi o resultado?
Ou seja, qual é a natureza exata do erro/problema?

Este não precisa de muita explicação. Se houve uma mensagem de erro específica, publique- a. Se você encontrou alguns problemas nos seus registos, publique as partes relevantes. Para grandes logs longos, considere anexá-los ao seu post, em vez de copiá-los / passá-los. Isso é na verdade outra razão para começar seu próprio tópico; apenas o primeiro post pode ter anexos! Por favor, sinta-se livre para redigir qualquer conteúdo que você possa achar sensível ou privado, mas por favor note quais alterações você fez para logs, mensagens de erro, etc.

Capturas de tela de problemas também podem ser úteis (especialmente erros visuais de conteúdo web dentro do seu navegador), no entanto, se você está compartilhando uma mensagem de erro é muito melhor para postar o texto do erro como texto. Torna mais fácil pesquisar as mensagens de erro no Google e também torna muito mais fácil para o Google encontrar o seu tópico no futuro (para ajudar os outros).

Que outras coisas fizeste recentemente?

Também é bom notar que outros ajustes você fez recentemente dentro do TurnKey (mesmo se você acha que é irrelevante - veja acima re verbosidade ponto). Às vezes, as coisas que mudaste têm consequências não intencionais e às vezes uma combinação de ajustes aparentemente não ligados pode causar problemas. Muitas vezes não, mas quanto mais informação você fornecer mais fácil é ajudá-lo!

Está na hora de colocar um insecto?

Se você tem certeza de que está "fazendo certo" mas recebendo o resultado errado, então pode ser um erro legítimo. localizador de emissão. Mais uma vez fornecer informações sobre sua versão TurnKey, o que você fez e o que você estava esperando, etc.

Se você não tem certeza, provavelmente é melhor postar nos Fóruns de Suporte primeiro, mas isso não importa. Fechando bugs (que não são realmente bugs) é fácil! :)