Instalar o Servidor Pentaho
Instalação dos componentes do Servidor Pentaho ..
Servidor Pentaho
Esta seção orienta você na instalação e inicialização do Servidor Pentaho no Ubuntu.
Você irá:
Criar diretórios de instalação
Preparar os bancos de dados do Repositório Pentaho
Configurar conexões JDBC/JNDI
Iniciar o Servidor Pentaho (e opcionalmente configurar systemd)
Configurar o Gerenciador de Licenças
Baseline testado: Ubuntu 24.04 LTS com Java 21 (OpenJDK) e PostgreSQL 17.
Certifique-se de que você completou Preparar Ambiente primeiro.
Para detalhes de compatibilidade, veja Referência de Componentes.
Pré-requisitos
Servidor Ubuntu 24.04 LTS
Java 21 instalado e
PENTAHO_JAVA_HOMEdefinidoPostgreSQL 17 instalado e em execução
Um usuário não root
pentahocom sudopacote unzipinstaladoZIPs de arquivo e drivers JDBC baixados

Diretórios do Servidor Pentaho
O Servidor Pentaho é uma aplicação web executada em um contêiner servlet Apache Tomcat.
Crie diretórios base em
/opt/pentaho.
Crie subdiretórios em
/opt/pentaho/software.
Descompacte o Pacote do Servidor Pentaho (ZIP)
Use pacote unzip para extrair o ZIP do servidor para o diretório runtime. Isso evita a necessidade do JDK completo (o JRE não inclui a ferramenta jar ).
pentaho-server-ee-11.0.0.0-2xx.zip- Servidor Pentaho (Arquivo - inclui Tomcat 10)
Garanta que
pacote unzipestá disponível e copie os ZIPs do servidor para o staging.
Extraia o ZIP do Servidor Pentaho em
$PENTAHO_BASE/server.

Torne todos os
.sharquivos executáveis.
Defina propriedade e permissões sensatas para executar 'pentaho' como um usuário não root.
755 significa que você pode fazer qualquer coisa com o arquivo ou diretório, e outros usuários podem ler e executar, mas não alterá-los. Adequado para programas e diretórios que você quer tornar publicamente acessíveis.
644 significa que você pode ler e escrever o arquivo ou diretório e outros usuários só podem lê-lo.
Verifique a estrutura de diretórios do servidor.
/opt/pentaho/
Plugins de servidor são instalados em pentaho-solutions/system pasta.
Componentes do Repositório Pentaho
O Repositório Pentaho (no PostgreSQL por padrão) consiste em:
Jackrabbit: repositório de soluções, segurança e metadados de conteúdo
Quartz: dados do agendador
Hibernate: registro de auditoria
Pentaho Operations Mart: relatórios de uso e desempenho
Revise senhas padrão nos scripts SQL
Inspecione os scripts PostgreSQL fornecidos com o servidor.
Você deverá ver arquivos semelhantes a:
Abra um script para revisar usuários/senhas padrão (alterar para produção).
Execute scripts SQL para criar bancos de dados do Repositório
Confirme que o PostgreSQL está em execução e localize os scripts.
Conecte-se como um
pentahosuperusuário.
Senha: SecurePassword123
Execute os comandos passo a passo - não como um único bloco de script. Forneça senhas se solicitado - veja abaixo.
postgres
SecurePassword123
pentaho
SecurePassword123
jcr_user
password
pentaho_user
password
hibuser
password
Validação rápida (CLI) - liste os bancos de dados criados e conecte-se - pressione q para percorrer a lista.
Tabelas para Hibernate e Jackrabbit podem ser criadas mais tarde pelo Servidor Pentaho na primeira inicialização. Ver esquemas vazios nesta etapa pode ser esperado.
Opcional: verifique no pgAdmin (GUI).

