Guia Técnico
Instalação Java JDK, servidor Tomcat e PERGAMUM WEB
Guia Técnico
Versão 01.00
Histórico da Revisão
|Data |Versão |Descrição |Autor |
|06/07/2011 |01.00 |Descrição do manual |D’ Artagnan Hryusv |
|03/01/12 |01.01 |Adicionado capítulo de foto de usuário |D’Artagnan Hryusv |
|18/06/2012 |01.02 |Alterada descrição da configuração do arquivo context.xml |Julierme Veiga |
|24/10/2012 |01.03 |Adicionada informação de local de download do war da versão 8.1 |D’artagnan Hryusv |
|16/09/2015 |01.04 |Atualizada a instalação do Java |Tiago Thurmann |
|06/10/2015 |01.05 |Atualizada a instalação Linux e Windows |Cristian Mietlicki |
Sumário
1. Requisitos de instalação/utilização 5
1.1 Softwares necessários (fornecidos ) 5
1.2 Sistema Operacional 5
1.3 Hardware 5
1.4 Estações Cliente 5
2. Instalação Java e servidor web tomcat em ambiente windows 5
2.1 Arquivos utilizados na instalação 5
2.2 Instalando o JDK+JRE (JavaDevelopment Kit +Java Runtime Environment) 6
2.3 Configuração das variáveis de ambiente (classpath e path) 9
2.4 Instalando Apache Tomcat 7 17
Configuração de memória do Tomcat 28
3. Instalação JAVA E servidor web tomcat em ambiente linux 29
3.1 Arquivos utilizados na instalação 29
3.2 Instalando o JRE (Java Runtime Environment) 30
3.3 Instalando Apache Tomcat 7 31
Configuração de memória do Tomcat 39
4. configuração da aplicação servidor em ambiente windows 40
4.1 Arquivos para configuração 40
4.2 Libs do Tomcat 41
4.3 Extraindo e testando aplicação no servidor web Tomcat 43
4.4 Pare o servidor para realizar os próximos passos. 46
4.5 Configurando a geração de logs (log4j.properties) 46
4.6 Configurar o instituição.properties 47
4.7 Configurar o context.xml(DBCP) 48
4.8 Configuração Criptografia PUCPR 50
Abrir o Component Services 50
Criar um novo aplicativo vazio 50
Associar componente 52
4.9 Reiniciando o Tomcat 54
4.10 Testando a conexão com o banco de dados 55
4.11 Configuração da URL de servidor de consulta PHP 56
5. configuração da aplicação servidor em ambiente LINUX 56
5.1 Arquivos para configuração 56
5.2 Libs do Tomcat 56
5.3 Extraindo e testando aplicação no servidor web Tomcat 56
5.4 Pare o servidor para realizar os próximos passos. 61
5.5 Configurando a geração de logs (log4j.properties) 61
5.6 Configurar o instituição.properties 62
5.7 Configurar o context.xml(DBCP) 62
5.8 Configuração Criptografia PUCPR 65
5.9 Reiniciando o Tomcat 65
5.10 Testando a conexão com o banco de dados 65
5.11 Configuração da URL de servidor de consulta PHP 66
6. Configuração de visualização de imagens de usuários armazenadas em diretório/pasta 68
7. Configuração DOS VÍNCULOS armazenadas em diretório/pasta 68
8. Psi PROBE 69
9. Internet Explorer – desativar Modo de Compatibilidade (Máquinas clientes) 69
10. Liberação de porta 71
Requisitos de instalação/utilização
1 Softwares necessários (fornecidos )
Java JDK 7
Apache Tomcat 7
pergamumweb.war
libs do projeto (pasta lib fornecida na instalação)
2 Sistema Operacional
Linux: debian, redhat, fedora, ubuntu, centos (Porem deve-se verificar se a versão do SO escolhido dá suporte ao php 5.3.x, caso o servidor compartilhe a aplicação da consulta ao acervo PHP)
Não utilizar o FREEbsd, suse, slackware
Windows: (XP, Win7, Win8, WinSERVER,). Porem as versões desktop tem limite de conexões simultâneas.
3 Hardware
Mínimo: Processador Dual Core, memória RAM 6GB caso seja dedicado ao pergamumWEB
Recomendado: Quad Core ou superior, memória RAM8GB+
4 Estações Cliente
Configuração minima:
Pentium IV 3GHz com 2GB RAM ou equivalente.
Navegadores: Internet Explorer 10.0, Firefox 16.0, Google chrome 26.0.
No rodapé da página inicial do sistema pergamumweb encontram-se as versões homologadas.
[pic]
Instalação Java e servidor web tomcat em ambiente windows
1 Arquivos utilizados na instalação
Os arquivos utilizados são os mais atualizados encontrados na data de desenvolvimento deste manual. O recomendado é utilizar versões mais atualizadas quando possível.
Os arquivos estão em :
Para encontrar as aplicações mais recentes acesse o nosso FTP utilizando o link abaixo:
• JDK [versao][update][plataforma] ATENÇÃO.. Se a instituição utiliza a criptografia da PUC nas senhas, deve-se obrigatoriamente utilizar o JDK 32 bits.
• apache-tomcat-[versao]
2 Instalando o JDK+JRE (JavaDevelopment Kit +Java Runtime Environment)
Faça o download do arquivo JDK [versao][update][plataforma] .exe em qualquer diretório do servidor (sugestão - desktop). Após finalizar o download, acesse-o com um duplo clique.
A tela abaixo deverá aparecer. Aguarde enquanto o instalador processa o setup, para instalação.
Clicar em Próximo/Next/Avançar...
[pic]
O próximo passo é a instalação da JRE(Runtime Envoronment.). Basicamente o processo é avançar até o seu final visto que a instalação já sugere ser instalada na pasta Java De Arquivos de Programas.
[pic]
Assim que a instalação for concluída, clique em ‘Close’.
[pic]
Esta tela demonstra que o JDK foi instalado corretamente. Só nos resta clicar em Close.
3 Configuração das variáveis de ambiente (classpath e path)
Iremos configurar as variáveis de ambiente JAVA_HOME, JDK_HOME, CLASSPATH e PATH. Para isso, no Desktop entre com o atalho no teclado ”WINDOWS+Pause_Break” para abrir a janela a seguir e acessar as Configurações avançadas do sistema:
[pic]
A tela abaixo aparecerá. Navegar até a aba ‘Avançado’. Clicar no botão ‘Variáveis de Ambiente’
[pic]
O próximo passo será criar as variáveis na opção variáveis do sistema. A diferença de variáveis de sistema para as de usuário é a que as variáveis de usuário só tem efeito para o perfil do usuário .que as criou.
A primeira a ser definida é a variável de ambiente JAVA_HOME que deve possuir como valor o caminho de instalação do jdk.
Paria isso, em variáveis do sistema:
• clicar no botão Novo;
• definir o nome da variável como JAVA_HOME
definir seu valor com o caminho da pasta onde foi instalado o JDK
(neste exemplo, C:\Arquivos de Programas\Java\jdk1.7.0_79\ )
[pic]
[pic]
Criar a variável de ambiente JDK_HOME em variáveis do sistema
• Clicar em Nova;
• Definir o nome como JDK_HOME
• Definir o valor como %JAVA_HOME%\bin\
[pic]
Criar a variável de ambiente CLASSPATH: em variáveis do sistema:
• Clicar em Nova;
• Definir o nome como CLASSPATH;
• Definir o valor como .;%JAVA_HOME%\lib\tools.jar;
[pic]
Alterar a variável de ambiente PATH e adicionar o caminho %JDK_HOME%; ao começo do valor da variável
[pic]
O teste de sucesso pode ser feito abrindo uma janela de console e digitando Java ou java-version conforme abaixo...
[pic]
4 Instalando Apache Tomcat 7
Existem 2 tipos de distribuições do Tomcat, versões installer ou zipada. Abaixo é demostrado como realizar a instalação a partir da distribuição no formato .EXE, mas pode ser feita através da maneira ZIP, as vantagens da versão .exe são a de definição de login e senha de admin sem ter que abrir o tomcat-user.xml e a inserção do tomcat como serviço do Windows automaticamente. Ainda assim, é necessário abrir o Server.xml para adicionar o termo maxThreads=”400” no Connector da porta 8080 ou se for o caso, da porta 80.
Abaixo a sequencia de instalação utilizando o Tomcat 7 .EXE
Para a instalação do Tomcat 7, será necessário que o arquivo apache-tomcat-7.0.57.exe seja baixado e executado:
[pic]
Após a janela de setup abrir, deve-se clicar em Next:
[pic]
Na proxima janela, I Agree:
[pic]
Na janela abaixo definir o modo de instalação como Normal “Padrão” e clicar em Next:
[pic]
Na proxima janela, será definida a porta de acesso utilizada pelo sistema, o nome do serviço e o usuario e senha do “Manager” do tomcat.
• A porta padrão é a “8080”, caso já não esteja sendo utilizada por outra aplicação no servidor, esta pode ser alterada conforme a necessidade da instituição.
• O nome do serviço padrão é Tomcat7, mas pode ser alterado ficando a critério da instituição.
• O usuário e senha padrão são: syspergamum/perga+codigodaempresa, Exemplo: perga444, porem podem ser alterados ficando a critério da instituição.
[pic]
Na tela a seguir, deve-se direcionar o diretório onde será instalado o Tomcat 7 e clicar em Next:
[pic]
Após finalizar a instalaçao, desmarcar os os dois checkbox conforme a imagem abaixo e clicar em “Finish”:
[pic]
No diretório onde foi instalado o Tomcat 7, edite o arquivo server.xml que se encontra neste diretório conforme imagem abaixo:
[pic]
Certifique-se de que a porta do servidor (padrão 8080) seja única e não esteja sendo utilizada por outro servidor. O padrão é 8080, e pode ser confirmada na tag , conforme imagem abaixo:
[pic]
IMPORTANTE
Adicione a informação maxThreads = “400”:
[pic]
Outra verificação a ser realizada no mesmo arquivo é se a extração de arquivos WAR está automática, assim como o deploy das aplicações. Para isso, verifique na tag , conforme imagem abaixo. Os atributos unpackWARs e autoDeploy deverão estar com o valor “true”.
[pic]
Após a instalação correta do serviço do Tomcat 7, acesse Ferramentas Administrativas->Serviços e procure pelo serviço Apache Tomcat. O status desse serviço deverá estar como manual e o mesmo não deverá estar iniciado.
[pic]
Clique com o botão direito sobre o serviço Apache Tomcat->Propriedades. A tela abaixo deverá ser exibida. Altere o Tipo de inicialização para Automático e clique em Aplicar.
[pic]
Agora basta iniciar o serviço, clicando no botão Iniciar, na mesma tela das configurações do serviço.
[pic]
Com o serviço iniciado corretamente, o status, na tela de serviços, deverá ser alterado para Em Execução, com Tipo de Inicialização Automático.
[pic]
Para testar o correto funcionamento do Apache Tomcat, acesse no browser local a url: . A tela abaixo deverá aparecer, confirmando que o Tomcat está executando corretamente.
[pic]
Configuração de memória do Tomcat
Executar o arquivo tomcat7w.exe (%TOMCAT_HOME%\bin). Na aba JAVA adicionar os parâmetros conforme exibidos abaixo:
[pic]
-XX:PermSize=128m
-XX:MaxPermSize=256m
Alterar o tamanho de memória inicial e de memória máxima, na imagem acima o padrão utilizado é para Sistema Operacional 64bits.
OBS: Em servidores 32bits deve-se utilizar Inicial 512mb e Máximo 1024mb, devido a limitação de memória da versão do SO.
Instalação JAVA E servidor web tomcat em ambiente linux
Observações iniciais:
• As distribuições Linux homologadas para a instalação são: RedHat, Fedora, Centos, Mandriva e Ubuntu.
• Algumas telas estão exibindo versão do apache mais antiga (6.0.6), deve-se substituir para a versão que foi baixada. Neste momento de criação do documento, foi utilizada a 6.0.32.
• Os comandos exibidos nas telas abaixo são precedidos do comando sudo. Caso esteja utilizando usuário com permissão de administrador (root), este comando deverá ser omitido.
1 Arquivos utilizados na instalação
Endereço do FTP do Pergamum é:
Url: ftp.pucpr.br
Login: pergaftp
Senha: pergapucftp
Caminho: ftp.pucpr.br/atualizacao900/webjava/ e
ftp.pucpr.br/atualizacao812/Arquivos_Instalacao/
Para download através do browser.
Arquivos necessários:
• pergamumweb.war
• Pasta lib (libraries necessárias no tomcat para funcionar logger, ireport, conexão com bd, etc...)
• Jdk7
• Apache_tomcat7
Utilize para instalação ou atualização sempre a última versão do pergamumweb.war, disponível em nosso FTP, conforme a imagem abaixo.
[pic]
Link para download:
• JDK [versao][update][plataforma] utilizar jdk 7.
• ATENÇÃO.. Se a instituição utiliza a criptografia da PUC nas senhas, deve-se obrigatoriamente utilizar o JDK 32 bits.
Obs: As versões do JDK 32 bits trabalham com restrições até 2 GB de memória.
• apache-tomcat-[versao] utilizar tomcat7.
• Link para download do Java 32bits ou 64 bits homologados pelo Pergamum:
•
2 Instalando o JDK
Faça o download do arquivo jdk-7u80-linux-x64.tar.gz no diretório /usr/local/.
Execute o arquivo, através do comando conforme exibido na tela abaixo:
# sudo tar -zxvf jdk-7u80-linux-x64.tar.gz
# sudo chomd –Rf 755 jdk7_80(Realizar permissões na pasta descompactada)
Configuração Variáveis de ambiente
É necessário editar o arquivo /etc/profile informando o caminho do jdk, conforme o exemplo abaixo.
JAVA_HOME=/usr/local/jdk_80xxx (Localização do JDK instalado)
PATH=$JAVA_HOME/bin:$PATH export PATH JAVA_HOME
CLASSPATH=$JAVA_HOME/lib/tools.jar
CLASSPATH=.:$CLASSPATH
export PATH JAVA_HOME CLASSPATH
Após a extrair e apontar as variáveis de ambiente do Java, certifique-se de que o mesmo está funcionando corretamente, executando através do shell o comando java ou java-version.
Deverá ser exibida uma mensagem conforme tela abaixo:
[pic]
3 Instalando Apache Tomcat 7
Para a instalação do tomcat, será necessário que o arquivo apache-tomcat-7.0.64.tar.gz seja baixado. Insira-o no diretório usr/local/ do servidor. Feito isso, deverá ser executado o comando para extração do tomcat no diretório /home/ do servidor, da seguinte maneira:
# sudo tar –zxvf apache-tomcat-7.0.64.tar.gz
[pic]
Acesse o diretório /usr/local/ e certifique-se que o diretório do tomcat foi criado.
# cd /usr/local/
# ls -l
Atribua permissão de leitura e execução para os scripts .sh. Para isso, basta executar o comando abaixo:
# sudo chmod –Rf 755 apache-tomcat-7.0.57/
Acesse o diretório /usr/local/apache-tomcat-7.0.57/conf, para verificar as configurações do servidor. Certifique-se que os arquivos tomcat-users.xml e server.xml encontram-se nesse diretório. Edite o arquivo tomcat-users.xml, para adição de um novo usuário.
# sudo vi tomcat-users.xml
[pic]
Neste arquivo, apague todo o conteúdo do arquivo, exceto a primeira linha, que representa a tag de arquivo xml (). Após isso, adicione neste arquivo, um usuário, conforme tela abaixo. Segue tags para adição de novo usuário, seguida da imagem do arquivo em si, como deverá ficar após a inserção do usuário.
O usuário e senha devem ser definidos pela instituição onde será feita a instalação.
Após, edite o arquivo server.xml, no mesmo diretório, e certifique-se de que a porta do servidor (padrão 8080) seja única e não esteja sendo utilizada por outro servidor. O padrão é 8080, e pode ser confirmada na tag , conforme imagem abaixo:
[pic]
Adicione o maxThreads=”400”
[pic]
Outra verificação a ser realizada no mesmo arquivo é se a extração de arquivos WAR está automática, assim como o deploy das aplicações. Para isso, verifique na tag , conforme imagem abaixo. Os atributos unpackWARs e autoDeploy deverão estar com o valor “true”.
[pic]
Para criar o script de inicialização automática do tomcat7, deve-se acessar o diretório /etc/init.d/ e executar os comandos abaixo (conforme a tela):
# cd /etc/init.d/
# sudo touch tomcat7
# Tomcat auto-start
#
# Descricao: Inicializa Tomcat automaticamente
# Nome do processo: tomcat
# pidfile: /var/run/tomcat.pid
export JRE_HOME=/usr/local/jdk_80
export CATALINA_HOME="/usr/local/apache-tomcat-7.0.57"
case $1 in
start)
sh "$CATALINA_HOME"/bin/startup.sh
;;
stop)
sh "$CATALINA_HOME"/bin/shutdown.sh
;;
restart)
sh "$CATALINA_HOME"/bin/shutdown.sh
sh "$CATALINA_HOME"/bin/startup.sh
;;
*)
sh "$CATALINA_HOME"/bin/shutdown.sh
sh "$CATALINA_HOME"/bin/startup.sh
;;
esac
exit 0
[pic]
Criado o arquivo, deverá ser atribuída permissão de execução do mesmo, através do seguinte comando:
# sudo chmod 755 /etc/init.d/tomcat
[pic]
Deve-se criar 4 links simbólicos nos diretórios /etc/rc2.d/, /etc/rc3.d/, /etc/rc4.d/ e /etc/rc5.d/ utilizando-se dos seguintes comandos:
# sudo ln -s /etc/init.d/tomcat /etc/rc2.d/S99tomcat
# sudo ln -s /etc/init.d/tomcat /etc/rc3.d/S99tomcat
# sudo ln -s /etc/init.d/tomcat /etc/rc4.d/S99tomcat
# sudo ln -s /etc/init.d/tomcat /etc/rc5.d/S99tomcat
[pic]
Inicie o tomcat, executando o script previamente criado no diretório /etc/init.d.
# ./tomcat7 start
[pic]
Para testar o correto funcionamento do Apache Tomcat, acesse no browser local a url: . A tela abaixo deverá aparecer, confirmando que o Tomcat está executando corretamente.
[pic]
Configuração de memória do Tomcat
Em %TOMCAT_HOME%\bin , editar o arquivo catalina.sh
APÓS OS COMENTARIOS inserir a linha
JAVA_OPTS="-Xms512m –Xmx2048m -server -XX:PermSize=128m -XX:MaxPermSize=256m"
Obs: Para realizar essa configuração deverá ser analisada a memória disponível no servidor, se
estiver alocada uma quantidade de memória maior do que disponível o container tomcat não será iniciado.
Qualquer problema verifique os logs que está no caminho: /usr/local/tomcat7/logs/
configuração da aplicação servidor em ambiente windows
1 Arquivos para configuração
Endereço do FTP do Pergamum para download é:
Url: ftp.pucpr.br
Login: pergaftp
Senha: pergapucftp
Caminho: ftp.pucpr.br/atualizacao900/webjava/ e
ftp.pucpr.br/atualizacao812/Arquivos_Instalacao/
Para download através do browser.
Arquivos necessários:
• pergamumweb.war
• Pasta lib.zip (libraries necessárias no tomcat para funcionar logger, ireport, conexão com bd, etc...)
• Jdk7
• Apache_tomcat7
Utilize para instalação ou atualização sempre a última versão do pergamumweb.war disponível em nosso FTP, conforme exemplo da imagem abaixo.
[pic]
Link para download:
2 Libs do Tomcat
Copiar a pasta pergamumweb da pasta lib () para a pasta de instalação do Tomcat 7:
[pic]
Alterar o parâmetro “common.loader” do arquivo catalina.properties na pasta conf (%TOMCAT_HOME%\conf\catalina.properties), adicionando o conteúdo abaixo no final da linha:
,${catalina.home}/lib/pergamumWeb/*.jar
[pic]
[pic]
3 Extraindo e testando aplicação no servidor web Tomcat 7
Antes de iniciar o procedimento de extração da aplicação, certifique-se de que o servidor web Tomcat está inicializado. Para isso, basta acesso o endereço no browser do servidor. A tela abaixo deverá ser carregada, garantindo que o servidor está inicializado.
[pic]
MODO 1 Com o servidor funcionando corretamente, deve-se copiar o aplicativo pergamumweb.war para o diretório de instalação do tomcat \\webapps.
MODO 2 efetuar o login no Tomcat Manager. Bem embaixo tem o formulário War File to Deploy, selecionar o pergamumweb.war e clicar no botão deploy e aguardar o processamento. A vantagem deste modo é que você irá saber quando a aplicação estiver disponível pelo tomcat manager e que este processo também pode ser feito remotamente, sem a necessidade de conexão via TS.
Logo após a execução do MODO 1 ou do MODO 2 , o próprio servidor web Tomcat se encarregará de extrair o arquivo .war, criando um diretório com o mesmo nome do arquivo, conforme imagem abaixo.
[pic]
Para verificar se a aplicação está pronta para execução, deve-se acessar o Gerenciador de aplicações do Tomcat (Tomcat Manager), na página inicial do servidor. Após solicitar o login e senha, entre com os dados cadastrados, durante o processo de configuração do servidor web, no arquivo C:\Arquivos de programas\tomcat 7.0\conf\tomcat-users.xml.
[pic]
[pic]
Efetuado o login, verifique se a aplicação pergamumweb está com status true. Caso contrário, entre em contato com o suporte do Pergamum, através do sistema de atendimento em
[pic]
4 Agora pare o serviço do Tomcat 7 para realizar os próximos passos.
Para os próximos procedimentos, o servidor tomcat deve estar parado.
5 Configurando a geração de logs (log4j.properties)
Acesse o diretório de instalação do tomcat webapps\pergamumweb\
WEB-INF\classes\br\pucpr\pergamum\log e edite o arquivo log4j.properties.
[pic]
Altere o valor do parâmetro para o diretório da aplicação pergamumweb (%pastadoTomcat%/logs/pergamumWebApp.txt), conforme exemplo abaixo:
[pic]
Em seguida, salve o arquivo com as alterações.
6 Configurar o instituição.properties
Abaixo segue a localização do arquivo de properties
%pastaInstalacaoTomcat%\webapps\pergamumweb \WEB-INF\classes\br\pucpr\pergamum\propriedades\instituicao.properties
• Modificar se for o caso a propriedade BANCO que define qual o banco de dados esta sendo utilizado para a implementação da DAOFactory;
•
Verique abaixo o uso da propriedade..
[pic]
7 Configurar o context.xml(DBCP)
O context .xml é o arquivo que possui informações de configuração da conexão de banco de dados e de propriedades do DBCP.
Esta localizado em %pastaInstalacaoTomcat%\webapps\pergamumweb\META-INF\context.xml
Os parâmetros a serem alterados estão destacados abaixo:
[pic]
IMPORTANTE
No processo de deploy, o tomcat copia o arquivo context.xml para %pastaInstalacaoTomcat% \conf\catalina\localhost\pergamumweb.xml. Ele deve ser atualizado para ficar idêntico ao context.xml. A dica é sobrescrever este conteúdo com o conteúdo do context.xml já configurado.
Exemplos de Driver class names para diferentes tipos de banco:
• SQlSERVER
com.microsoft.sqlserver.jdbc.SQLServerDriver
• ORACLE
oracle.jdbc.driver.OracleDriver
• POSTGreSQL
org.postgresql.Driver
• SyBase
com.sybase.jdbc3.jdbc.SybDriver
Exemplos de Url:
• SQlSERVER
jdbc:sqlserver://
• ORACLE service name
jdbc:oracle:thin://@
• ORACLE SID
jdbc:oracle:thin:@
• POSTGreSQL
jdbc:postgresql://
• SyBase
jdbc:sybase:Tds:
IMPORTANTE:
O usuário PERGAMUM_WEB_INT deve existir no banco de dados, com as seguintes informações:
- ROLE = CATALOGACAO_GERAL
- SENHA = mxabf1
Caso seja interesse utilizar outra senha, não existe nenhuma restrição a nível de aplicação, somente a nível de configuração. Portanto, se utilizar outra senha, alterar a propriedade password supra citada.
ATENÇÃO!
Por default o campo URL seta a opção DatabaseName como PERGAMARC(database de Produção do Pergamum) então não é necessária a sua descrição, no entanto, caso a instituição tenha mais de um Database(por exemplo PERGATESTE), passa a ser obrigatória a sua adição para que não haja conflito de base.
Exemplo:
url="jdbc:sqlserver://0.0.0.0\\banco01:3652; DatabaseName=PERGAMARC"
ou
url="jdbc:sqlserver://0.0.0.0\\banco01:3652; DatabaseName=PERGATESTE"
* Lembrando que toda vez que se altera o arquivo context.xml o Tomcat deve ser reiniciado para que as alterações façam efeito.
•
Configuração adicional somente para o banco de dados SQLServer:
- Políticas de segurança desabilitadas
- Idioma = ENGLISH
8 Configuração Criptografia PUCPR
Copie as dll’s de %pastaInstalacaoTomcat%\webapps\pergamumweb\WEB-INF\lib
• jacob-1.16-M1-x86.dll
• PucUserControl.dll
para a Pasta WINDOWS\System32 (32 bits) ou para Windows\sysWOW64 (64 bits)
Abrir o Component Services
Em Ferramentas Administrativas -> Serviços de Componentes.
Criar um novo aplicativo vazio
Em Serviços de Componentes -> Computadores -> Meu Computador -> Aplicativos COM+, clicar com o botão direito do mouse e selecionar a opção Nova -> Aplicação como abaixo:
[pic]
Na próxima tela clique em Avançar e escolha o botão “Criar um aplicativo vazio” como abaixo:
[pic]
Na próxima tela digite o nome PucUserControl e em Tipo de Ativação escolha a opção “Aplicativo de Biblioteca” como abaixo:
[pic]
Associar componente
- Agora precisamos associar o arquivo PucUserControl.DLL com o novo Aplicativo PucUserControl -> Componentes como abaixo:
[pic]
Na próxima tela clique em Avançar e escolha “Instalar novo componente” como abaixo:
[pic]
Na tela a seguir clique no botão Adicionar e selecione a DLL PucUserControl que está em WINDOWS\SYSTEM32\
Após entre nas propriedades do PucUserControl e desmarque a opção Autorização na pasta Segurança como abaixo:
[pic]
[pic]
Clique em ok e a configuração da DLL estará pronta.
9 Reiniciando o Tomcat
Para reiniciar o Tomcat, deve-se acessar o ícone de Serviços em Ferramentas Administrativas. Procure pelo serviço Apache Tomcat7 e em propriedades, Pare e Inicie o serviço.
[pic]
[pic]
10 Testando a conexão com o banco de dados
Para testar a conexão com o banco de dados e com isso, verificar se a configuração do arquivo context.xml está correta, deve-se acessar o endereço
através do browser. Caso as configurações estejam corretas, a mensagem abaixo deverá ser impressa na tela:
[pic]
Caso contrário, a conexão não será realizada. Nesse caso, as configurações do arquivo context.xml deverão ser revistas.
11 Configuração da URL de servidor de consulta PHP
Já logado no sistema, Navegue no menu em Parametros, Instituição, Geral. Inserir a URL do servidor de consulta PHP localizado em Parametros do sistema e gravar as alterações.
[pic]
configuração da aplicação servidor em ambiente LINUX
1 Arquivos para configuração
Os arquivos estão em
• Pasta lib (libraries necessárias no tomcat para funcionar logger, ireport, conexão com bd, etc...)
• pergamumweb.war
2 Libs do Tomcat
Copiar a pasta pergamumweb da pasta lib () para a pasta de instalação do tomcat: tomcatxxx\lib\
Alterar o parametro common.loader do arquivo catalina.properties da pasta conf (%TOMCAT_HOME%\conf\catalina.properties)
common.loader=${catalina.base}/lib,${catalina.base}/lib/*.jar,${catalina.home}/lib,${catalina.home}/lib/*.jar,${catalina.home}/lib/pergamumWeb/*.jar
3 Extraindo e testando aplicação no servidor web Tomcat
Antes de iniciar o procedimento de extração da aplicação, certifique-se de que o servidor web Tomcat está inicializado. Para isso, basta acesso o endereço no browser do servidor. A tela abaixo deverá ser carregada, garantindo que o servidor está inicializado.
[pic]
MODO 1 Com o servidor funcionando corretamente, deve-se copiar o aplicativo pergamumweb.war para o diretório de instalação do tomcat \\webapps.
# sudo cp /diretório/origem/pergamumweb.war /home/apache-tomcat-6.0.32/webapps/
MODO 2 efetuar o login no Tomcat Manager. Bem embaixo tem o formulário War File to Deploy, selecionar o pergamumweb.war e clicar no botão deploy e aguardar o processamento. A vantagem deste modo é que você irá saber quando a aplicação estiver disponível pelo tomcat manager e que este processo também pode ser feito remotamente, sem a necessidade de conexão via TS.
Logo após a execução do MODO 1 ou do MODO 2 , o próprio servidor web Tomcat se encarregará de extrair o arquivo .war, criando um diretório com o mesmo nome do arquivo, conforme imagem abaixo.
[pic]
Para verificar se a aplicação está pronta para execução, deve-se acessar o Gerenciador de aplicações do Tomcat (Tomcat Manager), na página inicial do servidor. Após solicitar o login e senha, entre com os dados cadastrados, durante o processo de configuração do servidor web, no arquivo C:\Arquivos de programas\tomcat 7.0\conf\tomcat-users.xml.
[pic]
[pic]
Efetuado o login, verifique se a aplicação pergamumweb está com status true. Caso contrário, entre em contato com o suporte do Pergamum, através do sistema de atendimento em
[pic]
4 Pare o servidor para realizar os próximos passos.
Para os próximos procedimentos, o servidor tomcat deve estar parado.
5 Configurando a geração de logs (log4j.properties)
Acesse o diretório de instalação do tomcat webapps\pergamumweb\
WEB-INF\classes\br\pucpr\pergamum\log e edite o arquivo log4j.properties.
[pic]
Altere o valor do parâmetro para o diretório da aplicação pergamumweb (\\%pastadoTomcat%/logs/pergamumWebApp.txt), conforme exemplo abaixo:
[pic]
Em seguida, salve o arquivo com as alterações.
6 Configurar o instituição.properties
Abaixo segue a localização do arquivo de properties
/home/%pastaInstalacaoTomcat%\webapps\pergamumweb \WEB-INF\classes\br\pucpr\pergamum\propriedades\instituicao.properties
• Modificar se for o caso a propriedade BANCO que define qual o banco de dados esta sendo utilizado para a implementação da DAOFactory;
Verique abaixo o uso da propriedade..
[pic]
7 Configurar o context.xml(DBCP)
O context .xml é o arquivo que possui informações de configuração da conexão de banco de dados e de propriedades do DBCP.
Esta localizado em /home/%pastaInstalacaoTomcat%\webapps\pergamumweb\META-INF\context.xml
Os parâmetros a serem alterados estão destacados abaixo:
[pic]
IMPORTANTE:
O usuário PERGAMUM_WEB_INT deve existir no banco de dados, com as seguintes informações:
- ROLE = CATALOGACAO_GERAL
- SENHA = mxabf1
Configuração adicional somente no SQLServer:
- Politicas de segurança desabilitadas
- Idioma = ENGLISH
Exemplos de Driver class names para diferentes tipos de banco:
• SQlSERVER
com.microsoft.sqlserver.jdbc.SQLServerDriver
• ORACLE
oracle.jdbc.driver.OracleDriver
• POSTGreSQL
org.postgresql.Driver
• SyBase
com.sybase.jdbc3.jdbc.SybDriver
Exemplos de Url:
• SQlSERVER
jdbc:sqlserver://
• ORACLE service name
jdbc:oracle:thin://@
• ORACLE SID
jdbc:oracle:thin:@
• POSTGreSQL
jdbc:postgresql://
• SyBase
jdbc:sybase:Tds:
ATENÇÃO!
Por default o campo URL seta a opção DatabaseName como PERGAMARC(database de Produção do Pergamum) então não é necessária a sua descrição, no entanto, caso a instituição tenha mais de um Database(por exemplo PERGATESTE), passa a ser obrigatória a sua adição para que não haja conflito de base.
Exemplo:
url="jdbc:sqlserver://0.0.0.0\\banco01:3652; DatabaseName=PERGAMARC"
ou
url="jdbc:sqlserver://0.0.0.0\\banco01:3652; DatabaseName=PERGATESTE"
* Lembrando que toda vez que se altera o arquivo context.xml o Tomcat deve ser reiniciado para que as alterações façam efeito.
IMPORTANTE
No processo de deploy, o tomcat copia o arquivo context.xml para %pastaInstalacaoTomcat% \conf\catalina\localhost\pergamumweb.xml. Ele deve ser atualizado para ficar idêntico ao context.xml. A dica é sobrescrever este conteúdo com o conteúdo do context.xml já configurado.
8 Configuração Criptografia PUCPR
No Linux, é utilizado um executável para a criptografia, o criptAnt.exe, já incluso no deploy da app. O comando abaixo deve ser executado no console do Linux, na pasta lib da aplicação
/home/apache-tomcat-6.0.32/webapps/pergamumweb/WEB-INF/lib# chmod 755 criptAnt.exe
9 Reiniciando o Tomcat
Para reiniciar o Tomcat, deve-se acessar o diretório /etc/init.d/ e executar o script tomcat, conforme comando abaixo:
# ./tomcat restart
[pic]
10 Testando a conexão com o banco de dados
Para testar a conexão com o banco de dados e com isso, verificar se a configuração do arquivo context.xml está correta, deve-se acessar o endereço
através do browser. Caso as configurações estejam corretas, a mensagem abaixo deverá ser impressa na tela:
[pic]
Caso contrário, a conexão não será realizada. Nesse caso, as configurações do arquivo context.xml deverão ser revistas.
11 Configuração da URL de servidor de consulta PHP
Já logado no sistema, Navegue no menu em Parametros, Instituição, Geral. Inserir a URL do servidor de consulta PHP localizado em Parametros do sistema e gravar as alterações.
[pic]
Configuração de visualização de imagens de usuários armazenadas em diretório/pasta
Para a visualização da imagem do usuário no empréstimo do Pergamum Web, é necessário especificar a localização das imagens (diretório de armazenamento local ou em unidade de rede mapeada).
Para isso deve-se criar o arquivo com o nome pergamumweb#imagens.xml em %TOMCAT_HOME%\conf\Catalina\localhost com o conteúdo abaixo:
Por exemplo:
Ou
IMPORTANTE:
• NÃO CRIAR A PASTA DENTRO DO TOMCAT/WEBAPPS/PERGAMUMWEB pois caso ocorra atualização do aplicativo (undeploy/deploy) a pasta e subpastas com todos os vínculos será excluída.
• Note que caso se utilize a barra invertida, ela deverá ser dupla e e se for a barra normal somente 1.
• Note que não foi atribuída barra no final do caminho.
• No tomcat manager, após a criação do pergamumweb#imagens.xml aparecerá uma nova aplicação “pergamumweb/imagens” NÃO EFETUAR O UNDEPLOY DO PERGAMUMWEB/IMAGENS. ISTO RESULTARÁ NO DELETE DE TODAS SUAS IMAGENS.
• O nome do arquivo da imagem salvo no banco de dados será concatenado ao caminho URL criado pelo XML.
Este XML estará disponível para download em podendo ser baixado e editado.
Configuração DOS VÍNCULOS armazenadas em diretório/pasta
Para gravar vínculos relacionados a acervo, é necessário especificar a localização da pasta (diretório de armazenamento local ou em unidade de rede mapeada).
Para isso deve-se criar o arquivo com o nome pergamumweb#vinculos.xml em %TOMCAT_HOME%\conf\Catalina\localhost com o conteúdo abaixo:
Por exemplo:
Ou
A barra invertida sempre deve ser dupla, caso utilize a barra normal informe apenas uma barra.
Essa informação do caminho bem como a forma de acesso a essa pasta via URL deve ser informado no banco de dados, tendo em vista que o usuário terá acesso URL aos arquivos posteriormente disponibilizados nessa pasta, e assim, a aplicação deverá ter uma forma de acesso a mesma. Para isso, deve ser executado o comando abaixo dentro do banco de dados do Pergamum:
update instituicao set host_vinculos = 'X', acesso_vinculos = 'Y'
Trocando o X pelo caminho físico conforme configuração do docbase anterior (Z:\\vinculos ou Z:/vinculos) e trocando o Y pelo acesso URL a pasta dos vínculos (http://[ip ou dns]/pergamumweb/vínculos).
Executada a operação acima, deve-se via aplicação do Pergamum verificar o sucesso na operação do banco de dados, e para isso deve-se acessar o seguinte caminho via Pergamum Web:
No módulo de parâmetros, instituição, catalogação, verificar as 2 propriedades:
- Unidade compartilhada (Caminho físico conforme configuração do docbase acima)
- Acesso URL (http://[ip ou dns]/pergamumweb/vinculos)
Caso os valores não estejam de acordo com a parametrização criada via arquivo XML, deve-se repetir o procedimento de update no banco de dados ou ainda contatar o suporte do Pergamum.
IMPORTANTE:
• NÃO CRIAR A PASTA DENTRO DO TOMCAT/WEBAPPS/PERGAMUMWEB pois caso ocorra atualização do aplicativo (undeploy/deploy) a pasta e subpastas com todos os vínculos será excluída.
• Note que caso se utilize a barra invertida, ela deverá ser dupla e se for a barra normal, utilize somente uma barra.
• Note que não foi atribuída barra no final do caminho.
• No tomcat manager, após a criação do pergamumweb#imagens.xml aparecerá uma nova aplicação “pergamumweb/vinculos” NÃO EFETUAR O UNDEPLOY DO PERGAMUMWEB/VINCULOS. ISTO RESULTARÁ NO DELETE DE TODOS SEUS VÍNCULOS.
• O nome do arquivo da imagem salvo no banco de dados será concatenado ao caminho URL criado pelo XML.
Este XML estará disponível para download em podendo ser baixado e editado.
Psi PROBE
O psi Probe é a ferramenta que permite agilidade no suporte Pergamum, permitindo visualizar logs, utilização de memória, data-sources, deploy da aplicação entre outras características .
Sua instalação é simples...
Com o tomcat startado, copiar o probe.war para a %TOMCAT_HOME%\webapps\
O deploy é feito automaticamente.
O Probe estará disponível para download em:
Internet Explorer – desativar Modo de Compatibilidade (Máquinas clientes)
Para a exibição correta de telas e componentes do pergamumweb nas máquinas clientes: no Internet Explorer, é necessário desabilitar a função Modo de Compatibilidade. Os outros browsers não é necessária nenhuma configuração adicional.
No menu Ferramentas, garantir que a opção modo de exibição de compatibilidade esteja desmarcado (sem o “v” precedente) conforme abaixo
[pic]
No menu ferramentas, clicar em Configurações do Modo de Exibição de compatibilidade, a tela abaixo será exibida:
[pic]
Remover da lista “Sites que você adicionou ao Modo de Exibição” o site do pergamum web (caso esteja na lista).
Desmarcar as 2 últimas opções (Exibir sites da intranet no modo de exibição de compatibilidade e Exibir todos os sites em modo de exibição de compatibilidade)
Clicar em Fechar.
Liberação de porta
Após realizada a configuração, deverá ser feita a liberação de acesso via http para a porta 8080 (Ou outra porta a ser utilizada, caso essa já esteja em uso). O acesso deverá ser restrito aos seguintes IP's:
200.192.112.6
200.192.112.21
200.192.113.19
200.192.115.2
Após realizar a liberação, deve-se cadastrar a URL na página abaixo, na Rede Pergamum, no campo URL:
[pic][pic]
................
................
In order to avoid copyright disputes, this page is only a partial summary.
To fulfill the demand for quickly locating and searching documents.
It is intelligent file search solution for home and business.