Instalação do Teleduc

Guia de instalação manual – TelEduc 4.3.1

O guia de instalação manual visa auxiliar o administrador do sistema, passo a passo, em todas as etapas de instalação do TelEduc.
Alternativamente há um script automático para a configuração do ambiente que faz todos os comandos listados aqui.
Caso queira utiliza-lo, procure o mesmo na página do site (www.teleduc.org.br/pagina/script_instalacao/).

Requisitos:

Para prosseguir com a leitura deste guia é necessário fazer o download de uma versão estável do TelEduc disponível na página de downloads do site www.teleduc.org.br/?q=downloads. Relize o download do arquivo compactado na pasta /home/seu_nome_de_usuario .

Instalação:

Passo 0: Instalação e checagem das dependências
A instalação só terá inicio se todas as dependências do TelEduc estiverem propriamente instaladas. As dependências são as seguintes:

MySQL
Apache
Lynx
Sendmail
PHP (não deve ser posterior a versão 5.3.x)
Abaixo seguem as sugestões de instalação dos pacotes Sendmail e Lynx, os demais devem estar propriamente instalados. No caso do PHP será necessário buscar em algum repositório específico ou compilar o código fonte.

Sugestões de comandos:
Como root, executar:

Fedora:

yum install sendmail
yum install lynx
service httpd restart

Ubuntu:
apt-get install sendmail
apt-get install lynx
/etc/init.d/apache2 restart

1ª Passo: Criação do usuário teleduc

A fim de centralizar a manutenção do TelEduc, a criação de um novo usuário exclusivo para executar as tarefas relacionadas ao ambiente é recomendada. Apesar de não ser obrigatória, os demais passos deste tutorial supõem que a criação deste usuário foi feita. Caso você decida não criar um novo usuário, você deverá adaptar os próximos passos da instalação para que o TelEduc seja instalado no home do seu usuário de preferência. Caso você decida criar este usuário, execute os seguintes comandos:

useradd teleduc
passwd teleduc

Após a criação do usuário, é necessário que você mova os arquivo baixado para a pasta home do usuário teleduc. Para isso, execute o seguinte comando:

cp teleduc*.tar.gz /home/teleduc

Agora você precisa deixar explícito para o sistema operacional que o arquivo compactado pertence ao usuário teleduc. Execute:

chown teleduc /home/teleduc/teleduc*.tar.gz

2º Passo: Definição de senha do MySQL

Para a segurança da sua instalação é altamente recomendado trocar a senha padrão do MySQL. Ignore se durante a instalação já foi definida uma senha segura. Caso você deseje criar uma senha, execute:

mysqladmin -u root password <NOVA SENHA>

3º Passo: Extração dos arquivos

Nesse passo o TelEduc vai ser extraído na pasta padrão dessa instalação, se optou por escolher outro nome de usuário, fique atento as menções de “/home/teleduc/public_html” para alterá-las adequadamente.

Sugestões de comandos:
Geral:

cd /home/teleduc
mkdir public_html
tar -C public_html -xzf teleduc*.tar.gz
rm teleduc*.tar.gz

4º Passo: Configuração do Apache

Nesse passo será dada permissão de acesso à pasta teleduc e serão liberadas as tags e flags necessárias para o correto funcionamento do ambiente. É , sem dúvida, o passo com mudanças mais drásticas entre as distribuições, se a sua não se encontra na lista de sugestões de comandos é recomendado procurar auxílio em forums e/ou listas de e-mail relacionadas.

Procedimentos sugeridos:
Como Root:
Geral:

Fedora: gedit /etc/php.ini
Ubuntu: gedit /etc/php5/apache2/php.ini

Altere as seguintes flags e se o item não for encontrado apenas inclua a versão alterada:

default_charset = "UTF-8" para default_charset = "" 
magic_quotes_gpc = Off para magic_quotes_gpc = On
register_globals = Off para register_globals = On

Além do que á foi feito, são necessárias alterações específicas.

Fedora:
Abra o arquivo httpd.conf usando o editor de textos de sua preferencia, neste caso estou usando o gedit. Lembre-se de executar os seguintes comandos como root:

gedit /etc/httpd/conf/httpd.conf

No arquivo, procure a linha “UserDir disable” e comente-a adicionando o caracter "#" ao início da linha( “#UserDir disable” ).
Logo abaixo descomente a linha “#UserDir public_html” ( deixando-a como “UserDir public_html” ).
Salve as alterações e retorne ao terminal.
Para que as alterações sejam efetivadas, reinicie o servidor:

service httpd restart

Ubuntu:
Execute o comando para instalação do módulo:

sudo a2enmod userdir

E reinicie o servidor:
/etc/init.d/apache2 restart

5º Passo: Ajuste de Permissões

Agora precisamos permitir que o apache leia e escreva em determinadas pastas. Também é nesse passo que definimos a pasta onde ficarão os arquivos enviados por usuários do TelEduc, é importante que essa pasta fique fora da pasta compartilhada ( public_html ) para evitar acessos indesejados ao conteúdo.
Sugestões de comandos:
Como Root:

Geral:

chmod 711 /home/teleduc
chmod 755 /home/teleduc/public_html

Fedora:

chown apache:apache /home/teleduc/public_html/teleduc4
chown apache:apache /home/teleduc/public_html/teleduc4/cursos/aplic/bibliotecas
chown apache:apache /home/teleduc/public_html/teleduc4/cursos/diretorio

Ubuntu:

chown www-data:www-data /home/teleduc/public_html/teleduc4
chown www-data:www-data /home/teleduc/public_html/teleduc4/cursos/aplic/bibliotecas
chown www-data:www-data /home/teleduc/public_html/teleduc4/cursos/diretorio

Por último, dentro da pasta "cursos", você deve criar um diretório com o nome "diretório"

mkdir /home/teleduc/public_html/cursos/diretorio

6º Passo: Configuração via browser

As configurações de ambiente e instalação foram concluídas. Agora acesse o seguinte link via browser e termine a configuração pelo endereço:

Formato:

<nome-da-máquina>/~<nome-do-usuario>/instalacao

Exemplo:
europa/~teleduc/instalacao