You can use the Tealeaf Network Capture add-on for additional insight into the customer experience by enabling the capture of network traffic data for analysis.

Installing the network capture add-on

Organizations must subscribe to the Network Capture add-on, and install and maintain the Passive Capture Application server and Data Transport server in their on-premises infrastructure to enable forwarding of network traffic to the cloud environment.

The Network Capture add-on is available for use along with your subscription. To purchase the Network Capture add-on, contact your administrator.

Warning: The Network Capture add-on must be installed on a stand alone server running a supported version of Windows Server. It must not be installed alongside other Tealeaf on-premise components.

To install the Network Capture add-on, complete the following steps.

1. Go to the "Installers" tab in the Tealeaf downloads page. If you do not have access to the downloads page, contact the Acoustic Tealeaf support team to obtain access.
2. Download "Acoustic Experience Analytics (Tealeaf) CX V10.2 on Cloud Network Capture Add-On" or "Acoustic Tealeaf CX V10.3 on Cloud Network Capture Add-On" package, depending on the version of your existing Tealeaf on-premise infrastructure. If in doubt, use the 10.3 version.
3. Run the setup.exe file.
4. Select the language that you want to use for the installation process and click Next. This opens the installation wizard, which begins the installation of the Network Capture add-on on your computer.
5. Accept the terms in the license agreement and click Next.
6. Choose the destination folder where you want the files to be stored.
7. Select either Default Transport Pipeline (No HBR) or HBR Transport Pipeline and click Next.

   This decision should be based on the amount of traffic you expect. You can discuss this issue with your Acoustic representative. If you are unsure, choose the Default Transport Pipeline.

8. Select the Tealeaf® CX on Cloud data center from the drop-down list and click Next.
9. Enter the Application Key.

   The Application Key is displayed on the Applications tab of the Admin screen in Tealeaf UI.

   Note: To configure network capture for more than one application, leave this field blank.
10. Enter the hostname or IP address for the SMTP mail server and click Next.
11. You can enter either the machine name or the IP address for the StatsLogger server.
12. Click Next.
13. Click Install to begin the installation.
14. Click Finish to complete the installation.

Changing the connection settings for the Network Capture add-on

You can modify the connection settings for the Network Capture add-on configuration by editing parameters in the TealeafCaptureSocket-base.cfg file.

Note: This procedure does not apply to an HBR server.

After you install the Network Capture add-on, you can modify the connection settings by editing the data center hostname or Application Key parameters manually.

To modify the connection settings for the Network Capture add-on manually, complete the following steps.

1. Go to the destination folder that you chose when you installed the Network Capture add-on.
2. Open the TealeafCaptureSocket-base.cfg file.
3. Locate the section that is labeled HTTP.
   Note: You can search for the text string [HTTP].
4. To change the data center hostname, edit the value after "Server=".

   The value must be the fully qualified domain name for the data center (for example, tealeaf-us-1.goacoustic.com).

5. To change the Application Key, edit the value after "AppKey=".

   If you have more than one Application Key, you can either leave the value blank or comment-out the line by adding # to the start of the line.

   For multiple Application Keys, the AppKey must be inserted into the captured data either by the SDK or by using a privacy rule. Consult your Acoustic representative for assistance.

6. Save the changes to TealeafCaptureSocket-base.cfg and close the file.

[HTTP]
# IMPORTANT NOTE: Do not edit this section in TealeafCaptureSocket.cfg.
# When HTTP is called from SessionRouter this section is loaded from TealeafCaptureSocket-base.cfg
TypeName=HTTP
DLL=SessionAgentHTTP.dll
DownStreamConfigSection=Null

# Domain name of Tealeaf server
Server=tealeaf-us-1.goacoustic.com

# Your application key. If you have more than one application key (set by SDK), then comment out
# the next line by adding # at the start of the line.
AppKey=390318acc1ab4839aadccd29cb9999b2

# Uncomment the following line to send all hits as HTTPS
#ForceSSL=True

# The following settings should not be changed unless instructed to by customer support
PostURI=/collector/hitPost
Port=80
SSLPort=443

Setting up the Network Capture add-on

After you install the Network Capture add-on, you must configure it.

1. Locate the destination folder that you chose during the installation process.
2. Open the TealeafCaptureSocket.cfg file.
3. Locate the section that is labeled [Global].
4. Replace the line Port=1966:DataDrop with Port=1966:DecoupleEx.
5. Locate the section that is labeled Inflate].
6. Replace the line DownStreamConfigSection=PrivacyEx with DownStreamConfigSection=DataDrop.
7. Locate the section that is labeled [DataDrop], which is toward the beginning of the file.
8. Replace the line DownStreamConfigSection=DecoupleEx with DownStreamConfigSection=PrivacyEx.
9. Save and close the file.

[SessionRouter]
TypeName=SessionRouter
DLL=SessionAgentPipelineSplitter.dll
DownStreamConfigSection=Null
InitScript=PipelineSplitterCFG.tcl
KeepTEMPConfig=False

PipelineEx1=Traffic SessPct=0-25 || DecoupleEx SpoolRollSizeMB=20 || PrivacyEx || HTTP Server=<SAAS_SERVER_HERE> AppKey=<APP_KEY_HERE> || Null
PipelineEx2=Traffic SessPct=26-50 || DecoupleEx SpoolRollSizeMB=20 || PrivacyEx || HTTP Server=<SAAS_SERVER_HERE> AppKey=<APP_KEY_HERE> || Null
PipelineEx3=Traffic SessPct=51-75 || DecoupleEx SpoolRollSizeMB=20 || PrivacyEx || HTTP Server=<SAAS_SERVER_HERE> AppKey=<APP_KEY_HERE> || Null
PipelineEx4=Traffic SessPct=76-100 || DecoupleEx SpoolRollSizeMB=20 || PrivacyEx || HTTP Server=<SAAS_SERVER_HERE> AppKey=<APP_KEY_HERE> || Null

Enabling the network capture add-on

Use this procedure to enable the Network Capture add-on for a specific organization. The add-on must be installed and configured before you can enable it.

1. Log in as the Organization Administrator.
2. Select Manage Accounts for the organization you are working with.
3. Select Company Settings.
4. Click Edit.
5. Select On for Network capture (in the Services section).
6. Click Save.