Instalação do servidor de aplicativos application-server-install

CAUTION
AEM 6.4 chegou ao fim do suporte estendido e esta documentação não é mais atualizada. Para obter mais detalhes, consulte nossa períodos de assistência técnica. Encontre as versões compatíveis here.
NOTE
JAR e WAR são os tipos de arquivo AEM é lançado em. Estes formatos estão a ser objeto de garantia de qualidade para acomodar os níveis de suporte a que o Adobe se comprometeu.

Esta seção informa como instalar o Adobe Experience Manager (AEM) com um servidor de aplicativos. Consulte o Plataformas compatíveis para ver os níveis de suporte específicos fornecidos para os servidores de aplicativos individuais.

As etapas de instalação dos seguintes Servidores de Aplicativos estão descritas:

Consulte a documentação apropriada do servidor de aplicativos para obter mais informações sobre a instalação de aplicativos da Web, configurações do servidor e como iniciar e parar o servidor.

NOTE
Se você estiver usando o Dynamic Media em uma implantação WAR, consulte o documentação do dynamic media.

Descrição geral general-description

Comportamento padrão ao instalar AEM em um Servidor de Aplicativos default-behaviour-when-installing-aem-in-an-application-server

AEM vem como um único arquivo war para implantar.

Se implantado, o seguinte ocorrerá por padrão:

  • o modo de execução é author

  • a instância (Repositório, ambiente Felix OSGI, pacotes etc.) está instalado no ${user.dir}/crx-quickstartem que ${user.dir} é o diretório de trabalho atual, esse caminho para crx-quickstart é chamado sling.home

  • a raiz de contexto é o nome do arquivo war, por exemplo : aem-6

Configuração configuration

Você pode alterar o comportamento padrão da seguinte maneira:

  • modo de execução : configure o sling.run.modes no WEB-INF/web.xml arquivo do arquivo war AEM antes da implantação

  • sling.home: configure o sling.home no WEB-INF/web.xmlarquivo do arquivo war AEM antes da implantação

  • raiz de contexto: renomeie o arquivo AEM war

Publicar instalação publish-installation

Para obter uma instância de publicação implantada, é necessário definir o modo de execução para publicar:

  • Descompacte o WEB-INF/web.xml do arquivo AEM war
  • Alterar o parâmetro sling.run.modes para publicação
  • Recompacte o arquivo web.xml em AEM arquivo war
  • Implantar AEM arquivo war

Verificação da instalação installation-check

Para verificar se tudo está instalado, é possível:

  • tail error.logpara ver que todo o conteúdo está instalado
  • examinar /system/console que todos os pacotes estão instalados

Duas instâncias no mesmo servidor de aplicativos two-instances-on-the-same-application-server

Para fins de demonstração, pode ser apropriado instalar a instância de criação e publicação em um servidor de aplicativos. Para isso, faça o seguinte:

  1. Altere as variáveis sling.home e sling.run.modes da instância de publicação.
  2. Descompacte o arquivo WEB-INF/web.xml do arquivo AEM war.
  3. Altere o parâmetro sling.home para um caminho diferente (caminhos absolutos e relativos são possíveis).
  4. Altere sling.run.modes para publicar para a instância de publicação.
  5. Recompacte o arquivo web.xml.
  6. Renomeie os arquivos war, de modo que eles tenham nomes diferentes: por exemplo, uma renomeação para aemauthor.war e a outra para aempublish.war.
  7. Use configurações de memória mais altas, por exemplo, para instâncias de AEM padrão usar, por exemplo: -Xmx3072m
  8. Implante as duas aplicações web.
  9. Depois da implantação, pare os dois aplicativos Web.
  10. Nas instâncias de autor e de publicação, certifique-se de que, nos arquivos sling.properties , a propriedade felix.service.urlhandlers=false está definida como false (o padrão é que esteja definida como true).
  11. Inicie as duas aplicações Web novamente.

Procedimentos de instalação dos servidores de aplicativos application-servers-installation-procedures

WebSphere 8.5 websphere

Antes de ler a implantação Descrição geral acima.

Preparação do servidor

  • Deixe que os cabeçalhos básicos de autenticação passem:

    • Uma maneira de permitir que o AEM autentique um usuário é desabilitar a segurança administrativa global do servidor WebSphere, para fazer isso: acesse Segurança -> Segurança global e desmarque a caixa de seleção Ativar segurança administrativa, salve e reinicie o servidor.
  • set "JAVA_OPTS= -Xmx2048m"

  • Se você quiser instalar AEM usando context root = /, primeiro altere a raiz de contexto do aplicativo Web padrão existente

Implantar AEM aplicação web

  • Baixar AEM arquivo war

  • Faça suas configurações em web.xml se necessário (veja acima na Descrição geral)

    • Descompactar arquivo WEB-INF/web.xml
    • alterar o parâmetro sling.run.modes para publicar
    • exclua o parâmetro inicial sling.home e defina esse caminho conforme necessário
    • Recompacte o arquivo web.xml
  • Implantar AEM arquivo war

    • Escolha uma raiz de contexto (se desejar definir os modos de execução do sling, é necessário selecionar as etapas detalhadas do assistente de implantação e especificá-lo na etapa 6 do assistente)
  • Iniciar AEM aplicação Web

JBoss EAP 6.3.0/6.4.0 jboss-eap

Antes de ler a implantação Descrição geral acima.

Preparar o servidor JBoss

Defina argumentos de memória no seu arquivo conf (por exemplo, standalone.conf)

  • JAVA_OPTS="-Xms64m -Xmx2048m"

