From 6da7829d853bce877bbe0ae1dff508b44f6f0c77 Mon Sep 17 00:00:00 2001 From: Rodrigo Carvalho Benevides Date: Fri, 6 Dec 2024 17:58:19 +0000 Subject: [PATCH] Atualizar 'Atendimento' --- Atendimento.md | 124 +++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 121 insertions(+), 3 deletions(-) diff --git a/Atendimento.md b/Atendimento.md index 540b858..8efff73 100644 --- a/Atendimento.md +++ b/Atendimento.md @@ -102,9 +102,12 @@ O procedimento é complexo e demorado. Apenas o faça se estritamente necessári > Todos os passos são feitos usando o usuário `admin`. Veja [aqui como obter a senha.](#conseguir-a-senha-de-administrador-em-um-portal) -### 1. Preparação -#### 1.1. Itens Avulsos na Raiz do Portal Com Problemas +### 1. Pedir a SEIT a Preparação do Novo Portal + +Antes de começar o procedimento, peça à SEIT/Sussumu para preparar um novo portal para ser destino da exportação. Só comece os próximos passos quando este novo portal estiver disponível. Isto porque os arquivos exportados nos próximos passos são perdidos em caso de reboot do container, é recomendável fazer tudo de uma vez. + +### 2. Itens Avulsos na Raiz do Portal Com Problemas Itens avulsos, isto é, que não são pastas, devem ser exportados e importados de uma vez só. Para isso, é necessário agrupar estes itens em uma pasta apenas para cópia. @@ -116,7 +119,7 @@ d. Aperte o botão `recortar`. e. Entre no diretório recém-criado. f. Aperte o botão `colar´. -#### 1.2. Fazer a Exportação de Dados +### 3. Fazer a Exportação de Dados Todas as pastas presentes na raiz devem ser exportadas individualmente. A exportação é feita pelo id do item, não o nome amigável. Para ver o item, passe o mouse por cima do link do item na página de conteúdo. @@ -148,7 +151,122 @@ Passos: > Resista à tentação de agrupar todos os itens num só e fazer a importação de uma vez só. Esta importação ficaria muito grande e a operação normalmente não se completa. +> **IMPORTANTE**: na pasta `/manage` da raiz, há vários itens internos do Plone que **NÃO** devem ser copiados. + +### 4. Mover os Itens que Serão Sobrepostos no Portal de Destino + +Os itens que serão sobrepostos devem ser movidos da pasta raiz. Se isto não for feito, o procedimento acusa erro de id já existente. + +Os passos são semelhantes aos do passo 2: +a. Entre na tela de conteúdo de pasta da raiz do portal. Exemplo: `https://novoportal.interlegis.leg.br/folder_contents`. +b. Crie uma pasta para este conteúdo. Use o botão `Adicionar Item -> Pasta` do interface. Exemplo de nome: `old`. +c. Selecione os itens. +d. Aperte o botão `recortar`. +e. Entre no diretório recém-criado. +f. Aperte o botão `colar´. + +> Os itens correspondentes a itens corrompidos no site original devem permanecer na raiz do novo site, já que não serão sobrepostos. + +### 5. Pedir a SEIT a Cópia dos Arquivos Exportados + +Peça à SEIT/Sussumu para copiar os arquivos exportados para o novo portal. Esta operação pode ser um pouco demorada. + +### 6. Importação dos Itens + +Agora todos os itens exportados no passo 3 devem ser importados. + +Passos: +a. Ir no /manage do novo site (exemplo: `https://novoportal.interlegis.leg.br/manage`) e apertar o botão Import/Export, sem selecionar nenhum checkbox. +b. Selecione o item na caixa de seleção `Import file name`. +c. Mantenha a radio no item `Take ownership of imported objects`. +d. Aperte o botão `Import`. + +> Alguns itens de tamanho elevado dão erro `504 Gateway Time-out` na importação. Neste caso, sigo o passo 6.1. + +> + +#### 6.1 Desabilitação de Health Check + +Este passo só é necessário se algum item der o erro `504 Gateway Time-out`, por demora na importação! + +a. Solicite a desabilitação do Health Check do novo portal à SEIT/Sussumu. +b. Normalmente eles têm de copiar novamente os arquivos exportados, pois eles são perdidos durante o processo de desabilitação. +c. Repita o passo 6 para o item. + + +### 7. Conferência e Ordenação dos Itens Importados +Após a importação, confira se todos os itens foram importados. Além disso, ordene os itens para ficarem na mesma ordem que no site original. Isto é para facilitar a adaptação dos usuários ao novo site. + +a. Entre na página de conteúdo da raiz. Exemplo: `https://novoportal.interlegis.leg.br/folder_contents`. +b. Use a área com pontinhos, à esquerda de cada checkbox, para arrastar o item para a sua ordem correta. + +### 8. Configuração da Capa + +É necessário configurar o novo site para a capa importada. + +a. Ir na raiz do novo site: `https://novoportal.interlegis.leg.br/` +b. Clicar na aba `Visão` +c. Clicar no item `Exibição` +d. Clicar no item `Alterar item usado como exibição padrão...` +e. Selecionar o item da capa (normalmente `Página Inicial`) + +### 9. Configuração de Portlets + +Caso os usuários tenham mexido na configuração de portlets do site antigo, é necessário refazer esta configuração no novo site. + +a. Ir na raiz do novo site: `https://novoportal.interlegis.leg.br/` +b. Apertar o botão `Gerenciar portlets` do lado direito ou esquerdo da página. +c. Conferir se a configuração está igual nos dois sites. + +### 10. Configuração do Site + +É necessário fazer a configuração do site, para bater com o site anterior. + +a. Ir na raiz do novo site: `https://novoportal.interlegis.leg.br/`. +b. No menu `admin` (canto direito superior), clicar em `Configuração do Site`. +c. Item `Discussion`: desmarque a checkbox `Ativar comentários globalmente`. +d. Item `E-mail`: + - Servidor SMTP: smtp.interlegis.leg.br + - Porta SMTP: 25 + - Usuário ESMTP e Senha ESMTP: em branco + - Nome do 'Remetente' do Site: `Câmara Municipal de - `. Exemplo: "Câmara Municipal de Itu - SP". + - Endereço do 'Remetente' do Site: copiar do site antigo. + - clique em "Salvar e Enviar Email de Teste" +e. Item `Site`, título e descrição: copie do site anterior. +f. Item `Site`, logo do site. No site anterior, clique com o botão direito no logo do site e `Salvar Imagem Como...`. No novo site, use a opção `Imagem do Logo - Replace with new image` para usar a imagem salva +g. Item `Configuração do SAPL Sync`: Nem sempre é usada. Copie do site anterior. +h. Item `Recaptcha`: Copie os dados do site anterior. + +### 11. Navegação Horizontal + +Logo abaixo do cabeçalho do site, tem uma barra de navegação horizontal. Lá há links rápidos para alguns dos itens do site. + +Confira se a navegação horizontal do novo site bate com o antigo (lembrando que itens corrompidos não aparecem na navegação horizontal). + +Se tiver algum item a mais no novo site, ele pode ser desabilitado assim: + +a. Clique no item +b. Clique em `Configuração` +c. Marque a checkbox `Excluir da navegação` + +### 12. Colocar o Novo Site no Ar + +Peça a SEIT/Sussumu para colocar o novo site no ar, com o nome do site antigo. Lembre de pedir pro site antigo ser renomeado para um outro nome antes, como backup. + +Exemplo: +1. Site antigo `pien.pr.leg.br` +2. Site novo `novosite.leg.br` +3. Renomear `pien.pr.leg.br` para `bkp.pien.pr.leg.br` +4. Renomear `novosite.leg.br` para `pien.pr.leg.br` + +### 13. Avisar ao Solicitante do Ticket + +Avise o solicitante do ticket que o site foi exportado para um novo e peça pra testar. + +Lembre a ele que os usuários do site antigo não são exportados, caso eles tenham criado algum. + +