DOCUMENTAÇÃO BADIU.NET
GMoodle 1.2

Anterior Próximo

Instalação do Badiu GMoodle

A instalação do Badiu GMoodle segue o padrão de instalação de aplicação em servidor corporativo EJB3. Aqui será demonstrado as instruções para instalação da aplicação EAR no servidor Jboss.

Para instalar Badiu GMoodle é necessário criar um ambiente de servidor com os seguintes softwares:

Software Descrição Download

Tutorial

Java 6 Ambiente de Java http://java.sun.com/javase/downloads/widget/jdk6.jsp Tutorial
JBoss 4.2.* ou 5.*
Servidor de Aplicação Java http://sourceforge.net/projects/jboss/files/JBoss/JBoss-5.1.0.GA/jboss-5.1.0.GA.zip/download

Tutorial

MySQL Sistema de Banco de Dados http://dev.mysql.com/downloads/mysql/ Tutorial
Badiu GMoodle Sistema de Gestão do Moodle http://www.badiu.net/gmoodle/download Tutorial

Caso você tenha a dificuldades de criar e configurar um ambiente de servidor, não desespere. Contrate um servidor de hospedagem JBoss. Caso opte por esse caminho, recomendo SERVERYOU4 - http://www.server4you.com ou JSPzone - http://www.jspzone.net/jboss_hosting.htm GMoodle já foi testado nesses servidores e teve um bom desempenho. Bem, se ainda quer livrar de toda a burocracia técnica e prefere tudo pronto para usar, contrate o serviço d GMoodle Onine da empresa Badiu - http://www.badiu.net/nportal/index.php?option=com_content&view=article&id=15&Itemid=17

Instalação do Ambiente Java

Badiu GMoodle funciona na versão 6 do Java (JKD 6). Caso for usado com a versão 5, ocorre erro na instalação.

Faça download do Java 6 no link: http://java.sun.com/javase/downloads/widget/jdk6.jsp
Siga as instruções de instalações nos tutorias indicado abaixo. Esses tutoriais mostram como instalar Java 5. Os passos são os mesmos para a instalação do Java 6.

Tutorial de Instalação do Java
Windows: http://www.guj.com.br/content/articles/installation/j2sdkinstall.pdf
Linux: http://www.guj.com.br/content/articles/java5_linux/guj_java_linux.pdf

Instalação e configuração do Jboss

JBoss é um servidor de aplicação JEE free open source. Existem vários outros servidores JEE tais como Geronimo, Glassfish, WebLogic etc. Geronimo e Classfish, assim como JBoss, são open source.

A camada da lógica de negócio do GMoodle foi desenvolvida em EJB3. Jboss fornece suporte a EJB3 a partir da versão 4.2.1, pois é necessário instalar a versão 4.2.1 ou superior. A versão 1.2.1 do Badiu GMoodle já funciona no Jboss 5. Faça download da versão  5.1.0 do Jboss  nesse link http://sourceforge.net/projects/jboss/files/JBoss/JBoss-5.1.0.GA/jboss-5.1.0.GA.zip/download se estiver usando a versão 1.2.1 do GMoodle. Caso estiver usando a versão mais antiga do GMoodle, como a 1.2 faça download da versão 4.2.3  do Jboss nesse link http://sourceforge.net/projects/jboss/files/JBoss/JBoss-4.2.3.GA/jboss-4.2.3.GA.zip/download  afasjdf EJB3

Antes de instalar JBoss, verifica se o Java 6 está instalado. JBoss só funciona se o Java estiver instalado e configurado.

Para instalar JBoss no Windows, leia este tutorial: http://rafaelsakurai.blogspot.com/2007/09/instalando-o-jboss-421ga.html

Para instalar JBoss no Linux leia este tutorial: http://www.vivaolinux.com.br/dica/Instalando-Jboss-no-Debian-Lenny Embora esse tutorial é sobre a instalação do JBoss 5, os passos para instalar JBoss 4.2.1 são os mesmos.

