Índice

Sobre o Redis

...

O Redis é um banco de dados NoSQL open - source do modelo chave-valor em memória, que possui licenciamento BSD e que pode ser utilizado como cache para o Fluigfluig. Ele possui funcionalidades extras , como a possibilidade de ser utilizado em cluster com fail-over.tolerância a falhas (failover).

Pré requisito

...

• Ter o Redis instalado na máquina ou realizar o download do instalador nos links abaixo conforme o sistema operacional da máquina. 

Download do Redis

...

• O download do instalador do Redis para Linux

...

http://redis.io/download

Download do instalador para Windows

https://github.com/MSOpenTech/redis/releases

• pode ser realizado neste link.

• O download do instalador do Redis para Windows pode ser realizado neste link.

...

Instalação do Redis em Modo Single-Server

...

O modo single-server significa que apenas um processo do Redis está no ar. Mesmo neste modo ele pode atender mais de um servidor fluig, porém será considerado um ponto de falha.

Instalação do Redis como

...

Serviço em Linux

...

A forma sugerida de instalar o Redis em Linux é compilá-lo a partir dos fontes, pois não há outras dependências além do que um compilador GCC e da biblioteca libc.

...

Vamos supor que você já copiou os executáveis redis-server e redis-cli os executáveis em  em /usr/local/bin , ou executou o comando make install.

Crie os seguintes diretórios:

...

Copie o script de inicialização disponibilizado sob o no diretório utils para /etc/init.d. Sugerimos renomeá-lo com o nome da porta onde você está executando esta instância do Redis.

sudo cp utils/redis_init_script /etc/init.d/redis_6379

Edite o script de inicialização. Certifique-se de modificar o REDISPORT de acordo com a porta que você está usando. Tanto o caminho do arquivo pid e quanto o nome do arquivo de configuração dependem do número de da porta.

sudo vi /etc/init.d/redis_6379

Copie o arquivo de configuração do modelo que você vai encontrar encontrado no diretório raiz da distribuição Redis em /etc/redis/ utilizando o número da porta como nome:

...

Crie um diretório dentro de /var/redis que funcionarão funcionará como os dados e diretório de trabalho para esta instância Redis:

...

• Altere a porta em conformidade. No nosso exemplo , não é necessário que , pois a porta padrão já é 6379.

...

• Definir o dir para /var/redis/6379 (passo muito importante!)

Instalação do Redis como

...

Serviço em Windows

...

Execute o seguinte comando:

redis-server.exe --service-install --service-name fluigcache redis.windows.conf

Configurando o Redis para uso com o

...

fluig

...

Memória

Procure no arquivo de configuração, o parâmetro maxmemory e certifique-se de configurar para o tamanho máximo desejado, caso contrário, podem ocorrer problemas de falta de memória.

maxmemory 1g

...

...

...

...

Persistência

Para que o Redis não salve um snapshot da memória de tempos em temposperiodicamente, procure as linhas iniciadas com a palavra "save" no arquivo de configuração:exemplo ...

...

save 900 1
save 300 10
save 60 10000

E altere ...e altere-as para:

# save 900 1
# save 300 10
# save 60 10000
save ""

Arquivo PID

Pra Para que o Redis grave um arquivo com o PID, sete defina o seguinte parâmetro:

daemonize yes

Configurando o

...

fluig para usar o Redis como

...

Cache

...

A configuração do servidor Redis no fluig pode ser realizada das seguintes formas:

• Arquivo configuration.properties, localizado em [Instalação fluig]\repository\wcmdir\config. Deve ser alterada a propriedade cacheServerAddress para "redis:

...

• [endereço IP]:[porta]" e o serviço precisa ser reiniciado para que a mudança seja aplicada;

• Alterar o parâmetro CACHE_SERVER_ADDRESS via API;

<simple name="java:global/wcm/cacheServerAddress" value="redis:127.0.0.1"/>

...

• Configuração via wcmadmin, caso o fluig já esteja no ar, através do Painel de controle → aba WCM → Configurações do Sistema → aba Parâmetros da Plataforma.

...

Configurando o Redis

...

em Ambientes de Alta Disponibilidade com Tolerância a Falhas

...

O Redis usa o modelo Master-Slave com um processo monitor chamado Sentinel.   Os passos indicados anteriormente continuam valendo para cada nó do cluster Redis.

Image Modified

Master

O nó Master não necessita de nenhuma configuração adicional além das configurações dos passos anteriores.

Slaves

Adicione a seguinte configuração (redis.conf) em cada nó Slavenó Slave:

slaveof <IP_MASTER> <PORTA_MASTER>

Exemplo:slaveof <masterIP> <masterPort>

slaveof 127.0.0.1 6379

Sentinel

O Sentinel oferece um modelo simples e automático de alta disponibilidade (HA) para Redis usando a estratégia de eleição caso o Master venha a falhar. Inicialmente, tem-se uma replicação do Master para N números um número indeterminado de Slaves.

Um processo Sentinel deve ser adicionado em cada um dos servidores que terão uma ou mais instancias dos instâncias do Redis para monitorar a execução dos processos e iniciar uma eleição para promover um Slave para Master caso o Master falhe.

...

• Crie um arquivo redis.sentinel.conf. 

• Defina a propriedade daemonize para "yes".

• Defina a propriedade sentinel monitor com o nome do cluster Redis e passe , informe o IP e Porta porta do Master e o quorum quórum de sentinelas. O quorum quórum é o número minimo mínimo de sentinelas que avaliam que o Master falhou para iniciar uma eleição. É importante usar o valor correto, pois um número inadequado vai impedir a eleição do novo Master.

Template:

daemonize yes
sentinel monitor NOME_DO_CLUSTER IP_MASTER PORTA_MASTER QUORUM
sentinel down-after-milliseconds NOME_DO_CLUSTER 10000

Exemplo:

daemonize yes
sentinel monitor fluigcache 127.0.0.1 6379 1
sentinel down-after-milliseconds fluigcache 10000

...

...

...

Instalando o Sentinel como serviço no Windows

...

O executável do Sentinel é o mesmo do servidor do Redis, exceto pelo parâmetro "--sentinel". 

redis-server.exe --service-install --service-name redissentinel redis.sentinel.conf --sentinel

Executar o Redis Sentinel em Servidor Linux

...

A partir da versão 3 o redis-sentinel é instalado por padrão junto do Redis. Para executar o Sentinel:

redis-sentinel /etc/redis/sentinel.conf

Sendo que /etc/redis/sentinel.conf é o arquivo de configuração padrão.

Configurando o fluig para usar o Redis Cluster com Sentinel como cache

...

Abra o arquivo configuration.properties, localizado em [Instalação fluig]\repository\wcmdir\config e modifique a propriedade cacheServerAddress, ou use a propriedade via API CACHE_SERVER_ADDRESS. O formato da configuração é "redisc:[nome_cluster]:[IP_Sentinel]:[Porta_Sentinel],[IP_Sentinel_2]:[Porta_Sentinel_2], etc.".

wcm/cacheServerAddress=redisc:NOME_DO_CLUSTER:IP_SENTINEL:PORTAL_SENTINEL

Exemplo:

wcm/cacheServerAddress=redisc:fluigcache:127.0.0.1:26379

Também é possível realizar esta configuração via wcmadmin, caso o fluig já esteja no ar, através do Painel de controle → aba WCM → Configurações do Sistema → aba Parâmetros da Plataforma.