Configuração do ambiente AEM para publicação de PDF nativo
O AEM Guides inclui um mecanismo de publicação PDF nativo que permite aos usuários projetar, desenvolver e publicar o conteúdo no formato PDF.
Ele fornece a capacidade de criar diferentes layouts de página, modelos CSS e projetar os modelos de PDF em conjunto com os layouts de página e CSS.
As etapas para configurar esse PDF nativo no AEM Guides diferem dependendo do sistema operacional. Use as etapas de configuração abaixo com base no sistema operacional no qual o AEM está instalado.
Pré-requisitos
Requisitos mínimos para a configuração do PDF nativo:
- Plataforma Java instalada, Standard Edition 8 ou 11 JDK (Java SE Development Kit) e JRE (Java SE Runtime Environment) instalados
- AEM 6.5 SP13, SP12, SP11 ou SP10
- Guias 4.1 e versões posteriores (não UUID ou UUID)
O mecanismo de publicação PDF nativo precisa do JDK do Oracle para gerar os módulos de nó na pasta AEM crx-quickstart. Por padrão, ele é compatível com os seguintes sistemas operacionais:
- Windows 10, Windows 2019 Server e superior.
- Linux - (RHEL 8 e superior, CentOS 7 e superior, Ubuntu 18 e versões superiores)
- SO Mac (baseado na Intel)
Etapas de configuração para Windows Server (JAVA 11/8)
-
Certifique-se de que o servidor AEM esteja desativado.
-
Na barra de tarefas do Windows, clique com o botão direito do mouse no ícone do Windows e selecione Sistema.
-
Na janela Configurações, em Configurações relacionadas, clique em Configurações avançadas do sistema.
-
Na guia Avançado, clique em Variáveis de ambiente.
-
Na seção de variáveis do sistema, clique em "Novo" para criar uma nova variável de ambiente.
-
Insira o nome da variável como JAVA_HOME.
-
No campo de valor, forneça o caminho de Instalação do Java e clique em Ok.
Por exemplo:
JAVA 11:
C:\Program Files\JAVA\jdk-11.0.15.1
JAVA 8:
C:\Program Files\JAVA\ jdk1.8.0_144
-
Adicione, selecione Caminho nas variáveis do sistema e clique em Editar.
-
Agora, em Path variables, forneça o valor de Server path e clique em Ok.
Por exemplo:
JAVA 11:
%JAVA_HOME%\bin\server\
JAVA 8:
%JAVA_HOME%\jre\bin\server\
-
Clique em 'OK' novamente na caixa de diálogo Variáveis de ambiente.
-
Clique novamente em 'OK' na caixa de diálogo Propriedades do sistema.
-
Agora, inicie o servidor AEM.
-
Gerar PDF nativo a partir de predefinições no editor da Web.
Etapas de configuração para servidor Linux (RHEL7/centOS 7)
-
Verifique se o servidor AEM está desativado
-
Verifique a variável JAVA_HOME fazendo echo $JAVA_HOME
-
Se a variável JAVA_HOME não estiver definida, siga a etapa 4. Caso contrário, vá diretamente para a etapa 5.
-
Defina a variável JAVA_HOME usando os comandos abaixo com base na versão instalada do java
Por exemplo:
JAVA 11:
- exportar JAVA_HOME=/usr/lib/jvm/java-11.0.15.1
- caminho de exportação=$PATH: $JAVA_HOME/bin
- exportar LD_LIBRARY_PATH=/usr/lib/jvm/jdk-11.0.15.1/lib/server:/usr/java/jdk-11.0.15.1/lib/server
JAVA 8:
- exportar JAVA_HOME=/usr/lib/jvm/java-11.0.15.1
- caminho de exportação=$PATH: $JAVA_HOME/bin
-
Reinicie o Servidor AEM e vá para a Etapa 12, se estiver usando o Guides versão 4.2 e superior.
-
Copie o "node_modules.zip" anexado na parte inferior deste artigo no diretório crx-quickstart/profiles/nodejs—b1aad0a7-9079-e56c-1ed8-6fcababe8166/.
-
Abra o terminal no crx-quickstart/profiles/nodejs—b1aad0a7-9079-e56c-1ed8-6fcababe8166/.
-
Exclua o diretório node_modules usando o comando abaixo
rm -rf node_modules
-
Descompacte node_modules.zip usando o comando abaixo
descompactar node_modules.zip
-
Se o comando unzip não estiver instalado/reconhecido, ele poderá ser instalado usando o seguinte comando
descompactar a instalação do yum
-
Instale o pacote fontconfig.
Comando: yum install fontconfig -
Gerar PDF nativo a partir de predefinições no editor da Web.
OBSERVAÇÃO: o pacote node_modules.zip pode ser baixado aqui.
A importação manual dos módulos de nó baixados para o sistema operacional Linux é uma solução alternativa para usuários que estão no Guides 4.1 ou em versões anteriores (Etapa 6-12)
Etapas de configuração para a máquina do Mac (JAVA 11/8)
-
Instale o Oracle JAVA 11 ou o Oracle JAVA 8.
-
Defina a variável de ambiente JAVA_HOME para o diretório JAVA instalado.
-
Abra um shell Unix.
(O Bash é usado aqui para definir a configuração)Comando: nano ~/.bashrc
-
Defina a variável JAVA_HOME usando os comandos abaixo com base na versão instalada do java
Por exemplo:
JAVA 11:
exportar JAVA_HOME= /Library/Java/JavaVirtualMachines/jdk-11.0.15.1.jdk/Contents/Home
-
Recarregar bashrc
Comando: fonte ~/.bashrc.
-
Verifique se JAVA_HOME está definido usando o comando echo $JAVA_HOME
-
Execute os três comandos abaixo a partir do caminho de instalação do AEM
C:/{aem-installation-folder}/crx-quickstart/profiles/nodejs—b1aad0a7-9079-e56c-1ed8-6fcababe8166
i) encontrar . -type d -exec chmod 0755 {} ;
ii) encontrar . -type f -exec chmod 0755 {} ;
iii)/node-darwin/bin/node node-darwin/lib/node_modules/npm/bin/npm-cli.js —prefix . install — unsafe-perm — scripts-prepend-node-path -
Verifique se o Java está instalado usando o comando abaixo
i) Execute .comando /node-darwin/bin/node da pasta /crx-quickstart/profiles/nodejs—b1aad0a7-9079-e56c-1ed8-6fcababe8166
ii) a = require('java')
-
Instale o pacote fontconfig.
Comando: apt install fontconfig -
Gerar PDF nativo a partir de predefinições no editor da Web.
Resolução de problemas
Abaixo estão os erros comuns que podem ocorrer durante a Geração de PDF quando as variáveis de ambiente não estão definidas corretamente.
Exceção de ponteiro nulo no sistema operacional Windows/Mac
Se o problema persistir mesmo após a correção das configurações do ambiente Java, revalide o seguinte:
-
Verifique se a predefinição de saída está definida corretamente ou crie uma nova predefinição de saída sem espaços.
-
Verifique o diretório de recursos do nó em /libs/fmdta/node_resources para garantir que todas as bibliotecas necessárias estejam instaladas durante a instalação.
Bibliotecas ausentes no SO Linux RHEL 7
Tempo limite do processo do Publish. O processo não foi concluído no tempo especificado de 0 ms
Valide o valor da propriedade timeout do nó nodejs em /var/dxml/profiles/b1aad0a7-9079-e56c-1ed8-6fcababe8166/nodejs no repositório do CRX. O valor padrão é 300.
Se você encontrar problemas ao executar qualquer uma das etapas acima, poste sua pergunta no fórum da Comunidade do AEM Guides para obter assistência.