2. Como Instalar o Plone

Como Instalar o Plone

Exigências

Plone pode ser instalado em qualquer plataforma que suportar o Zope: Windows, Mac OSX, Linux, a maioria dos Unixes e Solaris. No Windows 2000 é necessário ter permissões de administrador para instalar o Software.

Servidor

Um computador com alta qualidade de hardware obviamente fará com que o Plone tenha uma melhor performance. Requer máquina e memória. Em geral, para desenvolver ou servir sites grandes você não deve ter uma máquina com menos de 1.5Ghz e 1GB de RAM. Mas é recomendado 600 e 64 MB de RAM. Para maiores informações sobre a performance, veja o capítulo 9, "Como Otimizar o Plone".

Para realizar a instalação básica do Plone é necessário 50 MB de espaço em disco. Se você já tem instalações do Zope ou do Python, então esta instalação vai ser bem reduzida. Você também deve tomar cuidado com o banco de dados objeto do Plone que pode crescer muito dependendo da quantidade de dados que você armazena.

Cliente

O Plone necessita somente de um browser que possa acessar o servidor. Se os usuários quiserem se logar, os cookies devem estar habilitados. JavaScript não é necessário mas oferecerá uma experiência mais rica para o usuário.

Dicas de browsers para o Plone 1.0:

• Internet Explorer 5.5 ou superiores (6.0 ou superiores são recomendados)
• Netscape 7.0 ou superiores
• Mozilla 1.0 ou superiores (1.4 ou superiores são recomendados)
• Opera 7.0 ou superiores (7.20 ou superiores são recomendados)
• Konqueror 3.0 ou superiores (Há algumas inconscistências, mas você terá que conviver com elas até que atualizem-no conforme as mudanças do código base KHTML do Safari)
• Safari 1.1 e superiores

Plone também é completamente funcional nos seguintes browsers, mas pode ser possível que o layout original do Plone se pareça um pouco diferente:

• Netscape 4.7 ou superiores
• Internet Explorer 5.0
• Internet Explorer 4.0 (não foi muito testado, mas parece trabalhar bem)
• Konqueror 2.x
• Lynx (texto puro)
• w3m (texto puro)
• AWeb
• links (texto puro, com gráficos opcionais)
• Qualquer browser que reconheça um conjunto básico de HTML e formulários de entrada + cookies (incluindo a maioria dos browsers dos PDA´s)

Download do Plone

A última versão do Plone está sempre disponível em http://www.plone.org/download. Em breve deve estar disponível também em CD.

Instalação usando o Windows Installer

Créditos: Steve Rauch ajudou com screenshots e a documentação.

O Instalador

O Windows Installer mecaniza a instalação do Plone no Windows. As versões do Windows 9x, ME, NT 3.51+, 2000 e XP foram testadas, mas podem funcionar em outras. É recomendado que você tenha permissões de administrador no computador se quiser fazer a instalação. Se você já tem o Zope ou o Python instalados, você pode querer instalar o fonte separadamente para economizar espaço em disco. A instalação inclui pacotes extras e opções, um banco de dados pré-carregado e outras coisas.

O instalador do Plone para Windows pode ser baixado do site Plone.org, na sessão downloads. Depois de baixar o instalador, dê um clique duplo nele para começar a instalação. Deve ser apresentada a seguinte tela:

O instalador segue os passos comuns para instalação de softwares, siga as opções dos botões "Next" ou "Cancel". Não há necessidade de discutir todos os passos, a maioria deles são auto-explicáveis. Quando você chegar à tela "Enter a password" (Entre com uma Senha) (mostrada abaixo), você deve digitar uma senha. Este passo registrará uma senha para o usuário "admin". Você vai precisar desta senha mais tarde, então tome nota dela. Se você perder esta senha você pode colocar uma nova senha por meio do Plone Controller (Controlador do Plone).

A instalação leva aproximadadmente 3 minutos, dependendo da velocidade do seu computador. São realizadas algumas tarefas no final da instalação, tais como a compilação de todos os arquivos do Python. Quando a instalação terminar, o Plone não é iniciado automaticamente. Se você deixar a caixa "Launch Plone Controller" (Rodar o Controlador do Plone) marcada o Controlador do Plone vai ser executado possibilitando você iniciar o Plone.

