Manual de Instalação

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

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 3

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-detesauros- tecer). 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-einovacao/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

Figura 19 Propriedade de Logon Secundário 20

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 jboss- 5.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. Clique com o botão direito em Meu Computador > Propriedades

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: Pentium III 750 Mhz Desempenho mínimo aceitável 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.