Este capítulo explica como instalar Plone em uma variedade de plataformas e configurar as opções de configuração básicas. Se antes de instalar você quiser rapidamente fazer um “test drive” do Plone, vá ao site de demonstração on-line em http://demo.plone.org; lá você pode adicionar conteúdo imediatamente sem necessitar instalar qualquer coisa.

Diferentemente dos outros capítulos, você não precisa lê-lo do início ao fim. Ao invés, eu o dividi por tipo de sistema operacional, então você pode ler somente a seção que você necessita para instalar o Plone. O plone instalará em quaisquer das plataformas suportada pelo ZOPE: Windows, OS MAC X, Linux, a maioria das plataformas Unix, e Solaris.

Para um servidor Plone, um computador de alto desempenho obviamente fará com que o Plone execute mais rápido. O plone é um sistema complexo que exige potência de processamento e memória. Em geral, é recomendado que você não o instale, se você estiver hospedando um Site grande, em uma máquina de produção, mais lenta que 2GHz com menos de 1GB de Memória RAM. Ele também funciona com configurações mais modestas como 500MHz e 64MB de memória para sites menores. Para mais informações sobre a performance, caching, veja o Capítulo 14. Para uma instalação Plone, você precisará mais ou menos de 50MB de espaço em disco. Se você já tiver instalado Zope ou Python, você precisará de mais ou menos 2MB. Você irá utilizar também o banco de dados de objetos do Plone, que pode crescer dependendo da quantidade de dados que você armazena.

Para usar o Plone, você precisa de um navegador (Browser da Web) para poder acessar o servidor. Se demais usuários desejarem se logar no seu site, então eles devem habilitar, no navegador, os cookies. JavaScript não é exigido mas oferecerá para o usuário uma experiência mais gratificante. Por causa da grande quantidade de Folhas de Estilo (CSS) no Plone, browsers mais recentes verão a interface do Plone de uma maneira mais correta, mais atraente; porém, ela é bastante funcional em qualquer Browser.

• Internet Explorer da Microsoft 5.5 e mais atrasada
• Netscape 7.0 e mais atrasado
• Mozilla 1.0 e mais atrasada
• Ópera 7.0 e mais atrasada
• Konqueror 3.0 e mais atrasado
• Safari 1.0 e mais atrasado

• Netscape 4.x
• Internet Explorer da Microsoft 5.0
• Internet Explorer da Microsoft 4.0
• Konqueror 2.x
• Lince (baseado em texto)
• w3m (baseado em texto)
• AWeb
• Links (baseados em texto, com gráficos opcionais)
• Qualquer Browser que decodifique um conjunto básicos da linguagem HTML e permita a gravação de cookies (pelo formulario de login), inclusive a maioria dos mobile/Personal (PDA) browsers

Sem dúvida o caminho mais fácil para instalar Plone é utilizando o instalador para Windows, que automatiza a instalação do Plone neste sistema operacioal. A instalação inclui pacotes e opções extras, um servidor de Protocolo HTTP; banco de dados, a configuração de serviços, e um pacote Python para Windows. Você pode fazer o download deste instalador apartir do endereço http://www.plone.org/download.

O instalador foi testado no Windows 9x, ME, NT 3.51+, 2000, e XP, mas também funciona em outras versões do Windows. É recomendado que você seja ou tenha o acesso de administrador, pois o instalador tentará instalar o Plone/Zope como um serviço e acrescenta algumas linhas na “Register” do sistema. Se você já tiver Zope ou Python instalados, você pode querer instalar o fonte separadamente para economizar espaço em disco.

Antes de instalar Plone, você deve se atentar para quaisquer outros servidores Web que esteja sendo executado no mesmo servidor. Por exemplo, versões mais velhas do Windows instalam automaticamente e iniciam o IIS, que funciona na porta 80. O instalador Plone inicia nas portas 80 e 8080. Para testar se já existe alguma aplicação utilizando a porta 80 abra um navegador e digite o endereço http://127.0.0.1/ e certifique de que uma página foi encontrada. Você pode ou desativar este servidor Web ou mudar as portas do Plone; veja 'Configurando o Servidor Web” mais adiante neste capítulo. Se você quiser executar Plone atrás do IIS ou executar ambos no mesmo servidor e ao mesmo tempo, então veja Capítulo 14 para mais informações. No momento, porém, o mais fácil seria desativar outros servidores web.

O instalador vai pelos passos habituais de instalação de qualquer software; clique no botão “Próximo” para continuar a configuração ou “Cancelar” para sair. O instalador do Plone deixa você escolher um local para instalar o software; sendo o default em c:\Program Arquivos\Plone 2 (vejam Figura 2-2).