Para testar se a instalação foi feita com sucesso, inicie o JBoss e acesse o endereço http://localhost:8080/ no navegador. Se abrir a uma página como mostra a imagem abaixo significa que a instalação foi feita com sucesso.

Configuração da Memória no JBoss
Para garantir funcionamento do Badiu GMoodle é necessário alterar a configuração da memória heap e permanente do java no Jboss. É recomendável as seguintes configurações: -Xms128m -Xmx1024m -XX:MaxPermSize=728m esssa configuração deve ser feita no arquivo run.bat no Windows e run.conf no Linux localizado no endereço xxx/Jboss/bin na linha que tem o comando:

run.bat no Windows:
set JAVA_OPTS=%JAVA_OPTS% -Xms128m -Xmx513m

run.conf no Linux:
if [ "x$JAVA_OPTS" = "x" ]; then
JAVA_OPTS="-Xms128m -Xmx512m -Dsun.rmi.dgc.client.gcInterval=3600000 -Dsun.rmi.dgc.server.gcInterval=3600000"
fi

Basta editar esta linha para que a memória heaper seja -Xms128m -Xmx512m -XX:MaxPermSize=256m
Por padrão
-XX:MaxPermSize=256m não é especificado. Deve ser acrescentado. A configuração final deve ficar assim:

run.bat no Windows:
set JAVA_OPTS=%JAVA_OPTS% -Xms128m -Xmx513m -XX:MaxPermSize=128m

run.conf no Linux:
if [ "x$JAVA_OPTS" = "x" ]; then
JAVA_OPTS="-Xms128m -Xmx512m -XX:MaxPermSize=256m -Dsun.rmi.dgc.client.gcInterval=3600000 -Dsun.rmi.dgc.server.gcInterval=3600000"
fi

Banco de Dados
Para instalar o GMoodle é necessário ter a base de dados MySQL, PosgreSQL ou qualquer outra base que seja suportada pelo por Hibernate. GMoodle comunica com a sua base de dados através de servidor de aplicação JPA / Hibernate. Pois, pode utilizar qualquer banco de de dados. Caso tenha escolhido o MySQL, é recomendo a versão 5 que é a mais atualizada.

Se as bases do Moodle a serem gerenciadas pelo GMoodle tiverem carga elevado de dados, ou seja, milhões de registros, é recomendado o uso de PostgreSQL para instalar o GMoodle. PostgreSQL é mais eficiente para trabalhar carga de dados elevados em comparação com MySQL.

Por padrão, GMoodle traz a configuração do MySQL no DataSourece. Caso for usar MySQL, siga os tutorias de instalação indicado abaixo.

Instalação do MySQL

Faça download no link: http://dev.mysql.com/downloads/mysql e efetue a instalação. Após a instalação, crie uma base de dados para ser usando no GMoodle.

Caso não tenha habilidade para usar a linha de comandos, use uma interface gráfica. Neste caso use MySQL GUI Tools - http://dev.mysql.com/downloads/gui-tools/5.0.html ou qualquer outra. Há muitas opções. Basta pesquisar no Google.

Instalação do GMoodle

Faça download da aplicação EAR do Badiu.Net GMoodle em http://www.badiu.net/gmoodle/download

Descompacte o arquivo. Ao descompactar, terá a seguinte estrutura:

  • badiu.ear - Pasta da aplicação EAR com módulos do sistema da Plataforma Badiu.net e módulo do GMoodle;
  • jboss-ds.xml - Arquivo de configuração do banco de dados;
  • doc - Pasta com a documentação do sistema;
  • conf- Pasta com arquivos de configuração.

Copie os arquivos badiu.ear e jboss-ds.xml para dentro da pasta deploy da aplicação default do JBoss. Esta pasta fica no endereço: xxx/Jboss/server/defaul/deploy

