Before you install IBM TRIRIGA Application Platform

Verify IBM® TRIRIGA® Application Platform hardware and software requirements before you start the installation process.

The Compatibility Matrix for IBM TRIRIGA Products IBM Support page provides information about the IBM TRIRIGA supported software products. It lists the application servers, database servers, web servers, third-party servers, third-party components, and client options with which the IBM TRIRIGA Application Platform is certified. For more information, refer to the IBM TRIRIGA Best Practices for System Performance.

Furthermore, the following list outlines the hardware requirements and other software considerations:
Memory

The database server must have at least 3 GB of physical dedicated memory.

Ensure that you allocate enough memory to your application servers. Monitor memory usage regularly to avoid out of memory errors. You might also want to consider deploying a second process server to ensure that workflow processing continues if a process server experiences a failure.

Disk space
You must prepare the following disk space requirements:
  • If you download all components of an installation, you need at least 1.8 GB of disk space.
  • In addition, the installation occupies approximately 300 MB of disk space.
  • For the installer to run, you need at least 160 MB in temporary space on the hard disk.
  • For a new installation, you need at least 7 GB within the database.
  • Each WebSphere® Application Server profile requires approximately 1 GB of disk space.
Application server and database server
The application server and database server must be in the same physical location, such as a room or building to avoid issues with network latency. Minimize the number of segments or along the path between the application server and the database server. The minimum network speed that is required is fast Ethernet (100 Mbps), switched.
Application server software

The WebSphere Application Server software must be installed before you run the IBM TRIRIGA Application Platform installer. However, it is not necessary to install WebSphere Application Server Liberty beforehand. The only supported method of configuring WebSphere Application Server or WebSphere Application Server Liberty is to allow the TRIRIGA Application Platform installer to run the setup tasks.

If the value set for the maximum number of parameters allowed in an inbound request is too low, an error can occur when saving a workflow object map. In this case, you can either increase the value, or set the value to unlimited. Refer to your application server documentation for details.

Database server software
Oracle Database, IBM DB2®, or Microsoft SQL Server must be installed before you run the IBM TRIRIGA Application Platform installer. During the installation process, you are required to provide the database administrator (DBA) user ID and password.
Important: If your TRIRIGA database stores usernames and passwords, then before you use the production environment, (1) your database must be encrypted, and (2) if you are not using SSO, the passwords must be hashed with SHA-512 when stored on your encrypted database. To encrypt your database, see the related documentation for your database server. Meanwhile, there is no need to configure the SHA-512 hashing algorithm. The system encryption type is automatically set to SHA-512 Non-Reversible encryption. Administrators are no longer allowed to configure this setting.
Oracle Database installations
If necessary, table spaces for new Oracle Database installations must be created before you run the installer. Analyze your base data. This data includes documents, leases, and portfolio data, such as people, organizations, assets, and locations. Set the sizes for the TRIDATA_DATA table space and TRIDATA_INDX table space to support at least this base data. The minimum size for the TRIDATA_DATA table space and TRIDATA_INDX table space is 2.5 GB each. If you use existing IBM TRIRIGA table spaces, verify that the autoextend option is enabled.
IBM DB2 installations
An IBM DB2 instance and database must be created before you run the IBM TRIRIGA Application Platform installer.
Java Development Kit

The specific Java Development Kit (JDK) that is required by your application server must be installed before you run the IBM TRIRIGA Application Platform installer. See information specific to Windows and Linux below.

GNU OpenJDK is not supported and will not work with IBM TRIRIGA and the IBM TRIRIGA Application Platform installation program. The OpenJDK package should be completely uninstalled from the server.

Windows: The IBM TRIRIGA installer for Windows runs on an internally bundled JVM (IBM JDK 8). The IBM TRIRIGA installer for Windows also allows you to install this bundled JVM on your local machine to use with the TRIRIGA runtime.

Linux: The JDK must be installed before you run the IBM TRIRIGA installer. The JDK must be installed before you run the IBM TRIRIGA application. This can be downloaded at IBM Developer Kits and is licensed and appropriate for production use on Linux and AIX. Java must be running during an IBM TRIRIGA Application Platform installation. You must set the JAVA_HOME environment variable to the path of the JDK before you start the IBM TRIRIGA Application Platform installation program.

Security privileges and directory access
The administrator or user who runs the IBM TRIRIGA Application Platform installation must have create access and write access to the installation root directory.
IBM TRIRIGA licenses (keys)
Starting with IBM TRIRIGA Application Platform version 3.2, IBM TRIRIGA distributes software licenses in a separate license file for each product. The license file names are in the format LICENSE_IBM_TRIRIGA_[productname].properties (for example, LICENSE_IBM_TRIRIGA_Application_Platform.properties). You can continue to use an existing TRIRIGALICENSE.properties file if you have one until it expires or you use a new product. For more information, see the topic about license files.