INSTITUTO BRASILEIRO DE INFORMAÇÃO EM CIÊNCIA E TECNOLOGIA Manual de Instalação Tecer [Windows] 2 ÍNDICE DE FIGURAS Figura 1 Aquivo Postgresql ................................................................................................9 Figura 2 Arquivo de Instalação ......................................................................................... 10 Figura 3 Executar instalação do Postgresql ....................................................................... 10 Figura 4 Instalação do Postgresql [Segundo Passo] ............................................................ 11 Figura 5 Instalção do Postgresql [Terceiro Passo] .............................................................. 11 Figura 6 Intalação do Postgresql [Quarto Passo] ............................................................... 12 Figura 7 Instalação do Postgresql [Quinto Passo] .............................................................. 12 Figura 8 Instalação do Postgresql [Sexto Passo] ................................................................ 13 Figura 9 Instalação do Postgresql [Sétimo Passo] .............................................................. 13 Figura 10 instalação do Postgresql [Oitavo Passo] ............................................................. 14 Figura 11 Instalação do Postgresql [Nono Passo]............................................................... 14 Figura 12 Instalação do Postgresql [Décimo Passo] ........................................................... 15 Figura 13 Instalação do Postgresql [Décimo Primeiro Passo] .............................................. 15 Figura 14 Instalação do Postgresql [Décimo Segundo Passo] .............................................. 16 Figura 15 Instalação do Postgresql [Décimo Terceiro Passo] .............................................. 16 Figura 16 Instalação do Postgresql [Décimo Quarto Passo] ................................................ 17 Figura 17 Ativando Serviço Logon Secundário ................................................................... 18 Figura 18 Ativando Serviço Logon Secundário ................................................................... 19 Figura 19 Propriedade de Logon Secundário ..................................................................... 20 Figura 20 Acessando o PgAdminIII.................................................................................... 21 Figura 21 Criando Conexão com a Base de dados .............................................................. 21 Figura 22 Preenchendo os dados para conexão................................................................. 22 Figura 23 Alterando o Arquivo ......................................................................................... 23 Figura 24 Conectando ao Servidor.................................................................................... 23 Figura 25 Criar nova base de dados .................................................................................. 24 Figura 26 Preencher os dados para criar a base de dados .................................................. 25 Figura 27 Preencher os dados para criar a base de dados .................................................. 26 Figura 28 Abrindo o Executar ........................................................................................... 27 Figura 29 Criar a Pasta Tecer............................................................................................ 27 Figura 30 Link para Download JDK.................................................................................... 28 Figura 31 Selecione JDK e aceitar licença .......................................................................... 29 Figura 32 Iniciando a Instalação ....................................................................................... 29 Figura 33 Aceitando os termos da licença ......................................................................... 30 Figura 34 Customizando o Setup ...................................................................................... 30 Figura 35 Prosseguindo com a Instalação ......................................................................... 31 Figura 36 Instalando o JDK ............................................................................................... 31 Figura 37 Finalizando a Instalação .................................................................................... 32 Figura 38 Acessando as propriedades............................................................................... 33 Figura 39 Abrindo as Variáveis de Ambiente ..................................................................... 33 Figura 40 Alterando as Variáveis de Ambiente .................................................................. 34 Figura 41 Testando a Instalação ....................................................................................... 35 3 Figura 42 Abrindo o Executar ........................................................................................... 36 Figura 43 Configuração do Arquivo Components............................................................... 37 Figura 44 Configuração do Arquivo Components............................................................... 37 Figura 45 Iniciando Jboss ................................................................................................. 37 Figura 46 Jboss iniciado ................................................................................................... 38 4 SUMÁRIO 1. INTRODUÇÃO ............................................................................................................. 5 2. SOBRE O TECER ......................................................................................................... 6 3. SOFTWARES BÁSICOS PARA INSTALAÇÃO DO TECER ......................................... 8 4. INSTALAÇÃO DO PostgreSQL ..................................................................................... 9 5. Ativando o serviço Logon Secundário ........................................................................... 18 6. CRIANDO A BASE DE DADOS ................................................................................. 21 7. Criando uma pasta tecer ................................................................................................ 27 8. INSTALANDO O JDK ................................................................................................ 28 8.2. Testando a instalação ................................................................................................. 35 9. INSTALANDO O JBOSS APPLICATION SERVER..................................................... 36 10. REQUISITOS DE HARDWARE ................................................................................ 39 11.1. Cuidados com a segurança ....................................................................................... 40 11.2. Cópias de segurança ................................................................................................ 40 5 1. INTRODUÇÃO O objetivo deste manual é orientar os responsáveis pela instalação e manutenção do ambiente computacional necessário para a implantação do sistema de Tecer. O IBICT distribui o programa: Tecer; Este manual orienta a instalação e adequação necessárias do software bem como do Tecer. Conforme descrito no documento de visão, o TECER foi desenvolvido e testado para o sistema operacional Windows. . 6 2. SOBRE O TECER O TECER é um sistema de gerenciamento de tesauros que consiste em um conjunto de módulos integrados, atendendo a critérios de consistência e segurança. Um sistema de gerenciamento de tesauros possui as seguintes funções básicas: gerência facilitada da entrada de dados (termos), atualização e consulta aos dados do tesauro; Garantir a consistência dos dados por meio de rotinas de verificação, controle e manutenção; Permitir a consulta e utilização do tesauro no momento da indexação e da pesquisa a uma base de dados e, por fim, gerar saídas em tela ou impressas com vistas à editoração de acordo com as normas de apresentação de tesauros. O software tem suporte a mono e multiusuários onde está previsto o trabalho simultâneo de usuários numa rede local ou pela internet, com controle de senhas. O sistema na atual versão é composto pelo seguintes módulos principais: Coordenador Equipe Usuário 7 Sua instalação necessita de sistema operacional baseado na plataforma UNIX/LINUX: Plataforma Unix Linux < http://www.linux.org > Ubuntu < http://www.ubuntubr.org> BSD < http://www.openbsd.org > FeeBSD < www.freebsd.org > AIX < http://www.ibm.com> HPUX < http://www.hp.com> Solaris <http://www.sun.com> Também é possível instalá-lo em um sistema operacional baseado na plataforma Windows: Plataforma Windows Windows <http://www.microsoft.com/brasil> Windows 7 <http://www.microsoft.com/brasil/windows7> XP <http://www.microsoft.com/windows/windows-xp> Vista <http://www.microsoft.com/brasil/windows/windows-vista/> O TECER funciona nos seguintes navegadores: Internet Explorer 7.x; Internet Explorer 8.x; Mozilla 1.4+, Firefox. 8 3. SOFTWARES BÁSICOS PARA INSTALAÇÃO DO TECER A seguir é apresentada uma descrição dos softwares básicos necessários para a implantação do TECER, que podem ser baixados no link: ( http://www.ibict.br/pesquisa- desenvolvimento-tecnologico-e-inovacao/software-para-gerenciamento-detesaurostecer). JDK 1.6: Java Development Kit (JDK) significa Kit de Desenvolvimento Java, e é um conjunto de utilitários que permitem criar sistemas de software para a plataforma Java. É composto por compilador e bibliotecas. JBoss AS 5.0.1: É um servidor de aplicação de código fonte aberto baseado na plataforma J2EE implementada completamente na linguagem de programação Java. Como é baseada em Java, JBoss pode ser usado em qualquer Sistema Operacional que suporte Java. PostgreSQL 8.3.7: É um sistema gerenciador de banco de dados objeto relacional (SGBDOR), desenvolvido como projeto de código aberto e um dos mais avançados. 9 4. INSTALAÇÃO DO PostgreSQL O PostgreSQL é um SGBD (Sistema de Gerenciamento de Banco de Dados), utilizado para armazenar as informações do projeto. Seu uso é gratuito e seu código aberto, no Windows ele pode ser acessado através da ferramenta gráfica PGAdmin que é instalada junto ao PostgreSQL. Faça o download do software em: http://www.postgresql.org/ftp/binary/v8.3.17, ou no link do site do Ibict: (http://www.ibict.br/pesquisa-desenvolvimento-tecnologico-e- inovacao/software-para-gerenciamento-de-tesauros-tecer/download). Depois de ter feito o download, descompacte o arquivo para uma pasta que desejar. Figura 1 Aquivo Postgresql 10 Acesse a pasta e execute o arquivo postgresql-8.3.msi para a instalação. Figura 2 Arquivo de Instalação Clique em executar para começar a instalação Figura 3 Executar instalação do Postgresql 11 Ao executar o arquivo postgresql-8.3.msi será exibida a tela para escolha da linguagem a ser utilizada no programa de instalação. Figura 4 Instalação do Postgresql [Segundo Passo] Nesta tela de aviso, clique em Próximo. Figura 5 Instalção do Postgresql [Terceiro Passo] Em outra tela com algumas informações, clique em Próximo. 12 Figura 6 Intalação do Postgresql [Quarto Passo] Nesta tela informativa, sobre PL/Java e clique em Próximo. Figura 7 Instalação do Postgresql [Quinto Passo] 13 Na tela de configuração do serviço, o usuário/instalador pode deixar a senha em branco se desejar que o instalador gere uma senha para ser lembrada(não recomendado). Ou se preferir, poderá digitar uma senha com a palavra definida, “season” como senha (recomendado). Após esse passo, clique em próximo. O domínio deve ser o nome do usuário da máquina. Figura 8 Instalação do Postgresql [Sexto Passo] Aparecerá então uma janela perguntando se você deseja criar essa conta, marque a opção Sim. Figura 9 Instalação do Postgresql [Sétimo Passo] 14 Marque a opção: “Inicializar o agrupamento de bancos de dados”, selecione o Encoding (Server e Client) como UTF-8 nas duas caixas. Marque a opção: “Aceitar conexões em todos os endereços, e não apenas localhost” Escolha um Superusuário, neste caso usamos a palavra, season. Escolha uma senha, neste caso usamos a palavra, season. Para as demais informações, como Porta e Local, mantenha a configuração já definida. Figura 10 instalação do Postgresql [Oitavo Passo] Irá aparecer a seguinte mensagem clique na opção ok Figura 11 Instalação do Postgresql [Nono Passo] 15 Na próxima tela, desmarque a opção PL/plpgsql. Figura 12 Instalação do Postgresql [Décimo Passo] Na tela abaixo são apresentadas as extensões chamadas contribs, clique em Próximo. Figura 13 Instalação do Postgresql [Décimo Primeiro Passo] 16 Terminada a configuração será exibida a tela informando que o PostgreSQL está pronto para ser instalado. Clique Próximo e será exibida a tela de andamento da instalação. Figura 14 Instalação do Postgresql [Décimo Segundo Passo] Figura 15 Instalação do Postgresql [Décimo Terceiro Passo] 17 Para concluir a instalação, desmarque a opção “Launch Stack Builder at exit” e clique em Concluir. Figura 16 Instalação do Postgresql [Décimo Quarto Passo] 18 5. Ativando o serviço Logon Secundário O logon secundário e o serviço no Windows 7 que ativa o serviço de banco de dados. Para ativar esse o logon secundário vá ao menu iniciar->barra de pesquisa-> digite serv-> clique em Serviços. Figura 17 Ativando Serviço Logon Secundário 19 Abrirá a tela de serviços do Windows: Clique com o botão direito em Logon secundário> propriedades->Tipo de inicialização-> escolha automático. Figura 18 Ativando Serviço Logon Secundário 20 Figura 19 Propriedade de Logon Secundário 21 6. CRIANDO A BASE DE DADOS Para acessar o PostgreSQL vá ao menu Iniciar -> Programas -> PgAdmin III Figura 20 Acessando o PgAdminIII Adicione uma nova conexão em Arquivo -> Adicionar ao servidor ou clique no ícone parecido com uma tomada. Figura 21 Criando Conexão com a Base de dados 22 Então aparecerá uma janela, preencha-a com as seguintes informações, após preencher as informações o botão ok permanecerá desabilitado, deverá apena clicar no x e fechar a janela: Nome: localhost Porta: 5432 Manutenção do BD: season Nome de usuário: season Figura 22 Preenchendo os dados para conexão Se a aplicação estiver em outro servidor, então deverá ser alterado na aplicação o IP do servidor de banco de dados. Para alterar o IP, usuário e senha abra o arquivo Tecer-ds.xml que está no endereço jboss5.0.1.GA\server\default\deploy . Para abrir esse endereço abra o executar através do Menu Iniciar > Executar 23 Altere as informações das tags user-name, password e connection-url para as informações do seu banco de dados como na imagem a seguir. Figura 23 Alterando o Arquivo Depois de criado a conexão dê duplo clique em cima da conexão criada e um x que está acima do nome irá desaparecer, assim que você preencher a senha (season) Figura 24 Conectando ao Servidor 24 Abra a hierarquia do servidor (clicando em +) e selecione Banco de Dados Escolha o menu Editar -> Novo Objeto -> Novo Banco de Dados ou clique com o direito em cima de Banco de Dados, como na imagem a seguir. Figura 25 Criar nova base de dados 25 Preencha os campos da nova tela com valores (o nome da base de dados deve ser escrito em minúsculo): Nome: tecer Dono: season As demais informações mantenha como está e clique em OK Figura 26 Preencher os dados para criar a base de dados 26 Criando o banco de dados dê clique simples e em seguida clique no ícone (no menu principal) para abrir a janela de comandos sql. Com a janela aberta, selecione o menu Arquivo -> Abrir, localize o arquivo bd.sql na pasta do projeto e abra-o. Figura 27 Preencher os dados para criar a base de dados Com o arquivo aberto, clique no ícone para executá-lo. 27 7. Criando uma pasta tecer Abra o executar clicando no Menu Iniciar > Executar ou através das teclas Windows + R Figura 28 Abrindo o Executar Digite o seguinte conteúdo C:\Documents and Settings\All Users se for no windows XP, e C:\Users\ no Windows 7. Crie uma pasta chamada tecer no diretório que será aberto pelo executar, como na imagem: Figura 29 Criar a Pasta Tecer 28 8. INSTALANDO O JDK O JDK (Java Development Kit) é o conjunto de ferramentas necessárias para a programação na linguagem JAVA (a principal funcionalidade é o javac, que é o compilador da linguagem). Neste tutorial vamos aprender como instalar e configurar o JDK em ambiente Windows. Acesse o site oficial http://www.oracle.com/technetwork/java/javase/downloads/index.html Clique em Download JDK. Figura 30 Link para Download JDK 29 Selecione a plataforma (Windows x32 ou Windows x64 dependendo da configuração do seu Sistema Operacional). Aceite o contrato de licença (Accept License Agreement) e faça o download gratuito do JDK. Figura 31 Selecione JDK e aceitar licença Abra o arquivo e clique em executar. Figura 32 Iniciando a Instalação 30 Clique em aceitar ”accept”. Figura 33 Aceitando os termos da licença Clique em next “próximo” Figura 34 Customizando o Setup 31 Clique em next ”próximo” novamente. Figura 35 Prosseguindo com a Instalação Aguarde enquanto instala. Figura 36 Instalando o JDK 32 Clique em finish “encerrar” para finalizar a instalação Figura 37 Finalizando a Instalação 8.1. Configurando as variáveis de sistema Agora que já instalamos o JDK, vamos configurar as Variáveis de Ambiente para que o JAVA funcione corretamente. Computador > Propriedades Clique com o botão direito em Meu 33 Figura 38 Acessando as propriedades Selecione a aba Avançado >Variáveis de ambiente (botão). Figura 39 Abrindo as Variáveis de Ambiente 34 Crie/edite as variáveis do sistema. JAVA_HOME: informe <o diretório da instalação do JDK>, por exemplo C:\Program Files\Java\jdk1.6.0_24 (imagem) Figura 40 Alterando as Variáveis de Ambiente Path: informe <diretório da instalação do JDK>\bin, por exemplo C:\Arquivos de programas\Java\jdk1.6.0_31\bin (se existirem outros diretórios cadastrados, inserir no início e separar por ponto-e-vírgula, as vezes pode acontecer um problema de não conseguir iniciar o Jboss no Windows XP, e no Windows 7, se isso ocorrer deve-se acrescentar depois do Bin com ponto-e-vírgula o caminho: C:\Arquivos de programas\Java\jdk1.6.0_31\bin;%SYSTEMROOT%\System32) CLASSPATH: informe <diretório da instalação do JDK>\lib\tools.jar, por exemplo C:\Program Files\Java\jdk1.6.0_24\lib\tools.jar 35 8.2. Testando a instalação Para verificar se a instalação e configuração foram realizadas com sucesso, abra um prompt de comando (prompt do DOS) através do Menu Iniciar > Acessórios > Prompt de comando Digite a instrução: java -version (versão do JAVA) ou javac -version (versão do compilador) , conforme a figura abaixo: Figura 41 Testando a Instalação 36 9. INSTALANDO O JBOSS APPLICATION SERVER Acesse a pasta C: através do executar digitando C: como na figura abaixo ou Menu Iniciar > Executar. Figura 42 Abrindo o Executar Crie uma pasta chamada Tecer na raiz do C: Descompacte o arquivo jboss-5.0.1.GA.zip na pasta C:\Tecer\ . Antes de startar o servidor de aplicação Jboss-5.0.1.GA, faça a configuração do arquivo components esse arquivo e encontrado na pasta : C:\Tecer\jboss- 5.0.1.GA\server\default\deploy\Tecerear.ear\Tecer.war\WEB-INF , você vai abrir o arquivo components, você vai encontrar as seguintes informações no arquivo, as linhas que estão selecionadas e onde deve ser feitas as alterações. Este arquivo e para configurar o servidor SMTP, que e o 37 servidor de email, que serve para que a aplicação possa enviar emails, quando cadastrar usuário novo ou quando um usuário sugerir um termo. Figura 43 Configuração do Arquivo Components Deve-se configurar o email do coordenador do sistema exemplo: username = o email do coordenador do sistema port = 465 passoword = a senha do email ssl = true Figura 44 Configuração do Arquivo Components Depois de ter feito essas alterações clique em salvar o arquivo e starta o Jboss-5.0.1.GA Acesse a pasta C:\Tecer\jboss-5.0.1.GA\bin e execute o arquivo run.bat . Figura 45 Iniciando Jboss 38 Após aparecer uma janela e as mensagens pararem o projeto estará pronto para ser acessado pelo navegador através do endereço: http://localhost:8080/Tecer Figura 46 Jboss iniciado Parar o Jboss clicar em shutdown.bat ou fechar a janela da figura 46. Figura 47 Parando o Jboss 39 10. REQUISITOS DE HARDWARE Sugere-se a seguinte configuração de hardware: Desempenho mínimo aceitável Pentium III 750 Mhz 1 GB de RAM 40 11. CONSIDERAÇÕES FINAIS Os softwares necessários para o funcionamento do sistema Tecer podem ficar em um mesmo servidor. Algumas considerações devem ser relevantes: 11.1. Cuidados com a segurança Procedimentos de segurança devem ser efetuados no servidor onde os programas e a Tecer estão instalados. Se possível o servidor fique dedicado á Tecer, porém caso não seja possível, tomar as medidas de segurança para assegurar-se de falhas. Caso o servidor da TECER compartilhe com outros sistemas verificar se não há incompatibilidade nas configurações do software necessárias para a TECER. 11.2. Cópias de segurança Sugerimos que uma cópia de segurança seja feita freqüentemente durante o uso da Tecer. Os dados da TECER ficam armazenados no PostgreSQL, portanto uma estratégia de backup deve ser implantada para evitar perda de dados.