Com o banco de dados criado anteriormente, faça a configuração do Data Source JNDI no arquivo jboss-ds.xml localizado no endereço xxx/Jboss/server/defaul/deploy. Edite o jboss-ds.xml com dados de conexão do banco. Mantenha inalterável a linha de configuração do nome de JNDI <jndi-name>jdbc/badiuDS</jndi-name> e altere o resto. A configuração desse arquivo segue padrão da base MySQL.

Caso a sua base de dados for outra, altere a configuração do drive. Na pasta conf existe a configuração do Data Source para outras bases como PostgreSQL. Dentro dessa pasta, há uma subpasta com nome datasource. Na pasta datasource há um outra subpasta com nome  das bases de dados.  Nessa subpasta, há o arquivo jboss-ds.xml com a configuração da base. Se a sua base for PostgreSQL, copie o arquivo  jboss-ds.xml da pasta conf/datasource/postgresql para xxx/Jboss/server/defaul/deploy e faça a edição d    ogin e senha. É necessário lembrar que a configuração do JNDI <jndi-name>jdbc/badiuDS</jndi-name> deve manter inalterado.

Drive do Banco de Dados
Se estiver usando jboss 4.2.* com base de dados for PostgreSQL, é necessário colocar o drive do banco de dados na biblioteca do servidor. Jboss 4.2.* já vem com o drive de MySQL na sua distribuição. Já o drive do PostgreSQL é necessário adicionar. Para isso, copie o arquivo postgresql-.8.*.jdbc4.jar da pasta lib (subpasta da pasta descompactada do download. Fica no mesmo nível que a pasta badiu.ear)  e cole na xxx/Jboss/server/default/lib
Você não consegue instalar GMoodle com PostgreSQL sem copiar o drive postgresql-.8.*.jdbc4.jar para a pasta da biblioteca  do Jboss 4.2.*

Se estiver usando Jboss 5, é necessário fazer o mesmo procedimento descrito acima tanto para a  base MySQL quanto PostgreSQL.  Copie o drive do banco de dados da pasta lib (subpasta da pasta descompactada do download. Fica no mesmo nível que a pasta badiu.ear)  e cole na xxx/Jboss/server/default/lib

Observação
Para iniciar a instalação do GMoodle, inicie o servidor Jboss ou reinicie caso já estiver inicializado.

Iniciar Instalação
Acesse o instalador do Badiu.Net no endereço http://enderecodedominio/sistema/install.jsp. se o endereço for http://localhost:8080, a instalação será em http://localhost:8080/sistema/install.jsp. Feito isso, se tudo estiver bem configurado será exibida a página do instalador como mostra a imagem abaixo.

Clique no botão Avançar. Será exibida a página com licença de uso.

Leia o contrato. Caso concorde, marque a caixa se seleção para dizer que aceita as regras do contrato de uso. Em seguida, clique no botão Avançar. Será exibida a página de teste de conexão com a base de dados.


Caso a conexão não estiver funcionando, significa que há alguma falha na configuração do Data Source JNDI. Em caso de falha, o botão Avançar fica desativado. Estando tudo funcionando normalmente, clique no botão Avançar. Nessa etapa a base de dados será configurada com as informações básicas para inicialização do sistema. Se tudor ocorrer bem, a instalação será finalizada.

Clique no botão Iniciar Sistema. Será aberta a página de autenticação.

Use o login e senha padrão criados durante a instalação:
Login: admin
Senha: badiu

Ao colocar login e senha, será automaticamente redirecionado para o módulo GMoodle. Será exibida a página de gerenciamento de Portal Moodle.

Chegou a hora de cadastrar um Web Site Moodle para testar como funciona o GMoodle. Embora já deves ter lido bastante, vai ainda a indicação de mais um tutorial que auxilia nos primeiros passos para cadastrar o Moodle no GMoodle. Segue o link: http://www.badiu.net/nportal/index.php?option=com_content&view=article&id=26

Anterior Próximo