Faça download do tutorial:
Instalação do GMoodle no Linux

Em caso de dúvida, compartilhe no fórum da comunidade Badiu. Lá há um espaço de debate e troca de ideias entre administradores. Veja link a seguir.

Fórum de Administradores de Badiu GMoodle:
http://comunidade.badiu.com.br/mod/forum/view.php?id=4

Para efetuar a configuração do banco de dados, você precisa criar o banco de dados e ter em mão os seguintes dados:

• Host do banco
• Porta do banco
• Nome do banco
• Usuário de acesso ao banco
• Senha de acesso ao banco

Tendo esses dados, siga os seguintes passos para efetuar a configuração do Data Source JNDI:

1° Passo – Abra o arquivo jboss-ds.xml
Localize o arquivo jboss-ds.xml na pasta JBOSS_HOME/server/default/deploy e abra em um editor de texto. O JBOSS_HOME se refere ao endereço raiz da instalação do Jboss.

2° Passo – Efetuar configuração do banco
Ao abrir jboss-ds.xml, você visualizará seguinte código:

<?xml version=”1.0″ encoding=”UTF-8″?>
<datasources>
<local-tx-datasource>
<jndi-name>jdbc/badiuDS</jndi-name>
<connection-url>jdbc:postgresql://localhost:5432/nome_do_banco</connection-url>
<driver-class>com.progress.sql.jdbc.JdbcProgressDriver</driver-class>
<user-name>usuario_banco</user-name>
<password>senha_banco</password>
<min-pool-size>5</min-pool-size>
<max-pool-size>20</max-pool-size>
<idle-timeout-minutes>5</idle-timeout-minutes>
</local-tx-datasource>
</datasources>

Altere as partes coloridas do código. De modo geral, você precisa configurar o nome do banco, usuário e senha. O host precisa ser alterada se o banco estiver em outra máquina. A porta precisa ser alterada se o padrão for alterado.

A configuração do nome do JNDI não deve ser alterada. Nome do JNDI é configurada nessa parte do código:
<jndi-name>jdbc/badiuDS</jndi-name>

jdbc/badiuDS é o nome padrão que o sistema Badiu GMoodle vai localizar o banco de dados. Por isso, esse nome não deve ser alterada.

Segue explicação detalhada de cada item que precisa ser alterada:

a) Altere o host do banco
O host do banco deve ser alterado nessa linha:

<connection-url>jdbc:postgresql://localhost:5432/nome_do_banco</connection-url>

O trecho do código destacado em vermelho se refere ao host. Por padrão está configurado como localhost. Caso sua base não estiver na mesma maquina que o servidor Jboss, altere o localhost para o IP ou domínio em que o servidor do banco está instalado.

b) Altere a porta do banco
A porta deve ser alterada nessa linha

<connection-url>jdbc:postgresql://localhost:5432/nome_do_banco</connection-url>

O trecho do código destacado em vermelho 5432 se refere a porta. Trata-se da porta padrão do PostgreSQL. Altere esse valor apenas se houver mudança da porta padrão do banco.

c) Configure o nome do banco
Configure o nome do banco nessa linha

<connection-url>jdbc:postgresql://localhost:5432/nome_do_banco</connection-url>

O trecho do código destacado em vermelho nome_do_banco deve ser substituída pelo nome do banco de dados.

d) Configure o usuário de acesso ao banco
Configure o login de acesso ao banco no seguinte código:

<user-name>usuario_banco</user-name>

O trecho do código destacado em vermelho usuario_banco deve ser substituída pelo nome do usuário que vai logar no banco.

e) Configure a senha do banco
Configure a senha de acesso ao banco nessa linha

<password>senha_banco</password>

O trecho do código destacado em vermelho senha_banco deve ser substituído pela senha do banco.

Os procedimentos descritos acimas são fundamentais no processo de instalação do sistema Badiu GMoodle. Grande parte dos erros de instalação ocorrem nessa etapa. Por isso, preste muita atenção ao efetuar essa configuração.

