Instalação do Servidor de Aplicativos application-server-install
JAR
e WAR
são os tipos de arquivo em que o Adobe Experience Manager (AEM) é lançado no. Esses formatos estão passando por controle de qualidade para acomodar os níveis de suporte com os quais 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 ler sobre os níveis de suporte específicos fornecidos para os servidores de aplicativos individuais.
As etapas de instalação dos seguintes Servidores de Aplicações são descritas:
Consulte a documentação apropriada do servidor de aplicativos para obter mais informações sobre a instalação de aplicativos web, configurações do servidor e como iniciar e parar o servidor.
Descrição geral general-description
Comportamento padrão ao instalar o AEM em um servidor de aplicativos default-behaviour-when-installing-aem-in-an-application-server
O AEM vem como um único arquivo WAR a ser implantado.
Se implantado, o seguinte acontece por padrão:
-
o modo de execução é
author
-
a instância (Repositório, ambiente Felix OSGI, pacotes e assim por diante) é instalada em
${user.dir}/crx-quickstart
onde${user.dir}
é o diretório de trabalho atual, este caminho para crx-quickstart é chamado desling.home
-
a raiz do 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 : configurar o
sling.run.modes
parâmetro noWEB-INF/web.xml
arquivo do arquivo AEM war antes da implantação -
sling.home: configure a
sling.home
parâmetro noWEB-INF/web.xml
arquivo do arquivo AEM war antes da implantação -
raiz de contexto: renomear o arquivo AEM war
Publicar instalação publish-installation
Para implantar uma instância de publicação, é 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 publicar
- Recompacte o arquivo web.xml no arquivo AEM war
- Implantar arquivo AEM war
Verificação da instalação installation-check
Para verificar se tudo está instalado, é possível:
- tail the
error.log
arquivo para ver se todo o conteúdo está instalado - pesquisar em
/system/console
que todos os pacotes estejam 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 do autor e da publicação em um servidor de aplicativos. Para isso, faça o seguinte:
- Altere as variáveis sling.home e sling.run.modes da instância de publicação.
- Descompacte o arquivo WEB-INF/web.xml do arquivo AEM war.
- Altere o parâmetro sling.home para um caminho diferente (caminhos absolutos e relativos são possíveis).
- Altere sling.run.modes para publicar para a instância de publicação.
- Recompacte o arquivo web.xml.
- Renomeie os arquivos war para que eles tenham nomes diferentes. Por exemplo, um é renomeado para aemauthor.war e o outro para aempublish.war.
- Use configurações mais altas de memória. Por exemplo, instâncias AEM padrão usam
-Xmx3072m
- Implante as duas aplicações web.
- Após a Implantação, interrompa as duas aplicações Web.
- Tanto em instâncias de autor quanto de publicação, certifique-se de que, nos arquivos sling.properties, a propriedade felix.service.urlhandlers=false esteja definida como false (o padrão é que ela esteja definida como true).
- Inicie as duas aplicações web novamente.
Procedimentos de Instalação de Servidores de Aplicativos application-servers-installation-procedures
WebSphere® 8.5 websphere
Antes de uma implantação, leia o Descrição geral acima.
Preparação do servidor
-
Permitir a passagem de Cabeçalhos de Autenticação Básicos:
- Uma maneira de permitir que o AEM autentique um usuário é desabilitar a segurança administrativa global do servidor WebSphere®. Para fazer isso: vá para Security > Global Security e desmarque a caixa de seleção Enable administrative security, salve e reinicie o servidor.
-
set
"JAVA_OPTS= -Xmx2048m"
-
Se você deseja instalar o AEM usando raiz de contexto = /, altere a raiz de contexto do Default web application existente.
Implantar a aplicação Web AEM
-
Baixar arquivo AEM war
-
Faça as configurações em web.xml, se necessário (veja acima a Descrição geral)
- Descompactar arquivo WEB-INF/web.xml
- altere o parâmetro sling.run.modes para publish
- remova o comentário do parâmetro inicial sling.home e defina este caminho conforme necessário
- Recompactar arquivo web.xml
-
Implantar arquivo AEM war
- Escolha uma raiz de contexto (se quiser definir os modos de execução do sling, selecione as etapas detalhadas do assistente de implantação e especifique na etapa 6 do assistente)
-
Iniciar aplicativo web AEM
JBoss® EAP 6.3.0/6.4.0 jboss-eap
Antes de uma implantação, leia o Descrição geral acima.
Preparar o servidor JBoss®
Defina os argumentos de Memória no arquivo conf (por exemplo, standalone.conf
)
- JAVA_OPTS="-Xms64m -Xmx2048m"
Se você usar o mecanismo de varredura de implantação para instalar o aplicativo web AEM, talvez seja bom aumentar o deployment-timeout,
para esse conjunto, um 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 a aplicação Web AEM
-
Faça upload da aplicação web AEM no Console de administração JBoss®.
-
Habilite o aplicativo web AEM.
Oracle WebLogic 12.1.3/12.2 oracle-weblogic
Antes de uma implantação, leia o Descrição geral acima.
Usa um layout de servidor simples com apenas um servidor de administração.
Preparação do WebLogic Server
-
Entrada
${myDomain}/config/config.xml
adicione à seção configuração de segurança:<enforce-valid-basic-auth-credentials>false</enforce-valid-basic-auth-credentials>
ver em https://xmlns.oracle.com/weblogic/domain/1.0/domain.xsd para a posição correta (por padrão, posicioná-la no final da seção está ok)
-
Aumentar configurações de Memória da VM:
- open
${myDomain}/bin/setDomainEnv.cmd
(resp.sh) pesquisa por WLS_MEM_ARGS, definir, por exemplo, definirWLS_MEM_ARGS_64BIT=-Xms256m -Xmx2048m
- reiniciar o WebLogic Server
- open
-
Criar em
${myDomain}
uma pasta de pacotes e dentro de uma pasta cq e, nela, uma pasta Plano
Implantar a aplicação Web AEM
-
Baixar arquivo AEM war
-
Coloque o arquivo AEM war no ${myDomain}pasta /packages/cq
-
Faça suas configurações em
WEB-INF/web.xml
se necessário (veja acima a Descrição geral)- Desempacotar
WEB-INF/web.xml
arquivo - altere o parâmetro sling.run.modes para publish
- remova o comentário do parâmetro inicial sling.home e defina este caminho conforme necessário (consulte Descrição geral)
- Recompactar arquivo web.xml
- Desempacotar
-
Implantar arquivo AEM WAR como um aplicativo (para as outras configurações, use as configurações padrão)
-
A instalação pode demorar…
-
Verifique se a instalação foi concluída conforme mencionado acima na Descrição geral (por exemplo, seguido do error.log)
-
Você pode alterar a raiz do contexto na guia Configuração da aplicação web no WebLogic
/console
Tomcat 8/8.5 tomcat
Antes de uma implantação, leia o Descrição geral acima.
-
Preparar servidor Tomcat
-
Aumente as configurações de memória da VM:
- Entrada
bin/catalina.bat
(respcatalina.sh
no UNIX®) adicione a seguinte configuração: set "JAVA_OPTS= -Xmx2048m
- Entrada
-
O Tomcat não permite o acesso de administrador ou gerente na instalação. Portanto, é necessário editar manualmente
tomcat-users.xml
para permitir o acesso a essas contas:-
Editar
tomcat-users.xml
para incluir o acesso para administrador e 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ê gosta de implantar AEM com raiz de contexto "/", então você tem que alterar a raiz de contexto do aplicativo web RAIZ existente:
- Parar e desimplantar o aplicativo web ROOT
- Renomeie a pasta ROOT.war na pasta de aplicativos Web do Tomcat
- Iniciar o aplicativo Web novamente
-
Se você instalar o aplicativo web AEM usando o manager-gui, será necessário aumentar o tamanho máximo de um arquivo carregado, pois o padrão permite apenas o tamanho de upload de 50 MB. Para isso, abra o web.xml da aplicação Web gerenciadora,
webapps/manager/WEB-INF/web.xml
e aumentar 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 talweb.xml
arquivo.code language-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 a aplicação Web AEM
-
Baixar arquivo AEM war
-
Faça as configurações em web.xml, se necessário (veja acima a Descrição geral)
- Descompactar arquivo WEB-INF/web.xml
- altere o parâmetro sling.run.modes para publish
- remova o comentário do parâmetro inicial sling.home e defina este caminho conforme necessário
- Recompactar arquivo web.xml
-
Renomeie o arquivo AEM war como ROOT.war se quiser implantá-lo como aplicativo Web raiz, renomeie-o para, por exemplo, aemauthor.war se quiser que o aemauthor seja a raiz de contexto
-
copie-o na pasta webapps do tomcat
-
aguarde até que o AEM seja instalado
-
Resolução de problemas troubleshooting
Para obter informações sobre como lidar com problemas que podem surgir durante a instalação, consulte: