Before you begin to install Tealeaf, confirm that network environment meets all software requirements. If not, you must upgrade the installation environment.

Review the software that is running in every environment into which you plan to install Tealeaf applications and components. Check the following.

• Operating system, Windows or Linux (for the Passive Capture Application)
• Microsoft IIS version
• Microsoft .NET framework
• Web browsers

Required operating systems

Most Tealeaf applications run on Microsoft Windows Server. The Passive Capture Application (PCA) runs on Linux.

Windows servers

Windows servers that host Tealeaf applications and components must run on one of the following operating systems.

• Microsoft Windows Server 2019 (Starting with version 10.1)
• Microsoft Windows Server 2016 (64-bit)
• Microsoft Windows Server 2012 (64-bit) (Version R2 recommended)

If the system contains more than 32GB of RAM, then you must install an Enterprise version of one of the supported operating system versions.

Note: The default Windows Server installation also installs the .NET Framework. Confirm that the installed version of .NET Framework meets Tealeaf requirements.

When you configure Windows Server, you must register .Net Framework with IIS to enable it to accept Tealeaf.

Linux servers

Linux servers hosting the PCA must run on one of the following operating systems: Red Hat Enterprise Linux™ (RHEL) versions 6 and 7, SUSE Linux Enterprise Server (SLES) version 12

Red Hat Enterprise Linux (RHEL) 7 uses the same installation package and process as Red Hat Enterprise Linux (RHEL) 6.

Additional operating system information is contained in the installation instructions for the PCA.

Requirements for Microsoft IIS

You must install Microsoft Internet Information Services (IIS). If you have already installed IIS, you must verify that it is installed and at the required version level.

The Startup type must be set to Automatic.

If you are running the Tealeaf CX solution on a multi-CPU server hosting multiple web applications, create a new application domain that is assigned to Tealeaf only. When it is assigned to a single domain, the application can use an entire CPU or core for its purposes, thus enhancing performance.

The Tealeaf CX solution can be installed in any virtual directory, regardless of the website to which it might be attached, as long as the application domain is running .NET applications only. This deployment option is useful if the Portal is accessed from http:// TealeafPortal.MyCompanyDomain.com/Portal or a similar domain-dependent construction. Please note the /Portal at the end. If you must reference the Portal with http://TealeafPortal.MyCompanyDomain.com, please contact Acoustic Support for guidance.

For more information about IIS, see documentation from Microsoft.

Requirements for .NET framework

Tealeaf requires .NET version 4.5.1.

The default Windows Server installation also installs the .NET Framework. You must confirm that the installed version of .NET Framework is supported by Tealeaf.

When you configure Windows Server, you must register .NET Framework with IIS to enable it to accept Tealeaf.

Supported web browsers

The web browsers that you use to access Tealeaf applications and components, including the Portal, must meet certain minimum requirements.

On each desktop that accesses the Portal, one of the following Web browser versions must be installed:

• Microsoft Internet Explorer 11 or Edge
• Mozilla Firefox 14 or later
• Google Chrome 17 or later
• Safari
  • Tealeaf 10.1 has limited Safari support due to certain known issues.

The Portal does not support access from mobile browsers.

Tealeaf cxOverstat requires web browser support for HTML5.

User account requirements

Tealeaf user accounts include account permissions, NT authentication, and Passive Capture Application accounts.

• Account permissions: Give Local System permissions to any account used by a Windows-based Tealeaf service on the server.

  Using non-local system accounts for running Tealeaf software is not supported. Running Tealeaf services with permissions other than Local System permissions might cause problems, such as failures to connect, write errors, and unexpected time-outs.

• NT authentication: When NT authentication is enabled for the Tealeaf system, Tealeaf services must run under an NT domain account with appropriate privileges.
• Passive Capture Application (PCA) accounts: The PCA runs on the Linux operating system. During PCA installation, the ctccap account is created, which is used for running all PCA services.

cxVerify software requirements

Note: Do not install Tealeaf cxVerify on a server where other resource-intensive applications are installed.

cxVerify can be co-located on a server with Tealeaf cxConnect for Data Analysis.

If you must install cxVerify on the same server as Microsoft SQL, you must adjust the setting that controls the desktop heap for each desktop associated with an on-interactive window. For more information from Microsoft, check out Desktop Heap Overview.

With Tealeaf on premises version 10.3, Apache Tomcat is being used to support DOMDiff replay & LTS server functionality. This is replacing IBM WAS server.  

Before installing or upgrading to v10.3, Tealeaf on premises requires JAVA 1.8 to be installed on each Tealeaf server running Replay server & LTS server. JAVA 1.8 can be downloaded from the involved vendor’s website. 

Additionally, check the server.xml in the Apache/webapps/DomDiffserver directory to make sure any IBM is changed to Acoustic and restart the replay server.

Apache Tomcat bundled with Tealeaf on premises supports the following JAVA flavors: 

• IBM JAVA 
• ORACLE JAVA 
• OPENJDK 

Note: If you are installing Tealeaf v10.3 for the first time, you must have the latest JRE installed to ensure a successful installation of Tealeaf.