Se a configuração for bem sucedida, ao iniciar o servidor Jboss, automaticamente as tabelas do sistema Badiu GMoodle serão criadas. Verifique isso após inicia o Jboss.

Para efetuar a configuração do banco de dados, você precisa criar o banco de dados e ter em mão os seguintes dados:

• Host do banco
• Porta do banco
• Nome do banco
• Usuário de acesso ao banco
• Senha de acesso ao banco

Tendo esses dados, siga os seguintes passos para efetuar a configuração do Data Source JNDI:

1° Passo – Abra o arquivo jboss-ds.xml
Localize o arquivo jboss-ds.xml na pasta JBOSS_HOME/server/default/deploy e abra em um editor de texto. O JBOSS_HOME se refere ao endereço raiz da instalação do Jboss.

2° Passo – Efetuar configuração do banco
Ao abrir jboss-ds.xml, você visualizará seguinte código:

<?xml version=”1.0″ encoding=”UTF-8″?>
<datasources>
<local-tx-datasource>
<jndi-name>jdbc/badiuDS</jndi-name>
<connection-url>jdbc:mysql://localhost:3306/nome_do_banco</connection-url>
<driver-class>com.mysql.jdbc.Driver</driver-class>
<user-name>usuario_banco</user-name>
<password>senha_banco</password>
<min-pool-size>5</min-pool-size>
<max-pool-size>20</max-pool-size>
<idle-timeout-minutes>5</idle-timeout-minutes>
</local-tx-datasource>
</datasources>
Altere as partes coloridas do código. De modo geral, você precisa configurar o nome do banco, usuário e senha. O host precisa ser alterada se o banco estiver em outra máquina. A porta precisa ser alterada se o padrão for alterado.

A configuração do nome do JNDI não deve ser alterada. Nome do JNDI é configurada nessa parte do código:
<jndi-name>jdbc/badiuDS</jndi-name>

jdbc/badiuDS é o nome padrão que o sistema Badiu GMoodle vai localizar o banco de dados. Por isso, esse nome não deve ser alterada.

Segue explicação detalhada de cada item que precisa ser alterada:

a) Altere o host do banco
O host do banco deve ser alterado nessa linha:

<connection-url>jdbc:mysql://localhost:3306/nome_do_banco</connection-url>

O trecho do código destacado em vermelho se refere ao host. Por padrão está configurado como localhost. Caso sua base não estiver na mesma maquina que o servidor Jboss, altere o localhost para o IP ou domínio em que o servidor do banco está instalado.

b) Altere a porta do banco
A porta deve ser alterada nessa linha

<connection-url>jdbc:mysql://localhost:3306/nome_do_banco</connection-url>

O trecho do código destacado em vermelho 3306 se refere a porta. Trata-se da porta padrão do MySQL. Altere esse valor apenas se houver mudança da porta padrão do banco.

c) Configure o nome do banco
Configure o nome do banco nessa linha

<connection-url>jdbc:mysql://localhost:3306/nome_do_banco</connection-url>

O trecho do código destacado em vermelho nome_do_banco deve ser substituída pelo nome do banco de dados.

d) Configure o usuário de acesso ao banco
Configure o login de acesso ao banco no seguinte código:

<user-name>usuario_banco</user-name>

O trecho do código destacado em vermelho usuario_banco deve ser substituída pelo nome do usuário que vai logar no banco.

e) Configure a senha do banco
Configure a senha de acesso ao banco nessa linha

<password>senha_banco</password>

O trecho do código destacado em vermelho senha_banco deve ser substituído pela senha do banco. Caso não tiver senha, deixe vazio. Caso tenha instalado o MySQL através do Xampp, por padrão, o usuário root vem sem senha. Neste caso, deixe a senha vazia. Se não houver senha, a configuração deve ficar assim:

<password></password>

Os procedimentos descritos acimas são fundamentais no processo de instalação do sistema Badiu GMoodle. Grande parte dos erros de instalação ocorrem nessa etapa. Por isso, preste muita atenção ao efetuar essa configuração.

