Instruções de atualização para a versão 2024.06.0
Este artigo aborda as instruções de atualização e a matriz de compatibilidade da versão 2024.06.0 do Adobe Experience Manager Guides as a Cloud Service.
Para obter mais informações sobre os novos recursos e aprimoramentos, consulte Novidades na versão 2024.06.0.
Para obter a lista de problemas corrigidos nesta versão, consulte Problemas corrigidos na versão 2024.06.0.
Matriz de compatibilidade
Esta seção lista a matriz de compatibilidade dos aplicativos de software compatíveis com a versão 2024.06.0 do Experience Manager Guides as a Cloud Service.
FRAMEMAKER e FRAMEMAKER PUBLISHING SERVER
Conector de oxigênio
Versão do modelo da knowledge base
Atualização para a versão 2024.06.0
O Experience Manager Guides é atualizado automaticamente após o upgrade da versão atual (mais recente) do Experience Manager as a Cloud Service.
- ui_config.json (pode ter sido definido em perfis de pasta)
Execute as seguintes etapas para o Experience Manager Guides as a Cloud Service se ainda não tiver feito isso antes na sua versão existente:
Etapas para ativar o acionador de um script por meio de um servlet
(Somente se você estiver em uma versão anterior à versão de junho de 2023 do Experience Manager Guides as a Cloud Service)
Após concluir a instalação, você pode optar por APRESENTAR o acionador para iniciar o trabalho de tradução:
POST:
http://localhost:4503/bin/guides/script/start?jobType=translation-map-upgrade
Resposta:
{
"msg": "Job is successfully submitted and lock node is created for future reference",
"lockNodePath": "/var/dxml/executor-locks/translation-map-upgrade/1683190032886",
"status": "SCHEDULED"
}
Na resposta JSON anterior, a chave lockNodePath
contém o caminho para o nó criado no repositório que aponta para o trabalho enviado. Ela é automaticamente excluída quando o trabalho é concluído e, em seguida, você pode consultar esse nó para obter o status do trabalho.
Aguarde até que esse trabalho seja concluído antes de prosseguir para as próximas etapas.
GET
http://<aem_domain>/var/dxml/executor-locks/translation-map-upgrade/1683190032886.json
Etapas para pós-processar o conteúdo existente para usar o relatório de link corrompido
(Somente se você estiver em uma versão anterior à versão de junho de 2023 do Experience Manager Guides as a Cloud Service)
Execute as seguintes etapas para pós-processar o conteúdo existente e usar o novo relatório de link desfeito:
-
(Opcional) Se houver mais de 100.000 arquivos DITA no sistema, atualize o
queryLimitReads
e oqueryLimitInMemory
emorg.apache.jackrabbit.oak.query.QueryEngineSettingsService
para um valor maior (qualquer valor maior que o número de ativos presentes, por exemplo, 200.000) e reimplante.-
Use as instruções fornecidas na seção Substituições de configuração em Instalar e configurar o Adobe Experience Manager Guides as a Cloud Service para criar o arquivo de configuração.
-
No arquivo de configuração, forneça os seguintes detalhes (propriedade) para configurar a opção
queryLimitReads
equeryLimitInMemory
:table 0-row-3 1-row-3 2-row-3 PID Chave de propriedade Valor de propriedade org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitReads Valor: 200000 Valor padrão: 100000 org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitInMemory Valor: 200000 Valor padrão: 100000
-
-
Execute uma solicitação POST no servidor (com autenticação correta) -
http://<server>//bin/guides/reports/upgrade
. -
A API retorna um jobId. Para verificar o status do trabalho, você pode enviar uma solicitação de GET com id de trabalho para o mesmo ponto de extremidade -
http://<server>/bin/guides/reports/upgrade?jobId= {jobId}
(Por exemplo:http://localhost:8080/bin/guides/reports/upgrade?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678
) -
Quando o trabalho for concluído, a solicitação do GET anterior responderá com êxito. Se a tarefa falhar por algum motivo, a falha poderá ser vista nos logs do servidor.
-
Reverta para o valor padrão ou existente anterior de
queryLimitReads
se você o alterou na etapa 1.
Etapas para indexar o conteúdo existente para usar a nova localização e substituição e lista de tópicos na guia Relatórios:
(Somente se você estiver em uma versão anterior à versão de junho de 2023 do Experience Manager Guides as a Cloud Service)
Execute as seguintes etapas para indexar o conteúdo existente e usar o novo texto de localização e substituição no nível do mapa e da lista de tópicos na guia relatórios:
-
Execute uma solicitação POST no servidor (com autenticação correta) -
http://<server:port>/bin/guides/map-find/indexing
. (Opcional: é possível passar caminhos específicos dos mapas para indexá-los; por padrão, todos os mapas são indexados|| Por exemplo:https://<Server:port>/bin/guides/map-find/indexing?paths=<path of the MAP in repository>
) -
Você também pode passar uma pasta raiz para indexar os mapas DITA de uma pasta específica (e suas subpastas). Por exemplo,
http://<server:port\>/bin/guides/map-find/indexing?root=/content/dam/test
. Observe que se os parâmetros de caminhos e de raiz forem transmitidos, somente o parâmetro de caminhos será considerado. -
A API retorna um jobId. Para verificar o status do trabalho, você pode enviar uma solicitação GET com id de trabalho para o mesmo ponto de extremidade -
http://<server:port>/bin/guides/map-find/indexing?jobId={jobId}
(Por exemplo:http://localhost:8080/bin/guides/reports/upgrade?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678
) -
Quando o trabalho for concluído, a solicitação do GET anterior responderá com sucesso e mencionará se algum mapa falhou. Os mapas indexados com êxito podem ser confirmados nos logs do servidor.
Etapas para lidar com o conflito 'fmdita rewriter'
O Experience Manager Guides tem um módulo personalizado de reescrita do sling para manipular os links gerados no caso de mapas cruzados (links entre os tópicos de dois mapas diferentes).
Se você tiver outro reescritor sling personalizado em sua base de código, use um valor de 'order'
maior que 50, pois o reescritor Experience Manager Guides sling usa 'order'
50. Para substituir isso, é necessário um valor >50. Para obter mais detalhes, consulte Pipelines de regravação de saída.
Durante esta atualização, como o valor de 'order'
é alterado de 1000 para 50, você precisa mesclar o reescritor personalizado existente, se houver, com fmdita-rewriter
.
Etapas para executar a migração em árvore B para fragmentos de conteúdo
Se as referências não forem exibidas para fragmentos de conteúdo, você pode optar por ACESSAR o acionador para iniciar o trabalho de migração:
POST:
http://localhost:4503/bin/guides/script/start?jobType=cf-reference-store-btree-migration
Resposta:
{
"msg": "Job is successfully submitted and lock node is created for future reference",
"lockNodePath": "/var/dxml/executor-locks/cf-reference-store-btree-migration/1683190032886",
"status": "SCHEDULED"
}
Na resposta anterior, JSON, a chave lockNodePath
contém o caminho para o nó criado no repositório, que aponta para o trabalho enviado. Ele será excluído automaticamente quando o trabalho for concluído. Você pode consultar esse nó para obter o status do job.
Aguarde até que esse trabalho seja concluído antes de prosseguir para as próximas etapas.
GET:
http://<aem_domain>/var/dxml/executor-locks/cf-reference-store-btree-migration/1683190032886.json