Welcome
Installation, Deployment, and Upgrade
Installing HCL Discover involves planning and preparing your environment, installing and configuring prerequisite software, obtaining the HCL Discover installation files, and running the HCL Discover installer.
Discover Network Capture Application Manual
SSL Keys
For decrypting transmissions by using the SSL protocol, the HCL Discover Network Capture Application must be provided the SSL keys in use in the transaction stream.
Encrypted SSL Key Setup
To decrypt SSL connections, customers must provide the DNCA software with their valid SSL keys.
Steps to Manually Convert SSL Keys
The following sections describe how to perform manual steps to convert certificates into keys that the DNCA can use.
Loading DNCA with SSL Keys
You can learn to load DNCA with SSL keys in this section.
Adding PTL Files
You can manually add PTL files to your DNCA configuration by editing the dcx-conf.xml file.

Product Overview
Customer Experience is now the number one differentiator in decision making when transacting online. It is crucial that you are able to monitor, understand and manage those online experiences using quantitative data and insights from your actual customer sessions.
Release Notes
Installation, Deployment, and Upgrade
Installing HCL Discover involves planning and preparing your environment, installing and configuring prerequisite software, obtaining the HCL Discover installation files, and running the HCL Discover installer.
- Installation and Deployment Manual
- Discover Network Capture Application Manual
  - Discover Network Capture Application Overview
    Network Capture Application from Discover captures and records the complete interaction between the visitor and the web application environment by using a network tap or network switch spanning port. The Network Capture Application software features the following benefits:
  - Installing the Network Capture Application
    The following instructions can be used to assist the installation of your Network Capture Application software.
  - Configuring the DNCA
    The HCL Discover Network Capture Application can be configured through a web-based console or through the configuration files that are stored on the DNCA server. The following information guides you on how to configure the DNCA.
  - Upgrade for DNCA
    It is recommended that you always use the latest version of the HCL Discover Network Capture Application suitable for your version of HCL Discover.
  - Packet Forwarder Overview
    The Packet Forwarder is used to capture and forward hits to a cloud-based DNCA that is operating on a virtual machine.
  - SSL Keys
    For decrypting transmissions by using the SSL protocol, the HCL Discover Network Capture Application must be provided the SSL keys in use in the transaction stream.
    - Encrypted SSL Key Setup
      To decrypt SSL connections, customers must provide the DNCA software with their valid SSL keys.
      - Automatic Conversion of SSL Keys
        You can use an automatic conversion process to assist with converting SSL keys into PTL keys that can be imported into the DNCA.
      - Steps to Manually Convert SSL Keys
        The following sections describe how to perform manual steps to convert certificates into keys that the DNCA can use.
        Loading DNCA with SSL Keys
        You can learn to load DNCA with SSL keys in this section.
        Loading DNCA with SSL Key Files
        Use the following steps to load the DNCA with one or more SSL keys.
        Loading DNCA with Web Console
        To use the web console SSL Keys tab:
        Adding PTL Files
        You can manually add PTL files to your DNCA configuration by editing the dcx-conf.xml file.
        Automatically Loaded PTL Files
        Through the web Console, you can automatically upload SSL certificates in clear text .pem or password-protected .pfx format.
    - Exporting the SSL private key
      In cases where web application traffic is transmitted over HTTPS, the DNCA software must be configured to decrypt the SSL connections. This configuration requires exporting a copy of the private key from an existing web server to the DNCA software.
    - Generating a Self-Signed Certificate
      To generate a self-signed certificate, you must use the openssl utility to generate a private key and a self-signed certificate for that key.
  - Performance Measurement
    Performance measurement provides details on the Network Capture software performance and timestamp measurements.
  - Configuring DNCA on Red Hat Enterprise Linux™ (RHEL)
    The following sections contain important information for configuring DNCA in a Red Hat Enterprise Linux™ environment:
  - DNCA monitoring
    You can monitor the passive capturing to diagnose performance issues.
  - Overview of DNCA maintenance
    The maintenance utility performs routine maintenance and logging tasks for Discover DNCA. You can use the utility to help maintain the ability of the DNCA to perform DNCA.
  - DNCA frequently asked questions (FAQ)
    The following content contains frequently asked questions or scenarios that can be used to help isolate or fix an issue with your Network Capture Application.
  - Downloading Privacy Configuration
  - Enabling web console access through a single IP address
    You can specify a single IP address which can access the web console. Limiting access to a single IP address helps to prevent unauthorized access through an unknown system.
  - Applying authentication when accessing the web console
    You can improve security by enabling authentication to the web console.
- HCL Discover Session Archiving Installation Guide
  As you prepare for an installation, you need to gather some items, review hardware and software requirements, and then you can perform the installation.
- Discover Upgrade Manual
Configuration
Configuring HCL Discover involves setting up and managing Discover user authorization and configuring Discover server components and services that process captured data.
Administration
Administering HCL Discover involves configuring and integrating the HCL Discover client framework with your web applications or mobile native applications, installing and administering the databases used by HCL Discover, defining event objects and configuring events, hit attributes, dimensions, and other object attributes used by HCL Discover to monitor mission-critical metrics of your web application's performance.
Using
Notices

Adding PTL Files

You can manually add PTL files to your DNCA configuration by editing the dcx-conf.xml file.

About this task

To edit the configuration file to add PTL files:

Procedure

Log on to the DNCA host machine as user root and change to directory /usr/local/dncauser/etc.
Edit the DNCA configuration file dcx-conf.xml.
Look for the following line:
```
<CaptureKeys></CaptureKeys>
```
If DNCA is already configured with PTL files, the <CaptureKeys> and </CaptureKeys> tags are on separate lines.

Add a <CaptureKey> entry for each PTL file between <CaptureKeys> and </CaptureKeys>. Each entry requires a label and the full pathname of the PTL file. For example, the <CaptureKey> entry for a hypothetical PTL file named /usr/local/dncauser/etc/web1.ptl would look like the following:

<CaptureKey>
        <Label>Web1 Key </Label>
        <PrivateKeyFile>/usr/local/dncauser/etc/web1.ptl</PrivateKeyFile>
</CaptureKey>

Below is an example of two <CaptureKey> entries configured on a DNCA host machine:

<CaptureKeys>
        <CaptureKey>
              <Label>Web1 Key </Label>
              <PrivateKeyFile>/usr/local/dncauser/etc/web1.ptl</PrivateKeyFile>
       </CaptureKey>
              <CaptureKey>
              <Label>Web2 Key </Label>
              <PrivateKeyFile>/usr/local/dncauser/etc/web2.ptl</PrivateKeyFile>
       </CaptureKey>
</CaptureKeys>

Save changes to the configuration file and exit the editor.
Restart the capture programs using the following commands:
```
./discover stop capture
./disocver start capture
```
If capture fails to start, view capture.log to determine the reason.
Log on to the DNCA Web console with a Web browser and click the SSL Keys tab to view the PTL files you've configured.