Se a configuração for bem sucedida, ao iniciar o servidor Jboss, automaticamente as tabelas do sistema Badiu GMoodle serão criadas. Verifique isso após inicia o Jboss.

O sistema de gestão da Plataforma Moodle, o Badiu GMoodle foi projetado em Java. A sua instalação requer um servidor Java – Jboss e um servidor de banco de banco de dados que pode ser MySQL ou PostgreSQL.

Para montar o ambiente de instalação do GMoodle, siga os seguintes passos:

1° Passo – Instalação do Java
Efetue instalação do Java 6. Siga as instruções no link abaixo:
Instalar Java 6 no Windows: http://gmoodle.badiu.com.br/?p=97

2° Passo – Instalação do Jboss
Efetue instalação do Jboss 4.2.3. Siga as instruções no link abaixo:
Instalar Jboss 4.2.3 no Windows: http://gmoodle.badiu.com.br/?p=112

4° Passo – Configuração do Jboss
Após a instalação do Jboss, siga os seguintes procedimentos especificados abaixo. Os itens d) a f) são indispensáveis em ambiente de produção.

a) Configure as variáveis do ambiente do Java e do Jboss
Sistema Windows: http://gmoodle.badiu.com.br/?p=101

b) Inicie o servidor Jboss para testar a configuração
Sistema Windows: http://gmoodle.badiu.com.br/?p=128
Se der certo, pare o servidor e avance para os próximos itens.

c) Aumente a configuração da memória do Jboss
Sistema Windows: http://gmoodle.badiu.com.br/?p=122

d) Desabilite o hot deployer do Jboss. Siga as instruções nesse post: http://gmoodle.badiu.com.br/?p=116

e) Remova as aplicações que Jboss não usa para aumentar performance / segurança. Siga as instruções nesse post: http://gmoodle.badiu.com.br/?p=9

f) Habilitar apenas registro de log de erro do Jboss. Siga as instruções nesse post: http://gmoodle.badiu.com.br/?p=119

g) Teste o funcionamento do jboss após efetuar essas configurações. Inicie o servidor para ver se está ok. Caso ocorrer alguma falha, é sinal que cometeu algum erro durante a configuração.
Sistema Windows: http://gmoodle.badiu.com.br/?p=128

5° Passo – Instalação do banco de dados
GMoodle requer baco de dados MySQL ou PostgreSQL. Efetue a instalação do banco caso ainda não tiver nenhum desses servidores instalados na sua máquina.
Se for instalar o banco MySQL, uma forma rápida de fazer isso é instalar o Xampp. Siga os procedimentos abaixo para instalar o Xampp.
Sistema Windows: http://moodleeduc.badiu.com.br/?p=232

6° Passo – Criar banco de dados
Crie o banco de dados em que será usado pelo sistema Badiu GMoodle. O banco deve ter codificação uft8. Caso o banco for MySQL e tiver acesso a base pela interface phpMyAdmin (vem instalado no Xampp), siga as instruções nesse post: http://moodleeduc.badiu.com.br/?p=242

Preparar o ambiente do servidor do Badiu GMoodle é uma tarefa fácil, porém requer um pouco de paciência para seguir cada procedimento com cautela. Cada etapa do trabalho deve ser testada isoladamente. Antes de iniciar a instalação do GMoodle, faça um teste de funcionamento do ambiente do servidor.

Para efetuar instalação do GMoodle, é necessário que já tenha o servidor Jboss 4.2.3 instalado e funcionando. Além disso, é necessário ter um servidor de banco de dados.

Para instalar o sistema Badiu GMoodle, siga os seguintes passos:

1° Passo – Preparar ambiente do servidor
Preparar o ambiente do servidor é o processo de instalação de Java, Jboss e banco de dados. Caso ainda não tenha feito isso, siga as instruções nesse post: http://gmoodle.badiu.com.br/?p=146

2° Passo – Faça download do GMoodle
Faça download do sistema Badiu GMoodle no seguinte link: http://www.badiu.net/gmoodle/download
Faça download da versão mais recente.

