Ferramentas (kac-1.0.0)

Copyright (c) 2006 Fábio Lucena (fabio@inf.ufg.br) (licença GPL)
Veja “política de uso”, “instalação” e outros detalhes logo após a tabela abaixo.

Política de uso
Ao criar código ou realizar alguma tarefa de manutenção em código, primeiro identifique a versão do Kad apropriada. Esta identificaria deveria estar claramente definida para as atividades a serem executadas. Se for o caso, obtenha a versão correspondente e a instale antes de proceder com a execução das atividades. Deve estar claro para todos os desenvolvedores que não é permitido o uso de ferramenta que não faça parte do Kad. Também convém ressaltar que a presença de uma ferramenta no Kad não é suficiente, pois também é necessário observar a versão da ferramenta.

Dependências
O Kap depende do Kaa (pois este oferece suporte de software) e do Kaf (que oferece a infra-estrutura física onde é executado). Sem o Kaa não é possível usufruir sem restrições dos serviços disponibilizados pelas ferramentas do Kad. Por exemplo, python (ferramenta do Kaa) é empregado pelo para gerar relatórios pelo Jester (ferramenta do Kad).

Distribuição e Instalação
O Kad possui duas distribuições, uma para Linux(r) e outra para Windows(r). A distribuição Linux faz uso dos arquivos kad-versao.tgz (arquivo contendo o Kad propriamente dito) e kad-versao.tgz.md5 (arquivo contendo o valor MD5 obtido do anterior). A distribuição Windows(r) faz uso dos arquivos da distribuição Linux e de outros dois: win-versao.zip e win-versao.zip.md5. Para que não haja dúvidas, usuários Linux precisam da dois arquivos, enquanto usuários Windows terão que fazer uso de quatro arquivos, os dois da distribuição Linux e outros dois específicos para o Windows.

• Linux

1. Descomprima o arquivo tgz. Para a versão 1.0.0 o comando é equivalente àquele fornecido abaixo, que cria o diretório kad-1.0.0.

   $ tar xfz kad-1.0.0.tar.gz

2. Edite o arquivo .bashrc (disponível no diretório $HOME). Será necessário acrescentar o conteúdo abaixo ao final deste arquivo, contendo a definição de duas variáveis de ambiente e a requisição para executar script de configuração do Kad. A variável KAD_HOME indica o diretório de instalação do Kad e a variável KAD_TMP indica o diretório padrão a ser empregado pelas ferramentas do ambiente para armazenamento temporário. O HSQLDB, por exemplo, usa a variável KAD_TMP para depositar nele bases de dados eventualmente criadas. Estas variáveis são empregadas pelo script kad.sh, que deve ser executado em toda janela de comandos na qual as ferramentas do Kad serão usadas.

# Linhas abaixo configuram o KAD
export KAD_HOME=/home/users/fabio/kad-1.0.0
export KAD_TMP=/tmp
. $KAD_HOME/bin/kad.sh

• Windows (ainda em experimentação)

  1. Descomprima o arquivo kad-versao.tgz no diretório onde será instalado o Kad. Observe que esta distribuição é aquela empregada para o Linux, mas que também contém inúmeras ferramentas compartilhadas para o ambiente Windows.

  2. Descompacte o arquivo win-versao.zip. Observe que isto deverá ser feito na raiz do diretório gerado pelo passo anterior. No passo acima foi gerado o diretório kad-versao. Copie o arquivo para a distribuição Windows para este diretório e simplesmente descomprima-o.

  3. Defina a variável de ambiente KAD_HOME. No painel de controle (Control Panel) selecione System e, neste, a tab Advanced e, por último, o botão Environment Variables irá conduzi-lo à janela onde será possível o acréscimo da variável KAD_HOME. O valor desta variável deve ser o diretório criado ao descompactar o arquivo de distribuição.

  4. Para abrir uma shell com acesso ao conjunto de ferramentas do Kad basta execute o prompt (CMD) conforme abaixo:

     cmd /K %KAD_HOME%\bin\kad.bat

Verificação
Abra uma nova shell. Você deverá ver algo como abaixo.

Ambiente de Desenvolvimento (KAD 1.0.0)
Copyright (c) 2006 Kyriosdata(r)

Versões futuras (planejamento)
Faça suas sugestões para o acréscimo de novas ferramentas, novas versões destas ferramentas, remoções ou erros através de http://sourceforge.net/projects/kyrios.

Editado pela última vez em 13/06/2006.