O Controlador do Plone

O Plone Controller permite que você administre facilmente a instância do Plone de um GUI e dá o controle sobre "coisas" como os arquivos de log, portas e como o Plone pode ser iniciado. Para iniciar o Controlador do Plone, selecione a opção “Plone” do menu Iniciar.

O controlador começa com a página "Control" que faz com que você inicie ou pare facilmente sua instância do Plone. Para os impacientes, clique em "Start" para iniciar seu Plone.

Esta tela mostra se o Plone está iniciado ou parado, através dos botões que estão em evidência e pela mensagem no “Current Status” (Status Atual). Se o Plone não iniciar automaticamente você terá que clicar em "Start" para iniciá-lo. Em alguns computadores mais lentos pode levar algum tempo até que o Plone seja iniciado, especialmente pela primeira vez, isto faz com que o Controlador se conecte e pense que o Plone não iniciou. Clicando em "Start" novamente fará com que isto seja corrigido. Este bug será corrigido nas próximas versões.

Quando o Plone iniciar você pode acessar o site Plone clicando no botão "View Plone" (Visualizar o Plone). Isto vai iniciar um browser e será acessado o site Plone. O botão "Manage Plone" (Gerenciador do Plone) leva você a interface de gerenciamento do seu Zope se você tem definida uma porta "HTTP Manage" (Gerenciadora de HTTP), por default esta porta é a 8080.

Serviços

A aba "Services" (Serviços) permite que você especifique as portas que o Plone escuta para conexões como HTTP, FTP e WebDAV. Se você deixar a porta em branco então aquela porta não estará disponível. Certifique-se que nenhum outro servidor está "escutando" na mesma porta do Plone, servidores tais como IIS, Apache, PWS podem estar acessando portas similares.

• HTTP: especifica a porta que o usuário vai acessar o Plone, a porta default é a 80. Embora esta porta não seja necessária, sem ela você não será capaz de acessar o Plone com um browser. Se esta porta estiver habilitada e o Plone estiver rodando, o botão "View Plone" será habilitado na aba Control (Controle).
• HTTP Manage: especifica a porta de acesso ao Plone como gerenciador, a porta default é a 8080. Esta porta dá a você acesso a interface de gerenciamento do Zope, à raiz do Zope. Se esta porta estiver habilitada e o Plone estiver rodando, o botão "Manage Plone" estará habilitado na aba Control.
• FTP: especifica a porta para acessar o Plone via FTP, a porta default é a 21.
• WebDAV: especifica a porta para acessar o Plone via WebDAV, a porta default é a 8081.

Avançado

A janela "Advanced" (Avançado) deixa você especificar algumas das muitas opções avançadas. Se você não tiver certeza a que estes itens se referem, por favor, deixe os valores-padrões. A opção mais interessante é a "Service Daemon". Ela deixa você especificar como o Plone rodará e mostra os usos dos serviços no Windows.

Se você estiver trabalhando com Windows NT, 2000 ou XP você pode executar o Plone como um serviço (na opção "Windows NT/2000"). Isto deixará o Plone rodando em background, nenhum ícone ficará visível e o Plone pode ser acessado como um serviço. Como um serviço o botão "Restart" aparecerá na ZMI assim um usuário autorizado pode escolher restartar o Plone através da Web. Uma outra vantagem de rodar o Plone como serviço é que ele pode ser iniciado e parado pelo Management Console (Gerenciador do Console) (dentro do Painel de Controle do Windows) ou através da linha de comando usando os comandos net start Plone e net stop Plone.

Se você estiver trabalhando com Windows 95, 98 ou ME, você deve executar o Plone usando a opção "Windows 95/98". Isto executa o Plone como um processo com um ícone que é mostrado no system stray. Você pode ainda controlar o Plone do Controlador ou do system tray. Windows NT, 2000 ou XP podem usar esta opção se eles quiserem.

Estas opções são selecionadas para você automaticamente durante a instalação.

