Observium

Esta página de documentação fornece Informações relacionadas com o TurnKey Linux Observium appliance. A versão atual deste documento foi escrita especificamente com TurnKey versão 18.x em mente, mas deve permanecer compatível com versões mais recentes.

Por favor, forneça feedback e/ou problemas sobre esta página de documentos através da Fórum TurnKey (requer conta gratuita do usuário do site TurnKey Lnux). Alternativamente, erros de documentação podem ser reportados através de nossa rastreador de emissão TurnKey Linux consolidado.

Problema conhecido: "Não foi possível adicionar dispositivo manualmente via web, não foi possível ping <hostname>"

Como referido no documento TurnKey Linux consolidado localizador de emissão, esta questão pode ser resolvida se desejar. comentário no número) os documentos do Observatório recomendam que você não faça isso por causa de implicações de segurança; e em vez disso use o CLI para adicionar dispositivos. Então, cabe a você...

Actualização do Observatório

Todas estas instruções de actualização são baseadas no Documentação de Atualização do Obervium. Há aqui pormenores adicionais específicos para o TurnKey Observium appliance. Independentemente disso, você pode querer consultar a página de documentação oficial também - especialmente se você atualizar para uma Edição de Assinatura.

Conteúdo:

• Antes de começar; Backup!
• Uma nota importante para usuários do AWS Marketplace
• Atualizando o Observatório CE usando o script de atualização
• Actualização manual do Observatório CE
• Atualizando o Observatório CE para o Observatório Pro/Edição da Empresa
• Atualizando a edição de assinatura para a última
• Opções de atualização alternativa/adicional do Observatório Pro/Enterprise

Antes de começar; Backup!

Um regime de backup automatizado (por exemplo, usando TKLBAM) deve ser sempre configurado para qualquer sistema que contenha dados que você se importa. A perda de dados do sistema é sempre uma questão de quando, não se. O processo de atualização do Observatório deve ser suave, então um backup recente pode ser um pedaço de mente suficiente. Independentemente disso, um backup manual imediatamente antes de uma atualização de software é sempre recomendado.

O processo de atualização do Observatório documentado abaixo mantém uma cópia dos seus arquivos antigos do Observatório. No entanto, ele não mantém uma cópia do seu banco de dados original. Sem um backup adequado, você pode não ser capaz de voltar para uma versão anterior se algo der errado. O único cenário em que um backup não é tão importante é se você tiver apenas configurado seu servidor de Observatório e não tiver dados existentes. Mesmo assim, um backup ainda poderia poupar tempo se as coisas derem errado e você precisa voltar atrás.

Uma nota importante para usuários do AWS Marketplace

A maioria dos servidores TurnKey é padrão para usar o usuário 'root'. Se for você, leia. Para aqueles que usam TurnKey lançados do AWS Marketplace, eles são padrão para um usuário 'admin'. Então você precisará mudar para o usuário 'root' antes que essas instruções funcionem. Você pode prefixar todos os comandos com 'sudo', mas isso é uma dor. Em vez disso, recomendo que o 'root' user para este processo. Você pode fazer isso assim:

sudo su -

Quando terminar, mude de volta para o usuário 'admin', emitindo o comando 'saída'.

Atualizando o Observatório CE usando o script de atualização

Faça backup do seu sistema

Executar um manual backup como já foi referido.

Atualizando através do script 'turnkey-update-observarium' - incluído no TurnKey Observarium appliance

Este script automatiza as instruções de atualização manual, além de criar um backup local dos arquivos do Observatório (/opt/observium). O script é escrito em BASH e a fonte da versão incluída com o seu servidor pode ser visualizada em /usr/local/bin/turnkey-update-observium ou o código fonte mais recente em GitHub.

Para executar o script do CLI:

turnkey-update-observium

Até o momento, houve um feedback limitado relacionado a este script de atualização, embora não tenha havido relatos de erros ou problemas. No entanto, devido ao feedback limitado quando o script é executado, ele relata que é "experimental". Apesar disso, ele deve funcionar de forma confiável (veja abaixo nota). Como por qualquer atualização ou alterações significativas de configuração, é sempre recomendável que você tenha um backup (por exemplo, TKLBAM) no caso de algo correr mal.

