Tarefas pós-instalação

Endurecimento e desempenho ..

Endurecimento e Ajustes Pós‑instalação

Configurações opcionais que você pode aplicar após a instalação para endurecer o Tomcat/Pentaho e ajustar o comportamento:

Ocultar o cabeçalho do servidor Tomcat

Por padrão, o Tomcat envia um Server cabeçalho expondo informações da versão. Você pode sobrescrevê‑lo para reduzir o vazamento de informações.

1. Edite o conector do Tomcat em server.xml.

sudo nano /opt/pentaho/server/pentaho-server/tomcat/conf/server.xml

1. Adicione ou atualize o server atributo no conector HTTP e (se usado) no conector AJP, então salve.

<Connector port="8080" protocol="HTTP/1.1"
           connectionTimeout="20000"
           server=" "
           redirectPort="8443" />

1. Reinicie o Pentaho Server.

sudo systemctl restart pentaho-server

Java Security Manager (obsoleto/removido)

O legado Java Security Manager está obsoleto e não está disponível nas versões LTS modernas do Java (incluindo o Java 21). Não use -security com o Tomcat no Java 21. Prefira endurecimento ao nível do SO, usuários com privilégios mínimos, escopo de rede e políticas de container/AppArmor/SELinux conforme apropriado.

Alterar o caminho de contexto da aplicação web

Altere o caminho de contexto se você não quiser que a aplicação seja acessível em /pentaho.

1. Pare o Pentaho Server.

cd /opt/pentaho/server/pentaho-server
sudo ./stop-pentaho.sh

1. Edite context.xml.

sudo nano /opt/pentaho/server/pentaho-server/tomcat/webapps/pentaho/META-INF/context.xml

1. Atualize o caminho de contexto.

<Context path="/company" docBase="webapps/company/" />

1. Renomeie a pasta da webapp para corresponder ao novo nome de contexto.

sudo mv /opt/pentaho/server/pentaho-server/tomcat/webapps/pentaho \
        /opt/pentaho/server/pentaho-server/tomcat/webapps/company

1. Atualize o redirecionamento em ROOT/index.jsp.

sudo nano /opt/pentaho/server/pentaho-server/tomcat/webapps/ROOT/index.jsp

Altere o meta refresh para:

<meta http-equiv="refresh" content="0;URL=/company">

1. Atualize a URL do servidor.

sudo nano /opt/pentaho/server/pentaho-server/pentaho-solutions/system/server.properties

fully-qualified-server-url=http://localhost:8080/company/

1. Inicie o servidor e teste.

sudo ./start-pentaho.sh

Atualizações podem sobrescrever webapps implantadas. Reaplique personalizações após atualizações ou use mapeamento de caminho via proxy reverso em vez disso.

Mudar para HTTPS

A porta padrão é 8080.

1. Pare o Pentaho Server.

cd /opt/pentaho/server/pentaho-server
sudo ./stop-pentaho.sh

1. Altere a porta do conector.

sudo nano /opt/pentaho/server/pentaho-server/tomcat/conf/server.xml

<Connector URIEncoding="UTF-8"
      port="8443"
      protocol="org.apache.coyote.http11.Http11NioProtocol"
      maxThreads="150"
      SSLEnabled="true"
      scheme="https"
      secure="true"
      clientAuth="false"
      sslProtocol="TLS"
      keystoreType="PKCS12"
      keystoreFile="/opt/pentaho/pentaho-server/tomcat/ssl/keystore.p12"
      keystorePass="changeit"
    />

1. Atualize a URL do servidor.

sudo nano /opt/pentaho/server/pentaho-server/pentaho-solutions/system/server.properties

fully-qualified-server-url=http://localhost:8090/pentaho/

1. Inicie o servidor e verifique.

sudo ./start-pentaho.sh
curl -I http://localhost:8090/pentaho/ | head -n 1

Alterar a porta HTTP padrão

A porta padrão é 8080.

1. Pare o Pentaho Server.

cd /opt/pentaho/server/pentaho-server
sudo ./stop-pentaho.sh

1. Altere a porta do conector.

sudo nano /opt/pentaho/server/pentaho-server/tomcat/conf/server.xml

<Connector URIEncoding="UTF-8"
           port="8090" protocol="HTTP/1.1"
           connectionTimeout="20000"
           redirectPort="8443"
           relaxedPathChars="[]|"
           relaxedQueryChars="^{}[]|&amp;"
           maxHttpHeaderSize="65536" />

1. Atualize a URL do servidor.

sudo nano /opt/pentaho/server/pentaho-server/pentaho-solutions/system/server.properties

fully-qualified-server-url=http://localhost:8090/pentaho/

1. Inicie o servidor e verifique.

sudo ./start-pentaho.sh
curl -I http://localhost:8090/pentaho/ | head -n 1

Endurecer ou desabilitar a porta de shutdown do Tomcat

Por padrão o Tomcat escuta em uma porta local de shutdown (8005) para o SHUTDOWN comando.

• Desabilite a porta definindo port="-1", ou

• Altere tanto a porta quanto o comando de shutdown para valores imprevisíveis.

1. Edite o <Server> elemento em server.xml.

sudo nano /opt/pentaho/server/pentaho-server/tomcat/conf/server.xml

Exemplos:

<Server port="-1" shutdown="SHUTDOWN">

ou

<Server port="18005" shutdown="My$tr0ngShutCmd">

1. Reinicie o Pentaho Server.

sudo systemctl restart pentaho-server

