2.5.00.001: Fix Pack 1 for version 2.5.00

Changing the default regular expression used for extracting fields

During data collection, if the records (or events) in the data are too lengthy (or contain too many characters), data collection slows down. A lengthy record slows down the time taken by the default regular expression to detect fields, and this affects the data collection speed.

This fix pack provides you the capability to change the default regular expression used for extracting fields (name=value pairs in the data) automatically. For more information about automatic field extraction, see About field extraction.

To enable this capability, you need to install the fix pack on the machines hosting the standalone Collection Agent and PATROL for IT Data Analytics (KM). For more information about installing the fix pack on PATROL for IT Data Analytics, see Fix pack for PATROL for IT Data Analytics 2.5 .

After installing the fix pack on all instances of the standalone Collection Agent and PATROL for IT Data Analytics, you can change the default regular expression as described in the following procedure.

To change the default regular expression

1. Navigate to the following location based on your operating system:
   • Windows: %BMC_ITDA_HOME%\agent\collection\custom\conf\agent.properties
   • Linux: $BMC_ITDA_HOME/agent/collection/custom/conf/agent.properties
2. Edit the agent.properties file and add the following property with the corresponding value:
   filter.field.extraction.value.pattern.default=(?:^|[^\w-])([\w-]++)\s*+[=]\s*+([\w-.:_]++)
   This property determines the regular expression used for automatic field extraction.
3. Save the file and restart the standalone Collection Agent.
   For more information, see Starting or stopping product services

Fixes available in the fix pack

For information about issues corrected in this fix pack, see Known and corrected issues.

Downloading the fix pack

To download the fix pack

1. Create a directory in which to place the downloaded files.
2. Go to the Electronic Product Distribution (EPD) website .
3. At the logon prompt, enter your user ID and password, and click Submit.
4. On the Export Compliance and Access Terms page, provide the required information, agree to the terms of the agreements, and click Continue.
5. If you are accessing this site for the first time, create an EPD profile to specify the languages and platforms that you want to see, per the EPD site help; otherwise, skip to step 6.
6. Verify that the correct profile is displayed for your download purpose. If necessary, use the Profile list to select a different profile. 

7. From the Component View (the default view), in the Filter Products text box under Products, type part or all of the product name (TrueSight IT Data Analytics) and press Enter, or click Go.

   Note

   Only the product components entitled for the licenses you own will be displayed.

8. From the filtered list, click TrueSight IT Data Analytics to obtain the fix pack files.

9. In the pop-up window, select the appropriate platform and click Go.
   

10. Click the Patches tabs, and select the check boxes next to the files to download.
     The following table lists the fix pack files for each platform available on EPD.

    Platform	EPD (e-item) name	Product file name
    Windows	TrueSight IT Data Analytics 2.5.00 Fix Pack 1 for Windows	TrueSight_ITDA_2.5.00.001-Windows.zip
    Linux	TrueSight IT Data Analytics 2.5.00 Fix Pack 1 for Linux	TrueSight_ITDA_2.5.00.001-Linux.tar.gz

11. Click Download (FTP) or Download Manager:
    • Download (FTP) places the selected items in an FTP directory, and the credentials and FTP instructions are sent to you in an email message.
    • Download Manager enables you to download multiple files consecutively and to resume an interrupted download if the connection drops.
      This method requires a one-time installation of the Akamai NetSession client program on the target computer and is usually the faster and more reliable way to transfer files. A checksum operation is used to verify file integrity automatically.
12. To go back to the product listing page to download other product files, or to logout from EPD, click the << Back to Product List link that is displayed to the top-right of the pop-up window.
    

Fix pack installation sequence

In a single-server deployment, you can directly run the fix pack on the server where IT Data Analytics is installed.

However, if you are operating in a multiple-server deployment, BMC recommends you install the fix pack in the following order of priority.

1. Indexer

2. The following components in any order:
   
   • Collection Station
   • Console Server
   • Search
   The fix pack does not need to be installed on the Configuration Database.
3. Standalone Collection Agents
   If you have one or more standalone Collection Agents installed, you need to install the fix pack on all the machines hosting the standalone Collection Agent.

Before you begin

Before you begin the fix pack installation, ensure that the following requirements are met:

• Version 2.5 of IT Data Analytics is installed.

• The following default environment variables are already set.

  Entity	Platform	Environment variables
  IT Data Analytics	Windows	%BMC_ITDA_HOME%
  	Linux	$BMC_ITDA_HOME
  	The preceding variables are automatically set when you install IT Data Analytics.
  Standalone Collection Agent	Windows	%BMC_ITDA_AGENT_PATH%
  	Linux	$BMC_ITDA_AGENT_PATH
  	The preceding variables are automatically set when you install the standalone Collection Agent.

• The user installing the fix pack has the following permissions:
  • Write permissions to the following directories:
    • Windows: %tmp%
    • Linux: /tmp
    Access to the tmp directory is required for creating the fixpack.log that is used for logging the fix pack installation details.
  • Write permissions to the directory where IT Data Analytics is installed.
    Access to the installation directory is required to create the fix pack backup files and to access JRE required for installing the fix pack.

Installing the fix pack

In a single-server deployment, install the fix pack on the server hosting the IT Data Analytics product. In a multiple-server deployment, install the fix pack on all machines hosting the product components (except the Configuration Database).

Additionally, install the fix pack on all machines hosting the standalone Collection Agent.

When you run the fix pack, the fix pack installer automatically stops the service associated to the component on which you are installing the fix pack. After stopping the service, the fix pack installer applies the fixes and then automatically restarts the service that was stopped earlier.

To install the fix pack

1. Create a directory on the computer hosting the IT Data Analytics components or the standalone Collection Agent.
2. Extract the compressed (.tar or .zip) installation file that you downloaded.

3. Locate and run the following fix pack installer with Administrator privileges:

   Platform	Installer name
   Windows	setup.bat
   Linux	setup.sh

   To run the installer on Windows platform, you can either right-click on the installer and select Run as administrator or you run the installer from the command prompt. 
   

Verifying the fix pack installation

If the installation is successful:

The following message is displayed on the command prompt:
Fix pack installation completed successfully.

The fix pack version is updated in the following locations:

• For IT Data Analytics components: On the Administration > Components page, under the Version column.
• For Standalone Collection Agents: On the Administration > Hosts page, under the Version column.
  

If the installation is not successful: Log a call with BMC Support and include the fixpack.log available in the following directory.

• Windows: %tmp%
• Linux: /tmp