Instalação

As distribuições binárias e código fonte do servidor estão disponíveis no repositório SourceForge (http://sourceforge.net/projects/calypte). A pronta disponibilidade do código fonte permite-lhe depurar o servidor, aprender seu funcionamento interno e criar versões personalizadas para seu uso pessoal ou empresarial.

Pré-requisitos

Antes de instalar e executar o servidor, verifique o seu sistema para certificar-se de que você tem uma instalação funcional do JDK 1.5+. A maneira mais simples de fazer isso é executar o comando java -version para assegurar que o executável java está acessível e que está utilizando a versão 1.5 ou superior.

Não importa o local de instalação do calypte em seu sistema. Evite instalar o calypte em um diretório com nome que contenha espaço, pois pode causar problemas. Não existe nenhuma exigência para o acesso root na execução do calypte em sistemas UNIX/Linux.

Obtendo os arquivos binários

O mais recente lançamento do calypte está disponível na página de arquivos do calypte no SourceForge (http://sourceforge.net/projects/calypte). Você também vai encontrar versões anteriores, bem como beta e candidatos a futuras versões.

Instalando o pacote binário

Depois de obter o arquivo binário que deseja instalar, use uma ferramenta para descompactar arquivos no formato ZIP para extrair o conteúdo do arquivo scalypte-x.y.z.v.zip em um local de sua escolha. O processo de extração criará o diretório scalypte-x.y.z.v.

Instalando no Microsoft Windows e Linux

Para instalar o calypte:

Após concluir o download do arquivo ZIP, extraia-o em qualquer pasta do sistema.
- Para Windows, o arquivo executável do instalador tem a extensão .bat. Clique duas vezes no arquivo para o executar.
- Nas plataformas Linux, o arquivo do instalador tem a extensão .sh. Nessas plataformas, é preciso criar o arquivo executável do instalador usando este comando: chmod +x setup.sh. Digite ./setup.sh para executar o instalador.
Selecione a pasta de destino. Por padrão, o servidor é instalado na pasta do usuário.
Clique em próximo.
Se a instalação for feita no windows, é permitido selecionar o grupo do menu iniciar que serão inseridos os atalhos.
Clique em próximo.
Confirme se o servidor deve ser iniciado junto com o sistema operacional.
Clique em próximo.
Selecione o tipo de instâcia a ser executado:
- Developer Machine: Escolha esta opção para uma estação de trabalho típico onde o calypte é apenas para uso pessoal. Supõe-se que muitas outras aplicações desktop estão em execução. O servidor calypte será configurado para utilizar o mínimo de recursos do sistema.
- Server Machine: Escolha esta opção para uma máquina servidor onde o servidor calypte está rodando ao lado de outros aplicativos servidores, FTP, e-mail e servidores Web. O servidor calypte será configurado para usar uma porção moderada dos recursos do sistema.
- Dedicated Server Machine: Escolha esta opção para uma máquina servidor que se destina a executar apenas o servidor calypte. Supõe-se que não existem outras aplicações em execução. O servidor calypte será configurado para usar todos os recursos disponíveis do sistema.
Clique em próximo.
Revise as configurações da instalação.
Clique em instalar.
Aguarde o fim da instalação e clique finalizar.

Pacote Independente de Plataforma

Para executar o software:

Após fazer download do arquivo ZIP independente de plataforma, extraia-o em qualquer pasta do sistema.
Execute java -jar setup.jar.
Selecione a pasta de destino. Por padrão, a servidor é instalado na pasta do usuário.
Clique em próximo.
Selecione o tipo de instâcia a ser executado:
- Developer Machine: Escolha esta opção para uma estação de trabalho típico onde o calypte é apenas para uso pessoal. Supõe-se que muitas outras aplicações desktop estão em execução. O servidor calypte será configurado para utilizar o mínimo de recursos do sistema.
- Server Machine: Escolha esta opção para uma máquina servidor onde o servidor calypte está rodando ao lado de outros aplicativos servidores, FTP, e-mail e servidores Web. O servidor calypte será configurado para usar uma porção moderada dos recursos do sistema.
- Dedicated Server Machine: Escolha esta opção para uma máquina servidor que se destina a executar apenas o servidor calypte. Supõe-se que não existem outras aplicações em execução. O servidor calypte será configurado para usar todos os recursos disponíveis do sistema.
Clique em próximo.
Revise as configurações da instalação.
Clique em instalar.
Aguarde o fim da instalação e clique finalizar.

Desinstalando o Calypte

Siga as instruções nesta seção para desinstalar o servidor do seu sistema. Estas instruções de desinstalação se aplicam a todas as plataformas compatíveis.

Microsoft Windows

Se necessário, é possível desinstalar o Calypte utilizando os procedimentos a seguir.

Faça shutdown do Servidor.
No menu iniciar procure por Calypte ou Calypte Uninstaller. Clique duas vezes em Calypte Uninstaller.
Confirme a desinstalação.

Linux

Se necessário, é possível desinstalar o servidor utilizando os procedimentos a seguir.

Faça shutdown do Servidor.
No menu iniciar procure por Calypte ou Calypte Uninstaller. Clique duas vezes em Calypte Uninstaller.
Confirme a desinstalação.

Pacote Independente de Plataforma

Para desinstalar os arquivos do servidor, execute java -jar uninstaller.jar.

Teste básico de instalação

Depois de ter instalado o calypte, é aconselhável realizar um teste de inicialização simples para verificar que não há grandes problemas com a sua combinação de Java VM e sistema operacional. Para testar a instalação, vá para o diretório raiz e execute

java -jar scalypte-x.y.z.v.jar

Se nenhuma mensagem for exibida, significa que o servidor iniciou normalmente.

Estrutura de diretórios

A extração do arquivo ZIP cria o diretório scalypte-x.y.z.v que contém scripts de inicialização do servidor, JARs e arquivos de configuração.

Diretório	Descrição
data	Local onde os dados do cache são persistidos. Pode ser alterado.
lib	O diretório lib é o local onde ficam todas as bibliotecas usadas pelo servidor.
tx	Local onde as informações sobre as transação são persistidas.

Arquivo de configuração

No diretório raiz da instalação contém o arquivo calypte.conf. Nele contém toda a configuração do servidor.

Abaixo segue a tabela com todas as opções de configuração:

Variável	Descrição
port	Porta TCP/IP que o servidor calypte usa para escutar
max_connections	Quantidade máxima de sessões que o calypte permite.
timeout_connection	Timeout das conexões em milisegundos.
write_buffer_size	Tamanho do buffer de escrita
read_buffer_size	Tamanho do buffer de leitura
data_path	Local onde se faz a troca dos dados quando o limite da memória é atingido
nodes_buffer_size	Tamanho do buffer usado para armazenar os nós na memória
nodes_page_size	Tamanho da página do buffer de nós.
index_buffer_size	Tamanho do buffer usado para armazenar o índice dos itens na memória
index_page_size	Tamanho da página do buffer de índices.
data_buffer_size	Tamanho do buffer usado para armazenar os itens na memória
data_page_size	Tamanho da página do buffer de itens
data_block_size	Tamanho do bloco de dados.
data_swap_factor	Fator de swap dos itens.
max_size_entry	Tamanho máximo em bytes que um item pode ter para ser armazenado no cache.
max_size_key	Tamanho máximo em bytes que uma chave pode ter.
transaction_support	Permite usar o suporte transacional. Pode assumir true ou false.
transaction_timeout	Define o tempo máximo em milissegundos que uma operação pode demorar.
transaction_manager	Gestor das transações no cache.
memory_access_type	Método de leitura e escrita dos dados na memória. Pode ser heap ou unsafe
backlog	Tamanho máximo da lista de espera por conexões. Tamanho mínimo é 50.
address	Endereço do servidor.
reuse_address	Permite reutilizar as conexões. Pode assumir true ou false. O valor padrão é false.
compress_stream	Ativa ou desativa a compressão de dados.