Atualizando o Confluence

Antes de começar

Antes de atualizar o Confluence, você precisa responder a algumas perguntas. 

O instalador é o método correto de atualização para você?	Quero saber mais... É possível optar por atualizar usando o instalador ou manualmente, usando um arquivo zip ou tar.gz. Na maioria dos casos, o instalador é a maneira mais fácil de atualizar sua instância do Confluence. Será necessário atualizar manualmente se: você estiver mudando para outro sistema operacional ou localização de arquivos como parte dessa atualização. você estiver atualizando do Confluence 3.5 ou uma versão mais antiga você estiver atualizando do Confluence 5.6 ou uma versão mais antiga e tiver usado anteriormente a distribuição EAR/WAR para implantar o Confluence em um servidor de aplicação existente.
Você está qualificado para a atualização?	Quero saber mais... Para verificar se a manutenção do software está atualizada para sua licença, vá até  > Configuração geral > Ferramentas de suporte e certifique-se de que o período de suporte da licença ainda não tenha expirado. Se seu período de suporte tiver expirado, siga as instruções na tela para renovar sua licença e reaplicá-la antes de atualizar.
Nossas plataformas com suporte mudaram?	Quero saber mais... Dê uma olhada na página Plataformas com suporte da versão do Confluence que você está atualizando. Aqui você obterá informações sobre sistemas operacionais, bancos de dados e navegadores com suporte. É bom saber: O instalador do Confluence inclui Java (JRE) e Tomcat; por isso, você não precisará atualizá-los separadamente. Se precisar atualizar seu banco de dados, certifique-se de ler as observações de atualização da versão do Confluence para a qual você pretende atualizar (e as intermediárias) para verificar se há alterações que talvez você precise realizar na configuração do banco de dados.
Você precisar fazer alterações em seu ambiente?	Quero saber mais... Às vezes, versões mais recentes do Confluence exigem alterações em seu ambiente, como o fornecimento de mais memória ou o ajuste das configurações de proxy reverso. É bom saber: Usamos as Notas de atualização para comunicar alterações que afetarão você, como: Alterações nos bancos de dados com suporte, requisitos de memória ou outras alterações que afetarão seu ambiente. Recursos que tenham mudado significantemente ou que tenham sido removidas na versão em questão. Ações que talvez você precise realizar em sua instância ou ambiente imediatamente após a atualização. É importante ler as notas da versão para a qual você está atualizando e das versões entre a atual e a nova. Por exemplo, se for atualizar da 5.8 para a 5.10, você deve ler as notas de atualização da 5.9 e da 5.10.

Planeje sua atualização

1. Determine o caminho de sua atualização

2. Conclua as verificações de pré-atualização

1. Verifique as Notas de atualização da versão para a qual você pretende atualizar (e todas as versões entre uma e a outra). 
     

2. Vá até  > Configuração geral > Ferramentas de suporte para executar a verificação de integridade (disponível no Confluence 5.5 ou mais recente). 
   
   

   Licença expirada?

   Se o período de manutenção do software incluso em sua licença tiver expirado, você pode continuar usando o Confluence, mas será necessário renovar antes de poder atualizar.

   Vá até  > Configuração geral > Detalhes da licença e siga as instruções na tela para renovar sua licença.

   Ainda está usando o banco de dados integrado?

   Se estiver usando o banco de dados integrado (de avaliação), você deve migrar para um banco de dados diferente antes de atualizar.

   Esse banco de dados é fornecido apenas para fins de avaliação e não é recomendado para ambientes de produção. Consulte Banco de dados H2 integrado para obter mais informações.

   A codificação de caracteres do banco de dados está incorreta?

   A conferência de banco de dados precisa ser configurada como UTF+8 (ou AL32UTF8 para bancos de dados Oracle). Não será possível atualizar para versões atuais do Confluence se você não tiver a codificação de caracteres correta.

     

3. Vá até  > Complementos > complementos e desça até a Verificação de atualização do Confluence para verificar a compatibilidade dos seus complementos.
     

4. Escolha a versão para a qual você planeja atualizar e clique em Verificar.
   
   

   Se você tiver complementos incompatíveis...

   Se seus usuários utilizarem complementos específicos, talvez seja interessante esperar até eles se tornarem com suporte antes de atualizar o Confluence. Fornecedores de complementos costumam atualizar seus complementos pouco depois do lançamento de uma versão principal.

   É bom saber:

   • É possível desativar temporariamente um complemento enquanto você atualiza, caso ele ainda não seja com suporte.
   • Não costuma haver informações de compatibilidade da Atlassian Labs e outros complementos grátis disponíveis imediatamente após o lançamento de uma nova versão. Em muitos casos, o complemento continuará funcionando; por isso, experimente em um site de teste antes de atualizar seu site de produção.