Como observado ao executar o script:

Note que este script irá verificar a versão atual a partir de dados criados no tempo de compilação TurnKey appliance. Se o Observatório foi atualizado por um método alternativo (ou o arquivo não existe) ele sempre baixará e "atualizará" para o mais recente Observatório CE (community Edition). Ele fará isso, mesmo que você já esteja executando a versão mais recente do CE; ou tenha instalado através de um canal alternativo!

Actualização manual do Observatório CE

Estas instruções baseiam-se na Documentos oficiais de atualização do Observatório CE - com alguns pormenores adicionais especificamente relacionados com a TurnKey Linux Observium appliance. Todos os comandos devem ser executados a partir da linha de comando como o usuário root.

Faça backup do seu sistema

Executar um manual backup como já foi referido.

Desactivar o Observatório cronjobs (opcional)

Os trabalhos do Cron são tarefas automatizadas que são executadas em um cronograma. Geralmente os trabalhos do Cron estão relacionados com o Observatório "mantendo a casa". Desativar os trabalhos do Cron é opcional. No entanto, se você não fizer este passo, você pode obter alguns erros de cron notado em seus logs. Se você desabilitar as tarefas de cron, certifique-se de que você também re- habilitar após a atualização (trabalhos de cron re-enabligne cobertos mais tarde nestas instruções).

Para desativar tarefas do Observatório cron:

Ou edita manualmente o arquivo cron - /etc/cron.d/observium - e comente todas as linhas cron ativadas. Ou seja, adicione um caractere '#' a cada linha que ainda não comece com um '#'. Se você não tem experiência com este processo, sugere-se que você adicione um '#' a cada linha (então todos os comentários existentes são prefixados com '##').

Alternativamente, execute o comando sed imediatamente abaixo da linha de comando. Por favor, note que este comando irá adicionar um '#' a cada linha no arquivo cron (como por instruções manuais acima). Este comando não é idempotente, então faça NOT execute-o mais de uma vez! Se o fizer, então terá de editar manualmente o ficheiro cron para descomentar as linhas do cron e deixar os comentários reais com um prefixo '#'.

sed -i "s|^|#|" /etc/cron.d/observium

Substituir os ficheiros antigos pela nova versão

Os seguintes comandos movem os arquivos de Observatório atuais para fora do caminho, baixam a versão mais recente e copiam de volta os arquivos necessários (ficheiro de configuração e diretórios de registros e rdd) a partir da sua instalação original do Observatório.

Executa os seguintes comandos (como root):

cd /opt
mv observium observium_old
wget -Oobservium-community-latest.tar.gz https://www.observium.org/observium-community-latest.tar.gz
tar zxvf observium-community-latest.tar.gz
mv /opt/observium_old/rrd observium/
mv /opt/observium_old/logs observium/
mv /opt/observium_old/config.php observium/

Actualizar o esquema DB

Atualizar o esquema DB para a nova versão:

/opt/observium/discovery.php -u

Forçar a redescoberta (opcional)

Se já faz muito tempo desde que você atualizou (12 meses ou mais), você pode querer forçar uma redescoberta imediata de todos os dispositivos para garantir que as coisas estão atualizadas:

/opt/observium/discovery.php -h all

Re-ativar cronjobs de observação (opcional)

Ativar as tarefas do cron só é necessário se você as desabilitou antes de fazer a atualização do Observatório. Se você pulou esse passo inicial, certifique- se de que você o faz NOT siga este passo! Em vez disso, salte diretamente para a próxima seção.

Para habilitar manualmente as tarefas do cron, inverta o processo feito na seção de desabilitar tarefas do cron acima. descomentar as linhas de comando cron no arquivo cron do Observatório - /etc/cron.d/observium .