Páginas de erro personalizadas (404, 403, 500)

Defina páginas de erro em nível de aplicação para evitar expor padrões.

1. Crie uma página de erro na sua webapp.

sudo tee /opt/pentaho/server/pentaho-server/tomcat/webapps/pentaho/error.jsp >/dev/null <<'EOF'
<html>
<head>
  <title>Error</title>
</head>
<body>
  <h1>Something went wrong</h1>
  <p>Please contact your administrator.</p>
</body>
</html>
EOF

1. Adicione mapeamentos de erro no webapp web.xml.

sudo nano /opt/pentaho/server/pentaho-server/tomcat/webapps/pentaho/WEB-INF/web.xml

<error-page>
  <error-code>404</error-code>
  <location>/error.jsp</location>
</error-page>
<error-page>
  <error-code>403</error-code>
  <location>/error.jsp</location>
</error-page>
<error-page>
  <error-code>500</error-code>
  <location>/error.jsp</location>
</error-page>

1. Reinicie o servidor e teste.

Tempo limite de sessão

Defina um tempo limite de sessão global para a aplicação.

1. Edite a webapp web.xml.

sudo nano /opt/pentaho/server/pentaho-server/tomcat/webapps/pentaho/WEB-INF/web.xml

<session-config>
  <session-timeout>20</session-timeout>
</session-config>

Aumentar o tempo de espera de inicialização do Karaf

Se a inicialização do servidor expirar enquanto o Karaf instala recursos, aumente o tempo de espera.

1. Pare o servidor.

sudo systemctl stop pentaho-server

1. Edite server.properties.

sudo nano /opt/pentaho/server/pentaho-server/pentaho-solutions/system/server.properties

Descomente ou adicione:

# Tempo (ms) para aguardar o Karaf instalar recursos antes de expirar
karafWaitForBoot=180000

1. Inicie o servidor.

sudo systemctl start pentaho-server

Remover dados de exemplo do servidor

Remova amostras de avaliação antes de mover para produção.

1. Pare o servidor.

sudo systemctl stop pentaho-server

1. Exclua o samples.zip do conteúdo padrão (o caminho pode variar conforme a versão).

sudo rm -f /opt/pentaho/server/pentaho-server/pentaho-solutions/system/default-content/samples.zip || true

1. Edite a webapp web.xml e remova as definições de amostra HSQLDB e o SystemStatusFilter (apenas dev).

sudo nano /opt/pentaho/server/pentaho-server/tomcat/webapps/pentaho/WEB-INF/web.xml

Remova blocos semelhantes a:

<context-param>
  <param-name>hsqldb-databases</param-name>
  <param-value>sampledata@../../data/hsqldb/sampledata</param-value>
</context-param>

<listener>
  <listener-class>org.pentaho.platform.web.http.context.HsqldbStartupListener</listener-class>
</listener>

<filter>
  <filter-name>SystemStatusFilter</filter-name>
  <filter-class>com.pentaho.ui.servlet.SystemStatusFilter</filter-class>
</filter>

1. Opcionalmente remova o data/ diretório se apenas conteúdo de exemplo foi usado (verifique seu ambiente antes de excluir).

sudo rm -rf /opt/pentaho/server/pentaho-server/data || true

1. Inicie o servidor e remova pastas de amostra via PUC (Browse Files → Public → Move to Trash).

sudo systemctl start pentaho-server

Ocultar widgets da perspectiva Home

Oculte Getting Started e outros widgets da página Home do PUC.

1. Pare o servidor.

sudo systemctl stop pentaho-server

1. Edite a configuração da perspectiva Home.

sudo nano /opt/pentaho/server/pentaho-server/tomcat/webapps/pentaho/mantle/home/properties/config.properties

Adicione ou atualize:

disabled-widgets=getting-started,recents,favorites

1. Inicie o servidor e faça login para verificar.

sudo systemctl start pentaho-server

Desativar autocomplete na página de login (avançado)

Alterações em JSPs do fornecedor podem ser sobrescritas na atualização. Prefira SSO ou controles via proxy reverso. Se necessário, edite o JSP de login.

1. Pare o servidor.

sudo systemctl stop pentaho-server

1. Edite PUCLogin.jsp.

sudo nano /opt/pentaho/server/pentaho-server/tomcat/webapps/pentaho/jsp/PUCLogin.jsp

1. Defina autocomplete como off para os campos de usuário/senha.

<input id="j_username" name="j_username" type="text" autocomplete="off">
<input id="j_password" name="j_password" type="password" autocomplete="off">

1. Inicie o servidor.

sudo systemctl start pentaho-server

Aumentar limites de upload de CSV

Ajuste os limites de upload e (opcionalmente) o banco de dados de staging.

1. Edite pentaho.xml.

sudo nano /opt/pentaho/server/pentaho-server/pentaho-solutions/system/pentaho.xml

<file-upload-defaults>
  <relative-path>/system/metadata/csvfiles/</relative-path>
  <max-file-limit>10000000</max-file-limit>
  <max-folder-limit>500000000</max-folder-limit>
</file-upload-defaults>

1. Altere o banco de dados de staging para arquivos CSV (opcional) em data-access/settings.xml.

sudo nano /opt/pentaho/server/pentaho-server/pentaho-solutions/system/data-access/settings.xml

<!-- settings for Agile Data Access -->
<data-access-staging-jndi>hibernate</data-access-staging-jndi>

1. No PUC, vá em Tools → Refresh System Settings, então reinicie o PUC (ou o servidor) para aplicar.

---