Instruções de Instalação

Requerimentos de sistema:

• Sistema Operacional: Linux (Kernel 2.4 ou superior com glibc6). As seguintes distribuições são suportadas: Mandrake Linux versão 8.1 até 10.2; Mandriva 2006 ao 2007; Red Hat Linux versão 7.3 até 9.0; Fedora Core 1 ao 6, SuSE Linux versão 7.2 até 10.1; Debian 3.0 (Woody) e Debian 3.1 (Sarge); Ubuntu 5.04 (Hoary Hedgehog), 5.10 (Breezy Badger), 6.06 (Dapper Drake), 6.10 (Edgy Eft); CentOS 4.1 ao 4.4
• Servidor Web Apache versão 1.3.12 ou superior / 2.0.40 ou superior
• Sendmail ou Postfix
• Procmail
• Pacote de Cotas
• ProFTP versão 'standalone' ou vsftpd como inetd/xinetd/standalone
• PHP 4.0.5 ou superior como modulo Apache
• Banco de dados MySQL
• Daemon POP3/IMAP que suporte o tradicional formato de caixa de correio UNIX (ex: gnu-pop3d, qpopper, ipop3d, popa3d ou vm-pop3d) ou o formato Maildir (ex: Courier-Imap)
• OpenSSL e mod_ssl para a criacao de hosts virtuais SSL
• BIND8 / BIND9
• iptables ou ipchains
• gcc e cpp, os compiladores c e c++

Exemplos de configuração do Sistema Operacional:

Examplos de configuração do Sistema Operacional em que o ISPConfig funciona perfeitamente:

• CentOS 4.3: http://www.howtoforge.com/perfect_setup_centos_4.3
• CentOS 4.4: http://www.howtoforge.com/perfect_setup_centos_4.4
• Debian Woody (3.0): http://www.howtoforge.com/howto_linux_debian_server_setup
• Debian Sarge (3.1): http://www.howtoforge.com/perfect_setup_debian_sarge
• Debian Sarge (3.1) on a Strato Server: http://www.howtoforge.com/perfect_setup_debian_sarge_strato
• Fedora Core 3: http://www.howtoforge.com/perfect_setup_fedora_core_3
• Fedora Core 4: http://www.howtoforge.com/perfect_setup_fedora_core_4
• Fedora Core 5: http://www.howtoforge.com/perfect_setup_fedora_core_5
• Fedora Core 6: http://www.howtoforge.com/installing_a_lamp_system_with_fedora_core_6
• Mandrake/Mandriva 10.2: http://www.howtoforge.com/perfect_setup_mandrake_10_2
• Mandriva 2006 Free: http://www.howtoforge.com/perfect_setup_mandriva_2006
• Mandriva 2007 Free: http://www.howtoforge.com/perfect_setup_mandriva_2007
• SuSE 9.2: http://www.howtoforge.com/perfect_setup_suse_9.2
• SuSE 9.3: http://www.howtoforge.com/perfect_setup_suse_9.3
• SuSE 10.0: http://www.howtoforge.com/perfect_setup_suse_10.0
• SuSE 10.1: http://www.howtoforge.com/perfect_setup_suse_10.1
• Ubuntu 5.04: http://www.howtoforge.com/perfect_setup_ubuntu_5.04
• Ubuntu 5.10: http://www.howtoforge.com/perfect_setup_ubuntu_5.10
• Ubuntu 6.06: http://www.howtoforge.com/perfect_setup_ubuntu_6.06
• Ubuntu 6.10: http://www.howtoforge.com/perfect_setup_ubuntu_6.10

Instalação:

Dica: Com a instalação do ISPConfig, alguns arquivos de sistema são substituídos onde ajustes foram feitos. Isto pode levar a perca de entradas no named.conf bem como na configuração do Sendmail/Postfix.

Importante: ISPConfig foi feito para ser instalado em novas instalações do Linux sem websites. Se você já possui vários websites hospedados em um servidor e precisa de um painel de controle para os websites existentes, então ISPConfig não é adequado.
Antes de iniciar a instalação, certifique-se que os compiladores C e C++ estão instalados no servidor (gcc e cpp).

- Acesse o shell como super-usuário (root)

- Descompacte os arquivos de instalação:

  tar xvfz ISPConfig*.tar.gz

- Entre no diretório install_ispconfig:

  cd install_ispconfig

Neste diretório, leia o arquivo dist.txt e veja se os valores dados se enquadram na sua instalação Linux (são adequados para a maioria da instalações padrões) Se você modificar algum valor, atenção para não modificar o formato do arquivo.

- Inicie o script de instalação:

  ./setup
 
O programa de instalação irá compilar uma versão do Apache com PHP5 que irá rodar na porta 81, que será usado pelo ISPConfig. Isso não irá interferir com o Apache existente.

Importante: Certifique-se que você tem instalados no sistema gcc, flex e todas a ferramentas necessárias para compilação de fontes antes de executar ./setup! Você vai precisar instalar os arquivos de cabeçalho do MySQL que normalmente estão em um pacote chamado mysql-devel, mysql-dev, libmysql-devel ou similar. Caso contrário o PHP5 não irá compilar, e a instalação do ISPConfig falha.
Durante a compilação do Apache para o ISPConfig, um cerrtificado SSL personalizado será criado. Conseqüentemente você terá que responder algumas perguntas. Você pode aceitar os valores padrões ou entrar com novos valores, isto não é importante:

