9.2. Aplicando Patches ao Red Hat JBoss BPM Suite 6.3

No Red Hat JBoss BPM Suite, a ferramenta de aplicação de patches do cliente é distribuída como um arquivo zip que inclui os scripts simples .sh e .bat, permitindo a aplicação automática e fácil das atualizações de uma instalação do Red Hat JBoss BPM Suite 6.1 (ou superior) existente.

O script necessita de dois parâmetros mandatórios: <path-to-distribution-root> e <type-of-distribution>. Por exemplo, o comando a seguir aplica as atualizações ao pacote JBoss EAP especificado:

$ ./apply-updates.sh ~/EAP_HOME/jboss-eap-6.4 eap6.x

Os tipos de distribuição a seguir possuem suporte:

A ferramenta de migração e os guias de início rápido também estão incluídos no patch e estão disponíveis para download como um arquivo zip.

Antes de aplicar qualquer atualização, o script do cliente faz um backup da distribuíção especificada. Ele copia o arquivo de distribuição ou o diretório no subdiretório backup/<current-timestamp>. O diretório de backup de nível superior é criado no mesmo nível do sistema de arquivos, como o script apply-updates.

A ferramenta de aplicação de patches do cliente fornece um recurso de lista negra, permitindo que você informe ao script os arquivos que não devem ser atualizados. Esse é um recurso muito útil que ajuda a preservar os seus arquivos configurados de serem substituídos automaticamente pelo processo de atualização. Mas, você pode especificar os arquivos não configurados também, caso necessário.

Para especificar os arquivos na lista negra, abra o arquivo blacklist.txt dentro da distribuição de patch. Insira o caminho relativo para os arquivos que não devem ser atualizados. Cada arquivo deve ser especificado em sua própria linha.

# lines with a '#' are comment lines, like this one
# blank lines are ignored

# we have made changes to the web.xml that must be preserved
WEB-INF/web.xml

# this file has custom modifications
styles/base.css

Os arquivos especificados no arquivo blacklist.txt que possuem conteúdos atualizados no patch, não são tocados pela ferramenta de atualização. Ao invés disto, a ferramenta copia o arquivo novo e atualizado no mesmo local e anexa o sufixo new, 'novo', a ele. Por exemplo, após executar a ferramenta de aplicação de patches, ambos os arquivos existirão na pasta styles, continuando com o arquivo blacklist.txt no exemplo acima.

$ ls styles
base.css base.css.new

Cabe a você comparar os conteúdos dos dois arquivos e mesclar as alterações.

Caso existam arquivos que não sejam distribuídos mais, mas você gostaria de mantê-los, você deve colocá-los também no arquivo blacklist.txt. A ferramenta de aplicação de patches não excluirá esses arquivos, ao contrário, criará um arquivo marcador vazio com o sufixo removed, 'removido'. Cabe a você também manter ou excluir esses arquivos manualmente.

Continuando com o exemplo anterior, se o arquivo base.css foi removido e ele estava listado no arquivo blacklist.txt, então, após a ferramenta de aplicação de paches ter sido executada, os conteúdos do diretório styles pareceriam com o seguinte:

$ ls styles
base.css base.css.removed