Procedimento de Migração do SAPL 2.4 para 2.5

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.4 necessários para a migração. Para isso, digite no terminal o comando abaixo:

sudo mkdir /home/backup_migracao

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

mysqldump -uroot -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 a cópia do arquivo DocumentosSapl?.fs para a pasta de temporária.

sudo cp /var/interlegis/SAPL-2.4/instances/sapl24/var/DocumentosSapl.fs /home/backup_migracao/

Obs: Caso o seu SAPL 2.4 esteja instalado em uma pasta diferente ajuste o caminho do comando acima.

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

• posteriormente clique sobre o item "sapl", 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" selecione o item "Save to file on server" e clique em no botão "Export".

Observe que se a seguinte mensagem foi retornada "acl_users successfully exported to /var/interlegis/SAPL-2.4/instances/sapl24/var/acl_users.zexp", caso positivo feche o navegador e caso negativo repita o processo.

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

sudo cp /var/interlegis/SAPL-2.4/instances/sapl24/var/acl_users.zexp /home/backup_migracao/

6) 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 9 ."

7) Acesse o "manage" do SAPL 2.4, 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".

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

sudo cp /var/interlegis/SAPL-2.4/instances/sapl24/var/oai.zexp /home/backup_migracao/

9) Pare o SAPL 2.4, para isso digite no terminal o comando abaixo:

  sudo /var/interlegis/SAPL-2.4/instances/sapl24/bin/shutdownsapl.sh

Obs: Caso o seu SAPL 2.4 esteja instalado em uma pasta diferente ajuste o caminho do comando acima.

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

sudo mysqladmin -u root -p'nn5000' drop interlegis 

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

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

12) Neste ponto será possível proceder normalmente à instalação do SAPL 2.5, conforme Roteiro de Instalação ​http://colab.interlegis.leg.br/wiki/HOWTO-InstalarSAPL25Ubuntu, iniciando a partir do item 8.

13)A partir deste ponto vamos restautar os dados do SAPL 2.4 sobre a instalação do SAPL 2.5

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

sudo mysqladmin -u root -p'nn5000' drop interlegis 

14) Crie um banco Interlegis do Mysql, para isso digite no terminal o comando abaixo:

sudo mysqladmin -u root -p'nn5000' create interlegis 

15) Copie o backup do banco Interlegis do SAPL 2.4 para o SAPL 2,5, para isso digite no terminal o comando abaixo:

sudo mysql -uroot -p interlegis < /home/backup_migracao/interlegis_bk.sql

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

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

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

sudo chown zope.zope /var/interlegis/SAPL-2.5/instances/sapl25/var/DocumentosSapl.fs

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

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

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

sudo chown zope.root /var/interlegis/SAPL-2.5/instances/sapl25/var/acl_users.zexp

20) 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 23 .

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

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

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

sudo chown zope.root /var/interlegis/SAPL-2.5/instances/sapl25/var/oai.zexp

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

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

24) Inicie o SAPL 2.5, para isso digite no terminal o comando abaixo:

  sudo /var/interlegis/SAPL-2.4/instances/sapl24/bin/shutdownsapl.sh

25) Acesse o "manage" do SAPL 2.4, 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 boatão "Import"

26) 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 28 .

27) Acesse o "manage" do SAPL 2.4, 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 boatão "Import"

28) Acesse o "manage" do SAPL 2.4, 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 boatão "Import"

29) Acesse o "manage" do SAPL 2.4, 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 boatão "Import"

30) Para finalizar reinicie o SAPL 2.5, digitando no terminal o comando abaixo:

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

31) Caso deseje colocaro SAPL 2.5 na inicialização, basta editar o arquivo /etc/rc.local e adicionar o comando /var/interlegis/SAPL-2.5/instances/sapl25/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"