Se você desabilitou as tarefas do cron através da linha sed indicada acima - na seção de desabilitar tarefas cron acima, então você pode reativá-las com a linha sed abaixo. Ele removerá o caractere '#' (primeiro) de cada linha. Fazer NOT faça isto a menos que tenha usado o comando sed anterior para desactivar as tarefas do cron. De acordo com o comando sed anterior, não é idempotente, por isso faça NOT execute-o mais de uma vez! Se o fizer, então terá de editar manualmente o ficheiro cron para comentar (adicionar um '#' à) as linhas de comentários intencionais no trabalho cron.

sed -i "s|^#||" /etc/cron.d/observium

Limpeza final (opcional)

Uma vez que você tenha confirmado que a atualização funcionou como esperado, você pode agora excluir os arquivos antigos do Observatório criados no processo de atualização do arquivo acima. Ou seja, remover o diretório observarium_old:

rm -rf /opt/observium_old

Atualizando o Observatório CE para o Observatório Pro/Edição da Empresa

Estas instruções baseiam-se na Observatório CE oficial -> Observatório Pro docs - com alguns pormenores adicionais especificamente relacionados com a TurnKey Linux Observium appliance. Eles são relevantes tanto para as edições de assinatura Pro quanto Enterprise. Todos os comandos devem ser executados a partir da linha de comando como o usuário root - tantos usuários TurnKey estão prontos para ir. Os utilizadores do AWS Marketplace terão de mudar para o usuário raiz Primeiro.

sudo su -

Como observado na página dob. pertinente:

O Observatório foi concebido com facilidade de actualização e migração sem descontinuidades em mente, permitindo aos utilizadores a transição sem problemas da edição comunitária para o profissional ou Edição da Enterprise.

Faça backup do seu sistema

Executar um manual backup como já foi referido.

Instalar subversion

As edições de assinatura do Observatório fornecem o código de instalação inicial e as futuras atualizações através do sistema de controle de versão SVN (subversion). O TurnKey Observaium appliance não inclui o software de subversão necessário por padrão. No entanto, ele pode ser facilmente instalado via apt (como usuário de raiz):

apt update
apt install subversion

Desactivar as tarefas do Observatório cron (recomendado)

Os trabalhos do Cron são tarefas automatizadas que executam em um cronograma. Geralmente os trabalhos do Cron estão relacionados com o Observatório "mantendo a casa", embora incluam outras funcionalidades. Desativar as tarefas de cron durante a atualização é recomendável, embora estritamente falando é opcional. Contudo se o poller do Observatório (acionado por um trabalho do cron) for executado durante o processo de checkout de código ou ao mover o diretório rdd, ele pode ter consequências não intencionais. Se você desativar as tarefas do cron, certifique-se de que você também re- habilitar eles após a atualização (re-ativar trabalhos de cron é coberto mais tarde nestas instruções).

Para desativar tarefas do Observatório cron:

Ou editar manualmente o arquivo cron - /etc/cron.d/observium - e comentar todas as linhas de trabalho cron. Ou seja, adicionar um caractere '#' ao início de cada linha de trabalho cron. Recomenda-se adicionar um '#' a cada linha. Isso significa que os comentários intencionais existentes são prefixados com '##' e tornarão a re-alocação mais confiável e menos propensa a erros.

Alternativamente, você pode executar o comando sed imediatamente abaixo através da linha de comando. Por favor, note que este comando adicionará um '#' a cada linha no arquivo cron (como por recomendação em instruções manuais). Este comando sed não é idempotent - significa que re- executar este script causará alterações adicionais. NOT execute- o mais de uma vez! Se o fizer, terá de corrigir/editar manualmente o ficheiro cron para reactivar as tarefas do cron.

sed -i "s|^|#|" /etc/cron.d/observium

Migrar para o código do repositório SVN - substitua os arquivos antigos pela versão SVN

Para migrar para o código entregue pelo repositório SVN, você precisa verificar uma nova cópia do código e transferir seu diretório config.php e rrd existente para a nova cópia.

Os comandos abaixo instalarão o trem estável. Se preferir usar o trem rolando, substitua ramos/estável no terceiro comando por tronco. Consulte os documentos do Observatório para mais detalhes.