Rodando o Zope manualmente

Se houver problemas para rodar o Plone com o Controlador você pode também iniciar o Plone da linha de comando. Mais detalhes sobre este assunto estão disponíveis na documentação do Zope. O comando que o Controlador do Plone chama é o seguinte:

  c:\Arquivos de Programas\Plone\Python\python.exe
      c:\Program Files\Plone\Zope\z2.py
      -X -w80 -w8080 -f21
      INSTANCE_HOME=c:\Program Files\Plone\Data
      HTTP_MANAGE=8080

• As linhas foram quebradas para lê-las facilmente, este comando é só uma linha.
• Este comando supõe que sua instalação do Plone esteja em c:\Arquivos de Programas\Plone

Conteúdo do Instalador do Windows

Além do Plone, os componentes instalados na instalação do Windows são:

• CMF 1.3:
  • O CMF é requerido pelo Plone. A última versão pode ser encontrada em cmf.zope.org
• Zope 2.6.1:
  • Esta é a última versão do Zope e pode ser encontrada em zope.org
• Python 2.1.3:
  • Python 2.1.3 requer Zope 2.6.0. Python pode ser encontrado em http://www.python.org/
• Extensões Win 32 do Python:
  • As extensões Win32 feitas por Mark Hammond oferecem acesso às API's do Windows e às funções. As extensões do Win32 podem ser encontradas em Starship
• PIL 1.1.3:
  • A Biblioteca de Imagens do Python (Python Images Library) permite que você manipule e altere imagens do Python. A PIL pode ser encontrada em pythonware.com - PIL é usada pelo CMFPhoto para redimensionar imagens.
• ReportLab 1.15:
  • ReportLab fornece interface para PDF's. Ele permite que você crie PDF's através do Python. ReportLab pode ser encontrado em reportlab.com
• Zope Controller 1.0:
  • O Zope Controller é uma aplicação GUI para Windows que provê acesso fácil para iniciar, parar e configurar o Zope. A versão do Plone é derivada do Zope Controller
• CMF Collector 0.9b:
  • O CMF Collector é um sistema de rastreamento de bug’s para o Plone. CMF Collector foi desenvolvido pela Zope Corp. e pode ser encontrado no cvs.zope.org
• CMF Wiki 0.1:
  • O CMF Wiki 0.1 é uma implementação do sistema Wiki para o Plone. Foi desenvolvido pela Zope Corp. e pode ser encontrado em cvs.zope.org
• CMF Quick Installer:
  • CMF Quick Installer permite que você instale rapidamente novos produtos do Zope facilmente, selecionando os produtos apropriados na Interface de Gerenciamento do Zope (Zope Management Interface). O instalador pode ser encontrado em SourceForge Collective project".
• CMF Photo:
  • CMF Photo é um produto que permite que você visualize fotografias através do Plone e permite que sejam dinamicamente redimensionadas. CMF Photo pode ser encontrado em SourceForge Collective project"
• CMF Forum:
  • CMF Forum permite que você faça fóruns para que os usuários possam adicionar e editar comentários. O CMF Forum pode ser encontrado em SourceForge Collective project"
• External Editor 0.6 (Aplicação Cliente e Servidor):
  • External Editor é um programa que permite que você edite objetos e conteúdos do Plone localmente. Pode ser encontrado no "zope.org" em: http://www.zope.org/Members/Caseman/ExternalEditor
• Zope Book 2.5:
  • É o Livro do Zope. O fonte original do Livro do Zope está em Zope.org e a versão da Ajuda em HTML está aqui
• Localizer:
  • Localizer permite que você traduza o Plone em diferentes línguas.
• Translation Service and Translations:
  • O Translation Service (Serviço de Tradução) permite que traduções sejam feitas nos Zope Page Templates e Plone. Permite integração entre o Plone e o Localizer. O Translation Service pode ser encontrado aqui.
• Há várias traduções para o Plone mantidas no SourceForge Plone i18n project - o instalador instala todos os arquivos de tradução que há, embora algumas das traduções ainda não estejam completas.