3° Passo – Descompacte o arquivo
Descompacte o arquivo gmoodle-ear-1.2.2.zip ou gmoodle-ear-1.2.2.tar.gz que fez download. O arquivo gmoodle-ear-1.2.2.zip se refere a versão 1.2.2. Ao fazer download, opte sempre pela versão mais recente.

Ao descompactar o arquivo, deve encontrar a seguinte estrutura dentro da pasta do gmodle-ear-[versao]

•  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;
•  lib – Contém bibliotecas, ou seja, arquivos jar como drive do banco de dados.

4° Passo – Copiar pasta/arquivo para jboss
Pare o servidor Jboss caso estiver executando. Copie os seguintes pastas/arquivos:

•  badiu.ear 
•  jboss-ds.xml

e cole no seguinte endereço JBOSS_HOME/server/default/deploy. O JBOSS_HOME se refere ao endereço raiz da instalação do Jboss.
O arquivo jboss-ds.xml copiado da estrutura de arquivos descompactado traz a configuração padrão do banco MySQL. Caso seu banco for PostgreSQL, copie o arquivo jboss-ds.xml do seguinte endereço:
PASTA_DESCOMPACTADA_DO_GMOODLE/conf/datasource/postgresql e cole em JBOSS_HOME/server/default/deploy

5° Passo – Configurar banco de dados
Nessa etapa vamos configurar o banco de dados que GMoodle vai usar.
Para efetuar essa configuração, siga as instruções nesse post:
Banco MySQL: http://gmoodle.badiu.com.br/?p=151
Banco PostgreSQL: http://gmoodle.badiu.com.br/?p=158

6° Passo – Instalar drive do banco
Essa configuração é necessária caso estiver usando o banco PostgreSQL. Se o seu banco for MySQL, pule essa parte.
Na versão 4.2.3 do Jboss o drive do MySQL vem instalado. Já PostgreSQL não. Para instalar drive PostgreSQL no Jboss, siga os seguintes procedimentos:

a) Copie o arquivo postgresql-8.4-701.jdbc4 da pasta PASTA_DESCOMPACTADA_DO_GMOODLE/lib;

b) Cole em JBOSS_HOME/server/default/lib

7° Passo – Iniciar a instalação
Uma vez instalado GMoodle no servidor Jboss, para finalizar a instalação, siga os seguintes procedimentos:

a) Inicie o servidor Jboss. Antes de passar para item b) dá um tempo de 2 minutos, em média, para aguardar o servidor iniciar completamente.

b) Abra no navegador o seguinte endereço: http://localhost:8080/sistema/install.jsp
Feito isso, deve aparecer a seguinte tela:

c) Clique no botão Avançar. Feito isso, será exibida a tela de licença de uso, como mostra a imagem abaixo.

d) Na tela licença de uso, o botão Avançar fica habilitado depois de concordar com o termo de uso. Isso deve ser feito mancando a caixa de seleção checkbox. Ao clicar no botão Avançar, será exibida a tale de conexão com o banco, como mostra a figura abaixo.

Caso a conexão não estiver funcionando, significa que há alguma falha na configuração do banco de dados, ou seja, Data Source JNDI. Em caso de falha, o botão Avançar fica desativado.

e) Clique no botão Avançar. Feito isso, a base de dados será configurada com as informações básicas para inicialização do sistema. Isso pode levar alguns minutos. Se tudo ocorrer bem, a instalação será finalizada. Será exibida uma tela informando que a instalação foi feita com sucesso, como mostra a figura abaixo.

f) Nessa etapa é necessário parar o servidor Jboss e iniciar novamente. Ao reiniciar o servidor, o cron do GMoodle será habilitado.

g) Para acessar o GMoodle, acesse no navegador o seguinte endereço http://localhost:8080/gmoodle
Feito isso, deve abrir a tela de login do GMoodle como mostra a figura abaixo.

h) Logue no GModle com o login e senha padrão que é gerado na instalação.
Login: admin
Senha: badiu
Ao logar, se aparecer a tale abaixo, é sinal que instalação ocorreu com sucesso.