3. Atualize o Confluence em um ambiente de teste

1. Crie uma cópia de testes do seu ambiente de produção atual. 
   Consulte Criar um ambiente de testes para atualizar o Confluence para obter ajuda na criação de um ambiente no qual testar sua atualização.
     

2. Siga os passos abaixo para atualizar seu ambiente de teste.  
     

3. Teste todos os complementos não com suporte, personalizações (como temas ou layouts personalizados) e configuração de proxy (se possível) antes de atualizar seu ambiente de produção.   

Atualize o Confluence

4. Faça backup 

1. Faça backup do seu banco de dados e confirme se o backup foi criado corretamente. 
   Se o seu banco de dados não for com suporte com backups on-line, será preciso encerrar o Confluence primeiro. 
     

2. Faça backup de seu diretório de instalação e do diretório pessoal. 
   O assistente de instalação fará backup de seus diretórios do Confluence como parte do processo de instalação, mas você também deverá fazer backup desses diretórios antes de iniciar a atualização. 
     

   Onde está meu diretório pessoal?

   É possível encontrar a localização do seu diretório pessoal no arquivo <installation-directory>/confluence/WEB-INF/classes/confluence-init.properties .

   É nele que seus índices de pesquisa e anexos estão armazenados. Se você armazenar anexos fora do diretório pessoal do Confluence, você também deverá fazer backup de seu diretório de anexos. 

5. Baixe o Confluence

Baixe o instalador para seu sistema operacional – https://www.atlassian.com/software/confluence/download

6. Execute o instalador

1. Execute o instalador. 
     

   Mostre como fazer isso no Windows...

   Execute o arquivo .exe. Recomendamos usar uma conta de administrador do Windows.

   Se for solicitado para permitir que o assistente de atualização faça alterações no seu computador, escolha "Sim". Se não, o assistente de instalação terá acesso restrito ao seu sistema operacional e qualquer opção de instalação subsequente será limitada.

   Mostre como fazer isso no Linux...

   Altere para o diretório para onde você baixou o Confluence e, em seguida, execute o seguinte comando para tornar o instalador executável:

   $ chmod a+x atlassian-confluence-X.X.X-x64.bin

   Onde X.X.X é a versão do Confluence que você baixou.

   Em seguida, execute o instalador – recomendamos que você use o sudo para executar o instalador:

   $ sudo ./atlassian-confluence-X.X.X-x64.bin

   Você também pode optar por executar o instalador com privilégios de usuário raiz.

     

2. Siga as instruções para atualizar o Confluence:
    
   
   1. Quando solicitado, escolha Atualizar uma instalação existente do Confluence (para usuários do Linux, esta é a opção 3).
        
   2. Certifique-se de que o diretório de instalação existente do Confluence sugerido pelo assistente esteja correto (especialmente importante se você tiver várias instalações do Confluence na mesma máquina).
        
   3. Fazer backup da página inicial do Confluence é extremamente recomendado. Isso criará um backup .zip da página inicial do Confluence e dos diretórios de instalação.
        

   4. O assistente de instalação avisa sobre as personalizações no diretório de instalação do Confluence. Tome nota disso, pois será preciso reaplicá-las posteriormente.

      Há algumas limitações...

      A capacidade do assistente de instalação de avisar sobre as personalizações dependerá de como sua instância do Confluence foi instalada: 

      • Se sua instância atual do Confluence foi instalada com o uso do instalador, o assistente verificará todo o diretório de instalação do Confluence.
      • Se sua instância atual do Confluence foi instalada manualmente, o assistente verificará somente o subdiretório confluence do diretório de instalação do Confluence. O assistente de instalação não avisará sobre modificações em qualquer outro diretório, por exemplo, modificações em scripts de inicialização sob o diretório bin ou modificações no arquivo server.xml (como uma configuração SSL). 
3. O assistente encerrará a instância do Confluence e continuará com a atualização. Quando concluído, ele reiniciará o Confluence e você poderá então iniciar o Confluence em seu navegador para confirmar se a atualização foi bem-sucedida.
    
   Dependendo do tamanho de sua instância e o número de tarefas de atualização a serem realizadas, essa etapa pode levar alguns minutos ou várias horas.

Após a atualização

7. Copie o driver do seu banco de dados

8. Reaplique todas as modificações

Durante a atualização, o assistente migrou os itens a seguir de sua instalação existente do Confluence:

• Valores de portas TCP em seu arquivo server.xml. 
• Localização de seu diretório pessoal do Confluence em confluence-init.properties.
• ParâmetrosCATALINA_OPTS ou JAVA_OPTS  em seus arquivos  setenv.sh / setenv.bat.
    

Todas as outras personalizações precisam ser reaplicadas manualmente.  

9. Atualize seu proxy reverso e verifique se você consegue acessar o Confluence

Solução de problemas