Um banco de dados com uma instância do Plone é instalado, a menos que o banco de dados já exista naquele diretório (caso exista, o banco de dados não é instalado). Este banco de dados possui nele instalados uma instância do Plone (com CMF Collector e CMF Wiki instalados), um Access Rule (Funções de Acesso), um Site Root (Raiz do Site) e um External Editor (Editor Extenos).

Instalando o Plone usando o Mac OSX Installer

Crédito: Jim Roepcke ajudou com os screenshots e a documentação.

O Instalador

O Mac OS X installer facilita a instalação do Plone no Mac OS X. Mac OS X 10.2.3 e superiores foram testados e são suportados. É recomendado que você tenha permissões de administrador no computador para instalá-lo. Se você já tem o Zope ou Python instalados, você pode querer instalar o fonte separadamente para economizar mais espaço em disco. A instalação inclui pacotes extras e opções, um banco de dados pré-carregado e outras coisas.

O instalador do Plone para Mac OS X pode ser baixado do site Plone.org, na sessão de downloads. Depois que você fez o download do instalador, dê um clique duplo nele para descompactá-lo, e um clique duplo no pacote do instalador descompactado para começar a instalação. Você deve ver a seguinte tela:

Digite a senha da sua conta do Mac OS X para autorizar a instalação. Sua conta deve ter privilégios de Administrador para fazer isto. Se sua conta não tem tais privilégios, desloque-se e logue novamente com uma conta que tenha estes privilégios, rode o instalador novamente. (Você pode mover o pacote do instalador para /Users/Shared antes de você se deslogar assim pode acessá-lo de outras contas). Depois que a instalação for autorizada, você verá a seguinte tela:

O instalador passa por passos comuns para a instalação do software, siga as opções pelos botões "Continue" ou "Go Back". Não há necessidade de discutir todos os passos, a maioria são auto explicáveis. Entretanto, quando for apresentada a tela com a escolha de volumes para a instalação do Plone, você deve escolher a partição na qual o Mac OS X está instalado.

A instalação leva mais ou menos 3 minutos, dependendo da velocidade do seu computador. Quando a instalação terminar, o Plone não iniciará por default. O arquivo ReadMe.rtf em /Applications/Plone contém algumas informações úties sobre como rodar e gerenciar sua instalação do Plone, incluindo como iniciar o Plone. Para facilitar o comando está abaixo:

Conteúdos do Mac OS X Installer

Além do Plone, os componentes instalados na instalação Mac OS X são:

• CMF 1.3:
  • O CMF é requerido pelo Plone. A última versão pode ser encontrada em cmf.zope.org
• Zope 2.6.1:
  • Esta é a última versão do Zope e pode ser encontrada em zope.org
• Python 2.1.3:
  • Python 2.1.3 requer Zope 2.6.0. Python pode ser encontrado em http://www.python.org/
• PIL 1.1.3:
  • A Biblioteca de Imagens do Python (Python Images Library) permite que você manipule e altere imagens do Python. A PIL pode ser encontrada em pythonware.com - PIL é usada pelo CMFPhoto para redimensionar imagens.
• ReportLab 1.15:
  • ReportLab fornece interface para PDF's. Ele permite que você crie PDF's através do Python. ReportLab pode ser encontrado em reportlab.com
• CMF Collector 0.9b:
  • O CMF Collector é um sistema de rastreamento de bug’s para o Plone. CMF Collector foi desenvolvido pela Zope Corp. e pode ser encontrado no cvs.zope.org
• CMF Wiki 0.1:
  • O CMF Wiki 0.1 é uma implementação do sistema Wiki para o Plone. Foi desenvolvido pela Zope Corp. e pode ser encontrado em cvs.zope.org
• CMF Quick Installer:
  • CMF Quick Installer permite que você instale rapidamente novos produtos do Zope facilmente, selecionando os produtos apropriados na Interface de Gerenciamento do Zope (Zope Management Interface). O instalador pode ser encontrado em SourceForge Collective project".
• CMF Photo:
  • CMF Photo é um produto que permite que você visualize fotografias através do Plone e permite que sejam dinamicamente redimensionadas. CMF Photo pode ser encontrado em SourceForge Collective project"