Figure 2-2. Selecionando um diretório

Quando você chegar à tela da senha, como mostrada na Figura 2-3, você deve digitar um nome de usuário e uma senha. Um usuário será criado para você. Freqüentemente pessoas criam um usuário chamado admin ou coisa semelhante. Você precisará deste nome de usuário e senha mais adiante, então não se esqueça dele; porém, se você perder esta senha, você pode criar um novo mais adiante.

Figure 2-3. Digitando um nome de usuário e senha

Figure 2-4. tela de configuração final

Figure 2-5. O plone não está sendo executando.

Figure 2-6. O plone está executando.

Quando Plone inicia, você já pode acessar o site de Plone clicando o botão “View”. Isto faz com que um navegador seja iniciado acessando em seguida o site plone padrão; uma página de boas-vindas. Observe que, para acessar seu site de Plone, o endereço no navegador é http://localhost/. Clicando no link/botão da Interface de Gerenciamento do Zope um navegador também é iniciado e você acessa ZMI - a interface de gerenciamento do ZOPE; o endereço no Browser para isto é ohttp://localhost::8080/manage, que dá que você acesso para o servidor de aplicação. Quando você clicar no botão administrar e acessar o Plone, você terá que digitar um nome de usuário e senha os mesmos informados durante o processo de instalação.

O programa controlador saberá se você instalou Plone como um serviço ou não. Se o Plone foi instalado como um serviço de Windows, então você pode parar e começar Plone usando os comandos padrão para iniciar um serviço. Se não foi instalado como um serviço de Windows, você verá um ícone que aparece na barra de tarefa. Neste momento se você quiser trabalhar com o plone dirija-se para o Capítulo 3.

A configuração para o Plone esta contida em um arquivo de texto onde você pode editar e configurar a sua instância do Plone. Você pode mudar o número das portas do Plone, quais arquivos de log serão utilizados, e todo um conjunto de outras informações. Se você quiser alterar algumas das outras opções de configuração, dirija-se ao Apêndice que contém uma lista completa das opções de configuração. Para acessar o programa controlador, selecione “Iniciar” - Programas - Plone - Plone.

Como foi dito anteriormente, a primeira página que você verá é a página de Status, que permite a você parar ou iniciar o Plone. Falaremos agora de algumas outras telas disponíveis a esquerda do programa controlador.

Figure 2-7. A tela da página de configuração das Portas

o HTTP de PLONE: Este campo especifica a porta pela qual o usuários comum acessará o Plone. O default é a porta 80, que é o padrão para qualquer servidor da Web. Embora esta porta não seja exigida, sem ela você não poderá acessa Plone através de um navegador Web. Se esta porta estiver habilitada e Plone estiver sendo executado, o botão de Plone de Visão estará habilitado na página de Status.

o HTTP da interface de Gerenciamento do Zope: Este campo especifica a porta para acessar Plone como um gerente (manager). O default é a porta 8080. Esta porta permite acessar, na raiz, a ZMI - Interface de Gerenciamento de Zope. Você pode ainda utilizar a ZMI através da porta 80; porém, é mais fácil e mais conveniente ter uma porta separada. Se esta porta estiver habilitada e o Plone estiver sendo executado, o botão de administração do Plone estará habilitado na página de Status.

*Acesso FTP: Este campo especifica a porta de acesso via protocolo FTP. O valor default é branco, significando que este serviço não está habilitado; se você quiser ativa-lo, a porta habitual é a de número 21. Você pode usar FTP para transferir grandes arquivos.

