Guia de Atualização Release FoccoERP 2014 02/06/2014
Índice ÍNDICE... 2 APRESENTAÇÃO... 3 INTRODUÇÃO... 4 PROCESSO DE INSTALAÇÃO... 4 Página 2 de 20
Apresentação Este documento tem como objetivo descrever o processo de atualização do FoccoERP 2013 para a versão FoccoERP 2014. Página 3 de 20
Introdução Este documento descreve os passos para atualização da release 2013 para a release 2014 (3.14) do FoccoERP em um servidor. Processo de Instalação Atenção Este processo trata somente da atualização da versão do produto FoccoERP. A release 2014 contempla atualizações nos produtos FoccoERP e FoccoWEB. Clientes que utilizam o produto FoccoWEB devem contratar os serviços de atualização do mesmo junto a Infra Serviços da Focco. Esta atualização deve ser realizada na mesma data em que for feita a atualização do produto FoccoERP. Pré-Requisitos Para a migração do FoccoERP 2014 em um servidor é necessários alguns pré-requisitos: Instalador FoccoERP Servidor: instalador da atualização do FoccoERP 2014 no servidor FoccoUPDATE. Este instalador pode ser obtido via download na URL: Este instalador será disponibilizado no Portal de Agendamento de Atualizações 5 dias antes da data agendada.. Instalador Aplicativos Focco Servidor: instalador que integra os serviços disponíveis no Aplicativos Focco entre o servidor de banco de dados e as estações locais. Este instalador pode ser obtido via download através do endereço: Este instalador será disponibilizado no Portal de Agendamento de Atualizações 5 dias antes da data agendada. Instalador Aplicativos Focco Desktop: instalador da versão local do Aplicativos Focco que deve ser executado em todas as estações que irão acessar o FoccoERP. Este instalador pode ser obtido via download através do endereço: Este instalador será disponibilizado no Portal de Agendamento de Atualizações 5 dias antes da data agendada. Acesso ao Servidor FoccoUPDATE Para prosseguir com a atualização é necessário acesso total ao servidor onde está instalado o FoccoUPDATE, bem como acesso total ao FoccoUPDATE. Executar o Último Update FoccoERP 2013 É necessário que o ambiente que se deseja atualizar esteja atualizado via FoccoUPDATE até no mínimo o 6506. Conectividade ao Serviço de Atualização É necessário que a estação do FoccoUPDATE possua conectividade ao servidor de atualização do FoccoUPDATE (http://update.focco.com.br:5544). Página 4 de 20
O servidor de banco de dados do FoccoERP deve possuir a JRE (Java Runtime Environment) instalada na versão 1.7 ou superior. A JRE está disponível para download neste link. O servidor de banco de dados deve possuir acesso a internet liberado para os endereços http://update.focco.com.br (todas as portas). Acesso de administrador ao servidor de banco de dados FoccoERP. Processo de Atualização Para iniciar o processo de atualização do FoccoERP 2013 para a versão 2014 basta descompactar o arquivo focco.erp.server.installer.zip baixado previamente conforme a seção pré-requisitos. Dentro da pasta descompactada basta executar o arquivo Focco.ERP.Server.Installer.exe e seguir com os passos apontados abaixo. Procedimento de Backup Antes de iniciar o processo de atualização do FoccoERP 2014, a Focco indica como uma boa prática executar um backup do sistema e da base de dados. Página 5 de 20
Sincronia de Base de Dados Antes de iniciar o processo de atualização do FoccoERP 2014, convém realizar a rotina de sincronia da base de produção para a base de testes conforme necessário. Após realizar a atualização, executar o sincronismo entre Produção (2013) e Testes (2014) irá gerar uma problemas na base de dados. A primeira tela do Instalador FoccoERP 2014 Servidor exibe basicamente um descritivo do que se trata o programa e dá recomendações gerais ao usuário de como proceder com o processo de instalação. Esta tela possui dois botões que possuem os seguintes comportamentos: Cancelar Este botão irá fechar o aplicativo caso clicado. Continuar Este botão serve para continuar para o próximo passo do processo de instalação. Esta tela é responsável por testar os pré-requisitos para a atualização do FoccoERP 2014 no servidor FoccoUPDATE. Para isso, essa transação executa os seguintes testes: Verificando Instalação do FoccoUPDATE este teste verifica se a estação onde o instalador está sendo executado possui o FoccoUPDATE instalado. Caso positivo passa no teste. Caso não detecte a instalação do FoccoUPDATE na estação onde o instalador está sendo executado exibe falha no teste e impossibilita a continuação do processo de atualização. Para isso, garanta que a máquina onde o instalador está sendo executo é a mesma estação utilizada para a atualização de pacotes via FoccoUPDATE. Página 6 de 20
Checando Conexão com Serviço de Atualização simplesmente testa se a estação onde o instalador está sendo executado possui conectividade com os servidores de atualização da Focco. Todos os testes descritos acima deverão são executados de maneira simultanea e assincrona, exibindo seu respectivo indicador de carga durante a execução. Caso o teste seja bem sucedido, o sistema irá exibir um indicador verde apontando o sucesso, e caso ocorra alguma falha, exibirá exibir um indicador vermelho, impossibilitando o prosseguimento do processo de atualização. Por isso é muito importante garantir que os pré-requisitos apontados neste documento estejam corretos. Esta tela possui ainda dois botões que possuem os seguintes comportamentos: Anterior Este botão faz com que o processo de atualização retroceda, ou seja, volta para a tela de anterior. Este é o comportamento padrão para este botão nas demais telas. Continuar Este botão serve para continuar para o próximo passo do processo de atualização. Este botão pode estar desabilitado caso os testes ainda estejam sendo executados, ou caso tenha ocorrido alguma falha em um dos testes. Esta tela exibe os ambientes de atualização FoccoUPDATE para o produto FoccoERP sendo utilizados. Nesta tela, basta selecionar qual o ambiente desejado para executar a migração versão 2014. Ao clicar no botão Continuar o instalador irá verificar duas questões: Sobre a Atualização dos Ambientes O instalador verifica automaticamente se o ambiente de atualização selecionado está atualizado até o último pacote de Página 7 de 20
atualização lançado (denominado pacote de corte). Caso negativo, será exibida uma notificação informando sobre o ocorrido. Cabe ressaltar que para que a migração da versão seja bem sucedida é necessário que o último pacote de atualização disponível para a versão 2013 já esteja instalado no ambiente selecionado (conforme seção Pré-Requisitos). Sobre a Política de Migração Focco O instalador verifica automaticamente a ordem dos ambientes de atualização sendo migrados, isto é, é impossível atualizar o ambiente de produção antes do ambiente de testes. Isto é uma política definida pela Focco para garantir uma maior segurança no novo processo de migração de versões. Caso ambas as questões levantadas pelo instalador prossigam corretamente, o instalador irá para o próximo passo, que é a migração da versão propriamente dita. Nesta tela o processo de atualização basicamente exibe o que está sendo executado, juntamente com uma barra de progresso. Ao término da atualização, o botão Continuar irá aparecer na tela, direcionando para a última tela do processo de instalação. Página 8 de 20
A última tela do processo de atualização exibe uma mensagem comunicando o término do processo de migração, bem como o próximo passo a ser executado: a atualização da mídia via FoccoUPDATE. Atualizar Release - FoccoUPDATE Ao término da execução do Instalador FoccoERP Servidor, devem ser executadas as atualizações disponíveis no FoccoUPDATE. Para isto, basta abrir o FoccoUPDATE normalmente, selecionar o ambiente migrado e executar as atualizações. Página 9 de 20
Pacote de Release O primeiro pacote de atualização de cada um dos ambientes migrados pode demorar alguns minutos. Este pacote contém todos os arquivos necessários para a migração da base de dados. Além disso é MUITO IMPORTANTE atualizar todos os pacotes de atualização disponíveis para o ambiente migrado. A Focco não se responsabiliza por bases atualizadas parcialmente, pois com isso não existe como garantir a estabilidade da versão. Aplicativos Focco - Servidor O processo de instalação do Aplicativos Focco Servidor descreve o processo de instalação que diz respeito ao centralizador de informações para as estações locais dos produtos Focco. Esta instalação será feita diretamente no servidor de banco de dados do FoccoERP seja ele Windows ou Linux. Permissão de Administrador Para a correta instalação deste passo é necessário que o usuário possua permissão de administrador local no servidor de banco de dados. O primeiro passo que deve ser executado é a instalação da JRE (Java Runtime Environment) no servidor de banco de dados. Informações referentes a este passo podem ser obtidas no site da Oracle para Linux. Para verificar a correta instalação do Java no servidor basta executar o comando java - version no prompt de comando (Windows) ou na console (Linux). java -version Página 10 de 20
Após a instalação do Java, deve-se descompactar os arquivos contidos no zip focco.erp.server.aplicativos.zip para o diretório onde se deseja instalar o mesmo. É importante que o mesmo usuário que executa normalmente o banco de dados do FoccoERP tenha acesso de permissão e leitura no diretório escolhido. Na pasta onde os arquivos foram descompactados existe um arquivo chamado database.sql que deve ser executado na base de dados como sysdba. Dentro da mesma pasta, existe outro arquivo chamado configuration.xml. Neste arquivo é necessário configurar a chave do cliente FoccoUPDATE. Para isto, basta inserir os valores na chave CUSTOMER_KEY, conforme abaixo: <entry key="customer_key">xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx</entry> Por exemplo: <entry key="customer_key">e52df998-0595-42cf-9c1e-e1bbe4d15bcf</entry> Customer Key Chave do Cliente Caso você não saiba a sua chave de cliente acesse o seguinte arquivo na estação/servidor onde estiver instado o FoccoUPDATE: C:\Focco\Update\Config.txt. Abra este arquivo e anote o CustomerCode. Após estes passos, basta acessar a pasta em que foram copiados os arquivos e executar o comando: java -jar Bifrost.jar Para testar se o serviço foi corretamente iniciado, basta acessar pelo navegar a URL definida da configuração http://<ip-do-server>:7757 com o sufixo?wsdl. Portanto, para verificar o serviço na máquina 10.1.1.2 (por exemplo) basta digitar pelo navegador http://10.1.1.2:7757?wsdl. A página apresentada, deve ser similar à seguinte. Página 11 de 20
Configuração da Porta É imprescindível para o funcionamento do sistema que a porta 7757 esteja liberada em qualquer firewall ou outro aplicativo que controle o uso de portas. As estações locais irão comunicar com o servidor através desta porta. Inicialização do Servidor Convém colocar o comando java-jar Bifrost.jar dentro do script de inicialização do servidor. O sistema FoccoERP não funciona sem este serviço no ar, portanto caso o servidor seja reiniciado, o serviço deve ser inicializado novamente. Aplicativos Focco - Desktop O processo de instalação do Aplicativos Focco Desktop descreve o processo de instalação que diz respeito ao novo centralizador dos aplicativos Focco nas estações locais. Esta instalação deve ser feita em cada uma das estações que irão utilizar o FoccoERP, sendo que a mesma deve ser feita com acesso de administrador. Para instalar é necessário descompactar o arquivo focco.erp.client.installer.zip para uma pasta qualquer. Dentro da pasta contendo os arquivos existe uma pasta chamada Config, que apresenta dois arquivos. É necessário abrir o arquivo ConfigInstaller.xml para a configuração do servidor do Aplicativos Focco: Dentro deste arquivo basta digitar a url do servidor Aplicativos Focco, por exemplo, seguindo o exemplo fornecido no passo anterior: Após a configuração do Aplicativos Focco basta executar o arquivo Focco.ERP.Installer.exe com permissões de administrador para o usuário que irá acessar o sistema: Ao executar o programa Focco.ERP.Installer.exe a tela abaixo é exibida: Página 12 de 20
A primeira tela do Aplicativos Focco Desktop exibe basicamente um descritivo do que se trata o programa e dá recomendações gerais ao usuário de como proceder com o processo de instalação. Esta tela possui dois botões que possuem os seguintes comportamentos: Cancelar Este botão irá fechar o aplicativo caso clicado. Continuar Este botão serve para continuar para o próximo passo do processo de instalação. Página 13 de 20
Esta tela é responsável por testar os pré-requisitos para a instalação do Aplicativos Focco na estação local. Para isso, essa transação executa os seguintes testes: Testando Conexão com o License Server este teste verifica se o endereço informado para o Aplicativos Focco Servidor está acessível a partir desta estação. Checando Conectividade dos Serviços este teste verifica se os serviços de integração do Aplicativos Focco estão disponíveis e funcionando corretamente no servidor de banco de dados. Verificando Espaço Livre em Disco este teste verifica se a estação local possui espaço em disco suficiente livre para a instalação. Checando Permissões de Acesso Este testa verifica se o usuário instalando o Aplicativos Focco possui permissão de acesso ao diretório C:/Focco que deve ser criado para a instalação. Todos os testes descritos acima deverão são executados de maneira simultanea e assincrona, exibindo seu respectivo indicador de carga durante a execução. Caso o teste seja bem sucedido, o sistema irá exibir um indicador verde apontando o sucesso, e caso ocorra alguma falha, exibirá exibir um indicador vermelho, impossibilitando o prosseguimento do processo de atualização. Por isso é muito importante garantir que os pré-requisitos apontados neste documento estejam corretos. Esta tela possui ainda dois botões que possuem os seguintes comportamentos: Página 14 de 20
Anterior Este botão faz com que o processo de atualização retroceda, ou seja, volta para a tela de anterior. Este é o comportamento padrão para este botão nas demais telas. Continuar Este botão serve para continuar para o próximo passo do processo de atualização. Este botão pode estar desabilitado caso os testes ainda estejam sendo executados, ou caso tenha ocorrido alguma falha em um dos testes. Esta tela exibe os ambientes de atualização FoccoUPDATE para o produto FoccoERP sendo utilizados. Nesta tela, basta selecionar qual o ambiente que o usuário necessita ter acesso. Ao clicar no botão Continuar o instalador inicializará o processo de instalação. Página 15 de 20
Nesta tela o processo de atualização basicamente exibe o que está sendo executado, juntamente com uma barra de progresso. Ao término da atualização, o botão Continuar irá aparecer na tela, direcionando para a última tela do processo de instalação. Página 16 de 20
A última tela do processo de atualização exibe uma mensagem comunicando o término do processo de migração. Após este passo o FoccoERP está pronto para ser utilizado através do ícone na área de trabalho: O mesmo ícone pode ser pesquisado pelo menu iniciar do sistema operacional Windows: Ao inicializar o programa Aplicativos Focco a janela de carga da aplicação será exibida: Página 17 de 20
Após a carga da aplicação a tela inicial do aplicativos Focco é exibida, e o processo de sincronismo é executado junto ao servidor. Na primeira execução é normal que este processo demore alguns minutos. Nas próximas execuções este processo não demora mais do que 10 segundos. Aplicativos Focco Desktop Atualização Silenciosa Existe ainda a possibilidade de agendar a instalação das estações locais através da inicialização do sistema operacional das estações. Este agendamento pode ser feito através de um script de logon chamando o Focco.ERP.Installer.exe com o seguinte parâmetro: Focco.ERP.Installer.exe -silent Quando o usuário logar em sua estação o FoccoERP iniciará a instalação automaticamente sem intervenção do usuário. Para escolher quais ambientes serão instalados na estação local basta editar o arquivo ConfigInstallerUser.xml, localizado na pasta Config dentro do instalador. <configuration> <ambients> <ambientkey>3e8bcfdb-e75a-45d0-aca9-2da72821453c</ambientkey> <ambientkey>a4097c56-f68e-4c35-842e-6a9d59f0d985</ambientkey> </ambients> </configuration> É necessário inserir uma chave <ambientkey> contendo a chave do ambiente para cada um dos ambientes que se deseja instalar através da inicialização. Caso você não saiba a chave dos seus ambientes, basta entrar em contato com a Infra Serviços da Focco. Atenção: Não é possível selecionar individualmente por estação ambientes diferentes daqueles informados pelo arquivo de configuração. Caso um ambiente esteja configurado no arquivo, o mesmo será instalado em todas as estações locais. Página 18 de 20
Quando os usuários entrarem em suas estações o script de logon irá inicializar o instalador automaticamente, em um janela no canto inferior direito da tela, e irá instalar o sistema, sendo encerrado automaticamente ao término da instalação. Página 19 de 20
matriz marcos moreschi 437 caxias do sul RS 54 3025 9000 filiais são leopoldo rs são josé sc são paulo sp arapongas pr ubá mg www.focco.com.br focco@focco.com.br Página 20 de 20