Procedimento de Migração do SAPL 2.4 para 2.5

Requisitos:

• Ter acesso root do seu sistema operacional;
• 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 /tmp/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 > /tmp/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 /tmp/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 esquerda do "manage", 
* posteriormente marque o item acl_users, 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 /tmp/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", 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 /tmp/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 < /tmp/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 /tmp/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 /tmp/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 /tmp/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"