A instalação e configuração do KyaPanel em si é bem simples, entretanto sua função é interagir com várias outras ferramentas (LDAP, Courier, Postfix, eGroupWare, Munin, etc ) e isso faz com que a instalação e configuração seja um pouco mais trabalhosa. Se você não esta familiarizado com essas ferramentas poderá seguir passo-a-passo este documento, mas deverá ao menos, saber o que esta fazendo.

A equipe de desenvolvimento do KyaPanel tem se esforçado muito para automatizar ao máximo o processo de instalação, se você seguir estes passos o sistema deverá funcionar, em caso de dúvidas cadastre-se na lista de discussão de usuários do KyaPanel e envie uma mensagem.

E o endereço para se cadastrar na lista de discussão é:

http://list.kyapanel.com/cgi-bin/mailman/listinfo/kyapanel

Instale as dependências usando o comando abaixo:

aptitude install bc slapd apache2 ldap-utils libapache2-mod-php5 libpam-ldap libdb4.8 phpldapadmin php5-ldap php5-cgi db4.8-util postfix-ldap courier-base courier-imap courier-ldap courier-pop courier-authdaemon libfile-tail-perl librrds-perl librrd4 heirloom-mailx maildrop munin munin-node gettext rrdtool sqlite samba samba-common smbclient smbfs tcputils xinetd bc maildrop uudeview ytnef

Irá instalar todos os pacotes necessários de acordo com o que estiver pré-instalado no sistema, como o apache por exemplo.

O sistema de configuração do Debian/Ubuntu lhe fará algumas perguntas para configurar o servidor LDAP, Postfix e outros. É importante saber o que você esta fazendo (isto não pretende ser um tutorial de LDAP, mas um guia para instalar o KyaPanel).

Na configuração do Phpldapadmin selecione a autenticação por “session” e em seguida o servidor apache no qual deseja que ele seja executado.

Neste momento você já deverá ter o slapd e apache+php funcionando.

Devido ao grande número de pessoas que ainda não estão íntimas desta base de dados, aqui vai um passo a passo de como o pacote slapd deve ser configurado.

• Passo 1

A primera dependência, para que sua base LDAP fique organizada é ter o nome da máquina bem definido. Isso significa que você deve seguir o esquema da internet, onde o nome do servidor é formado por duas partes: nome.domínio

Um exemplo para ficar bem claro:

     server.kyapanel.net

Assim server é o nome e kyapanel.net é o domínio.

Para ter certeza de que sua configuração está assim, verifique os seguintes arquivos:

• /etc/hosts

Você deverá encontrar uma linha contendo o seguinte formato:

endereço_ip    nome.domínio    domínio

Exemplo: 200.23.186.7 server.kyapanel.net kyapanel.net

• /etc/hostname

Você deverá encontrar uma linha contendo o seguinte formato:

nome.domínio

Exemplo: server.kyapanel.net

• Passo 2

Depois de ter arrumado os arquivos acima, reinicie a máquina ou execute o seguinte comando:

hostname nome.domínio

Exemplo: hostname server.kyapanel.net

• Passo 3

Agora que tudo está OK, então execute o comando:

dpkg-reconfigure slapd

A tela de configuração vai se abrir e perguntar a senha do administrador.

Pronto! O seu LDAP está pronto para a instalação do KyaPanel

Copie o arquivo kyapanel-0.XX.tar.gz para o DocumentRoot do seu Apache. No Debian /var/www. Depois use o comando:

tar -zxvf kyapanel-xxxxxxx.tar.gz

Será então criado um diretório kyapanel. Depois disso acesse pelo seu browser preferido o endereço http://localhost/kyapanel/ que irá redirecionar você para:

Este aplicativo realizará uma checagem das configurações básicas para que o KyaPanel possa ser instalado a saber:

   1. Versão instalada do PHP;
   2. Instalação inicial;
   3. Servidor LDAP

Se problemas forem detectados, o instalador irá propor a solução. Depois de fazer as configurações sugeridas a página Instalação do KyaPanel deverá ser recarregada para que as checagens sejam feitas outra vez.

Depois que todas as checagens sejam bem sucedidas lhe será apresentado um formulário com as opções de instalação do KyaPanel. Estas opções, todas, serão armazenadas no arquivo /etc/jegue.conf e podem ser alteradas, no futuro, em qualquer momento.

Cada opção tem uma ajuda on-line explicado para que server cada uma delas. Em caso de dúvida consulte a ajuda on-line.

Depois que as opções de instalação foram preenchidas clique no botão Instalar e você será redirecionado para a página de login do Jegue.

Assim que o primeiro login for bem sucedido é fundamental ativar os módulos que serão usados. O KyaPanel, atualmente, disponibiliza dois módulos:

• Mail - Para gestão de servidore de e-mail;
• Samba - Para gestão de servidores de autenticação Samba

Para ativar um módulo siga esta sequência:

  1. Configurações Globais;
  2. Ativar/Desativar Módulo;
  3. Faça sua seleção;
  4. Clique no botão Alterar

Depois de ter ativado os módulos é hora de configurar os demais serviços que compõe o sistema.

Apenas o módulo Mail tem outrso serviços para serem configurados.

Para ter acesso à configuração dos demais serviços siga esta sequência:

  1. Gestão de E-mail
  2. Configurações Gerais

Nessa tela você poderá configurar os seguintes serviços:

• Postfix;
• Courier;
• Egroupware;
• ClamAV;
• SpamAssassin; e
• O prórpio KyaPanel

Detalhes sobre cada uma dessas opções, podem ser encontradas no Guia do Administrador

Para ver a relação dos problemas mais comuns e suas soluções, visite o Guia de Problemas e Soluções