Instalando o Confluence no Linux

Guia de instalação do Confluence

On this page

In this section

Related content

  • No related content found

Still need help?

The Atlassian Community is here for you.

Ask the community

Neste guia, explicaremos a instalação do Confluence em um ambiente de produção, com um banco de dados externo, usando o instalador do Linux.

Essa é a maneira mais simples de colocar o site de produção em funcionamento em um servidor Linux.

 

 

Outras maneiras de instalar o Confluence: 

  • Avaliação - coloque seu teste gratuito em funcionamento rapidamente.
  • TAR.GZ – instalar o Confluence manualmente de um arquivo de armazenamento. 
  • Windows – instalar o Confluence em um servidor Windows.

Nesta página:

Antes de começar

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

 

Você está usando um sistema operacional com suporte?
Quero saber mais...

Dê uma olhada na Plataformas com suporte página da versão do Confluence que você está instalando. Aqui você obterá informações sobre sistemas operacionais, bancos de dados e navegadores com suporte.

É bom saber:

  • Não damos suporte à instalação do Confluence em OSX para sites de produção.
  • O instalador do Confluence inclui Java (JRE) e Tomcat; por isso, você não precisa instalá-los separadamente.
  • O Confluence não pode ser executado em OpenJDK.
Você deseja executar o Confluence como serviço?
Quero saber mais...

Executar o Confluence como serviço significa que o Confluence será iniciado automaticamente quando o Windows for iniciado.

Se você optar por executar o Confluence como serviço:

  • Será necessário usar sudo para executar o instalador para poder instalar o Confluence como serviço. 
  • O instalador criará uma conta de usuário dedicada, confluence, que executará o serviço.

Se você optar por não executar o Confluence como serviço:

  • Você iniciará e interromperá o Confluence executando o arquivo start-confluence.sh em seu diretório de instalação do Confluence.
  • O Confluence será executado como a conta de usuário que foi usada para instalar o Confluence, ou você pode optar por executar como usuário dedicado.
  • O Confluence precisará ser reiniciado manualmente se o seu servidor for reiniciado.
As portas 8090 e 8091 estão disponíveis?
Quero saber mais...

O Confluence é executado na porta 8090 por padrão. Se essa porta já estiver em uso, o instalador solicitará que você escolha uma porta diferente.

A sincronização, que é obrigatória para a edição colaborativa, é executada na porta 8091 por padrão. Se essa porta já estiver em uso, será preciso alterar a porta na qual a sincronização é executada depois que a instalação do Confluence estiver concluída. Consulte Administrando a edição colaborativa para saber como alterar a porta na qual a sincronização é executada. Não será possível editar páginas até que a Sincronização tenha uma porta disponível.

O banco de dados está configurado e pronto para uso?
Quero saber mais...

Será necessário um banco de dados externo para executar o Confluence na produção. Consulte a Plataformas com suporte página para saber a versão que você está instalando, a fim de obter uma lista de banco de dados com suporte atualmente. Se você ainda não tiver um banco de dados, o PostgreSQL é gratuito, fácil de configurar e foi testado extensivamente com o Confluence.

É bom saber:

  • Instale seu banco de dados antes de começar. Guias passo a passo estão disponíveis para o PostgreSQL, Oracle, MySQL e SQL Server.
  • Use codificação de caracteres UTF-8. Consulte Configurando a codificação de caracteres para obter mais informações.
  • Se estiver usando Oracle ou MySQL, você precisará baicar o driver para o seu banco de dados.
  • O banco de dados integrado H2 pode ser usado para avaliar o Confluence, mas será necessário migrar para outro banco de dados antes da execução em produção. Talvez seja mais fácil usar um banco de dados externo desde o início.

Você tem uma licença do Confluence?

Quero saber mais...

Você precisará de uma licença válida do servidor Confluence para usá-lo.

É bom saber:

  • Se você ainda não adquiriu uma licença do Confluence, você poderá criar uma licença de avaliação durante a configuração.
  • Se você já possui uma chave de licença, será solicitado a fazer login em my.atlassian.com para resgatá-la ou você poderá inserir a chave manualmente durante a configuração.
  • Se estiver migrando do Confluence Cloud, você precisará de uma nova licença.

 

Instalar o Confluence

1. Baixe o Confluence

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