se você usar o scanner de implantação para instalar o aplicativo web AEM, talvez seja bom aumentar a variável deployment-timeout, para esse conjunto de deployment-timeout no arquivo xml da sua instância (por exemplo, configuration/standalone.xml):

<subsystem xmlns="urn:jboss:domain:deployment-scanner:1.1">
            <deployment-scanner path="deployments" relative-to="jboss.server.base.dir" scan-interval="5000" deployment-timeout="1000"/>
</subsystem>

Implantar AEM aplicação web

  • Faça upload do aplicativo Web AEM no Console de administração do JBoss.

  • Habilite o aplicativo Web AEM.

Oracle WebLogic 12.1.3/12.2 oracle-weblogic

Antes de ler a implantação Descrição geral acima.

Ele usa um layout de servidor simples com apenas um servidor de administração.

Preparação do WebLogic Server

  • Em ${myDomain}/config/config.xmladicione à seção configuração de segurança:

  • Aumente as configurações de memória da VM:

    • open ${myDomain}/bin/setDomainEnv.cmd (resp.sh)pesquisar WLS_MEM_ARGS, definir, por exemplo, definir WLS_MEM_ARGS_64BIT=-Xms256m -Xmx2048m
    • reiniciar o WebLogic Server
  • Criar em ${myDomain} uma pasta de pacotes e dentro de uma pasta cq e nela uma pasta Plan

Implantar AEM aplicação web

  • Baixar AEM arquivo war

  • Coloque o arquivo war AEM na pasta ${myDomain}/packages/cq

  • Faça suas configurações em WEB-INF/web.xml se necessário (veja acima na Descrição geral)

    • Descompactar WEB-INF/web.xmlarquivo
    • alterar o parâmetro sling.run.modes para publicar
    • exclua o parâmetro inicial sling.home e defina esse caminho conforme necessário (consulte Descrição geral)
    • Recompacte o arquivo web.xml
  • Implantar AEM arquivo war como um Aplicativo (para outras configurações, use as configurações padrão)

  • A instalação pode demorar…

  • Verifique se a instalação terminou conforme mencionado acima na Descrição geral (por exemplo, acompanhando o error.log)

  • Você pode alterar a raiz de contexto na guia Configuração da aplicação Web no WebLogic /console

Tomcat 8/8.5 tomcat

Antes de ler a implantação Descrição geral acima.

  • Preparar o servidor Tomcat

    • Aumente as configurações de memória da VM:

      • Em bin/catalina.bat (resp catalina.sh no unix) adicione a seguinte configuração:
      • set "JAVA_OPTS= -Xmx2048m
    • O Tomcat não ativa o acesso do administrador nem do gerente na instalação. Portanto, é necessário editar manualmente tomcat-users.xml para permitir o acesso a estas contas:

      • Editar tomcat-users.xml para incluir o acesso do administrador e do gerente. A configuração deve ser semelhante ao seguinte exemplo:
      code language-xml
        <?xml version='1.0' encoding='utf-8'?>
         <tomcat-users>
         <role rolename="manager"/>
         <role rolename="tomcat"/>
         <role rolename="admin"/>
         <role rolename="role1"/>
         <role rolename="manager-gui"/>
         <user username="both" password="tomcat" roles="tomcat,role1"/>
         <user username="tomcat" password="tomcat" roles="tomcat"/>
         <user username="admin" password="admin" roles="admin,manager-gui"/>
         <user username="role1" password="tomcat" roles="role1"/>
         </tomcat-users>
      
    • Se você quiser implantar AEM com a raiz de contexto "/", será necessário alterar a raiz de contexto do aplicativo Web ROOT existente:

      • Parar e desimplantar o aplicativo web ROOT
      • Renomeie a pasta ROOT.war na pasta webapps do tomcat
      • Iniciar o aplicativo Web novamente
    • Se você instalar o aplicativo Web AEM usando o gerenciador-gui, precisará aumentar o tamanho máximo de um arquivo carregado, já que o padrão permite apenas o tamanho de upload de 50 MB. Para isso, abra o web.xml do aplicativo web gerenciador,

      webapps/manager/WEB-INF/web.xml

      e aumente o tamanho máximo do arquivo e o tamanho máximo da solicitação para pelo menos 500 MB, consulte o seguinte multipart-config exemplo de uma web.xml arquivo:

      code language-none
      <multipart-config>
       <!-- 500MB max -->
       <max-file-size>524288000</max-file-size>
       <max-request-size>524288000</max-request-size>
       <file-size-threshold>0</file-size-threshold>
       </multipart-config>
      
  • Implantar AEM aplicação web

    • Baixar AEM arquivo war

    • Faça suas configurações em web.xml se necessário (veja acima na Descrição geral)

      • Descompactar arquivo WEB-INF/web.xml
      • alterar o parâmetro sling.run.modes para publicar
      • exclua o parâmetro inicial sling.home e defina esse caminho conforme necessário
      • Recompacte o arquivo web.xml
    • Renomeie AEM arquivo war para ROOT.war se desejar implantá-lo como webapp raiz, renomeie-o para aemauthor.war se desejar ter aemauthor como context root

    • copie-o na pasta webapps do tomcat

    • aguarde até que o AEM esteja instalado

Resolução de problemas troubleshooting

Para obter informações sobre como lidar com problemas que podem surgir durante a instalação, consulte:

recommendation-more-help
6a71a83d-c2e0-4ce7-a6aa-899aa3885b56