Instalando o Confluence no Linux pelo arquivo de armazenamento

Instalando o Confluence no Linux

On this page

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 manualmente um arquivo zip.

Esse método oferece o máximo de controle sobre o processo de instalação.

 

 

Outras maneiras de instalar o Confluence: 

  • Avaliação - coloque seu teste gratuito em funcionamento rapidamente.
  • Instalador – instalar o Confluence usando o instalador do Linux. 
  • 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 e uma versão do Java 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 OS X ou mac OS para ambientes de produção.
  • O Confluence não pode ser executado em OpenJDK. Será necessário instalar o Oracle Java.
  • É possível usar o JDK (Java Development Kit) ou o JRE (Java Runtime Environment).
  • Damos suporte apenas à versão do Apache Tomcat que vem inclusa no Confluence.
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 servidor Linux for iniciado.

Você deve usar o instalador do Linux se desejar executar o Confluence como serviço.

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

  • Você iniciará o Confluence executando o arquivo start-confluence.sh em seu diretório de instalação do Confluence.
  • Recomendamos criar um usuário dedicado para executar o Confluence. Esse usuário precisa ter acesso completo de leitura, gravação e execução no diretório de instalação e no diretório home.
  • 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.

Que banco de dados você planeja usar? 
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.

Sua variável JAVA_HOME está configurada corretamente?
Quero saber mais...

Antes de instalar o Confluence, verifique se você está executando uma versão do Java com suporte e se a variável de ambiente JAVA_HOME está configurada corretamente.

O Confluence somente pode ser executado com Oracle JDK ou JRE.

Para verificar sua versão do Java:

$ java -version

Para verificar se sua variável JAVA_HOME está configurada corretamente:

$ echo $JAVA_HOME

Se você vir um caminho para o seu diretório de instalação do Java, a variável de ambiente JAVA_Home foi configurada corretamente. Se um caminho não for retornado, será necessário configurar manualmente sua variável de ambiente JAVA_HOME antes de instalar o Confluence.

Você criou um usuário dedicado para executar o Confluence?
Quero saber mais...

Recomendamos fortemente executar o Confluence como usuário dedicado.

Você deve criar esse usuário antes de começar, para que, ao criar os diretórios de instalação e home, possa dar a esse usuário as devidas permissões de leitura e gravação.

Neste exemplo, criaremos um usuário chamado confluence:

$ sudo /usr/sbin/useradd --create-home --comment "Account for running Confluence" --shell /bin/bash confluence

Consulte Criando uma conta de usuário dedicada no sistema operacional para executar o Confluence para obter mais informações.

 

Instalar o Confluence

1. Baixe o Confluence

Baixe o arquivo tar.gz para seu sistema operacional - https://www.atlassian.com/software/confluence/download. 

2. Crie o diretório de instalação

  1. Crie seu diretório de instalação – é aqui que o Confluence será instalado. Evite usar espaços ou caracteres especiais no caminho. Chamaremos esse diretório de seu <installation-directory>. 
     

    Mostre como fazer isso...

    Neste exemplo, chamaremos nosso diretório de instalação de confluence:

    $ mkdir confluence

  2. Extraia o arquivo Confluence tar.gz para seu <installation-directory>. Recomendamos usar uma versão GNU do utilitário de arquivamento, especialmente no Solaris.
     

    Mostre como fazer isso...

    Altere o diretório para onde você baixou o Confluence e, em seguida, execute os seguintes comandos:

    $ tar -xzf atlassian-confluence-X.X.X.tar.gz -C <installation-directory>
$ cd <installation-directory>
$ tar -xf atlassian-confluence-X.X.X.tar

    Substitua x.x.x pela sua versão do Confluence e <installation-directory> pelo caminho completo até o diretório que você criou no último passo.

  3. Dê a seu usuário dedicado do Confluence permissão para ler, gravar e executar em seu <installation-directory>. 
     

    Mostre como fazer isso...

    Neste exemplo, alteraremos o proprietário do diretório de instalação e daremos ao usuário confluence permissões para ler, gravar e executar.

    $ chown -R confluence <installation-directory>
$ chmod -R u=rwx,go-rwx <installation-directory>

3. Criar o diretório home

  1. Crie seu diretório home – é aqui que os dados da aplicação Confluence como logs, índices de pesquisa e arquivos serão armazenados. Deve ser separado de seu diretório de instalação, sem espaços e nem caracteres especiais no caminho. Chamaremos esse diretório de seu <home-directory>. 
     

    Mostre como fazer isso...

    Neste exemplo, chamaremos nosso diretório home de confluence-home:

    $ mkdir confluence-home

  2. Dê ao seu usuário dedicado do Confluence permissões para ler, gravar e executar no <home-directory>.
     

    Mostre como fazer isso...

    Neste exemplo, alteraremos o proprietário do diretório home e daremos ao usuário confluence permissões para ler, gravar e executar.

    $ chown -R confluence <home-directory>
$ chmod -R u=rwx,go-rwx <home-directory>
  3. Edite <installation-directory>\confluence\WEB-INF\classes\confluence-init.properties.

  4. No final do arquivo, insira o caminho absoluto para o seu <home-directory>. Isso diz ao Confluence onde encontrar seu <home-directory> quando ele for iniciado.
     

    Mostre como fazer isso...

    É possível editar o arquivo confluence.init.properties em qualquer editor de texto.

    1. Role a tela até o final do texto e encontre a seguinte linha:

      # confluence.home=c:/confluence/data

    2. Retire o # e o espaço no início dessa linha (para que o Confluence não leia a linha como comentário) e adicione o caminho absoluto para o diretório home (não um symlink). Por exemplo:

      confluence.home=/var/confluence-home

4. Verificar as portas

Por padrão, o Confluence fica ativo na porta 8090. Se você tiver outra aplicação sendo executada em seu servidor que utilize as mesmas portas, será necessário dizer ao Confluence para usar uma porta diferente. 
 

Mostrar como...

Para alterar as portas:

  1. Edite <installation-directory>\conf\server.xml

  2. Altere a porta do servidor (8000) e a porta do conector (8090) para portas livres em seu servidor.

    No exemplo abaixo, alteramos a porta do servidor para 5000 e a porta do conector para 5050.

    Server port="5000" shutdown="SHUTDOWN" debug="0">
  <Service name="Tomcat-Standalone">
    <Connector port="5050" connectionTimeout="20000" redirectPort="8443"
        maxThreads="48" minSpareThreads="10"
        enableLookups="false" acceptCount="10" debug="0" URIEncoding="UTF-8"
        protocol="org.apache.coyote.http11.Http11NioProtocol" />

O Linux não permite que você vincule a portas menores que 1024. Se você desejar executar o Confluence na porta 80, por exemplo, poderá usar um proxy reverso para redirecionar o tráfego da porta 80. Consulte Usando Apache com mod_proxy.

5. Iniciar o Confluence

  1. Execute <installation-directory>/bin/start-confluence.sh para iniciar o processo de configuração.  
      

    Mostre como fazer isso...

    Recomendamos executar o Confluence como seu usuário dedicado.

    $ su -u <user>
$ ./start-confluence.sh

    Se estiver usando o Ubuntu, o comando é um pouco diferente:

    $ sudo su <user>
$ ./start-confluence.sh
  2. Vá para http://localhost:8090/ para iniciar o Confluence em seu navegador (altere a porta se tiver atualizado a porta do Conector).

 

Problemas para iniciar o Confluence?

Configure o Confluence

6. Escolher o tipo de instalação

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

7. 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. 

8. 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.

9. 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.

10. 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.

11. 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. 

12. 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?

 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

Related content

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