ZRabbit - Instalação
O processo de instalação é feito em três etapas:
- Instalação do Zope 2.8.4
- Instalação do ZRabbit V2.0
- Instalação do Zope 2.6.4
- Instalação do ZRabbit V1.3
Instalação do Zope 2.8.4 (versão mais recente 2005)
Unix:
Faça download e descompacte o pacote do Zope (versão 2.8.4) e siga as instruções do arquivo README.txt:
- Siga as instruções do arquivo "doc/INSTALL.txt" para instalar o ZOPE.
- É recomendado fazer o build e install do Zope como usuário unix DIFERENTE do ROOT
- Normalmente são os passos: "./configure --prefix=/where/to/install/zope", "make" e "make install"
- Após a instalação é necessário a criação de uma INSTÂNCIA onde armazenará seu produto. Execute "/where/to/install/zope/bin/mkzopeinstance.py"
- Executando o "mkzopeinstance.py" vocÊ será perguntado sobre o "user name" e "password" para a conta de Administrador.
- "/location/of/zope/instance/bin/runzope" para inicalizar o Zope
- O Servidor web do Zope utilizará a porta 8080 para inicializar o serviço;
- Se não inicializar, verifique se algum serviço esta sendo executado na porta 8080 e desative-o.
- Se preferir mude a porta a ser utilizada pelo zope, no arquivo de configuracao - etc/zope.conf - localizado no diretório da INSTANCIA.
- Após a alteração do arquivo execute novamento o "runzope" para inicializar o Zope.
- Existe também um comando shell interativo para iniciar o Zope que se encontra em "bin/zopectl". Por default, "zopectl start" irá iniciar um background process que gerencia Zope e um "zopectl stop" que irá parar o processo.
- Finalmente abra a url no browser com o seguinte formato: >http://<nome do host onde foi feita a instalacao>:<porta na qual o zope será inicializado>.
- Exemplo: http://zrabbit.unicamp.br:8080
Se uma mensagem de boas vindas for visualizada a instalacao foi concluida com sucesso.
Instalação do ZRabbit versão 2.0:
- Descompacte o arquivo "ZRabbit20.tgz" e copie os Arquivos ZRabbit.zexp e ZRabbitClasses.zexp para a pasta import que esta no diretório da INSTANCIA criada.
- Após a inicialização do Zope, abra a url no browser no formato http:// <nome do host onde foi feita a instalacao>:<porta na qual o zope foi inicializado>/manage.
- A conta/senha de administrador será solicitada. Obs: A conta/senha é a mesma criada quando da instalação do Zope.
- Após logar no sistema, observe que a interface apresenta duas duas colunas. Na coluna esquerda, clique na pasta root folder.
- Em seguida na coluna da direita clique no botão import/export, localizado no final da coluna.
- Uma nova tela será apresentada na coluna da direita apresentando dois itens Export object id e Import file name.
- Na caixa de texto "import file name" digite o nome do arquivo ZRabbit.zexp e clique no botão import.
- Na coluna da esquerda clique no sinal de “+” localizado ao lado do item “control panel” e clique na pasta products também localizada na coluna da esquerda
- Repetir os quatro últimos passos para o arquivo ZRabbitClasses.zexp.
- Observe que na pasta root folder foi criado uma pasta com o nome ZRabbit e dentro de "Control Panel", observe na pasta Products o item "ZRabbitClasses".
- Clique na pasta root folder na coluna da esquerda e em seguida na pasta Zrabbit na coluna da direita, feito isso clique na aba properties que aparecera na coluna da direita, logo após altere o campo “rabbit_path” para a url onde está instalado o ZRabbit . Ex: “http://zecoelho.unicamp.br:8080/ZRabbit”
- O campo do tipo boolean envia_email é utilizado caso o Administrador deseje que seja enviado email para o Editor Chefe quando ocorrer novo cadastramento de notícia por um jornalista. Se sim, então selecione este campos e forneça o email para os campos "email_origem", "editor_banner", "editor_chunk", etc
- Finalmente abra a url com o seguinte formato: http://<nome do host onde foi feita a instalacao>:<porta na qual o zope será inicializado>/ZRabbit/admin (Ex: http://zecoelho.unicamp.br:8080/ZRabbit/admin)
- A conta/senha de Administrador será solicitada. A conta/senha é a mesma criada quando da instalação do Zope.
- Como Administrador crie as contas de Editor e Jornalistas para os responsáveis em gerenciar as notícias da página principal. A ferramenta ZRabbit já vem com duas contas exemplo "editor" e "jornalista" (a senha é a mesma) que podem ser utilizadas para avaliação inicial. RECOMENDAMOS FORTEMENTE QUE SEJAM CRIADAS NOVAS CONTAS/SENHAS para uso da ferramenta. Para criar novas contas acesse o item acl_users na pasta /ZRabbit. Para cada nova conta selecione o perfil desejado: editor ou jornalista. Mais informações sobre esses perfis e uso do ZRabbit se encontram nas páginas da ferramenta.
OBS: Em ambas plataformas - Windows e Linux, os passos são os mesmos, observando que no ambiente linux ao descompactar os arquivos de instalação verifique se as permisões são do tipo 777 – leitura, escrita e deleção, se não altere as permissões para que o zope possa manipular os arquivos para instalação.
- O próximo passo é a instalação das rotinas de expiração e limpeza da base de dados (somente UNIX)
- Deve-se proceder a inserção de duas linhas de execução de shells na CRONTAB da máquina onde está instalado o Zope e que irá hospedar o ZRabbit (use a CRONTAB do usuário ROOT ou um outro usuário definido pelo Administrador do Sistema). Segue também o conteúdo das shells consiste_agenda.sh e limpa_expirados.sh a serem salvos no diretório /cgi-bin/zrabbit:
>> CRONTAB (Exemplo de crontab de um usuario ZRABBIT. Modificar para uma outra crontab de usuario
de acordo com sua instalacao. Os horários de execução ficam a criterio)
05 01 * * * /cgi-bin/zrabbit/limpa_expirados.sh 1> /dev/null 2> /dev/null
00 02,06,10,14,18,22 * * * /cgi-bin/zrabbit/consiste_agenda.sh 1> /dev/null 2> /dev/null
As shells supra citadas devem ter permissao de execução, seguem:
::::::: consiste_agenda.sh ::::::::
#! /bin/sh -x
# Executa a rotina consiste_agenda.html no Zope
PATH=/usr/local/bin:/usr/bin:/usr/sbin:/bin
cd /cgi-bin/zrabbit
rm /cgi-bin/zrabbit/consiste_agenda.html
# (neste caso o Zope esta instalado na maquina "zrabbit.unicamp.br" e porta 8080,
# substituir de acordo com sua instalacao )
wget -t0 http://zrabbit.unicamp.br:8080/ZRabbit/rotinas/consiste_agenda.html
::::::: limpa_expirados.sh ::::::::
#! /bin/sh -x
# Executa a rotina limpa_expirados.html no Zope
PATH=/usr/local/bin:/usr/bin:/usr/sbin:/bin
cd /cgi-bin/zrabbit
rm /cgi-bin/zrabbit/limpa_expirados.html
# (neste caso o Zope esta instalado na maquina "zrabbit.unicamp.br" e porta 8080,
# substituir de acordo com sua instalacao )
wget -t0 http://zrabbit.unicamp.br:8080/ZRabbit/rotinas/limpa_expirados.html
Instalação do Zope 2.6.4
Unix:
Descompacte o pacote do Zope (versão 2.6.4) e siga as instruções:
- Execute o script "install" que consta no diretório que foi descompactado no passo anterior. Atenção: Fique muito atento para as mensagens que seguirão no processo de instalação, pois o conteúdo de uma das mensagens, o zope informará usuário/ senha inicial do administrador, que poderá ser alterada a critério.
- Execute o script "start" para inicalizar o Zope
- O Servidor web do Zope utilizará a porta 8080 para inicializar o serviço;
- Se não inicializar, verifique se algum serviço esta sendo executado na porta 8080 e desative-o.
- Se preferir mude a porta a ser utilizada pelo zope, no arquivo de configuracao - z2.py - localizado no diretório descompactado.
- Após a alteração do arquivo execute o script "start" para inicalizar o Zope .
- Finalmente abra a url no browser com o seguinte formato: >http://<nome do host onde foi feita a instalacao>:<porta na qual o zope será inicializado>.
- Exemplo: http://zrabbit.unicamp.br:8080
Se uma mensagem de boas vindas for visualizada a instalacao foi concluida com sucesso.
Windows:
Execute o instalador e siga as instruções:
- O próprio instalador criará um diretório com atalhos para inicialização do Zope.
- O instalador solicita ao usuário uma conta/senha com atribuições de administrador.
- Inicialize o servidor clicando no ícone start que consta dentro do grupo de programas zope
- Finalmente abra a url no browser com o seguinte formato:
- http://<nome do host onde foi feita a instalacao>:<porta na qual o zope será inicializado>,
- ex. http://zrabbit.unicamp.br:8080
- Se uma mensagem de boas vindas for visualizada a instalacao foi concluida com sucesso.
Instalação do ZRabbit versão 1.3
- Descompacte a Ferramenta ZRabbit e copie os Arquivos ZRabbit.zexp e ZRabbitClasses.zexp para a pasta import que esta no diretorio de instalacao da ferramenta.
- Após a inicialização do zope, abra a url no browser no formato http:// <nome do host onde foi feita a instalacao>:<porta na qual o zope foi inicializado>/manage.
- A conta/senha de administrador será solicitada. Obs: A conta/senha é a mesma criada quando da instalação do Zope.
- Após logar no sistema, observe que a interface apresenta duas duas colunas. Na coluna esquerda, clique na pasta root folder.
- Em seguida na coluna da direita clique no botão import/export, localizado no final da coluna.
- Uma nova tela será apresentada na coluna da direita apresentando dois itens Export object id e Import file name.
- Na caixa de texto "import file name" digite o nome do arquivo ZRabbit.zexp e clique no botão import.
- Na coluna da esquerda clique no sinal de “+” localizado ao lado do item “control panel” e clique na pasta products tambem localizada na coluna da esquerda
- Repetir os processos b , c e d para o arquivo ZRabbitClasses.zexp.
- Observe que na pasta root folder foi criado um diretório com o nome ZRabbit e dentro do diretório Control Panel, observe no subdiretório Products o diretório ZRabbitClasses.
- Clique na pasta root folder na coluna da esquerda e em seguida na pasta Zrabbit na coluna da direita, feito isso clique na aba properties que aparecera na coluna da direita, logo após altere o campo “rabbit_path” para a url onde está instalado o Zrabbit . Ex: “http://zecoleho.unicamp.br:8080/ZRabbit”
- Finalmente abra a url com o seguinte formato:
- http://<nome do host onde foi feita a instalacao>:<porta na qual o zope será inicializado>/ Zrabbit/admin
- ex. http://zecoelho.ccuec.unicamp.br:8080/ZRabbit/admin
- A conta/senha de administrador será solicitada. A conta/senha é a mesma criada quando da instalação do Zope
OBS: Em ambas plataformas - Windows e Linux, os passos são os mesmos, observando que no ambiente linux ao descompactar os arquivos de instalação verifique se as permisões são do tipo 777 – leitura, escrita e deleção, se não altere as permissões para que o zope possa manipular os arquivos para instalação.