2. Execute o instalador

  1. Torne o instalador executável.
     

    Mostre como fazer isso...

    Altere para o diretório para onde você baixou o Confluence e, em seguida, execute o seguinte comando:

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

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

  2. Execute o instalador – recomendamos usar sudo para executar o instalador, pois isso criará uma conta dedicada para executar o Confluence e permitir que você execute o Confluence como serviço.
     

    Mostre como fazer isso...

    Para usar o sudo para executar o instalador, execute este comando:

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

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

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

  3. Siga as instruções para instalar o Confluence. As seguintes informações serão solicitadas:
     
    • Tipo de instalação – escolha a opção 2 (personalizada) para ter maior controle. 
    • Diretório de destino – é onde o Confluence será instalado.
    • Diretório home – é onde os dados do Confluence como logs, índices de pesquisa e arquivos serão armazenados.
    • Portas TCP – é a porta do conector HTTP e a porta de controle nas quais o Confluence será executado. Use o padrão, a menos que você esteja executando outra aplicação na mesma porta.
    • Instalar como serviço – essa opção estará disponível apenas se você tiver executado o instalador como sudo. 
  4. Quando a instalação for concluída, vá para http://localhost:8090/ em seu navegador para iniciar o processo de configuração. 
    (Substitua 8090 se você tiver escolhido uma porta diferente durante a instalação). 

 

Problemas para iniciar o Confluence?

Se você estiver instalado o Confluence em uma instalação nova do Linux, consulte O Confluence gera o erro para ver opções de solução de problemas.

Configure o Confluence

3. Escolher o tipo de instalação

  1. Escolha Instalação de produção. 
      
  2. Escolha os complementos que você quer instalar.

4. Inserir a licença

Siga as instruções na tela para fazer login em my.atlassian.com para recuperar sua licença, ou insira uma chave de licença. 

5. Conectar-se ao seu banco de dados

  1. Se você ainda não tiver criado seu banco de dados, é hora de fazer isso. Consulte a seção "Antes de começar" desta página para obter detalhes. 
     
  2. Selecione seu banco de dados no menu suspenso e escolha Banco de dados externo.
     

  3. Escolha como você quer se conectar ao seu banco de dados:
     

    Conexão JDBC direta...

    Essa opção usa uma conexão de banco de dados JDBC padrão. A combinação de conexões é manejada dentro do Confluence.

    Se você estiver usando Oracle ou MySQL, há um passo extra: 

    • Baixe e extraia o Drivers JDBC de banco de dados adequados.
    • Solte o arquivo JAR dentro da sua pasta <confluence-installation>/confluence/WEB-INF/lib antes de continuar com o assistente de instalação.

    No assistente de instalação:

    • Nome da classe do driver – o nome da classe Java do driver do seu banco de dados. Se você não tiver certeza, verifique a documentação do banco de dados.
    • URL do banco de dados – o URL JDBC do seu banco de dados. Se você não tiver certeza, verifique a documentação do banco de dados.
    • Nome de usuário e Senha – Um nome de usuário e senha válidos que o Confluence possa usar para acessar seu banco de dados.
    Fonte de dados...

    Essa opção pede ao servidor de aplicação (Apache Tomcat) uma conexão de banco de dados. Será necessário adicionar manualmente a fonte de dados ao arquivo server.xml antes de poder continuar.

    Para configurar uma fonte de dados, siga nosso guia para o seu banco de dados:

    No assistente de instalação:

    • Nome da fonte de dados – é o nome JNDI da fonte de dados, conforme configurada no arquivo server.xml.
      Alguns servidores terão nomes JNDI como jdbc/datasourcename; outros serão algo do tipo java:comp/env/jdbc/datasourcename.

6. Preencher seu novo site com conteúdo

Escolha se você deseja que o Confluence preencha seu site com conteúdo:
 
Espaço de demonstração...

 Essa opção criará um espaço que você e seus usuários poderão usar para conhecer o Confluence. Você poderá excluir esse espaço a qualquer momento.

Importar dados de um site existente...

Use essa opção se você tiver uma exportação completa de site de um site Confluence existente. Essa opção é útil quando estiver migrando para outro banco de dados ou configurando um site de teste.  

É bom saber:

  • Só é possível importar sites da mesma versão ou anterior do Confluence.
  • A conta de administrador do sistema e todos os outros dados e conteúdo de usuários serão importados de sua instalação anterior.

No assistente de configuração:

  • Fazer upload de um arquivo de backup – use essa opção se seu arquivo de exportação de site for pequeno (25 mb ou menos).

  • Restaurar um arquivo de backup do sistema de arquivos – use essa opção se seu arquivo de backup for grande. Solte o arquivo em seu diretório <confluence-home>/restore  e siga as instruções para restaurar o backup.

  • Criar índice – precisaremos criar um índice antes que o conteúdo importado possa ser pesquisado. Isso pode demorar para sites grandes, por isso desmarque a seleção dessa opção se preferir criar o índice mais tarde. Não será possível pesquisar o conteúdo até que o índice seja criado.

7. Escolher onde gerenciar usuários

Escolha gerenciar os usuários e grupos do Confluence dentro do Confluence ou em uma aplicação JIRA, como JIRA Software ou JIRA Service Desk:
 