WebDAV: Este campo especifica a porta para acessar Plone via WebDAV. O valor default é branco, significando que o serviço não está habilitado; se você quiser ativa-lo, a porta habitual é 8081. (WebDAV é um protocolo para a criação remota de conteúdo em Plone. Com o WebDAV, você mapear seu servidor Plone para uma determinada letra da unidade de armazenamento do Windows

O capítulo 9 cobre esta página de Usuário de Emergência, mas, ponha brevemente, permite a você conseguir acesso de emergência a seu sistema devido ao esquecimento do nome de usuário ou senha do administrador informados durante a instalação.

Até aqui, você iniciou e parou o serviço Plone no modo de produção. Isto é o modo no qual o Plone é executado de maneira mais rápida. Quando você esta desenvolvendo ou em um servidor de desenvolvimento ou para problemas de depuração, você precisará iniciar o Plone em modo debug. Este modo é recomendado quando você estiver desenvolvendo produtos e skins, como você fará nos capítulos seguintes. Este método não é o default porque você notará que Plone é cerca de dez vezes mais lento do que o normal.

Figure 2-8. Executando Plone via linha de comandos

Para se certificar que o Plone está funcionando, inicie um programa navegador e vá para http://localhost/; se o Plone foi iniciado com sucesso, você verá uma página de bem-vindo.

As instalações para OS Mac X, Unix, e Linux são diferentes, mas as configurações são semelhantes. Existem pacotes específicos para sistemas operacionais diferentes, inclusive OS Mac X, Debian, Gentoo, FreeBSD, OpenBSD, e RPM para Red Hat, SuSE, e Mandrake. Falaremos apenas dos mais populares: OS MAC X, Red Hat, e Debian. Para informações sobre seu sistema operacional específico, consultem as instruções de instalação.

No Mac OS, o instalador automatiza a instalação do Plone e foi testado na versão 10.2.3 e anteriores. Você precisará ter acesso com administrador do computador no qual você deseja instalar. Você pode fazer o download deste instalador em http://ww.plone.org/download. Uma vez que você baixou o instalador, clique duas vezes no instalador para descompacta-lo, e clique duas vezes no pacote instalador resultante para começar o instalar. Você devia ver a tela mostrada na Figura 2-9.

Figure 2-9. Autorizando a instalação usando seu OS Mac X

O digite sua senha da contaOS Mac X para autorizar a instalação; sua conta deve ser a de um administrador com privilégios para fazer isto. Antes do “log off”, você pode querer reposicionar pacote de instalação para /Users/Shared assim você poderá acessá-lo por outra conta. Uma vez que a instalação foi autorizada, você verá a tela mostrada na Figura 2-10.

Figure 2-10. Bem-vindo do instalador.

::image:: img/3294f0211.png

Figure 2-11. Escolhendo o volume de inicialização

A instalação toma mais ou menos cinco minutos, dependendo na velocidade de seu computador. Quando a instalação estiver terminada, o Plone não se inicia automaticamente. O arquivo de ReadMe.rtf em /Applications/Plone* contém muitas informações úteis sobre como executar e administrar a sua instalação de Plone, inclusive como iniciar o Plone.

Para testar se Plone esta funcionando, use um navegador em http://localhost:9090/; você deveria ver a página de boas-vindas do Plone. Também no arquivo “leia-me” você encontrará o nome do usuário e senha que Plone gerou para você acessar o servidor.

Os RPMs estão disponíveis para os sistemas operacionais Red Hat, Mandrake, e distribuições de SuSE. Você pode fazer o download dos pacotes mais recentes em http://www.plone.org/download. O RPM exige que Python 2.3 esteja instalado. Para descobrir qual é a versão de Python que você já esteja utilizando, execute o comando (numa janela shell):

 $ Python -V
 Python 2.3.2

Neste caso, Python 2.3.2 está instalado; se você não obtiver este tipo de mensagem, o RPMs para o Python estão disponíveis no Site http://www.python.org. Depois de baixar os arquivos, instale usando o comando padrão rpm; felizmente, a instalação do Plone mostra algumas informações realmente úteis. Por exemplo:

 [root@lappi i386]# rpm -ivh Plone2-2.0.0rh-2.i386.rpm
 Preparing... ###########################################
 [100%]
 Making group plone (not altered if already exists).
 Making user plone.
 ~ 1:Plone2 ###########################################
 [100%]
 Creating initial 'main' instance...
 Instance created. Listening on 127.0.0.1:8080, initial user: 'plone'
 with password: 'plone'.
 Setup of initial database in 'main' instance...
 /usr/lib/plone2/lib/python/AccessControl/Owned.py:79:
 DeprecationWarning: Owned.getOwner(1) is deprecated; please use
 getOwnerTuple() instead.
 ~ DeprecationWarning)
 Created initial database content.
 look at /etc/plone2/main/zope.conf.
 Run then "/etc/rc.d/init.d/plone2 start" to start Plone2.
 you may create new Plone instances with mkploneinstance.

As shown in the previous output, to start Plone, run the following:

:: /etc/rc.d/init.d/plone2 começo

Para testar se tudo esta Ok, use um navegador e va para o endereço http://localhost:8080/; você deve ver a página de boas-vindas. O nome do usuário plone e a senha* deve ter sido criada para você.

