Home
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.
HCL Discover Administration Manual
Discover Management System
The Discover Management System (Manage Services) centralizes configuration management for Discover systems on Windows™-based hosts.
Manage Services Pipeline Editor
This section describes how to use the Manage Services Pipeline Editor to create or edit the pipelines for the current server.
Pipeline Status
This section describes how to view and troubleshoot the pipeline status.
Troubleshoot Pipeline Status
This section contains information to help troubleshoot issues that are related to the pipeline status.
Advanced
This section describes the troubleshooting options that are available under the Advanced tab when viewing the pipeline status.
Restore from a Backup of the Manage Services Data Store
You can restore information from the Manage Services data store by accessing files created using the Backup option.

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.
- HCL Discover Administration Manual
  - Discover Admin Overview
    This section is an overview to the Discover system and its components.
  - Discover System Monitoring
    Discover provides several mechanisms for monitoring the health of the Discover system and Discover user activities. This section provides access to the various tools available in the Discover system for monitoring it and its users.
  - Portal Management
    This section contains administration topics for managing the Discover Portal and features available through it.
  - Discover Management System
    The Discover Management System (Manage Services) centralizes configuration management for Discover systems on Windows™-based hosts.
    - Overview of Manage Services
      Manage Services consists of a master server (normally the Portal server) and multiple slave servers, which are all other servers running Discover software, with the exception of Network Capture. The Manage Services master server communicates configuration information to the appropriate slave servers. Each slave then updates the appropriate configuration file or registry.
    - Manage Services Tabs
    - Manage Services Pipeline Editor
      This section describes how to use the Manage Services Pipeline Editor to create or edit the pipelines for the current server.
      - Overview
        Through the Pipeline Editor, you can create or edit the pipelines for the current server.
      - Editing Pipeline Globals
        Through the Pipeline Editor, you can edit global settings that apply to all pipelines on the selected server.
      - Adding Pipelines
        Complete the following steps to create a new pipeline.
      - Building Pipelines
        Complete the following steps to build your pipeline.
      - Editing Pipelines
        To edit the settings for any pipeline, select the pipeline node in the left panel and click Edit.
      - Removing Pipelines
        To remove a created pipeline, select it. Then, click Remove Pipeline at the bottom of the screen. Click OK.
      - Adding Session Agents
        Session agents can be dragged from the Available Session Agents panel to the pipeline name to add them.
      - Editing Session Agents
        To edit a session agent, select it in one of your pipelines. Then, click Edit at the bottom of the window. The session agent properties are displayed.
      - Removing Session Agents
        To remove a session agent, drag it from the pipeline.
      - Saving Session Agents
        You can use the Saved SessionAgents panel to retain configured session agents that you would like to use at a later time.
      - Available Session Agents
        The following session agents are currently available for inclusion in Discover pipelines. Please review the links below for details on implementing session agents in your pipeline.
      - Identify Deprecated Session Agents
        When a system is upgraded, the deprecated session agents are not removed from the available session agents.
      - Pipeline Development Workflow
        If your pipeline is receiving data, you can iterate on it through Manage Services to monitor performance.
      - Configuring the Manage Services Server
        If needed, you can make changes to the configuration for the master Discover Management System server.
      - Restarting Manage Services
        Complete the following instructions to restart the Manage Services server.
      - Reinitializing Manage Services Datastore
        Complete the following steps to re-initialize the Manage Services datastore.
      - Manage Services Components
        The components Discover Management system enables the following basic functionality:
      - Install Manage Services
        Complete the following steps to install Manage Services.
      - Servers
        This section describes how to disable, enable, group, and filter your servers.
      - Components
        This section describes how to manage components.
      - Configurations
        This section describes how to edit, revert, share, and copy configurations in the Pipeline Editor.
      - Pipeline Editor
        The Pipeline Editor is displayed whenever a pipeline configuration is edited. Pipeline Editor manages the Transport Server configuration (DiscoverCaptureSocket.cfg), the Event Bus configuration (DiscoverEventBus.cfg), as well as the various child pipeline configurations used by some of the Session Agents.
      - Jobs
        This section describes how to manage and troubleshoot jobs.
      - Pipeline Status
        This section describes how to view and troubleshoot the pipeline status.
        View Pipeline Status for a Server
        To view the Pipeline Status for a server, click the Pipeline Status tab and select the desired server from the dropdown menu.
        Troubleshoot Pipeline Status
        This section contains information to help troubleshoot issues that are related to the pipeline status.
        Advanced
        This section describes the troubleshooting options that are available under the Advanced tab when viewing the pipeline status.
        Create a Backup of the Manage Services Data Store
        To create a backup of the Manage Services data store, complete the following steps.
        Restore from a Backup of the Manage Services Data Store
        You can restore information from the Manage Services data store by accessing files created using the Backup option.
        Export a Configuration Summary
        You can export a configuration summary by using the Export Config Summary option.
        Perform Discovery on a Server
        Initiate® the discovery process by completing the following steps.
        File Management
        You can get files from any Discover server in the environment for local editing and submission.
        Manage Services Errors
        This section describes Manage Services error messages that might be displayed and how to begin troubleshooting the errors.
  - Database Administration
    The HCL Discover datastore runs on top of a set of four Microsoft™ SQL Server databases.
  - Report Access Permissions
    Users whose accounts contain the proper permissions may administer Discover reports. Depending on the type of report, permissions to administer individual reports of that type are configured in the report definition.
  - Managing User Agents
    Through Discover, you can monitor the different types of user agents that contact your web application. Through a provided set of data objects, Discover can identify the type of traffic that is requesting resources from your web application and then monitor counts and other information that pertains to the type of user agent. These objects can be used as the source data for developing a useful set of user agent-related reports, enabling you to closely monitor the composition of traffic to your site.
  - Configuring User Agent Detection
    This section describes how to acquire and maintain the configuration files necessary for parsing of fixed and mobile user agents and how to prepare those files for use in the HCL Discover platform.
  - Configuring User Agent Events
    To use the data that is injected into the [ExtendedUserAgent] section by the Discover SessionAgentTLTRef, a Discover administrator must create events that create charts for this data.
  - User Agent Tools
    These external utilities can be used to monitor and update user agent configuration data that is required by Discover.
  - bot Detection
    Most commercial enterprise web applications are subjected to significant traffic from web crawling bots. Short for "robot," a bot is a software agent that navigates websites to extract information about them. Some bots are used by search engines for indexing pages.
  - Discover Reference Information
    Use the links below to access reference information on file formats, common standards, and more in use by the Discover system.
  - Integrating HCL Discover and Unica Journey
    HCL Discover and Unica Journey integration works with CEP configuration. The CEP configuration enables the event to be sent to CEP and the external systems. Unica Discover-Unica Journey integration is supported from version 12.1.0.3 onwards.
  - Integrating HCL Discover and Unica Interact
    HCL Discover and Unica Interact integration works with CEP configuration. The CEP configuration enables the event to be sent to CEP and the external systems. Unica Discover-Unica Interact integration is supported from version 12.1.0.3 onwards.
  - Selective Deletion
    You can delete sessions and session fragments from the HCL Discover system with the Selective Deletion tool.
  - Using the ArchiveConfig utility
    Run the ArchiveConfig utility to configure and execute Selective Archiving.
  - ELK Configurations
    Before configuring ELK on HCL Discover, there are some prerequisites:
  - Securing Interprocess Communication
    Discover 12.1.8 and above supports the use of a new SSL certificate based mechanism for securing all inter-process communication between the Discover servers. This is important in a distributed environment with multiple servers, as the components of Discover communicate with each other over the network, using a variety of ports.
- HCL Discover Data Export for Data Analysis Administration Manual
- Session Archiving Guide

Restoring from a Backup of the Manage Services Data Store

You can restore information from the Manage Services data store by accessing files created using the Backup option.

Procedure

Select the Advanced tab.
Enter the full path and filename for the backup file in the Upload Data File field, or click Browse and navigate to the backup file. This file must be a file created using the Backup option.
Click Restore.
Click OK to confirm the restore or Cancel to quit.
Note: During the restore process the Manage Services service is temporarily unavailable. Refresh the page in your browser to reestablish communication with Manage Services.
- See Manage Services Advanced Tab.

Rate this topic

5 stars 4 stars 3 stars 2 stars 1 star

Comment on this topic.

By clicking this box, you acknowledge that you are NOT a U.S. Federal Government employee or agency, nor are you submitting information with respect to or on behalf of one. HCL provides software and services to U.S. Federal Government customers through its partners immixGroup, Inc. Contact this team at https://hcltechsw.com/resources/us-government-contact. Do not include any personal data in this Comment box.