Install Tealeaf CX automatically

Tealeaf CX installation uses an install wizard that prompts you for information. You can use a command line command to install Tealeaf CX instead of the install wizard. When you use the command line, you are not prompted for any information. You can use silent install to do a fresh installation or an upgrade.

There are two ways to do a silent installation, uninstallation, or upgrade:

Command and parameters - specify all of the options and parameters on a command line. You might specify all of the parameters on a command line if you are doing a one-time installation or uninstall.
Command and file - specify the parameters and options in a file and call the file from the command line. You might use the file option to do multiple installs that have the same options.

Silent installation command: You use the TLsetup.exe command to silently install CX.

Silent uninstallation command: You use the msiexec command to silently uninstall CX. You must run this command as Administrator.

Silent upgrade command: You use the TLsetup.exe command to silently install CX.

All property names and parameters are case sensitive. This table lists and describes the parameters that you can set for silent installation:

Parameter	Description
TARGETPASS	The path that is assigned to the INSTALLDIR property, if a value is not found in the registry. For example, C:\Program Files\Tealeaf. This parameter is used for installation only and is ignored by uninstall.
INSTALLPORTAL	Whether to install the portal. This parameter is a CX installation parameter.
INSTALLDATACOLLECTOR	Whether to install the data collector. This parameter is a CX installation parameter.
INSTALLPREAGGREGATOR	Installs the data preaggregator. Value: `Yes` installs the data preaggregator. The data preaggregator must be installed to a dedicated server without any other Tealeaf components. Use the following values to make sure that no additional components are installed: NSTALLPROCESSOR=NO INSTALLPORTAL=NO INSTALLDATACOLLECTOR=NO INSTALLREPLAYSERVER=NO INSTALLTRANSPORT=NO INSTALLPREAGGREGATOR=YES Additionally, you must specify the following additional information: PORTALSERVER=`host name`: Identifies the Tealeaf portal server address. TMSSERVER=`host name`: Identifies the Tealeaf TMS server address. REPORTDBSERVER=`host name`: Identifies the Tealeaf reporting database server address. DATACOLLECTOR=`host name`: Identifies the Tealeaf data collector server address. REPORTDBPORT=`port number`: Identifies the port number that is used to transfer data to the reporting database.
INSTALLPROCESSOR	Whether to install the processor. This parameter is a CX installation parameter.
INSTALLREPLAYSERVER	Whether to install the replay server. This parameter is a CX installation parameter.
INSTALLTRANSPORT	Whether to install the transport pipeline. This parameter is a CX installation parameter.
HBROPTION	Whether to install the HBR transport pipeline. Valid values are: 1 - do not install HBR 2 - install HBR This parameter is a CX installation parameter.
PROCSERVERLIST	A list of servers that are separated by a pipe. For example (SERVERNAME1) or (SERVERNAME1\|SERVERNAME2). This parameter is a CX installation parameter.
PORTALSERVER	The portal server name. This parameter is a CX installation parameter.
TMSSERVER	The TMS server name. This parameter is a CX installation parameter.
MAILSERVER	The mail server name. This parameter is a CX installation parameter.
REPORTDBSERVER	The report database server name. This parameter is a CX installation parameter.
REPORTDBPORT	The report database port number. This parameter is a CX installation parameter.
REPDBLOCATION	The report database location. Valid values are: 1 - Local 2 - Remote This parameter is a CX installation parameter.
REPDBINSTALL	Whether to install the report database. Valid values are: 0 - do not install 1 - install This parameter is a CX installation parameter.
CANISTERDIR	The Canister directory path. This parameter is a CX installation parameter.
SQLDATA	The SQLDATA directory path. SQLDATA directory Path must be specified (if REPDBLOCATION = 2 (installed on Remote machine)), otherwise Report Database installation will fail. This parameter is a CX installation parameter.
SPOOLDIR	The Spool directory path. This parameter is a CX installation parameter.
DATACOLLECTOR	The remote data collector host name or IP address. This parameter is a CX installation parameter.
FORCETOREMOVE	Whether to force the uninstall. Default value is NOValid values are: YES - uninstall CX even other Tealeaf products are still installed NO (Default) - do not Uninstall CX if any Tealeaf products are still installed This parameter is a CX uninstall parameter.
REMOVEDATABASE	Whether to remove the database. Valid values are: 0 - do not remove the database 1 - remove the database This parameter is a CX uninstall parameter.
SOURCEFILEPATH	The location of *.ini file that contains the list of properties for the install. If no value is assigned, the installer ignores this property.
TRACKINGHOST	The server where the Tracking service is installed. Default is `localhost`. During an upgrade, you can specify this parameter only if the tracking service is not already installed,
TRACKINGPORT	The port that the Tracking service will use. Default is 9001. During an upgrade, you can specify this parameter only if the tracking service is not already installed,
TRACKINGSERVICECONFIGURE	Enable or disable the Tracking services. Valid values are: 0 - disable tracking service 1 - default, enable tracking service During an upgrade, you can specify this parameter only if the tracking service is not already installed,
DBUPGRADEOPTION	Whether to upgrade the database. Valid values are: 1 - upgrade the database 2 - do not upgrade the database During an upgrade, all other parameters are ignored.

Silent installation or uninstall file

You can set the parameters for installation and uninstall in a file and call that file from a command line to do silent installation or uninstall. You create a .ini file for the values that you want to configure. You might use the file option to do multiple installs that have the same options.

This example shows the contents of a .ini file that installs transport but not data collector, portal, processor, or replay server, uses the HBR transport and defines two servers:


[COMMON]
TARGETPASS=C:\Program Files\Tealeaf