O Plone é um pacote padrão para o Debian e depende do processo de liberação de novos release, então você pode optar por versões, de Plone, estáveis ou não, dependendo de como sua instalação Debian foi configurada. Para instalar o Plone, simplemente utilize o apt para baixar o pacote. Exemplo de uma instalação:

 agmweb:/home/andy# apt-get install plone
 Reading Package Lists... Done
 Building Dependency Tree... Done
 The following extra packages will be installed:
   zope zope-cmf zope-cmfcalendar zope-cmfcore zope-cmfdefault
 zope-cmfplone zope-cmftopic zope-cmfworkflow
   zope-formulator zopectl
 Suggested packages:
   zope-cmfwiki python-unit zope-devguide zope-book
 Recommended packages:
   zope-cmfforum zope-localizer
 The following NEW packages will be installed:
   plone zope zope-cmf zope-cmfcalendar zope-cmfcore zope-cmfdefault
 zope-cmfplone zope-cmftopic zope-cmfworkflow
   zope-formulator zopectl
 0 upgraded, 11 newly installed, 0 to remove and 49 not upgraded.
 Need to get 4743kB of archives.
 After unpacking 24.9MB of additional disk space will be used.
 Do you want to continue? [Y/n]

Press Y to continue and install all the required packages. To start and stop Zope, an install script has been created in the init.d directory, called zope. To start Plone, run the following:

 /etc/init.d/zope começa

O instalador Debian inicia o Zope na porta 9673, não-padronizada. Já que isto é bastante incomum, recomendado que você leia a documentação para os pacotes em /usr/share/doc/zope e /usr/share/doc/zope-cmfplone.

Como uma alternativa para usar um instalador ou um pacote, você pode instalar do “source tarball”. Se você estiver familiarizado com instalação a partir do “source”, é realmente bastante simples mas exige mais familiaridade com ferramentas básicas como tar. As seçõe seguinte demonstram como instala-lo no Linux.

NOTA Para instalar o Zope, veja as instruções de instalação no arquivo doc/INSTALL.txt do seu download. Para mais informações, vejam http://zope.org/Documentation/Books/ZopeBook/2_6Edition/InstallingZope.stx).

1. Faça o download do Plone 2 em http://www.plone.org/download, e selecionar o tarball file.
2. Unzip com: tar xzf CMFPlone2.0.tar.gz
3. Você achará que um diretório chamado CMFPlone-Xxx foi criado, onde Xxx é a versão (por exemplo, CMFPlone-2.0).
4. Mova o conteúdo deste diretório para o seu diretório Products da sua instalação Zope. Por exemplo, se o diretório de Produtos Zope está em /var/zope, então faça: mv CMFPlone2.0/ /var/zope/Products*

Depois de completar a instalação, reinicie o Zope. Uma vez Zope reiniciado, acesse o Zope via navegador indo para http://localhost:8080/manage. Você precisará de um nome de usuário e senha (por exemplo, o nome de usuário e senha informados durante a instalação do Zope).

Figure 2-12. Site de plone na lista “drop-down”

Instalando de CVS .................

O acesso ao Concurrent Versioning System (CVS) é recomendado só para usuários e desenvolvedores experimentados. Você pode achar CVS em http://ww.plone.org/development/cvs. O comando de saída do CVS é como se segue:

 cvs -d:pserver:anonymous@cvs.sf.net:/cvsroot/plone login
 cvs -d:pserver:anonymous@cvs.sf.net:/cvsroot/plone co CMFPlone

Plone 2 has a whole host of other dependencies (such as DCWorkflow, Formulator, Group User Folder, and so on) that aren't in Plone CVS, meaning users will have to go and find all these dependencies. When you start Plone, it'll print any errors regarding packages not found. For example:

 2003-11-21T12:23:11 ERROR(200) Plone Dependency
 CMFActionIcons not found.  Please download it from http://cvs.zope.org/Products/

Uma vez que você instalou Plone de um “source”, você precisa criar uma instância Plone. Para fazer isto, você precisará de logar na ZMI - interface de gerenciamento e adicionar um site Plone. Você fazer isto va para a URL http://localhost:8080/manage (esta porta mudará dependendo da sua instalação). Você precisará de nome de usuário e senha de gerente para acessar a ZMI; esta senha foi criada durante a instalação do Zope.

NOTA Se você esqueceu a senha, criada na instalação, não entre em pânico. Você pode criar uma nova; veja o Capítulo 9 para mais informações.

Você adiciona todos os objetos via a lista “drop-down” do canto superior-direito, como mostrada na Figura 2-12.