Se você estiver visualizando essa imagem é sinal que a instalação deu certo. Ufa, até que enfim chegamos no final da instalação. Trabalhar com Java tire suor. Para GMoodle vale a pena. A próxima etapa é cadastrar site Moodle e customizar as configurações.

Após a instalação e configuração do Jboss é fundamental testar o funcionamento do serviço.

Para iniciar / parar o servidor Jboss no Windows, siga os seguintes passos:

1° Passo – Execute o arquivo run.bat
Localize o arquivo run.bat que fica na pasta JBOSS_HOME/bin. O JBOSS_HOME se refere ao endereço raiz da instalação do Jboss. Dê 2 cliques no arquivo run.bat como mostra a figura abaixo.

Feito isso, será aberta uma janela de DOS. Quando Jboss iniciar vai aparecer a tela como mostra a figura abaixo.

2º Passo – Abrir Jboss no navegar
Para testar que Jboss foi iniciado com sucesso, 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.

3º Passo – Encerrar o serviço do Jboss
Para encerrar o serviço, adote o seguinte procedimento:

a) Clique na janela de DOS que Jboss está funcionando;

b) Feito isso, a janela ficará ativa na lista de janela. Dê um comando Ctrl + C;

c) Feito isso, o serviço encerra. Para fechar a janela do DOS aperte a tecla S quando aparecer no DOS a mensagem: Deseja finalizar o arquivo em lote <S/N>?.
Esse procedimento se aplica na versão 4.2.3 do Jboss e também em outras versões no ambiente Windows. Antes de efetuar a instalação do sistema Badiu GMoodle no Jboss, é recomendável fazer teste de funcionamento do sevidor para averiguar se não ocorreu nenhum erro durante a instalação.

A configuração padrão do Jboss vem com quantidade baixa da memória. O sistema Badiu GMoodle requer, em média, 3GB de RAM. Jboss 4.2.3 vem com 512M de RAM configurado. Se rodar o GMoodle com essa configuração vai dar erro de falta de memória.

Para aumentar a memória RAM do Jboss no Linux, siga os seguintes passos:

1° Passo – Abrir o arquivo run.conf
Localize o arquivo run.conf que fica na pasta JBOSS_HOME/bin e abra em um editor de texto. O JBOSS_HOME se refere ao endereço raiz da instalação do Jboss.

2º Passo – Aumentar a memória
Ao abrir o run.conf localize aproximadamente na linha 42 o código:

if [ "x$JAVA_OPTS" = "x" ]; then
          JAVA_OPTS=”-Xms128m -Xmx512m -Dsun.rmi.dgc.client.gcInterval=3600000 -Dsun.rmi.dgc.server.gcInterval=3600000″
fi
Altere esse código, aumentando a memória de 514m para 2048m. Também adicione em seguida a configuração do PermSize. O código: -XX:MaxPermSize=1024m
Feito a configuração, deve ficar assim:

if [ "x$JAVA_OPTS" = "x" ]; then
       JAVA_OPTS=”-Xms128m –Xmx2048m -XX:MaxPermSize=1024m -Dsun.rmi.dgc.client.gcInterval=3600000 -Dsun.rmi.dgc.server.gcInterval=3600000″
fi

A parte do código alterado está  na cor azul. Feito a alteração, grave o arquivo.
Essa configuração se aplica na versão 4.2.3 do Jboss e também em outras versões. Feito essa configuração, você garante o funcionamento do sistema Badiu GMoodle. Pode ser que seja necessário ajustar a configuração da memória em função da o tamanho da base de dados do seu Moodle.

Por padrão Jboss vem configurado com pouca memória. O sistema GModle requer em média 3GB de RAM para funcionar com maior performance. Se deixar a configuração padrão do Jboss, o servidor vai dar erro de falta de memória após a instalação do GMoodle.

Para aumentar a memória do Jboss no Windows, siga os seguintes passos:

1° Passo – Abrir o arquivo run.bat
Localize o arquivo run.bat que fica na pasta JBOSS_HOME/bin e abra em um editor de texto. O JBOSS_HOME se refere ao endereço raiz da instalação do Jboss.

2º Passo – Aumentar a memória
Ao abrir o run.bat localize aproximadamente na linha 74 o código:

set JAVA_OPTS=%JAVA_OPTS% -Xms128m -Xmx512m

Altere esse código, aumentando a memória de 514m para 2048m. Também adicione no final a linha a memória PermSize. O código: -XX:MaxPermSize=1024m
Feito a configuração, deve ficar assim:

set JAVA_OPTS=%JAVA_OPTS% -Xms128m –Xmx2048m -XX:MaxPermSize=1024m

A parte do código alterado está  na cor azul.  Feito a alteração, grave o arquivo.

Essa configuração se aplica na versão 4.2.3 do Jboss e também em outras versões. Feito essa configuração, você garante o funcionamento do sistema Badiu GMoodle. Pode ser que seja necessário ajustar a configuração da memória em função da o tamanho da base de dados do seu Moodle.

Por padrão o log de Jboss registra erros e debug. O debug acaba deixando o arquivo muito grande chegando até a mais de 1 GB em um dia. Isso rapidamente consome todo o espaço disponível em HD.

Para resolver esse problema, a alternativa é configurar o log para registrar apenas o erro. Assim, o arquivo de log pode crescer em até alguns MB e não em GB.
Para ativar apenas o log de erro, siga os seguintes passos:

1° Passo – Abrir o arquivo jboss-log4j.xml
Localize o arquivo jboss-log4j.xml que fica na pasta
JBOSS_HOME/server/default/conf e abra em um editor de texto.  O JBOSS_HOME se refere ao endereço raiz da instalação do Jboss.

2º Passo – Habilitar apenas log de erro
Ao abrir o arquivo jboss-log4j.xml localize aproximadamente na linha 301 o código:

<root>
     <appender-ref ref=”CONSOLE”/>
     <appender-ref ref=”FILE”/>
</root>

Altere esse código retirando o trecho:
<appender-ref ref=”CONSOLE”/>

E adicione um novo trecho de código:
<priority value=”ERROR”/>

Feito a configuração, deve ficar assim:
<root>
       <priority value=”ERROR”/>
    <appender-ref ref=”FILE”/>
</root>

Feito a alteração, grave o arquivo.

Essa configuração é recomendável no ambiente de produção. Se aplica na versão 4.2.3 do Jboss e também em outras versões. Feito essa configuração, o Jboss fica com maior performance para executar o sistema Badiu GMoodle.

Hot deployer é o mecanismo de escanear arquivo para deployer. Por padrão vem habilitado. Uma vez habilitado, o deployer de arquivos e aplicação pode ser feita após o servidor iniciar. Qualquer nova aplicação em war, ear ou mesmo arquivos jsp é executado com o servidor funcionando.

Ao desabilitar hot depolyer, as aplicações serão executadas apenas ao iniciar o servidor. Novas aplicações adicionadas entrarão em ação após reiniciar o servidor.
Para desabilitar o deployer automático, siga o seguintes passos:

1º Passo – Abrir o arquivo jboss-service.xml
Localize o arquivo jboss-service.xml que fica na pasta
JBOSS_HOME/server/default/conf e abra em um editor de texto. O JBOSS_HOME se refere ao endereço raiz da instalação do Jboss.

2º Passo – Desabilite a variável ScanEnabled
Ao abrir o arquivo jboss-service.xml, localize aproximadamente na linha 654 a variável

<attribute name=”ScanEnabled”>true</attribute>

Altere o valor true para false. Feito a configuração, deve ficar assim:

<attribute name=”ScanEnabled”>false</attribute>

Feito a alteração, grave o arquivo.

Essa configuração é recomendável no ambiente de produção. A vantagem é que aumenta a segurança e por outro lado, deixa o servidor mais leve para executar o sistema Badiu GMoodle com maior performance.