Configure o Pentaho para usar PostgreSQL
PostgreSQL é o padrão. Se você manteve as senhas e a porta padrão (5432), apenas verifique as configurações abaixo; caso contrário, ajuste host/porta/usuário/senha para corresponder ao seu ambiente.
Quartz - defina o delegate do PostgreSQL e a fonte de dados JNDI.
Abra a configuração do Quartz.
Verifique estes valores (números de linha podem diferir):
Hibernate — aponte para o arquivo de configuração do PostgreSQL.
Abra as configurações do Hibernate.
Confirme a referência do arquivo de configuração:
Opcionalmente revise
postgresql.hibernate.cfg.xmlpara nome da datasource e dialect.
Assegure:
Jackrabbit — verifique o armazenamento PostgreSQL em repository.xml.
Abra a configuração do Jackrabbit.
Verifique se as seções do PostgreSQL estão ativas (outras comentadas), por exemplo:
Esquema de sistema de arquivos:
postgresqlDatastore
databaseType="postgresql"Esquema do PersistenceManager:
postgresqlDiário de Banco de Dados:
postgresql
Verifique os nomes JNDI e as portas no Quartz, Hibernate, Jackrabbit e Tomcat context.xml para garantir consistência (mesmo host, porta 5432 a menos que alterada, e nomes de recursos JNDI correspondentes).
Nomes JNDI esperados:
Quartz:
QuartzHibernate:
java:comp/env/jdbc/HibernateJackrabbit: conforme referenciado em
repository.xml
Tomcat
Após configurar o Repositório, configure o servidor de aplicação web (Tomcat 10) para conectar-se ao Repositório usando JDBC/JNDI.
Drivers JDBC
Para conectar a bancos de dados (incluindo o Repositório), instale os drivers JDBC apropriados. Devido a restrições de licença, alguns drivers devem ser baixados manualmente.
Verifique se o driver JDBC do PostgreSQL está presente em lib do Tomcat (exigido para o Repositório):
Se não for encontrado, baixe o driver JDBC do PostgreSQL (por exemplo, postgresql-42.7.8.jar) e distribua-o usando o script auxiliar:
Copie quaisquer drivers JDBC adicionais para a pasta de staging e distribua.
Distribua os drivers para o Tomcat.
Verifique se os JARs estão presentes em lib do Tomcat.
Você deve reiniciar o Servidor Pentaho (e ferramentas clientes, se estiverem em execução) para carregar novos drivers JDBC. Não é necessário um reboot completo do sistema.
context.xml
Informações de conexão de banco de dados para recursos JNDI usados pelo Pentaho são armazenadas em context.xml.
Abra o arquivo e revise os recursos JNDI e credenciais.
Em produção, verifique se nome de usuário, senha, classe do driver, host/IP e porta correspondem ao seu ambiente. Garanta que os nomes JNDI alinhem-se com as configurações do Quartz, Hibernate e Jackrabbit.
Iniciar Servidor Pentaho
Execute o servidor como o usuário pentaho para evitar problemas de permissão.
Inicie o servidor.
Acompanhe o log do Tomcat (padrão robusto).
Mensagens esperadas incluem:
Pentaho User Console (PUC)
A Pentaho User Console (PUC) é a interface web para criar e visualizar conteúdo.
Credenciais padrão (altere imediatamente após o primeiro login):

Você também tem a opção de alternar para a nova tela de login.

Se você já inseriu seus detalhes de licenciamento, você será redirecionado para a nova User Console.
Validações rápidas
Verifique se o HTTP está respondendo:
Opcional (acesso remoto): abra o firewall e teste a partir de uma máquina cliente (ajuste conforme a política de sua rede):
Systemd (opcional)
Crie um serviço systemd para gerenciar o Pentaho na inicialização e em caso de falha.
Salve o arquivo unit como
/etc/systemd/system/pentaho-server.service.
Recarregue e inicie.
Gerencie o serviço:
Solução de problemas (clique para expandir)
HTTP 404 em
/pentahoapós a inicialização: confirme"$TOMCAT_HOME/webapps/pentaho"existe, verifiquecatalina.*.logpor erros de implantação, e verifique permissões de arquivo em$PENTAHO_SERVER.Porta 8080 já em uso: altere a porta do Tomcat em
server.xmlou pare o serviço conflitante.Driver JDBC não encontrado: verifique os JARs do driver (por exemplo,
postgresql-*.jar,mysql-*.jar) existem em"$TOMCAT_HOME/lib".Autenticação ao PostgreSQL falha: prefira
scram-sha-256; revisepg_hba.conf, reinicie o PostgreSQL e testepsql -h 127.0.0.1com o usuário alvo.Problemas de esquema do Jackrabbit: verifique novamente
repository.xmlseções estão definidas parapostgresql.Erros de ativação de licença: verifique os logs do Tomcat em
tomcat/logs/porlicense/elmmensagens.
Gerenciador de Licenças
O Pentaho Pro Suite 11.x usa um Gerenciador de Licenças (na nuvem ou local) para gerenciar direitos do PDI & BA e verificar plugins EE.

Licença de avaliação
Uma licença de avaliação de 30 dias está incluída se você baixou de: Avaliação Pentaho de 30 dias
Se você baixou os binários GA de: Portal do Cliente Pentaho, então você precisará de um ID de Ativação ou da sua URL de Licenciamento.
Se você instalou em um ambiente isolado (air-gapped), precisará solicitar uma licença offline.
Abra Servidor Pentaho > Administração > Licenças para abrir o diálogo Adicionar Licença.
Clique no sinal +.

Insira o código de Ativação ou sua URL de licenciamento:

Licenças empresariais
Se estiver atualizando a partir da versão 9.x ou anterior, instale a nova versão do produto antes de ativar as licenças. Não inicie o servidor antes de atualizar as licenças.
Defina variável de ambiente do caminho da licença
Crie um PENTAHO_LICENSE_INFORMATION_PATH variável de ambiente para que o Servidor Pentaho encontre consistentemente seu arquivo de licença.
Garanta que o diretório de destino exista e esteja seguro.
Edite
/etc/environmente adicione a linha abaixo (semexport).
Acrescente (ou atualize) o seguinte:
Faça logout/login ou recarregue o ambiente e verifique.
A PENTAHO_LICENSE_INFORMATION_PATH variável agora está definida.
Atualizado
Isto foi útil?