• ID: Isto é um identificar único (ID) do site de Plone.
• Title: Isto é o título do site Plone.
• Membership source: Para o momento, deixe isto como a opção default. Isto possibilita que os usuários tenham mais de uma fonte de autenticação que não o próprio portal.
• Description: é uma descrição do portal que membros verão em e-mails,. Não se preocupe demais sobre isto; você pode sempre alterar esta informação nas propriedades de portal.

Figure 2-13. Adicionando um site Plone

Depois de clicar Adicione Site de Plone, um site de Plone será criado. Isto pode tomar um minuto ou duas em máquinas mais lentas porque muito processamento acontece. A tela então redirecionará você para o Plone bem-vindo página.

NOTA Se você instalou no Windows usando o instalador, então a maior parte desta configuração já foi provida pelo programa controlador; veja 'Configurando o Servidor no Windows” nas seções acima.

NOTA Se você instalou usando OS Mac X ou o instalador de Windows, então você achará um arquivo extra (plone.conf), que contém definições de porta usadas no arquivo de configuração principal do Zope.

O Zope 2.7 cria um arquivo de configuração dentro de cada instância instalada. Toda a configuração para o servidor é localizada naquele arquivo. Uma lista completa das opções de configuração está disponível no Apêndice A. Para achar o arquivo de configuração, procure pelo arquivo chamado zope.conf localizado no etc da pasta de sua instalação Plone. Alguns instaladores (Windows e OS Macs X, por exemplo) criam um segundo arquivo de configuração chamado plone.conf que contém opções de configuração específicas do Plone. Se sua instalação contém arquivo plone.conf, então use este arquivo de configuração para fazer as mudanças; elas serão incluídas no arquivo de configuração principal.

O arquivo de configuração é extremamente documentado e contém muitos comentários e exemplos úteis. Se você estiver familiarizado com arquivos de configuração Unix como o do apache, então você achará o arquivo de configuração do Zope bem familiar. Para alterar a configuração de Zope, abra-o em um editor de textos, e mude as linhas necessárias; depois de alterar a configuração, você precisará reiniciar Zope.

É possível executar o Plone 2.0 com uma versão do Zope anterior a 2.7; porém, Zope 2.7 oferece maior estabilidade e novas funcionalidades, inclusive uma configuração mais fácil. Se você estiver usando uma versão de Zope anterior a 2.7, você precisará ler a documentação de como mudar a configuração.

Para mudar uma porta, adicione as linhas de endereço para aquela porta. Por exemplo, para executar Plone na porta 80 em vez da default, mude, no zope.conf, a linha em negrito para o seguinte:

 <http-server>
   # valid keys are "address" and "force-connection-close"
   address 8080
   # force-connection-close on
 </http-server>

to the following:

 <http-server>
   # valid keys are "address" and "force-connection-close"
   address 80
   # force-connection-close on
 </http-server>

Se você utilizou o instalador do Windows ou do OS Mac X, então você achará estas definições de porta no arquivo plone.conf. Estes valores são então importados para dentro do arquivo de configuração principal. Desta maneira você editaria o arquivo plone.conf assim:

 ## PLONE_WEBSERVER_PORT
 ## --------------------
 ## This is the port you will access your Plone site from.  Set this to a port
 ## number above 1024 not used for any other server on your computer.
 %define PLONE_WEBSERVER_PORT 8080

para o seguinte:

 %define PLONE_WEBSERVER_PORT 80

Por default, no Zope 2.7, o modo debug (de depuração de erros) está habilitado. Observe que assim o Plone fica aproximadamente 10-20 vezes mais lento. Para desligar isto, adicione a linha no arquivo de configuração:

 Debug-mode off

Por default existem dois tipos logs no Plone: um log de acesso que você pode produzir uma estatística do site e um log de evento que contém informações sobre produtos Plone. O log de evento é o lugar certo para encontrar erros e mensagens do Plone. A configuração default parece com o seguinte:

 <eventlog>
   level all
   <logfile>
     path $INSTANCE/log/event.log
     level INFO
   </logfile>
 </eventlog>

 <logger access>
   level WARN
   <logfile>
     path $INSTANCE/log/Z2.log
     format %(message)s
   </logfile>
 </logger>

Isto é lugar onde você pode mudar o caminho para do arquivo definindo um novo arquivo. Os valores que são gerados são baseados em mensagens de erros enviadas; as mensagens mais sérias são enviadas com níveis mais altos. Por padrão, somente informações e a mensagem prévia são enviadas para o log, mas aquele valor podia ser um dos seguintes: CRITICAL, ERROR, WARN, INFO, DEBUG, e ALL. Se você quisesse somente um log de erros, então você mudaria level INFO para level ERROR.