Instalação MS-Windows com MS-SQL PROJURIS WEB 5.0
Implantação ProJuris Web 5.0 Revisão: 1.1 16/08/2013 Instalação ProJuris Web 5 Página 2
Florianópolis, 02 de Agosto de 2013. Prezado Senhores, Estou encaminhando a documentação sobre a Implantação do ProJuris Web 5.0 no Sistema Operacional Windows Server como servidor de aplicação, e servidor de Banco de Dados MS-SQL Server, a fim de elucidar eventuais incertezas. As informações contidas aqui servem como referência e podem ser alteradas de acordo com as necessidades técnicas. Esperamos que o conteúdo apresentado atenda as expectativas de V.Sas. de forma clara e objetiva. Atenciosamente. Marcelo Crivelli Instalação ProJuris Web 5 Página 3
Data Revisão Descrição Autor 02/08/2013 1.0 Apache Tomcat 6.0.36 em Windows Server Marcelo 2008 e conexão com banco MS-SQL Server 2008 16/08/2012 1.1 Incluído etapa de cópia de Libs ao Tomcat Marcelo Instalação ProJuris Web 5 Página 4
Sumário 1 Instalação do Servidor de aplicação.... 6 1.1. Versões... 6 1.2. Instalação e configuração do Java 1.6... 6 1.3. Instalação e configuração do Apache Tomcat... 6 2 Configuração da Instância Banco de Dados.... 9 2.1. Criação do Banco de Dados... 9 2.2. Criação do Usuário... 9 3 Integração e manutenção dos Serviços.... 10 3.1. Local dos diretórios do Tomcat e suas funções.... 10 3.2. Para parar/iniciar o serviço do Tomcat... 11 Instalação ProJuris Web 5 Página 5
1 Instalação do Servidor de aplicação. 1.1. Versões Deverão ser utilizadas o Apache Tomcat 6.0.36 com Oracle JDK 1.6. O ProJuris Web não está homologado para outras versões e não poderá ser responsabilizado por falhas em detrimento de versões diferentes das homologadas. 1.2. Instalação e configuração do Java 1.6 Obrigatoriamente deve ser instalada o Oracle JDK 1.6, independente da subversão. Sempre que possível, recomendamos a versão 64 bits, desde que o servidor também seja 64 bits. Instalação padrão, sem alteração de diretório de instalação ou outra configuração. 1.3. Instalação e configuração do Apache Tomcat A instalação do Tomcat deve ser realizada em um diretório DIFERENTE do padrão Windows, como Arquivos de Programas. Recomendação a criação de uma pasta APPS na Raiz de seu servidor, e dentro dele a instalação do Tomcat (por exemplo: C:\APPS\Tomcat 6.0\). Durante o processo de instalação, terão a possibilidade de modificar a porta Padrão do Tomcat, que é 8080. Para facilitar ao Usuário Final, sem necessidade de configurar um Proxy ou Firewall, esta porta pode ser alterada para 80. É necessária a configuração para definir a memória no servidor de aplicação. Para isto, abra o Monitor do Tomcat (aparecerá no systray). Em seguida, clique no mesmo com o botão da Direita e depois em Configure. Aparecerá uma janela como abaixo: Instalação ProJuris Web 5 Página 6
Observe as marcações. - no campo Java Virtual Machine, deve ser utilizado o arquivo jvm.dll, dentro do diretório do JDK. Esta informação deve ser detectada pela instalação do Tomcat, mas caso haja mais de um Java instalado na máquina, a informação cadastrada por estar equivocada. Deve ser verificada. - nos campos: Initial memory pool, Maximum memry pool e Thread stack size, estão valores padrões utilizados em máquinas com 4Gb de memória. Podem ser modificados, de acordo com a disponibilidade da máquina, quantidade de usuário simultâneos, etc. Além disso, o campo Java Options pode ser alterado, inserindo informações de monitoramento. Se forem utilizar, basta copiar as linhas abaixo, acrescentando no campo Java Options: -Djava.rmi.server.hostname=0.0.0.0 -Djava.rmi.server.useLocalHostname=true -Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=8999 -Dcom.sun.management.jmxremote.ssl=false -Dcom.sun.management.jmxremote.authenticate=false Instalação ProJuris Web 5 Página 7
Agora, deverão ser feita alterações, como mostrado abaixo. - Criar a Pasta/Diretório: C:\APPS\TOMCAT 6.0\VIRTUEM_APPS - Copiar o pacote ProJurisweb.war na pasta acima. Renomear para virtuem.zip. Descompactar o arquivo, criando a pasta VIRTUEM. Agora, configurar: - Diretório/arquivo: C:\APPS\TOMCAT 6.0\CONF\server.xml Inserir a linha a seguir, entre <HOST...> e </HOST>: <Context path="/" docbase="../virtuem_apps/virtuem"> </Context> - Opcional: Recomendamos acrescentar um diretório nomeado RELEASES, onde ficarão guardados os pacotes antigos da aplicação, servindo para histórico e para um eventual retorno, caso um pacote gere problemas. - Deve ser Excluído o diretório ROOT, da pasta a seguir: Diretório/arquivo: C:\APPS\TOMCAT 6.0\WEBAPPS\root - Devem ser copiadas novas LIBs a pasta padrão do Tomcat. As Libs faltantes podem ser baixadas pelo link: http://download.projuris.com.br/projurisweb/tomcat_lib.zip O arquivo acima deve ser descompactado no Diretório abaixo: Diretório/arquivo: C:\APPS\TOMCAT 6.0\LIB Instalação ProJuris Web 5 Página 8
2 Configuração da Instância Banco de Dados. A Instalação do servidor de Banco de dados MS-SQL 2008, assim com sua configuração, já deve estar disponível, apenas para acesso da Duo. 2.1. Criação do Banco de Dados Criar um banco de dados. O nome pode ser PROJURIS ou outro, conforme o padrão do Cliente. Entretanto, o nome do banco e o nome do usuário deverão ser IGUAIS. OBS: Neste ponto, podemos encaminhar um backup de um banco Padrão a ser restaurado. Verifique com seu Consultor de Implantação. Conterá apenas tabelas Auxiliares, primeiro usuário da Aplicação e outros acessórios. 2.2. Criação do Usuário Criar um Usuário e Senha, com a permissão DBOWNER ao banco criado. Deve ser executado o script a seguir, para dar permissão de visualizar as transações do banco: - grant view server state to USUÁRIO; OBS: Este banco deverá entrar na rotina de Backup automatizada, conforme os padrões do Cliente. Instalação ProJuris Web 5 Página 9
3 Integração e manutenção dos Serviços. Em toda atualização do sistema, são necessários alguns cuidados: 3.1. Local dos diretórios do Tomcat e suas funções. C:\APPS\TOMCAT 6.0\virtuem_apps\virtuem Local que contém o pacote e onde é feito o redeploy. O arquivo ProJurisWeb.war deverá ser descompactado nesta pasta, substituindo os arquivos existentes. C:\APPS\TOMCAT 6.0\virtuem_apps\virtuem\WEB-INF\config-sis.xml Este arquivo contém a conexão com o banco de dados, o nome da instância, o nome do banco de dados, a senha, entre outros. Como o arquivo.war é gerado para Todos os clientes da Duo, sempre deve ser verificado se a conexão com o Banco está adequado, caso contrário a aplicação não iniciará adequadamente. A linha adequada para o servidor muda para cada Cliente. Um exemplo é: Onde: <system POOL_DRIVER="net.sourceforge.jtds.jdbc.Driver" POOL_PASSWORD="senha" POOL_URL="jdbc:jtds:sqlserver://servidorSQL:1433/usuario" POOL_USER=" usuario " id="pjw" name="projuris"> - POOL_URL: contém a conexão com o banco em si - POOL_DRIVER: driver Jdbc do MS-SQL - POOL_USER: usuário do banco de dados - POOL_PASSWORD: senha do usuário do banco de dados - ID: não alterar, padrão: PJW - NAME: não alterar, padrão: projuris C:\APPS\TOMCAT 6.0\WORK\CATALINA\LOCALHOST Aqui, devem ser excluídos os diretórios _ e virtuem, quando o pacote foi atualizado. C:\APPS\TOMCAT 6.0\TEMP Local com os temporários e cache, apagar todos os arquivos, mas não a pasta Temp, quando o pacote foi atualizado. C:\APPS\TOMCAT 6.0\LOGs Local com os logs da aplicação ProJuris, apagar quando não há erros que geraram uma demanda e quando o pacote foi atualizado. Instalação ProJuris Web 5 Página 10
3.2. Para parar/iniciar o serviço do Tomcat Clique no Monitor do Tomcat, com o botão da Direita, e depois em Stop Service. Para Iniciar, clique em Start Service, com abaixo: Para ter certeza que o Tomcat iniciou, observe o ícone do Monitor do Tomcat. Deve estar como abaixo, uma seta verde. Caso tenha um quadrado vermelho, o servidor não iniciou. Neste caso, abra o arquivo: tomcat6-stdout.<data>.log, na pasta C:\APPS\TOMCAT 6.0\LOGS mais atual para identificar o problema. O mais comum é que a string de conexão com o banco estar errada ou com um caractere a mais. Para entrar na aplicação, abra um Navegador e entre no endereço a seguir: Uma tela como abaixo deve aparecer: http://localhost/projuris Instalação ProJuris Web 5 Página 11