Gerenciar usuários e grupos no Confluence...

Escolha essa opção se desejar gerenciar usuários no Confluence ou se não tiver uma aplicação JIRA instalada.

É bom saber:

  • Se você planejar gerenciar usuários em uma aplicação JIRA, mas ela ainda não estiver instalada, recomendamos instalar primeiro o JIRA e retornar à configuração do Confluence depois.
  • É possível adicionar gerenciamento externo de usuários (por exemplo, LDAP, Crowd ou JIRA) posteriormente, caso você queira.
Conectar ao JIRA...

 Escolha essa opção se você tiver uma aplicação JIRA instalada e desejar gerenciar usuários entre ambas as aplicações.

É bom saber:

  • Essa é uma maneira rápida de configurar sua integração com o JIRA com as opções mais comuns. 
  • Ela configurará um diretório de usuários do JIRA para o Confluence e definirá links de aplicações entre o JIRA e o Confluence para facilitar o compartilhamento de dados.
  • Você poderá especificar exatamente que grupos da sua aplicação JIRA deverão ter permissão para fazer login no Confluence. Seus níveis de licença para cada aplicação não precisam ser iguais. 
  • Você precisará do JIRA 4.3 ou mais recente, JIRA Core 7.0 ou mais recente, JIRA Software 7.0 ou mais recente ou JIRA Service Desk 3.0 ou mais recente.

No assistente de instalação:

  • URL base do JIRA – o endereço do seu servidor JIRA, como http://www.example.com:8080/jira/ ou http://jira.example.com/

  • Login do administrador do JIRA – é o nome de usuário e a senha de uma conta de usuário que tem permissão global de Administrador de Sistema JIRA em sua aplicação JIRA. O Confluence também usará esse nome de usuário e senha para criar uma conta de administrador local, que permitirá que você acesse o Confluence se o JIRA não estiver disponível. Observe que essa conta específica fica armazenada no diretório de usuários interno do Confluence; por isso, se você alterar a senha no JIRA, ela não será atualizada automaticamente no Confluence.
  • URL base do Confluence – é o URL que o JIRA usará para acessar seu servidor do Confluence. O URL que você fornecer aqui substitui o URL base especificado no Confluence para fins de conexão à aplicação JIRA.
  • Grupos de usuários – são os grupos do JIRA cujos membros devem ter permissão para usar o Confluence. Membros desses grupos receberão a permissão "Can use" para o Confluence e serão contados em sua licença do Confluence. O nome padrão do grupo de usuários varia dependendo da sua versão do JIRA:
    • JIRA 6.4 e versões mais antigas: jira-users. 
    • JIRA Software 7.x e versões mais recentes: jira-software-users
    • JIRA Core 7.x e versões mais recentes: jira-core-users
    • JIRA Service Desk 3.x e versões mais recentes: jira-servicedesk-users
  • Grupos de administradores – informe um ou mais grupos do JIRA cujos membros devem ter acesso administrativo ao Confluence. O grupo padrão é jira-administrators. Esses grupos receberão as permissões globais de administrador de sistema e administrador do Confluence no Confluence.

8. Criar a conta de administrador

Insira os detalhes da conta de administrador.  

Pule essa etapa se tiver escolhido gerenciar usuários em um aplicativo JIRA ou se tiver importado dados de um site existente. 

9. Começar a usar o Confluence

Pronto! Seu site do Confluence está acessível de um URL como este: http://<nome_do_computador_ou_endereço_IP>:<porta>

Caso você planeje executar o Confluence por trás de um proxy reverso, consulte Considerações de proxy e SSL antes de seguir adiante. 

Consulte algumas coisas que podem ajudar a sua equipe a iniciar as operações:

Solução de problemas

Está encontrando pendências na instalação do Confluence?
  • Determinados antivírus ou outras ferramentas de segurança da Internet podem interferir no processo de instalação do Confluence e impedir que o processo seja concluído com êxito. Se você tiver ou achar que vá ter um problema desse tipo com seu antivírus/ferramenta de segurança da Internet, desative essa ferramenta antes de prosseguir com a instalação do Confluence.
  • Por vezes, o Linux OOM Killer pode encerrar processos do Confluence quando a memória do servidor fica baixo demais. Consulte Como configurar o Linux Out-of-Memory Killer.
  • Erros de edição colaborativa? Consulte Solucionando problemas de edição colaborativa.

 Vá para Solucionando problemas de instalação em nossa base de conhecimento para obter mais ajuda.  

Last modified on Aug 7, 2017

Was this helpful?

Yes
No
Provide feedback about this article

In this section

Related content

  • No related content found
Powered by Confluence and Scroll Viewport.