MIGRAÇÃO SAPL-2.5 PARA SAPL-3.0

Requisitos:

• Seu usuário necessita ter permissões de root;
• Possuir a senha do Mysql;
• Possuir a senha do usuário "admin" do ZOPE/SAPL;

1) Crie uma pasta temporária para o armazenamento dos arquivos do SAPL 2.5 necessários à realização da migração. Para isso, digite no terminal o comando abaixo:

sudo mkdir /home/backup_migracao

2) Utilizando o comando abaixo, faça uma cópia de segurança do banco de dados do SAPL 2.5 contido no Mysql.

sudo mysqldump -u root -p interlegis > /home/backup_migracao/interlegis_bk.sql

Observação: Caso seu Mysql esteja com senha, será necessária fornece-la durante este processo e caso o mesmo não possua senha basta confirmar teclando "enter".

3) Utilizando o comando abaixo, faça uma cópia de carga do banco de dados do SAPL 2.5 contido no Mysql.

sudo mysqldump -u root -p -t interlegis > /home/backup_migracao/interlegis_bk_dados.sql

Observação: a opção -t irá criar arquivo somente com os dados e os respectivos comandos inserts sem as estruturas das tabelas, o qual deverá ser utilizado para posterior carga no banco de dados do sapl 3.0. A observação acima no passo 2 - sobre o procedimento de uso ou não de senha - também vale para esta execução.

4) Utilizando o comando abaixo, faça a cópia do arquivo DocumentosSapl?.fs para a pasta de temporária.

sudo cp /var/interlegis/SAPL-2.5/instances/sapl25/var/DocumentosSapl.fs /home/backup_migracao/

Observação: Caso o seu SAPL 2.5 esteja instalado em uma pasta diferente ajuste o caminho do comando acima.

5) Acesse o "manage" do SAPL 2.5, através do endereço ​http://localhost:8080/manage,

• posteriormente clique sobre o item "sapl", no ambiente ZMI, no menu na lateral esquerdo do "manage",
• posteriormente marque o item acl_users na lista de itens central do "manage", em seguida clique no botão "Import / Export" localizado na parte inferior da página,
• e, para finalizar, em "Export to" e selecione o item "Save to file on server" e clique em no botão "Export".

Observe que se a mensagem retornada foi: "acl_users successfully exported to /var/interlegis/SAPL-2.5/instances/sapl25/var/acl_users.zexp". Caso positivo, feche o navegador e em caso negativo repita o processo.

6) Utilizando o comando abaixo, faça uma cópia do arquivo acl_users.zexp para a pasta de temporária.

sudo cp /var/interlegis/SAPL-2.5/instances/sapl25/var/acl_users.zexp /home/backup_migracao/

7) Caso esteja utilizando o módulo OAI/LEXML para a trasmissão de dados para o projeto LEXML, faça a cópia do "SAPL OAI Server" utilizando o procedimento a seguir, caso contrário passe para o procedimento 10 ."

8) Acesse o "manage" do SAPL 2.5, através do endereço ​http://localhost:8080/manage,

• posteriormente clique sobre o item "sapl", no menu na lateral esquerda do "manage",
• posteriormente marque o item oai na lista de itens central do "manage", em seguida clique no botão "Import / Export" localizado na parte inferior da página,'""
• e para finalizar em "Export to" selecione o item "Save to file on server" e clique em no botão "Export".

9) Utilizando o comando abaixo, faça uma cópia do arquivo oai.zexp para a pasta de temporária.

sudo cp /var/interlegis/SAPL-2.5/instances/sapl25/var/oai.zexp /home/backup_migracao/

10) Pare o SAPL 2.5, sendo que, para isso, digite no terminal o comando abaixo:

  sudo /var/interlegis/SAPL-2.5/instances/sapl25/bin/shutdownsapl.sh

Observação: Caso o seu SAPL 2.5 esteja instalado em uma pasta diferente ajuste o caminho do comando acima.

11) Remova o banco Interlegis do Mysql, para isso digite no terminal o comando abaixo:

mysqladmin -u root -p drop interlegis 

12) Remova a pasta onde está instalado o SAPL 2.5, para isso digite no terminal o comando abaixo:

sudo rm -R /var/interlegis/SAPL-2.5/

13) Neste ponto proceda à instalação do SAPL 3.0, conforme Roteiro de Instalação ​http://colab.interlegis.leg.br/wiki/HOWTO-InstalarSAPL30Ubuntu, iniciando a partir do item 9 do roteiro mencionado.

14) A partir deste ponto vamos restaurar os dados do SAPL 2.5 sobre a instalação do SAPL 3.0 . Copie o backup do banco Interlegis do SAPL 2.5, que foi obtido no passo 3 acima, para o SAPL 3.0, sendo que, para isso, digite no terminal o comando abaixo:

sudo mysql -u root -p interlegis < /home/backup_migracao/interlegis_bk_dados.sql

