Skip to main content
Pentaho Documentation

Starting DI Server on Windows

Overview

Explains how to start the DI Server.

Install License Keys Using the Command Line Interface

  1. Download the .lic file you want to install.
  2. Copy your .lic files to the DI Server.
  3. Navigate to the license-installer directory: pentaho\license-installer
  4. Run install_license.bat with the install switch and the location and name of your license file as a parameter, like this:
install_license.bat install "C:\Users\dvader\Downloads\Pentaho DI Enterprise Edition.lic"

Modify Tomcat Windows Startup Script

The Tomcat startup script must be modified to include the CATALINA_OPTS variable. CATALINA_OPTS indicates the amount of memory to allocate. It also indicates where Pentaho licenses are installed. Specific instructions on how to modify the startup script depend on your operating system.

  1. Make sure the Tomcat web application server is not running by starting the Windows Task Manager and looking for Tomcat in the Applications tab. If the server is running, stop it.
  2. Use a text editor to open the startup.bat file, which is in the bin subdirectory of the Tomcat home directory.
  3. Add this line before the CATALINA_HOME definition.
SET DI_HOME=%~dp0pentaho-solutions\system\kettle
  1. Add this line directly before the call "%EXECUTABLE%" start %CMD_LINE_ARGS% line, which is located near the end of the file.
set CATALINA_OPTS=-Xms4096m -Xmx6144m -XX:MaxPermSize=256m -Dsun.rmi.dgc.client.gcInterval=3600000 -Dsun.rmi.dgc.server.gcInterval=3600000 -Dpentaho.installed.licenses.file=%PENTAHO_INSTALLED_LICENSE_PATH% -DDI_HOME=%DI_HOME%
  1. Save and close the file.

Modify JBoss Startup Script

The JBoss startup script must be modified to include the JAVA_OPTS variable. JAVA_OPTS indicates the amount of memory to allocate. It also indicates where Pentaho licenses are installed. Specific instructions on how to modify the startup script depend on your operating system.

  1. Make sure the JBoss web application server is not running by starting the Windows Task Manager and looking for JBoss in the Applications tab. If the server is running, stop it.
  2. Use a text editor to open the standalone.conf.bat file, which is located in the JBoss bin directory.
  3. Use a text editor to open the standalone.bat file.
  1. Locate "x%JBOSS_HOME%" == "x"  ( and copy this text above it:
pushd "%DIRNAME%..\.."
set "INSTALL_HOME=%CD%"
popd
SET DI_HOME=%INSTALL_HOME%\pentaho-solutions\system\kettle
  1. Save and close the file.

Start DI Server

  1. Run the startup script for your web application server by launching one these files.
    • Windows Tomcat: Launch the startup.bat file. The startup.bat file is in the Tomcat bin directory.
    • Windows JBoss: Launch the standalone.bat file. The startup.bat file is in the JBoss bin directory.
  2. The server starts. There is no GUI for the server, but when you install then start the client tool, which is called Spoon, you can interact with the DI Server from there. When you start Spoon, you will also be prompted to enter your license information. See Install DI Tools to learn how to install Spoon and other plugins.

Problems Starting the DI Server?

Check out our Troubleshooting Guide for help.