[CX]
INSTALLTRANSPORT=YES 
INSTALLDATACOLLECTOR=NO 
INSTALLPORTAL=NO 
INSTALLPROCESSOR=NO 
INSTALLREPLAYSERVER=NO 
HBROPTION=2 
PROCSERVERLIST=server1|server2 

[CXUNINSTALL]
FORCETOREMOVE=NO
REMOVEDATABASE=1

Tealeaf project GUIDs for uninstall

When you uninstall a Tealeaf product, you must specify the project GUID. The GUIDs for the Tealeaf projects are:

CX - {249E5938-69C9-4017-9C39-B7E53867F2E5}
Upgrader - {173E74FF-DFFA-49F3-8E4B-AED9A4A492B8}
RTV - {464592FF-2576-4A64-B2CB-A0F57095DC5D}
cxView - {9DBE60C5-02E0-4601-A7A7-0C8A1C2DCC9E}
cxVerify - {D1490BBD-1DDE-4772-936D-3640BFF43B67}
cxReveal - {72D988CA-4F53-460A-8632-9543D8F10C92}
cxOverstat - {7471B3BF-CC11-42BE-AC40-0C4E8455E0B0}
cxMobile - {EFF86135-C1F6-481E-BB6B-EDF3BBF723DB}
cxImpact - {0962511C-1FBF-492F-9A6A-BD732AAA1D7A}
cxConnectWA - {B97DCE20-E3C9-443D-AA21-E33E18980A5A}
cxConnectVOC - {D33F5260-B354-487B-979D-9F420D10296A}
cxConnectDA - {9846E3C9-3457-4986-8C4F-9585C4FD7F3A}

Install CX silently

You can silently install Tealeaf CX from the command line by specifying the parameters or by calling a file that has parameter values in it. You silently install when you do not want to go through the installation prompts, for example if you want to automate nightly installations.

Before you do a silent installation, you must identify the parameters and values that you want to specify on the command line or in the .ini file that you want to use for installation.

Log in to the server where you want to install CX.
Optional: To silently install CX from the command line without a .ini file, enter the TLsetup.exe installation command and the parameters on the command line.
For example, to specify a new Tealeaf installation folder, and install transport but not data collector, portal, processor, or replay server, use the HBR transport and define two servers, you might use this command:
```
"C:\src\current\Installations\TealeafCX_MSI\PROJECT_ASSISTANT\TealeafCX\DiskImages\DISK1\TLsetup.exe" /s /v"/qn TARGETPASS=\"C:\Program Files\Tealeaf\" INSTALLTRANSPORT=YES INSTALLDATACOLLECTOR=NO INSTALLPORTAL=NO INSTALLPROCESSOR=NO INSTALLREPLAYSERVER=NO HBROPTION=2 PROCSERVERLIST=server1|server2"
```
After the installation is complete, a completion message displays on the screen.
Optional: To silently install CX with a .ini file, enter the TLsetup.exe installation command and specify the .ini file.
For example, you created a silent.ini file in C: that specifies an installation folder, and install transport but not data collector, portal, processor, or replay server, use the HBR transport and define two servers. You might use this command to call the .ini file and install CX:
```
"C:\src\current\Installations\TealeafCX_MSI\PROJECT_ASSISTANT\TealeafCX\DiskImages\DISK1\TLsetup.exe" /s /v"/qn SOURCEFILEPATH=\"C:\Silent.ini\""
```
After the installation is complete, a completion message displays on the screen.

Uninstall CX silently

The unistall wizard prompts you for information on the parts of CX that you want to uninstall. You can use the msiexec to uninstall CX and not use the uninstall wizard.

Before you uninstall CX silently, you must identify the component that you want to uninstall and have the GUID for the component.

You must run the commands in this task as Administrator.

Log in to the server where you want to uninstall CX.
Optional: To silently uninstall CX from the command line without a .ini file, enter the msiexec installation command and the parameters on the command line.
For example, to uninstall CX and remove the database, you might use this command:
```
msiexec /X{249E5938-69C9-4017-9C39-B7E53867F2E5} /qn REMOVEDATABASE=1
```
After the components are uninstalled, a completion message displays on the screen.
Optional: To silently uninstall CX with a .ini file, enter the msiexec installation command and specify the .ini file.
For example, you created a silent.ini file in C:. You might use this command to call the .ini file and uninstall CX:
```
msiexec /X{249E5938-69C9-4017-9C39-B7E53867F2E5} /qn SOURCEFILEPATH="C:\TestSourceFile.ini"
```
After the components are uninstalled, a completion message displays on the screen.

Re-install Tealeaf by using the web application installation utility

Use the Tealeaf CX Web Application Installation utility to manually re-install the Tealeaf CX Portal and its web service with expanded supervision of the required permissions and component installation.

Do not use the Tealeaf CX Web Application Installation utility unless you are experiencing issues with the Portal.

In most installations, the Tealeaf Portal Web Application is installed and configured automatically by the standard Tealeaf CX install process. Due to issues in the installation environment or permission restrictions, the Portal components may not install properly the first time.

Re-installing Portal components

Use the web application installation utility to re-install Tealeaf CX Portal components.

Select the component to install: Portal or Web Service.
Click the installation mode: Standard or Extended.
To see the log output of the install process, select Show Output.
Modify the available options.

To reset options, click Reset.
Click Execute to install the component.

If you attempted to re-install the Portal under Extended mode and are still experiencing issues with connecting to the Portal, contact Support.

Install CX silently

Uninstall CX silently

Re-install Tealeaf by using the web application installation utility

Re-installing Portal components

Join the community

Academy

CX installation

Install CX silently

Uninstall CX silently

Re-install Tealeaf by using the web application installation utility

Re-installing Portal components

Related articles

Join the community

Academy