Atualização para openQRM 5.1 no Debian Wheezy

Versão 1.0
Última edição 01. Outubro 2013
Autor Matt Rechenburg

Este HowTo é sobre como atualizar um ambiente openQRM existente na versão 4.9 ou 5.0 para a mais recente openQRM 5.1 no Debian 7, também conhecido como Wheezy.

Requisitos

uma instalação openQRM existente < versão 5.1 (por exemplo, 4.9 ou 5.0)

Faça backup do seu ambiente openQRM existente

Aqui está uma captura de tela de uma configuração openQRM 5.0 existente e totalmente configurada:

Aqui está uma captura de tela dos detalhes da versão desta configuração openQRM 5.0

openQRM consiste em “arquivos” e um “banco de dados”. Ter um backup de ambas as partes permite “reverter” a atualização a qualquer momento.

Todos os arquivos no openQRM estão localizados dentro do diretório base do openQRM (normalmente /usr/share/openqrm). Para criar um backup simples, execute os seguintes comandos como ‘root’ no seu servidor openQRM:

cp -aR /usr/share/openqrm /usr/share/openqrm-5.0.before-update

Para fazer backup do conteúdo do banco de dados openQRM (assumindo mysql como o backend do banco de dados), execute:

mysqldump openqrm -p > /usr/share/openqrm-5.0.before-update/openqrm-db.sql

Este comando pedirá a senha do banco de dados openQRM.

Por favor, note!

A qualquer momento neste howto, você pode reverter para o seu ambiente openQRM existente executando como ‘root’

mv /usr/share/openqrm /usr/share/openqrm-update-rolled-back && mv /usr/share/openqrm-5.0.before-update /usr/share/openqrm && /etc/init.d/openqrm restart

Além disso, o openQRM fornece um ‘backup de estado’ que captura o estado completo (todos os arquivos de configuração e o conteúdo dos bancos de dados). Um ‘backup de estado’ do openQRM também permite “reverter” a atualização a qualquer momento. Para executar um backup de estado, execute:

/usr/share/openqrm/bin/openqrm state backup -n 5.0.before-update

Para listar todos os backups de estado, execute:

/usr/share/openqrm/bin/openqrm state list

Para aplicar/restaurar um backup de estado, execute, por exemplo:

/usr/share/openqrm/bin/openqrm state restore -n [backup-name]

Aqui estão os comandos a serem aplicados para um backup padrão antes de uma atualização:

Atualizar openQRM para a versão 5.1

Obter a versão openQRM 5.1

Este howto para atualizar um ambiente openQRM existente para openQRM 5.1 funciona para a Edição Comunitária do openQRM da mesma forma que para a Edição Empresarial do openQRM.

O procedimento de atualização para openQRM 5.1 é direto.

Obtenha a Edição Comunitária do openQRM 5.1 em http://sourceforge.net/projects/openqrm/ ou obtenha a Edição Empresarial do openQRM em http://www.openqrm-enterprise.com/

Como ‘root’, mude para o diretório ../src e execute:

make && make update

A fase ‘make’ está baixando os novos componentes para a versão openQRM 5.1 e preparando a fonte para uma instalação ou atualização. A fase ‘make update’ realmente realiza as seguintes ações para atualizar a configuração openQRM existente:

Como primeiro passo, o procedimento de atualização cria um backup de estado atual, conforme descrito acima.

Como segundo passo, ele cria um diretório ‘mirror’ /usr/share/openqrm_pre_update. Isso é para comparar o conteúdo de todos os arquivos de configuração em um passo posterior.

Como terceiro passo, ele realmente executa a ação de instalação, que então sobrescreve o conteúdo atual de /usr/share/openqrm.

Como quarto passo, o procedimento de atualização verifica todos os arquivos de configuração e aplica os valores configurados atuais à nova instalação.

Como quinto passo, ele aplica eventualmente atualizações do esquema do banco de dados.

Como último passo, ele atualiza os arquivos initrd do kernel (usados pela implantação de rede) e reinicia o openQRM

Por favor, note!

Após a atualização, é necessário reiniciar o ‘openqrm-client’ em todos os sistemas integrados!

Apenas para a Edição Empresarial do openQRM (pule se você estiver usando a Edição Comunitária do openQRM)

A Edição Empresarial do openQRM encaminha para o Upload de Licença.

Por favor, selecione as chaves de licença Pública, Servidor e eventuais Clientes da Enterprise e clique em enviar.

Por favor, note!

Com openQRM 5.1, os seguintes plugins foram mesclados:

citrix + citrix-storage para citrix

kvm + kvm-storage para kvm

xen + xen-storage para xen

Os seguintes plugins foram renomeados:

lxc-storage para lxc

openvz-storage para lxc

Para esses plugins, o diretório de configuração da VM mudou de /var/lib/[plugin-name]-storage para /var/lib/[plugin-name]. por exemplo, para o plugin KVM-Storage, é necessário mover o diretório de configuração da VM anterior /var/lib/kvm-storage para /var/lib/kvm. Para KVM-Storage, execute o seguinte comando como ‘root’ para fazer a migração do diretório.

mv /var/lib/kvm-storage /var/lib/kvm

O procedimento de atualização não fará isso automaticamente, pois é recomendado que este diretório seja montado a partir de um NAS!

Por favor, note!

Se você estiver usando qualquer um dos plugins acima, a maneira mais segura de fazer a atualização para 5.1 é parar e remover todos os appliances e recursos de VM (mantendo apenas as Imagens de VM), e então fazer a atualização. A versão 5.1 fornece uma maneira fácil de trazer as Imagens de volta para o openQRM. Então, simplesmente crie novos recursos de VM e adicione novos servidores com as Imagens de VM existentes.

Aqui está uma captura de tela da interface do openQRM após a atualização bem-sucedida para openQRM 5.1