- Em step 7 ("Encrypting RSA private key of CA with a pass phrase for security [ca.key]") e step 8 ("Encrypting RSA private key of SERVER with a pass phrase for security [server.key]") da criação do certificado, você será perguntado se quer criptografar a respectiva chave. Escolha 'n' porque caso contrário, você terá que digitar a senha toda vez que reiniciar o ISPConfig o que quer dizer que o sistema não poderá reiniciar sem interação humana.

Se a compilação falhar, o programa de instalação para e todos os arquivos compilados são removidos. A mensagem de erro dirá a razão da falha (normalmente um pacote não encontrado (ex: arquivos de cabeçalho do MySQL não instalados). Resolva o problema e re-execute ./setup.

Completada a compilação com sucesso, a instalação continua:

Please choose your language. Aqui você escolhe o idioma da interface do ISPConfig.

em seguida, será mostrada a licença do ISPConfig (Licença BSD). Por favor, leia-a cuidadosamente. Caso concorde com os termos, pressione "y" para aceitart e continuar. Se você não quiser aceitar a licença, pressione "n" e o programa de instalação será interrompido.

Installation Mode. Aqui você seleciona o modo de instalacão. Você pode escolher o modo padrão (standard) ou expert.

No modo padrão, o programa de instalação assume os valores padrões para a distribuição Linux instalada e repassa para o ISPConfig.

No modo expert, o programa de instalação propõe os valores padões para a distribuição Linux instalada, os quais você pode confirmar ou editar.

Em circunstancias normais, o modo padrão deve atender suas necessidades.

O programa de instalação verifica se o seguinte software está instalado::

• Apache,
• Mail Transport Agent (MTA): Sendmail ou Postfix,
• Procmail,
• Quota,
• MySQL,
• ProFTP ou vsftpd,
• OpenSSL,
• Bind8 / Bind9,
• iptables ou ipchains.

Se algum dos pacotes não estiver presente, o programa de instalação será interrompido. Instale o pacote não encontrado, apague o diretório install_ispconfig,descompacte o ISPConfig novamente e comece a instalação desde o início.

A sintaxe do arquivo de configuração do Apache será também verificada. A instalação será interrompida se algum erro for encontrado.

Se todas as condições forem atendidas, você terá que responder algumas perguntas essenciais para o ISPConfig::

Please enter your MySQL server: E.G. localhost
Please enter your MySQL user: E.G. root
Please enter your MySQL password: Your MySQL password
Please enter a name for the ISPConfig database: E.g. ispconfigdb
Please enter the IP address of the ISPConfig web: E.g. 192.168.0.1
Please enter the host name: E.g. www
Please enter the domain: E.g. xyz.de
Please select the protocol (http or https (SSL encryption)) to use to access the ISPConfig system: If you want to use your control panel with SSL, select 1. You can then access it under https://www.xyz.de:81. If you want to access it under http://www.xyz.de:81, choose 2.

Após respondidas as perguntas, o ISPConfig estará instalado. Se você indicou www como host e xyz.com como domínio, você poderá conectar-se a interface do ISPConfig por https://www.xyz.de:81 ou http://www.xyz.de:81

Usuário: admin
Senha..: admin

É recomendável modificá-la imediatamente! Para modificar a senha, vá no menu TOOLS -> CHANGE PASSWORD.

Se o seu servidor tem mais de 1 endereçoi IP, verifique se os endereços
adicionais foram detectados corretamente: Vá em MANAGEMENT -> Server -> Properties in the register Server -> IP list.

SpamAssassin

O ISPConfig instala o SpamAssassin, mas não os módulos Perl necessários pelo SpamAssassin.

Execute o seguinte comando após a instalação do ISPConfig:

/home/admispconfig/ispconfig/tools/spamassassin/usr/bin/spamassassin

Se aparecer algum erro, você deve instalar alguns módulos Perl.

# perl -MCPAN -e shell

cpan> install HTML::Parser
cpan> install DB_File
cpan> install Net::DNS (se perguntado para 'enable tests', escolha 'no')
cpan> install Digest::SHA1

Para sair do shell do Perl, digite: q

Se o comando

/home/admispconfig/ispconfig/tools/spamassassin/usr/bin/spamassassin

não mostrar nenhuma mensagem de erro, tudo está correto. Você pode sair do SpamAssassin pressionando: " CTRL + C "

Referências Gerias

* Linux Quota

Se o pacote de cotas estiver instalado, os seguintes passos são necessários após a instalação: (O exemplo assume que você quer aplicar cotas para o diretório /home na partição /dev/hda6)

- Edit o arquivo /etc/fstab e procure pela entrada na qual o diretório /home é mencionado. por exemplo: /dev/hda6/home ext2 default 1 2

- Adicione as palavras usrquota e grpquota como no exemplo:

  /dev/hda6 /home ext2 defaults,usrquota,grpquota 1 2

- Crie os arquivos aquota.user e aquota.group no diretório /home:

  touch /home/aquota.user

  touch /home/aquota.group

- Mude as permissões nos novos arquivos:

  chmod 600 /home/aquota.*

- Reinicie o servidor:

  shutdown -r now

- Após reiniciar, verifique e ative o pacote de cotas:

  quotacheck -avugm

  quotaon -avug