• CMF Forum:
  • CMF Forum permite que você faça fóruns para que os usuários possam adicionar e editar comentários. O CMF Forum pode ser encontrado em SourceForge Collective project"
• External Editor 0.6 (Aplicação Cliente e Servidor):
  • External Editor é um programa que permite que você edite objetos e conteúdos do Plone localmente. Pode ser encontrado no "zope.org" em: http://www.zope.org/Members/Caseman/ExternalEditor
• Zope Book 2.5:
  • É o Livro do Zope. O fonte original do Livro do Zope está em Zope.org e a versão da Ajuda em HTML está aqui
• Localizer:
  • Localizer permite que você traduza o Plone em diferentes línguas.
• Translation Service and Translations:
  • O Translation Service (Serviço de Tradução) permite que traduções sejam feitas nos Zope Page Templates e Plone. Permite integração entre o Plone e o Localizer. O Translation Service pode ser encontrado aqui.
• Há várias traduções para o Plone mantidas no SourceForge Plone i18n project - o instalador instala todos os arquivos de tradução que há, embora algumas das traduções ainda não estejam completas.

Um banco de dados com uma instância do Plone é instalado, a menos que o banco de dados já exista naquele diretório (caso exista, o banco de dados não é instalado). Este banco de dados possui nele instalados uma instância do Plone (com CMF Collector e CMF Wiki instalados), um Access Rule (Funções de Acesso), um Site Root (Raiz do Site) e um External Editor (Editor Externo).

Instalando no Linux

Debian

O Plone é um pacote padrão no Debian (em teste e instável). Assim, os usuários do Debian podem instalar o Plone usando simplesmente o comando apt-get install plone.

Red Hat/Mandrake/Suse

Os RPMs estão disponíveis para as distribuições Red Hat, Mandrake e Suse. Os últimos pacotes podem ser baixados em SourceForge.

Fique atento com as dependências dos pacotes. Se você usa-os com outra versão da distribuição pode ter problemas.

Instalando os fontes

Se você estiver familiarizado com as instalações dos produtos pela distribuição dos fontes, este pode ser um maravilhoso método de instalação do Plone. Entretanto a instalação supõe que você esteja familiarizado com as ferramentas tais como o tar, se você não está as outras opções de instalação devem ser escolhidas.

Exigências

• Zope 2.6.2 ou acima disponível em zope.org
• CMF 1.3.2 ou acima disponível em cmf.zope.org

Obtendo o último Plone

Está disponível como um tar ball no plone.org. Para extrair o tar ball, execute os seguintes comandos[1]:

                gunzip CMFPlone1.0.tar.gz
                tar -xvf CMFPlone1.0.tar

O tar bal atual do Plone contém vários produtos do Plone: ActivePak, DCWorkflow e Formulator. Você pode obtê-los do CVS do Sourceforge e com estes outros produtos rodando os seguintes comandos[2]:

                cvs -d:pserver:anonymous@cvs.plone.sourceforge.net:/cvsroot/plone login 
                cvs -d:pserver:anonymous@cvs.plone.sourceforge.net:/cvsroot/plone co -r Plone-1_0 CMFPlone 
                cvs -d:pserver:anonymous@cvs.formulator.sourceforge.net:/cvsroot/formulator co Formulator

                cvs -d:pserver:anonymous@cvs.zope.org:/cvs-repository login
                cvs -d:pserver:anonymous@cvs.zope.org:/cvs-repository checkout Products/DCWorkflow

Instalação

• Instalar o Zope, siga as instruções contidas no INSTALL.txt para completar.
• Instalar o CMF, siga as instruções contidas no INSTALL.txt para completar.
• Copie os diretórios CMFPlone, ActivePak, DCWorkflow e Formulator dentro do diretório Produtos da sua instância do Plone. Informações podem também ser encontradas no arquivo INSTALL.txt dentro do diretório CMFPlone.
• Reinicie o Zope. Aqui depende de como você instalou o Zope e do seu sistema operacional.
• Vá a Interface de Gerenciamento, isto é feito adicionando /manage a URL do seu Zope. Você deve agora ver um "Plone Site" na lista de produtos para adicionar. Isto significa que o Plone foi instalado com sucesso, veja "Adicionando um Plone Site" para mais informações.

