Instalação do servidor de aplicativos

OBSERVAÇÃO

JAR e WAR são os tipos de arquivos AEM são lançados. Esses formatos estão passando por uma garantia de qualidade para acomodar os níveis de suporte que a Adobe comprometeu.

Esta seção informa como instalar o Adobe Experience Manager (AEM) com um servidor de aplicativos. Consulte a seção Plataformas suportadas 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 como instalar aplicativos da Web, configurações do servidor e como start e parar o servidor.

OBSERVAÇÃO

Se você estiver usando o Dynamic Media em uma implantação WAR, consulte a documentação de mídia dinâmica.

Descrição Geral

Comportamento padrão ao instalar AEM em um Servidor de aplicativos

AEM vem como um único arquivo de guerra para implantar.

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

  • o modo de execução é author

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

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

Configuração

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

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

  • sling.home: configure o parâmetro sling.home no arquivo WEB-INF/web.xmldo arquivo de guerra AEM antes da implantação

  • raiz de contexto: renomear o arquivo AEM war

Publicar instalação

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

  • Desempacotar o WEB-INF/web.xml do arquivo de guerra AEM
  • Alterar o parâmetro sling.run.mode para publicar
  • Reempacotar o arquivo web.xml em AEM arquivo de guerra
  • Implantar AEM arquivo de guerra

Verificação de instalação

Para verificar se tudo está instalado, você pode:

  • exclua o arquivo error.logpara ver se todo o conteúdo está instalado
  • verifique /system/console se todos os pacotes estão instalados

Duas instâncias no mesmo servidor de aplicativos

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

  1. Altere as variáveis sling.home e sling.run.mode 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.mode para publicar para a instância de publicação.
  5. Reempacotar o arquivo web.xml.
  6. Renomeie os arquivos de guerra para que eles tenham nomes diferentes: Por exemplo, uma renomeia 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, use, por exemplo: -Xmx3072m
  8. Implante os dois aplicativos da Web.
  9. Após a implantação, pare os dois aplicativos da Web.
  10. Nas instâncias de autor e publicação, verifique se nos arquivos sling.properties a propriedade felix.service.urlhandlers=false está definida como false (o padrão é que ela esteja definida como true).
  11. Start os dois aplicativos da Web novamente.

Procedimentos de instalação dos servidores de aplicativos

WebSphere 8.5

Antes de uma implantação, leia a Descrição Geral acima.

Preparação do servidor

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

    • Uma maneira de permitir que AEM autenticem um usuário é desabilitar a segurança administrativa global do servidor WebSphere, para fazer isso: vá para 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 a raiz de contexto = /, primeiro é necessário alterar a raiz de contexto do aplicativo Web padrão existente

Implantar AEM aplicativo da Web

  • Baixar AEM arquivo de guerra

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

    • Desempacotar arquivo WEB-INF/web.xml
    • alterar o parâmetro sling.run.mode para publicar
    • exclua o comentário do parâmetro inicial sling.home e defina esse caminho conforme necessário
    • Repack arquivo web.xml
  • Implantar AEM arquivo de guerra

    • Escolha uma raiz de contexto (se desejar definir os modos de execução de sling, você precisa selecionar as etapas detalhadas do assistente de implantação e, em seguida, especificá-la na etapa 6 do assistente)
  • Start AEM aplicação Web

JBoss EAP 6.3.0/6.4.0

Antes de uma implantação, leia a Descrição Geral acima.

Preparar servidor JBoss

Defina os argumentos da memória no arquivo conf (por exemplo, standalone.conf)

  • JAVA_OPTS="-Xms64m -Xmx2048m"

se você usar o deployment-scanner para instalar o aplicativo da Web AEM, talvez seja bom aumentar o deployment-timeout, para esse conjunto de atributos 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 aplicativo da Web

  • Carregue o aplicativo da Web AEM no console de administração do JBoss.

  • Ative o aplicativo da Web AEM.

Oracle WebLogic 12.1.3/12.2

Antes de uma implantação, leia a Descrição Geral acima.

Isso 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 security-configuration:

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

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

Implantar AEM aplicativo da Web

  • Baixar AEM arquivo de guerra

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

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

    • Desempacotar o arquivo WEB-INF/web.xml
    • alterar o parâmetro sling.run.mode para publicar
    • exclua o comentário do parâmetro inicial sling.home e defina esse caminho conforme necessário (consulte Descrição geral)
    • Repack arquivo web.xml
  • Implantar AEM arquivo de guerra 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, ajustando o error.log)

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

Tomcat 8/8.5

Antes de uma implantação, leia a Descrição Geral acima.

  • Preparar 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 permite acesso de administrador nem de gerente na instalação. Portanto, é necessário editar tomcat-users.xml manualmente para permitir o acesso a essas contas:

      • Edite tomcat-users.xml para incluir o acesso do administrador e do gerente. A configuração deve ser semelhante ao seguinte exemplo:
        <?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 "/", é necessário alterar a raiz de contexto do aplicativo Web ROOT existente:

      • Parar e desimplantar o aplicativo Web ROOT
      • Renomear pasta ROOT.war na pasta de aplicativos da Web do tomcat
      • Aplicativo Web do start novamente
    • Se você instalar o aplicativo da Web AEM usando o manager-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 da Web do gerenciador,

      webapps/manager/WEB-INF/web.xml

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

      <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 aplicativo da Web

    • Baixar AEM arquivo de guerra

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

      • Desempacotar arquivo WEB-INF/web.xml
      • alterar o parâmetro sling.run.mode para publicar
      • exclua o comentário do parâmetro inicial sling.home e defina esse caminho conforme necessário
      • Repack arquivo web.xml
    • Renomeie AEM arquivo de guerra para ROOT.war se desejar implantá-lo como aplicativo Web raiz, renomeie-o como, por exemplo, aemauthor.war se desejar que aemauthor seja uma raiz de contexto

    • copie-o para a pasta de aplicativos Web do tomcat

    • aguarde até que AEM esteja instalado

Resolução de problemas

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

Nesta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now