Back-up online do CRX

Pergunta/problema

Como faço um back-up online para o CRX 1.4.1 ou 1.4.2?

Resposta/resolução

Back-up online

Consulte Back-up online para detalhes.

Certifique-se de ter o seguinte parâmetro da JVM:

-Dcom.day.crx.NioFileCopy=false

Usando um diretório de origem diferente

A documentação acima supõe que a instalação padrão do CRX / CQ é usada (usando o Standalone ou o Quickstart). Ao usar uma configuração diferente, o diretório de origem do backup pode não corresponder. Nesse caso, o diretório de origem precisa ser definido no URL ao criar o backup. O parâmetro de URL para o diretório de origem de backup é 'installDir'. Exemplo:

• Crie um novo backup (O comando (curl) retorna quando o backup é concluído no servidor).

curl -b login.txt -f -o progress.txt -d "action=add&zipFileName=backup.zip&installDir=/cq/data"  "http://localhost:7402/crx/config/backup.jsp"

Se o diretório compartilhado também deve ser incluído no backup (geralmente sim, pois ele contém o armazenamento de dados), o diretório compartilhado precisa ser um subdiretório do diretório de origem de backup (installDir). Esse é o caso na instalação padrão. Se esse não for o caso, uma solução é criar um link flexível para o diretório compartilhado no diretório de origem do backup.

Usando um diretório de destino diferente

A ferramenta de backup cria o arquivo zip de backup, é sempre criado no diretório <repository/../../..>, que pode não ser o diretório pai do diretório de origem do backup. Certifique-se de que o CRX tenha acesso de gravação a essa pasta. Ao usar um servidor de aplicativos diferente (como o JBoss), o backup online pode não funcionar como esperado, porque o diretório de destino não é gravável. Nesse caso, peça ao suporte DayCare por um hotfix ou arquivo patchback backup.jsp.

curl -b login.txt -f -o progress.txt "http://localhost:4502/crx/config/backup.jsp?action=add&zipFileName=backup.zip&targetDir=/Cq5/cq5"

Para escrever diretamente na pasta (não em um arquivo zip):

curl -b login.txt -f -o progress.txt "http://localhost:4502/crx/config/backup.jsp?action=add&zipFileName=&targetDir=/Cq5/cq5"

Certifique-se de que o targetDir esteja sempre limpo antes de fazer um novo backup, pois ele pode produzir um erro inesperado se os arquivos antigos estiverem presentes nesse diretório.

CRX2.x: basta adicionar um parâmetro targetDir à solicitação curl, especificando o caminho de destino onde armazenar o backup.

Duplicando um Repositório

Somente CRX 1.4.x: Se o backup for restaurado e o CRX / CQ for iniciado enquanto o primeiro repositório (original) ainda estiver em execução e se houver uma conexão TCP/IP entre o repositório original e o restaurado (novo), uma exceção será lançada. Para resolver esse problema, exclua todos os arquivos **/listener.properties e cluster_node.id no repositório restaurado antes de iniciar.

Algoritmo

O backup online usa o seguinte algoritmo atualmente:

• Ao criar um arquivo zip, primeiro um diretório temporário é criado. Este diretório começa com "backup". e termina com ".temp".
• Todos os arquivos são copiados do diretório de origem para o diretório de destino (ou diretório temporário ao criar um arquivo zip). O indicador da barra de progresso deste subprocesso está entre 0% - 70% ao criar um arquivo zip ou 0% - 100% se nenhum arquivo zip for criado.
• Se nenhum arquivo zip for criado, o arquivo especialmente nomeado "backupInProgress.txt" será criado no diretório de destino (esse arquivo de marcador é excluído quando o backup é concluído).
• Se nenhum arquivo zip for criado, os arquivos antigos no diretório de destino serão excluídos. Arquivos antigos são arquivos que não existem no diretório de origem.
• Os arquivos são copiados para o diretório de destino em quatro etapas.
• No primeiro estágio da cópia (indicador de progresso 0% - 63% ao criar um arquivo zip ou 0% - 90% se nenhum arquivo zip for criado), todos os arquivos serão copiados simultaneamente enquanto o repositório estiver sendo executado normalmente.
• No segundo estágio da cópia (indicador de progresso 63% - 66,5% ao criar um arquivo zip ou 90% - 95% se nenhum arquivo zip for criado), somente são copiados arquivos que foram criados ou modificados no diretório de origem desde que o primeiro estágio da cópia foi iniciado. Dependendo da atividade do repositório, isso pode signifcar nenhum arquivo, ou um número médio de arquivos (porque o primeiro estágio de cópia de arquivo geralmente leva muito tempo).
• No terceiro estágio da cópia (indicador de progresso 66,5% - 68,6% ao criar um arquivo zip ou 95% - 98% se nenhum arquivo zip for criado), somente são copiados arquivos que foram criados ou modificados no diretório de origem desde que o segundo estágio de cópia foi iniciado. Dependendo da atividade do repositório, não há arquivos ou um número muito pequeno de arquivos (porque o segundo estágio de cópia de arquivos geralmente é rápido).
• As etapas um a três de cópia de arquivo são executadas simultaneamente enquanto o repositório está sendo executado. O quarto e último estágio de cópia de arquivos primeiro bloqueará as operações de gravação do repositório (as operações de gravação são pausadas; elas não lançam uma exceção, mas aguardam). Apenas arquivos são copiados que foram criados ou modificados no diretório de origem desde que o terceiro estágio de cópia foi iniciado. Dependendo da atividade do repositório, não há nenhum arquivo ou um número muito pequeno de arquivos (porque o segundo estágio de cópia de arquivos geralmente é muito rápido). Depois disso, o acesso ao repositório continua. Indicador de progresso 68,6% - 70% ao criar um arquivo zip ou 98% - 100% se nenhum arquivo zip for criado.
• Se um arquivo zip for criado, isso é feito agora usando o diretório temporário. Indicador de progresso 70% - 100%. O diretório temporário é excluído.

Note que este algoritmo pode mudar em futuras versões sem aviso prévio.

Versões afetadas

CRX 1.4.1 e 1.4.2, CRX 2.x