Adicionando um Plone Site

Chegar aqui supõe que você instalou com sucesso o Plone usando um dos procedimentos descritos acima. Se você usou os instaladores do Windows ou do Mac OSX então você já tem um site Plone criado para você chamado "Plone" e não há necesidade de ler esta seção a menos que você queira instalar outro site Plone dentro do seu Zope.

• Acesse a Interface de Gerenciamento do seu Zope, isto é feito adicionando o /manage a URL do seu Zope.
• Selecione "Plone Site" da sua lista:
• O seguinte formulário é apresentado para indicar algumas informações sobre seu site Plone:
  • Id obrigatório: é o id (identificador) do site Plone e é um nome curto contendo um conjunto de caracteres restritos (somente caracteres alfanuméricos são recomendados), este será a URL do seu site Plone.
  • Title: é o nome do site Plone que aparecerá em todas as páginas.
  • Membership source: se você não tem certeza do que isto significa, deixe como default "Create a new...". Você pode também escolher adicionar uma pasta de usuários dentro do seu site Plone ou usar uma pasta de nível acima.
  • Description: uma descrição do site.
  • Site type: deixa você definir um tipo diferente de site, por exemplo, uma skin para o site. Este manual assume que você usou o valor Default.
• Depois clique em "Add Plone Site", um novo site será criado. Isto pode levar alguns segundos até que ele carregue as informações.

Parabéns, você instalou o Plone.

Migrando o Plone de uma instalação existente

Observe: estas instruções da instalação devem ser aplicadas a todas as versões e futuras versões do Plone. Entretanto deve haver passos extras necessários, por favor consulte as instruções de download para sua release.

Se você já tem uma instalação do Plone e deseja atualizá-la, então a ferramenta migration (migração) foi adicionada. Esta ferramenta de migração requer conhecimento, e acesso a Interface de Gerenciamento do Zope. Antes de executar uma migração faça um backup completo do seu site Plone.

Instalando o software

• Pare o Zope
• Faça um backup de sua instalação do Plone, incluindo o banco de dados. Veja o Capítulo 9 para fazer o backup do banco.
• Faça o download e instale a nova versão do Plone, como você vai fazer isso depende exatamente do seu sistema operacional e como você instalou o Plone. Esta instalação resultará em arquivos sendo atualizados para a nova versão no seu filesystem. Geralmente instalar diretamente sobre uma versão antiga já é o suficiente.
• Reinicie o Zope
• Para cada instância do Plone no seu Zope, ache a ferramenta chamada portal_migration na ZMI. Ela vai identificar a versão atual do Plone e a versão do seu sistema de arquivos. Para migrar para o Plone existente apenas clique em migrate. O Plone executará todas as atualizações necessárias.

Migrando de um site pre 1.0 Alpha

Isto não é abordado no procedimento da migração. Sugerimos que adicione uma nova instância de Plone usando o novo código e mova os objetos contidos para dentro do seu novo site. Apenas use o copy e paste nas telas de Gerenciamento do Zope.

Migrando de um pre 1.0 Beta3 (depois do alpha)

Na ZMI você deve adicionar uma ferramenta de migração. Selecione "Plone Tool" da lista de objetos para adicionar, na página seguinte selecione "Plone Migration Tool" e clique "Add". Um novo objeto foi adicionado em sua instância Plone chamado migration_tool. Selecionado o objeto, serão mostradas algumas informações sobre a sua instância Plone e o código no sistema de arquivo.

Entretanto depois que esta ferramenta foi recentemente acidionada ela não será capaz de dizer que instância do Plone você tem e mostrará beta 1.3 para ambas as instâncias atuais e a instância do sistema de arquivos. Selecione a versão que você achar correta e selecione force migration.

[1] Ou em qualquer versão do Plone que você baixou.

[2] Depois de usar um comando de login do cvs será requerida a senha, apenas pressione enter (isto é, deixe a senha em branco)

Próximo: Usando o Plone