Content
ATUALIZADO EM 24/07/2018!!!
Manual de Instalação do WebDiário
Atualização em 08/01/2017:
- Retirada do manual da VPN antigo, mantendo somente o oficial, do Stone;
Atualização em 31/01/2017:
- Inclusão dos passos de inserção dos dados do câmpus e SMTP;
- Inclusão do manual VPN Stone;
Atualização em 30/08/2016:
- Atualização do manual, retirando procedimentos que agora são automáticos na atualização;
Atualizado em 10/06/2016:
- Atualização do manual;
- Atualização do script da vpn (mantenha o seu caso esteja funcionando);
Atualizado em 05/03/2015:
- Parâmetro do db2Cron.php mudou de 1 para --D para habilitar modo debug;
Atualizado em 08/05/2015:
- Inclusão do pacote php5-ldap no comando de instalação;
Atualizado em 18/08/2015:
- Inclusão dos pacotes default-jre, sshpass e p7zip no comando de instalação;
- Inclusão do comando de script de backup no Cron;
Atualizado em 19/09/2015:
- Alteração dos parâmetros de /academico para /webdiario
Equipe de Desenvolvimento do WebDiário:
Eduardo Leal – Assessor da Pró-Reitoria de Desenvolvimento Institucional
João Paulo Lemos Escola (Barretos) – Coordenador do projeto
Geovanny Magalhães O. Filho (Barretos), Lucas Exposto Soares (Barretos), Ricardo Takazu (São Paulo)
Agradecimentos:
Anne Camila Dominici, Carlos Eduardo Alves da Silva, Fernando Parreira, Josiane Rosa de Oliveira Gaia, Lourenço Alves, Lucas de Oliveira Araújo, Kerollaine Lauto Oliveira, Marcelo Fernandes de Araújo, Naylor Garcia Bechiega
Antes de iniciar:
a) os procedimentos devem ser realizados em um servidor Ubuntu Server, versão 14.04 a 15.10, obrigatoriamente (versões posteriores instalam o php7, não compatível com nossos scripts);
b) Todos os comandos são executados com o usuário root;
c) O servidor deve ter acesso à Internet;
d) Solicite o usuário e senha do Hudson e a versão atual do WebDiario para webdiario@ifsp.edu.br.
e) Solicite, via suporte@ifsp.edu.br a criação de um usuário Admin no Nambei.
f) Solicite, via suporte@ifsp.edu.br a criação de uma conta de e-mail wd.[sigla do campus].naoresponder@ifsp.edu.br para possibilitar o envio de e-mails pelo sistema.
g) Solicite, via suporte@ifsp.edu.br a criação de um certificado válido para o domínio do seu câmpus: *.[sigla do campus].ifsp.edu.br.
1) Para baixar os arquivos de fonte do sistema vai ser necessário instalar os seguintes pacotes no servidor:
apt-get install -y apache2 mysql-server
apt-get install -y php5-gd php-pear php5-dev make php5-mysql libapache2-mod-php5 curl libcurl3 libcurl3-dev php5-curl
apt-get install -y php5-ldap default-jre sshpass p7zip unzip
2) Agora vamos criar o diretório do sistema e baixar os arquivos:
mkdir /var/www/html/webdiario
cd /var/www/html/webdiario
wget --auth-no-challenge --http-user=<USER_HUDSON> --http-password=<SENHA_HUDSON> http://hudson.ifsp.edu.br/job/web-diario.Git_WebDiario_PHP/lastSuccessfulBuild/artifact/target/webdiario-<VERSAO>.zip
unzip webdiario*.zip
rm webdiario*.zip
chown www-data:www-data -R /var/www/html/webdiario
3) Crie a base de dados para o sistema em seu servidor MySQL:
mysql -uroot -p'senha'
mysql> create database academico;
mysql> exit
4) Configure o usuário e senha do MySQL no arquivo config.inc.php da pasta inc:
nano /var/www/html/webdiario/inc/config.inc.php
5) Agora vamos criar a estrutura de tabelas do banco de dados com o comando abaixo (Solicite o arquivo banco.sql para webdiario’@’ifsp.edu.br):
mysql -uroot -p'senha' < banco.sql
Se você já tem um backup do banco de dados (pode ser solicitado para webdiario’@’ifsp.edu.br, caso disponível):
mysql -uroot -p'senha' academico < seu-arquivo-backup.sql
6) Agora seu sistema já pode ser acessado pela URL https://ipDoServidor/webdiario. Se você puder visualizar a imagem abaixo, pule para o item 12.
7) Caso não tenha conseguido acessar o site usando o protocolo HTTPS, pode ser necessário habilitar o SSL no seu servidor. Para isso, vamos criar o diretório para armazenar as chaves de segurança. Obs: se você já tem SSL instalado no Apache, pule para o passo 11.
mkdir /etc/apache2/ssl
8) Agora vamos criar as chaves de segurança. Execute o comando abaixo e preencha os campos solicitados, como mostrado na figura:
openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout /etc/apache2/ssl/apache.key -out /etc/apache2/ssl/apache.crt
9) Habilite o SSL e reinicie o Apache:
a2enmod ssl
service apache2 restart
10) Agora vamos configurar o Apache para permitir conexões pelo protocolo seguro HTTPS. Abra o arquivo /etc/apache2/sites-available/default-ssl e altere as linhas que especificam as chaves de segurança conforme a figura:
nano /etc/apache2/sites-available/default-ssl.conf
SSLCertificateFile /etc/apache2/ssl/apache.crt
SSLCertificateKeyFile /etc/apache2/ssl/apache.key
11) Ative as novas configurações:
a2ensite default-ssl
service apache2 restart
12) Agora você deve conseguir acessar o servidor pelo IP. Clique em “Continuar mesmo assim” (Chrome) ou “Entendo os riscos/Adicionar exceção” (Firefox). O usuário inicial de acesso é “admin” e senha “admin”.
ATENÇÃO: É possível instalar um certificado válido para o domínio do seu câmpus. Abra um chamado no suporte da reitoria solicitando um certificado válido para o domínio de seu câmpus, informando seu domínio. Exemplo: *.brt.ifsp.edu.br
13) Se seu servidor está aberto na Internet, deve ser possível acessa-lo via domínio do campus, faça os testes.
14) Agora iremos configurar o acesso ao Nambei para que seja possível importar dados para o WebDiario. Para isso, vamos primeiro configurar o servidor de pacotes e instalar o servidor de banco de dados DB2 da IBM por meio do pacote “db2exc”.
echo deb http://archive.canonical.com/ubuntu lucid partner >> /etc/apt/sources.list
apt-get update
apt-get install -y db2exc
15) Após instalar o pacote “db2exc” vai ser necessário executar o comando abaixo para instalar as extensões do DB2 no PHP.
pecl install ibm_db2
Obs: Quando o instalador solicitar o diretório de instalação do banco de dados, digite /home/db2inst1/sqllib
16) Com o comando abaixo, localize o arquivo php.ini:
locate php.ini
Após localizar, adicione a extensão do DB2 ao PHP e reinicie o Apache:
echo extension=ibm_db2.so >> /etc/php5/cli/php.ini
echo extension=ibm_db2.so >> /etc/php5/apache2/php.ini
service apache2 restart
17) Após instalar o DB2, vamos criar a base de dados de exemplo, mas antes é necessário logar com o usuário padrão do DB2:
su - db2inst1
db2sampl
exit
18) Agora vamos configurar a conexão VPN para acesso ao banco de dados DB2 no servidor da reitoria. Se o seu servidor já se encontra na reitoria, você pode pular para o passo 23:
-apt-get install pptp-linux
echo $’\nlock\ndebug\nrefuse-eap\nrefuse-pap\nrefuse-mschap\nrefuse-chap\n require-mppe’ >> /etc/ppp/options-
Não utilizar mais o script antigo. Utilizar o do item 19.
19) Para conectar à VPN pelo Linux, é possível criar um script de conexão, assim, não será mais necessário que cada PC conecte à VPN quando for utilizar o Nambei. Basta copiar o conteúdo da caixa para o seu editor de textos preferido (vi/nano) e alterar os parâmetros de usuário e senha nas quatro primeiras linhas do script. ATENÇÃO: É possível criar a conexão VPN de forma permanente no seu Firewall Stone ou outro (mais informações pergunte a webdiario@ifsp.edu.br).
20) Agora salve o arquivo com o nome “stone.sh” e configure a permissão de execução antes de executá-lo:
chmod +x /root/stone.sh
bash /root/stone.sh
21) Vai ser criada uma nova interface de rede, provavelmente a ppp0:
22) Faça o teste para verificar se o seu servidor tem acesso à máquina 192.168.6.X referente ao seu servidor DB2 disponível pela VPN. No meu caso o IP do servidor é 192.168.6.150, mas o seu pode ser outro, consulte o manual de instalação do Nambei:
23) No arquivo inc/config.inc.php estão os parâmetros de acesso ‘Admin’ ao Nambei. Neste arquivo, você precisa adicionar o nome da base de dados (de acordo com o manual do Nambei), e um usuário e senha do Nambei, além do IP referente ao seu campus (de acordo com o manual do Nambei). Solicite um usuário via suporte@ifsp.edu.br caso não possua um.
24) Faça o teste da importação de Alunos logando com o usuário “admin” (senha “admin”) e, utilizando a opção “Sincronizar Nambei” no menu Admin, conforme a figura abaixo e verifique se tudo ocorre bem, caso contrário revise os itens 14 a 17. Importe um item de cada vez. Alguns podem demorar mais, de acordo com o número de registros disponíveis no banco de dados do Nambei.
25) O comando abaixo faz todas as importações em sequência para tornar essa tarefa mais prática:
php5 /var/www/html/webdiario/db2/db2Cron.php --D
Em caso de erro, pode ser necessário especificar o caminho para o arquivo “php.ini”:
php5 -c /etc/php5/apache2/php.ini /var/www/html/webdiario/db2/db2Cron.php --D
Agora vamos configurar o CRON para executar diariamente a sincronização dos dados com o Nambei e o Backup online. Esse programa Java faz o backup do MySQL automaticamente, compacta e o envia por meio do protocolo SSH ao servidor de backup da reitoria. Em caso de necessidade, o CTI pode solicitar o backup por meio do suporte da reitoria:
crontab -e
adicione as linhas:
0 1 * * * php5 /var/www/html/webdiario/db2/db2Cron.php
0 12 * * * java -jar /var/www/html/webdiario/extra/BackupOnline.jar
Essa configuração no CRON faz com que os scripts sejam agendados para executar diariamente à 1h da manhã (Sincronizador Nambei) e 12h (backup online) respectivamente.
26) Verifique qual o usuário do Apache e configure a permissão para a pasta /var/www/html/webdiario/arquivo que armazena os arquivos submetidos pelo professor para os alunos:
chown www-data:www-data /var/www/html/webdiario/arquivo
27) Acessar o WebDiário menu ADMIN > Instituição e configurar os dados do câmpus;
28) Acessar o WebDiário menu ADMIN > Instituição > aba Configurações. Preencher os campos conforme imagem abaixo (solicitar via suporte@ifsp.edu.br caso não possua):
Obrigado.
Em caso de dúvidas, entre em contato com:
_João Paulo Lemos Escola
ei: jpescola@ifsp.edu.br
skype: jpescola
google talk: jpescola@gmail.com_