Académique Documents
Professionnel Documents
Culture Documents
Copyright © 2006 Pentaho Corporation. Redistribuição permitida. Todas as marcas registradas são
de propriedade de seus respectivos donos.
Para as últimas informações, visite nosso web site www.pentaho.org
Page 1
Sumário
Sumário.............................................................................................................................................................2
Fazendo o Download do Pentaho BI..................................................................................................................3
O Site de Download.......................................................................................................................................3
As Distribuições de Instalação de Pre-Configurada (PCI)..................................................................................3
Distribuição de Instalação J2EE ........................................................................................................................3
Requisitos adicionais.....................................................................................................................................4
Configurar as Bases de dados...................................................................................................................4
Configurar as Soluções de Amostra...........................................................................................................4
A instalação (Deployment)........................................................................................................................5
Incluindo a Aplicação Styles Web..............................................................................................................6
Testando Tudo...........................................................................................................................................6
Deployment em Servidores de Aplicação.........................................................................................................6
JBoss 4.0.3 ....................................................................................................................................................6
Características e Exemplos do Portal........................................................................................................7
Tomcat 5.0.....................................................................................................................................................7
Características e Exemplos do Portal........................................................................................................8
Tomcat 5.5.....................................................................................................................................................8
Características e Exemplos do Portal........................................................................................................9
Modificando a Porta do Servidor ..................................................................................................................9
Edite o arquivo de configuração da aplicação Pentaho Web ....................................................................9
Edite a configuração de seu servidor de aplicação ................................................................................10
Outras Distribuições Disponíveis....................................................................................................................10
Distribuição Fonte.......................................................................................................................................10
Distribuição Java Archive (JAR)....................................................................................................................10
Distribuição de Soluções.............................................................................................................................10
Distribuição de Dados.................................................................................................................................11
Distribuição da Aplicação dos Estilos Web..................................................................................................11
Distribuição da Documentação Javadoc......................................................................................................11
Construindo das Fontes..................................................................................................................................11
Page 2
Fazendo o Download do Pentaho BI
O Site de Download
A Plataforma de BI Pentaho pode ser livremente baixada:
• Clique em ‘Files’
• Selecione o download da distribuição conforme sua necessidade. Se você não está seguro, as
seções de ajuda irão determinar que download é correto para você.
• Seleciona de onde gostaria de baixar os arquivos.
Se escolhe a distribuição PCI, você quererá baixar o Guia do Iniciante, também disponível e, de
http://www.sourceforge.net/projects/pentaho , que o guiará pela instalação simples,
configuração e execução das amostras da plataforma.
Page 3
qualquer um que procure setar e executar a plataforma rapidamente com esforço mínimo.
Usar a Distribuição de Instalação J2EE é a alternativa para as pessoas que querem um arranjo
de plataforma no seu próprio ambiente.
Nota:
Nossa plataforma primária de prova de servidor de aplicação foi JBoss 4.0.3. A comunidade
Pentaho e a equipe de desenvolvimento grandemente apreciam qualquer feedback – se forem
problemas ou mesmo para saber que você teve uma instalação bem sucedida – concernente a
instalações em outros servidores de aplicação. Por favor use o forum em
http://www.pentaho.org/discussion/installation.html para compartilhar sua experiência.
Requisitos adicionais
Além do ‘pentaho_j2ee_deployments-<version>.zip’, você necessitará baixar as seguintes
distribuições:
Page 4
• Se a aplicação tem problemas achando as soluções de amostra, você pode entrar um
parâmetro de configuração para apontar a eles.
o Extraia o arquivo web.xml (do .war)
o Encontre o elemento <param-name> que tem valor ‘solution-path’.
o Diretamente depois do elemento <param-name>, entre um elemento
<param-value>, e ponha seu valor como o caminho absoluto do diretório
‘pentaho-solutions’.
o Exemplo: <param-value>d:\pentaho\pentaho-solutions</param-value>
o Reconstrua o arquivo .war.
A instalação (Deployment)
Para instalar a Platforma de BI Pentaho, você primeiramente deve ter um arquivo J2EE-
compliant que contenha todos os arquivos e recursos para a plataforma. Montamos o
‘pentaho_j2ee_deployments-<version>.zip' para ajudar a construir para a maioria mais usados
arquivos.
Se você usa JBoss ou Tomcat como seu servidor de aplicação, este bundle construirá o arquivo
para você. Se usa um servidor diferente de aplicação, você necessitará escrever a própria
tarefa Ant para construir o arquivo que você quer, e adicionar os arquivos de configuração que
são específicos a seu servidor de aplicação. Estaríamos felizes em incorporar sua tarefa Ant ao
bundle se você desejar contribui-lo. Veja os detalhes sobre contribuir a Pentaho em http:
//www.pentaho.org/contributions.
Então, por exemplo, se quisesse construir um arquivo .war para Tomcat em Windows, o
comando pareceria semelhante a isto:
Aguarde o script terminar. O arquivo resultante .ear ou .war será encontrado em uma subpasta
/dist/<appserver>, o qual é criado em seu diretório de trabalho. No nosso exemplo,
<appserver> será a pasta do tomcat.
Agora que construiu o arquivo apropriado para seu servidor de aplicação, você pode instalar a
plataforma. Os procedimentos de instalação serão específicos ao servidor de aplicação que
você usa, que nós supomos são já familiares.
IMPORTANTE!
Page 5
Verifique dicas específicas do servidor de aplicação ao final do documento para
passos adicionais necessários para sua instalação.
Testando Tudo
Isto deve bastar! Verifique as dicas do servidor de aplicação abaixo e lembre-se de iniciar o
banco de dados antes. A URL dos exemplos será http://localhost:8080/pentaho/Navigate. O host
name dependerá se seu servidor app está instalado localmente ou é remoto, então ajuste se
necessário. E divirta-se!
A aplicação web Pentaho depende do JNDI para nomear as fontes de dados, portanto estas
fontes devem ser definidas para o JBoss. O JBoss 4.0.3 padrão usa um arquivo xml com
denominação convencionada para –ds.xml. Se o deployment for para arquivo .ear, não será
preciso definir estas fontes de dados, mas para arquivo .war, podem ser usadas as definições
contidas na raiz do pacote jboss_pentaho_war-<latest version>.zip,
• PentahoHibernate-ds.xml
• quartz-ds.xml
• sampledata-ds.xml
• shark-ds.xml
Page 6
2. Faça o download do jaxen 1.1 beta 4 de http://jaxen.org/releases.html, ou use o pacote
jaxen.jar de pentaho_j2ee_deployments-<version>.zip.
3. Faça o download de dom4j 1.6.1 de http://dom4j.org/download.html, ou use o
dom4j_1.6.1.jar contido na raiz de pentaho_j2ee_deployments-<version>.zip.
4. Copie o arquivo jaxen.jar no diretório <jboss_home>/lib.
5. Delete o arquivo dom4j.jar de <jboss_home>/lib.
6. Renomeie o dom4j_1.6.1.jar para dom4j.jar e copie o novo arquivo dom4j.jar na pasta
<jboss_home>/lib.
7. Faça o deployment do .war ou .ear. No caso do .war, certifique-se de que o nome fica
pentaho.war.
8. Se realizar deployment para arquivo pentaho.war, adicione os arquivos *-ds.xml
listados acima para a pasta <jboss_home>/server/default/deploy. Se não estiver
usando o servidor padrão, copie os arquivos no diretório de deploy do servidor.
9. Verifique se o banco de dados está rodando.
10. Reinicie o servidor.
Estas dicas valem para o arquivo pentaho.war e para JBoss SOMENTE. Você pode poupar
alguns problemas se construir para pentaho.ear em JBoss o qual incorpora vários passos que
seriam manuais.
Tomcat 5.0
Se você está fazendo o deployment do Pentaho BI para Tomcat 5.0, veja as dicas abaixo.
Recomendamos que você inicie do ‘pentaho_j2ee_deployments-<version>.zip’ e construa seu
arquivo .war desta distribuição.
Para acessar os bancos de dados padrão para os exemplos, você deve adicionar o hsqldb.jar (o
driver do banco de dados Hypersonic) para a pasta common/lib do Tomcat 5.0.
A aplicação web Pentaho depende do JNDI para nomear as fontes de dados, portanto estas
fontes devem ser definidas para o Tomcat. O Tomcat 5.0 padrão usa as entradas xml no
arquivo server.xml.
Page 7
Mapeamento das fontes de dados JNDI para Tomcat 5.5:
Tomcat 5.5
Se você está fazendo o deployment do Pentaho BI para Tomcat 5.5, veja as dicas abaixo.
Recomendamos que você inicie do ‘pentaho_j2ee_deployments-<version>.zip’ e construa seu
arquivo .war desta distribuição.
Para acessar os bancos de dados padrão para os exemplos, você deve adicionar o hsqldb.jar (o
driver do banco de dados Hypersonic) para a pasta common/lib do Tomcat 5.5.
A aplicação web Pentaho depende do JNDI para nomear as fontes de dados, portanto estas
fontes devem ser definidas para o Tomcat. Descobrimos que adicionando os recursos ao
elemento <Context> aninhado dentro de <Host> funciona bem. Proporcionamos alguns
exemplos de xml abaixo.
Page 8
2. Copie hsqldb.jar da pasta pentaho-third-party para <tomcat-home>/common/lib, onde
<tomcat-home> é a raiz de seu servidor de aplicação Tomcat. O hsqldb.jar está
contido no ‘pentaho_j2ee_deployments-<version>.zip’.
3. Abra o arquivo server.xml, localizado em <tomcat-home>\conf.
4. COM CUIDADO adicione o xml listado abaixo entre os nodos <Host></Host> no
arquivo server.xml.
5. Salve e feche o arquivo server.xml.
6. Inicie o banco de dados.
7. Reinicie o servidor Tomcat.
Nota: Neste procedimento, assumimos que você colocou o arquivo pentaho.war na pasta
webapps e que o Tomcat está setado para fazer autodeploy de novas aplicações.
Page 9
Edite a configuração de seu servidor de aplicação
Ajustar a porta em que o servidor roda é uma tarefa inerente de administração. Cada servidor
de aplicação é único em seus requisitos. Como nossa implementação de referência é feita em
JBoss, nossa documentação é para este sistema. Para outros servidores de aplicação , consulte
documentação específica.
• Edite <jboss-home>/server/default/deploy/jbossweb-tomcat55.sar/server.xml. ** Se
estiver usando a instalação pré-configurada, o server.xml é localizado em pentaho-
demo/jboss/server/default/deploy/jbossweb-tomcat55.sar/server.xml.
• Mude o texto port=”8080” para o número da porta que deseja usar. Você pode mudar
as portas de outros conectores também se quiser.
A distribuição fonte pode ser anexada a biblioteca binária para depuração e auditoria, ou
modificada e recompilada para seus próprios interesses. Não oferecemos scripts de construção
ou documentação com o arquivo fonte. Se você estiver interessado nisto, deve fazer download
do Pentaho SDK no SourceForge.net.
A distribuição Java Pacote (JAR) é útil se você quiser codificar para a API da plataforma em uma
aplicação independente ou deseja incluir classes em sua aplicação web.
Distribuição de Soluções
A distribuição de soluções é um pacote de documentos de exemplo e soluções de teste que
pode ser usado como ponto de partida para suas próprias soluções, ou colocado em seu
deployment personalizado da platforma. Esta distribuição é encontrada em SourceForge como
‘pentaho_solutions-<version>.zip’.
Para maiores informações em como construir soluções Pentaho e para entender os esquemas
de documentos de soluções, consulte o Guia Construindo Soluções, o qual também pode ser
encontrado em nossa página do SourceForge.net.
Page 10
Distribuição de Dados
A distribuição de dados é um pacote de diversos bancos de dados Hypersonic que contém
todos os dados de aplicação e exemplos requeridos para rodar a distribuição pré-configurada e
soluções. Esta distribuição pode ser encontrada em SourceForge como ‘pentaho_data-
<version>.zip’.
Faça download da distribuição de dados se você deseja construir a plataforma a partir das
fontes ou está tentando rodar as soluções exemplo.
Se você quer construir os exemplos da plataforma após ter construído das fontes ou precisa
começar sua própria customização, então deve obter esta distribuição, a qual também está
disponível no SourceForge.
Para satisfazer estas necessidades, dispomos do Pentaho SDK, o qual oferece aos
desenvolvedores um conjunto de arquivos que eles podem jogar na IDE e iniciar a compilar e
analisar o código fonte do Pentaho com relativa facilidade. O Pentaho SDK está disponível
para download em nosso site do Sourceforge.
Se (após seguir as instruções no guia do SDK) você ainda não chegar a seu objetivo final,
existe um forum que poderá lhe ajudar: http://www.pentaho.org/index.php?
option=com_simpleboard&Itemid=275&func=showcat&catid=14.
Page 11