Observação: as tabelas do banco de dados que migraram da versão 2.5, neste ponto - após execução da instrução acima - deverão estar carregadas com os conteúdos que vieram da versão 2.5. As demais tabelas estarão ou vazias ou com valores iniciais, que foram previamente definidos.

15) Utilizando o comando abaixo, faça a cópia do arquivo DocumentosSapl?.fs da pasta de temporária, para a pasta do SAPL 3.0.

sudo cp /home/backup_migracao/DocumentosSapl.fs /var/interlegis/SAPL-3.0/instances/sapl30/var/

16) Utilizando o comando abaixo, mude o dono do arquivo DocumentosSapl?.fs copiado anteriormente

sudo chown zope:zope /var/interlegis/SAPL-3.0/instances/sapl30/var/DocumentosSapl.fs

17) Utilizando o comando abaixo, faça a cópia do arquivo acl_users.zexp da pasta de temporária, para a pasta do SAPL 3.0.

sudo cp /home/backup_migracao/acl_users.zexp /var/interlegis/SAPL-3.0/instances/sapl30/import

18) Utilizando o comando abaixo, mude o dono do arquivo acl_users.zexp copiado anteriormente

sudo chown zope:root /var/interlegis/SAPL-3.0/instances/sapl30/import/acl_users.zexp

19) Caso esteja utilizando o módulo OAI/LEXML para a transmissão de dados para o projeto LEXML, faça a cópia do SAPL "OAI Server utilizando o procedimento a seguir, caso contrário, passe para o procedimento 23 .

20) Utilizando o comando abaixo, faça a cópia do arquivo oai.zexp da pasta temporária, para a pasta import do SAPL 3.0.

sudo cp /home/backup_migracao/oai.zexp /var/interlegis/SAPL-3.0/instances/sapl30/import

21) Utilizando o comando abaixo, mude o dono do arquivo oai.zexp copiado anteriormente

sudo chown zope:root /var/interlegis/SAPL-3.0/instances/sapl30/import/oai.zexp

22) Utilizando o comando abaixo aplique as atualizações da versão 2.5 ao banco de dados Interlegis no Mysql, para isso, digite no terminal o comando abaixo:

mysql -u root -p interlegis < /var/interlegis/SAPL-3.0/instances/sapl25/Products/ILSAPL/instalacao/documento_administrativo.sql

23) Inicie o SAPL 3.0, para isso, digite no terminal o comando abaixo:

  sudo /var/interlegis/SAPL-3.0/instances/sapl30/bin/startsapl.sh

24) Acesse o "manage" do SAPL 3.0, através do endereço ​http://localhost:8080/manage,

• posteriormente clique sobre o item "sapl", no menu na lateral esquerda do "manage",
• posteriormente marque o item "acl_users", em seguida clique no botão "Delete" localizado na parte inferior da página,
• clique no botão "import/export"
• Em "Import file name" selecione o item "acl_users" e clique no botão "Import"

25) Caso esteja utilizando o módulo OAI/LEXML para a trasmissão de dados para o projeto LEXML, faça o procedimento a seguir, caso contrário, passe para o procedimento 27 .

26) Acesse o "manage" do SAPL 3.0, através do endereço ​http://localhost:8080/manage,

• posteriormente clique sobre o item "sapl", no menu na lateral esquerda do "manage",
• * clique no botão "import/export"
• Em "Import file name" selecione o item "oai.zexp" e clique no botão "Import"

27) Acesse o "manage" do SAPL 3.0, através do endereço ​http://localhost:8080/manage,

• posteriormente clique sobre o item "sapl", no menu na lateral esquerda do "manage",
• * clique no botão "import/export"
• Em "Import file name" selecione o item "administrativo.zexp" e clique no botão "Import"

28) Acesse o "manage" do SAPL 3.0, através do endereço ​http://localhost:8080/manage,

• posteriormente clique sobre o item "sapl", no menu na lateral esquerda do "manage",
• * clique no botão "import/export"
• Em "Import file name" selecione o item "oradores_expediente.zexp" e clique no botão "Import"

29) Para finalizar reinicie o SAPL 3.0, digitando no terminal o comando abaixo:

sudo /var/interlegis/SAPL-3.0/instances/sapl30/bin/shutdownsapl.sh && /var/interlegis/SAPL-3.0/instances/sapl25/bin/startsapl.sh

30) Caso deseje colocaro SAPL 3.0 na inicialização, basta editar o arquivo /etc/rc.local e adicionar o comando /var/interlegis/SAPL-3.0/instances/sapl30/bin/startsapl.sh antes do "Exit 0".

Observação: após substituir o Documentos Sapl.fs e reiniciar o Zope, o objeto /sapl/sapl_documentos poderá aparecer quebrado na ZMI. Para resolver esse problema, basta excluí-lo e adiciona-lo novamente através da opção "Add ZoDB mount point"