Install IBM TM1 Server components on UNIX or Linux

You can use the installation wizard to select the server components for installation and the installation location on your computer.

For a complete list of supported UNIX and Linux® operating systems, create a detailed system requirements report for IBM® Planning Analytics Local software by using the Software Product Compatibility Reports tool (

Before you begin

When you install TM1® Server on UNIX or Linux operating systems, configure the components to run as a user with appropriate permissions for TM1 binary files and TM1 databases.

Note: Only the TM1 Server components can run on UNIX or Linux. You cannot run TM1 clients on UNIX or Linux.

Complete the following prerequisites:

  • Familiarize yourself with TM1 terms and concepts.

    For more information, see the TM1 for Developers documentation.

  • Determine which components you want to install and how they must be distributed across your hardware environment.

    For more information on how to design the optimal TM1 environment, see Planning Analytics Local architecture and Deploying Planning Analytics Local.

  • Determine your hardware and software requirements.

    Review a list of supported environments, including operating systems, patches, web servers, and web browsers, by creating a detailed system requirements report for IBM Planning Analytics Local software with the Software Product Compatibility Reports tool (

    • If you plan to import data from another relational database, install your database software first.
    • If you are running Oracle on UNIX, install the appropriate UNIX client software for your Oracle database on the UNIX machine. Use the Oracle Network Configuration Assistant to specify a local net service name.
    • If you are running on Red Hat Enterprise Linux, install the required runtime C/C++ libraries that are listed in the Prerequisites tab of the Detailed Systems Requirements Report or verify that they are already available. Additional libraries might need to be installed, depending on your version of Red Hat Enterprise Linux. For example, on Red Hat Enterprise Linux (RHEL) Server 7, run the following command to install additional libraries:
      yum -y install libstdc++ libstdc++.i686 motif libXtst
  • Optional: Install your own copy of the Java™ Runtime Environment (JRE) if necessary. The TM1 installation does not provide a JRE for UNIX installations.
    Note: If you are installing on IBM POWER8® LE, you do not need to install a JRE.
  • Optional: Check the X-server software on your UNIX machine.

    To run the Graphical User Interface UNIX Installation Wizard, X-server software must be installed on the machine that hosts your TM1 components. You must install X-server client software on the machine from which you run the TM1 Installation Wizard. If X-server software is not installed on the UNIX machine, run the console installation.

    Note: If you do not use X-server software, you must use an unattended installation. For more information, see Setting up unattended installations and configurations.
  • Optional: Install and configure the TM1 components to run as a user with appropriate permissions for TM1 binary files and TM1 databases.


  1. Go to the location where the installation files were downloaded and extracted, or insert the product disk.
  2. Go to the operating system directory and then type the following command:


  3. Follow the directions in the installation wizard and copy the required files to your computer.
  4. Select the components that you want to install. By default, all components are installed.
  5. In the Finish page of the installation wizard, click Finish.