Skip to main content
Pentaho Documentation

Start DI Server

Overview

Explains how to start the DI Server.

Image of the DI Server installation steps.

After you've complete the tasks in the Prepare Environment, Initialize Repository, and Specify Connections steps, you can now install license keys and 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 licenses directory. pdi/pdi-ee/data-integration/licenses
  4. Run the license installation script.
    1. For Linux: Run install_license.sh with the install switch and the location and name of your .lic file as a parameter. You can specify multiple .lic files separated by spaces. Be sure to use backslashes to escape any spaces in the path or file name. install_license.sh install /home/dvader/downloads/Pentaho\ DI\ Enterprise\ Edition.lic
    2. For Windows: Run install_license.bat with the install switch and the location and name of your license file as a parameter. install_license.bat install "C:\Users\dvader\Downloads\Pentaho DI Enterprise Edition.lic"

Modify Tomcat 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.

Modify the Tomcat Windows Startup Script

  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 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%
  4. Save and close the file.

Modifying the Tomcat Linux Startup Script

  1. Make sure the Tomcat web application server is not running by opening a Terminal window and typing ps -A at the prompt. If the server is running, stop it.
  2. Use a text editor to open the startup.sh file, which is in the bin subdirectory of the Tomcat home directory.
  3. Add this line directly before the exec "$PRGDIR"/"$EXECUTABLE" start "$@" line near the end of the file. export 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"
  4. Save and close the file.

Windows Pentaho Archive Installation

If you used the Archive Installation, we provide individual control scripts to start and stop the DI server, and DI repository. Here is where you can find the individual control scripts.

DI Repository

  • The Archive Installation enables you to install PostgreSQL, MySQL, or Oracle as the solution repository. Consult the third-party documentation for the RDBMS to find more information about starting and stopping.

    The solution repository must be started before the DI Server.

DI Server

  • /pentaho/server/data-integration-server

Linux and Macintosh OS Pentaho Installation Wizard

When you ran the Installation Wizard on Linux, the DI Server was deployed in an included Apache Tomcat application server. You can control the Tomcat server using the start and stop scripts that come with the Pentaho installation. This script is also used as an easy way to start and stop the DI Server and the PostgreSQL repository. You can find this script at /pentaho/ctlscript.sh.

Here is a list of the script arguments you can use with the data-integration-server service.

Arguments
  • start
  • stop
  • restart
  • status
  • help

./ctlscript.sh start data-integration-server

./ctlscript.sh status data-integration-server

./ctlscript.sh help