Durante o processo de atualização abaixo, você será solicitado para obter um nome de usuário e senha. Portal de Assinatura do Observatório.

Os seguintes comandos movem os arquivos de Observatório atuais para fora do caminho, baixando a versão mais recente estável da assinatura do Observatório via versão SVN e, em seguida, copiando de volta o arquivos necessários (ficheiro de configuração e diretórios de registros e rdd) da instalação original do Observatório.

cd /opt
mv observium observium-old
svn co https://svn.observium.org/svn/observium/branches/stable observium
cp observium-old/config.php observium
mv observium-old/rrd observium-old/logs observium
cd observium
./discovery.php -u

Reactivar as tarefas de Observatório cron (recomendado - necessário se estiver desactivado acima)

É necessário voltar a aceder às tarefas do cron se as tiver desactivado antes da actualização do Observatório - como recomendado. Se tiver ignorado esse passo inicial, certifique- se de que o faz NOT siga este passo! Em vez disso, salte diretamente para a próxima seção.

Para habilitar manualmente as tarefas do cron, inverta o processo feito nas tarefas de cron desabilitadas passo acima. remover o '#' do início de cada linha (exceto os comentários intencionais) no arquivo cron do Observatório - /etc/cron.d/observium .

Se você desabilitou as tarefas do cron através do comando sed observado no passo inicial de desabilitar as tarefas cron acima, então você pode reativá-las com a linha sed abaixo. Ele removerá o caractere '#' (primeiro) de cada linha. Fazer NOT fazer isto a menos que você usou o comando sed anterior para desactivar as tarefas do cron. Como no comando sed anterior, este comando não é idempotente e fará alterações adicionais se for executado mais de uma vez. Assim como eu. NOT execute-o mais de uma vez! Se o fizer, então terá de editar/fixá-lo manualmente para que os comentários intencionais sejam prefixados com '#'.

sed -i "s|^#||" /etc/cron.d/observium

Se necessário, o arquivo de cron TurnKey Observaium padrão pode ser consultado se precisar de corrigir o seu ficheiro cron.

Limpeza final (opcional)

Uma vez que você tenha confirmado que a atualização de migração funcionou como esperado, você pode agora excluir os arquivos antigos do Observatório criados no processo de atualização acima. Ou seja, remover o diretório observarium_old:

rm -rf /opt/observium_old

Atualizando a edição de assinatura para a última

Este processo só se aplica se você já tiver atualizado o Observatório para um edição da assinatura.

Faça backup do seu sistema

Antes de começar, execute um manual backup como já foi referido.

Desactivar as tarefas do cron (opcional, mas recomendada)

Desactivar as tarefas do Observatório em cron tal como documentado acima.

Atualizar para a versão estável mais recente

Atualizar as edições de assinatura do Observatório usando SVN é simples. Para atualizar a Edição de Assinatura do Observatório para a última versão estável, use os comandos abaixo:

cd /opt/observium
svn update
./discovery.php -u

Opções de atualização alternativa/adicional do Observatório Pro/Enterprise

Por favor, note que o software webapp geralmente não suporta a redução para uma versão anterior. Não posso confirmar que é especificamente o caso do Observatório, mas se você se mantiver nessa regra, então você é menos provável que atinja problemas. backup como já foi referido, é sempre recomendada e considerada a melhor prática.

Atualizar a Edição de Assinatura do Observatório para revisão específica

Em vez de atualizar para o stable mais recente, você pode desejar atualizar para uma revisão específica, ou seja, um lugar específico na linha do tempo de lançamento estável. Atualizar o Observatório para revisão específica é muito semelhante ao processo e comandos observados no atualização instruções acima. No entanto, o comando 'svn update' é adicionado com '-r <revision number>'. Ou seja:

svn update -r <revision number>

Por exemplo, digamos que você deseja instalar/atualizar a versão 0.12.4.3049. A revisão SVN é o último número, então execute o seguinte:

svn update -r 3049

Por favor, veja o fóssil. Documentos de atualização da edição de assinatura do Observatório para mais opções e detalhes.