Instalando o Teleduc 4

Teleduc v4

Aqui vai um breve relato da experiência de instalação e desenvolvimento do tipo third-part do Teleduc v4. As minhas recomendações já foram passadas diretamente a equipe do NIED (Núcleo da Unicamp responsável pelo desenvolvimento do sistema). Enquanto as recomendações não são aplicadas, segue um pequeno passo-a-passo para ajudar a quem venha se interessar.

Encontrando o documento
1. Após uma busca simples no Google por ‘instalação teleduc’, encontrei o link do pdf no NIED referente ao procedimento de instalação.

2. Ao clicar no primeiro link, ganhei um 404 para o endereço: http://fenix.nied.unicamp.br/repositories/entry/teleduc/instalacao/Guia_de_Instalacao.pdf

3. No segundo resultado, tive sucesso, para o link http://www.teleduc.org.br/downloads/Guia_de_instalacao.pdf

Processo de instalação
3.1 Ao abrir o documento, senti falta de um formato formal ao documento, uma vez que é feito pelo pessoal do NIED. Acho que ficaria legal se o manual técnico tive ao menos, o logotipo do produto, bem como do NIED, criando uma identidade que faça menção aos criadores.

3.2 Ao passar pela instalação do LAMP, coloquei uma sugestão de inserir o link para o Bitnami Stack. Esse produto, gratuíto e opensource, traz um appliance pronto para ser colocado em produção, ao invés de ter que ter acesso a super usuário da máquina e instalar diretamente na árvore do sistema operacional, gerando possíveis conflitos. Ex: Possuo 3 ou 4 softwares que utilizam a pilha LAMP, e alguns deles só rodam com versões específicas de PHP e MySQL. Instalei 4 pilhas da Bitnami e configurei os bancos e apaches em portas diferentes, viabilizando tudo em uma máquina só. O site do Bitnami é: http://bitnami.org/ . Apenas complementando, pelo que vi no código fonte, o Teleduc usa variáveis globais do PHP. Unir esse aspecto ao fato do software rodar como superusuário, é gerar um grande backdoor no servidor que rodará o aplicativo.

3.3 Na seção seguinte, o manual me instrui a criar um usuário ‘teleduc’, específico para rodar a aplicação. Esse passo poderia ser comentado, explicando sua importância.

3.4 Antes desse passo, as versões do softwares envolvidos também poderiam ser especificadas para melhorar o entendimento de qual ambiente escolher para instalar. Problema exemplo que tive: nenhum dos arquivos .php do software possui diretivas explícitas do PHP. Para tal, é necessário adicionar diretivas de short_open_tag = On no arquivo de configuração do PHP.ini.

3.5 O manual técnico não menciona que será necessário instalar e configurar o sendmail para que o software envie emails automaticamente. Particularmente, o sendmail é muito complicado, de difícil configuração, e muito provavelmente leva seu email diretamente para a caixa de spam do destinatário (alunos e cordenadores de custo). Nesse ponto, seria muito legal poder informar um endereço de servidor SMTP, para que o Teleduc o use para enviar os emails. Dá pra fazer isso via sendmail (teleduc > sendmail > servidor smtp > destinatário), mas também é de difícil configuração.

Um outro ponto é que, durante a configuração do Teleduc (as páginas que configuram o banco/conexões/etc), não explicitam como os links enviados por email ficarão de acordo com o endereço de hospedagem do teleduc. Por exemplo, após uma série de tentativas e erros, consegui configurar isso no nosso servidor, que tem o teleduc disponível via: http://———-:8085/teleduc, para enviar os links corretos por email. Outro problema é o remetente, que inicialmente veio como: NAO_RESPONDA@——-“:8085@heaven.ampliato.com.br (???)

ps: —— é a url do host, ex: asd.asd.com.br

3.6 As configurações do httpd.conf não são explicadas, e para um responsável de TI, que visa segurança de dados, fica difícil pois ele vai ter que procurar cada diretiva e entender o que faz, para garantir que vai funcionar.

3.7 No item 4, a url da aplicação pode não ser aquela especificada, dependendo da instalação. Vale uma explicação de como ela é montada.

3.8 Para finalizar o manual, acredito que valeria a pena colocar um glossário no documento, além de uma seção de erros comuns, como os que eu reportei aqui.

Suporte e canal de ajuda
4. Houve diversos pontos de dúvida durante o processo de instalação, e senti falta de uma referência ao grupo de desenvolvimento do projeto, ou o responsável com que eu pudesse tirar dúvidas. No mundo opensource é muito comum haver canais de comunicação com os responsáveis do software. Para isso, sugiro:

4.1 Lista de emails pública para desenvolvedores e para usuários, ex: teleduc-dev@googlegroups.com e teleduc-users@googlegroups.com

4.2 Canal de IRC em algum servidor público, como a Mozilla (irc.mozilla.org), ou o Freenode (irc.freenode.net). É só mandar um email aos administradores solicitando a criação de uma sala. Muita gente utiliza o IRC para desenvolver remoto. Muita mesmo.

4.3 Sistema de tracker para abertura de bugs. Aqui, vale a pena citar o Redmine ou o Trac, que são ferramentas muito boas para esse trabalho.

4.4 Sistema de forum para discussões com a comunidade, além de notificações, publicações e dúvidas abertas.

Desenvolvimento third-part.
5. Quando iniciei o desenvolvimento da integração, busquei por documentos que mostrassem como a base foi modelada, como o software foi construído, e quais são os conceitos que ele emprega. Não tivemos sucesso nesse processo, e vale comentar:

5.1 No site, há menção a um documento chamado teleduc-v3.0-documentacao.tar.gz mas o link é inválido. Após diversas consultas no Google, o encontramos no ftp de uma outra universidade. A documentação está incompleta, contendo somente os MERs, e da versão antiga. Não encontramos um equivalente para a versão 4, que estamos utilizando. O link é: ftp://ftp.fja.edu.br/ead/teleduc/teleduc-v3.0-documentacao.tar.gz

5.2 Não encontramos diagramas de sequência/atividade que pudesse mostrar como o software funciona, nem como os arquivos-fonte são utilizados5.3 Não encontramos nenhum documento oficial que possa nos ajudar em relação aos conceitos do Teleduc. O que chegamos mais perto foi um manual de usuário de uma outra universidade: http://www.unilasalle.edu.br/canoas/ftp/ead/Teleduc.Manual%20Usuario.pdf , que mostra alguns dos conceitos básicos da ferramenta, mas também não cobre detalhes técnicos sobre qual a versão, e demais dados.Consegui algum sucesso no desenvolvimento da integração via tentativa/erro, e entendendo como as coisas se comportam dentro da base de dados. Como são bancos diferentes em cada curso, ficou mais simples de entender a organização.

Caso o leitor ainda esteja tendo problemas, não deixe de comentar.