Log4J Installation Instructions

Minimum Version

This DEX Pack requires SysTrack version 10.1 or higher.

Notes

  • After this DEX Pack is installed, it may take up to 24 hours for data to appear.

  • If you update or reinstall this DEX Pack, you must reassign any Views created below to the SF_Log4J Role.

Import Kit

To use this DEX Pack, the corresponding Kit must be imported to SysTrack.

If you have already imported the DEX Pack directly from the Kits page, the Import Kit step is complete. You may move on to the next step.

If you are viewing this DEX Pack in the Customer Gateway, follow these steps to import this DEX Pack Kit:

  1. On the DEX Pack page, download the DEX Pack ZIP file

  2. In SysTrack, open Kits

  3. Under Local, click Select Kit File

  4. Select the DEX Pack ZIP File

Log4J View

This DEX Pack requires you to make a View for the relevant SF_Log4j Role.

To create the new View:

  1. Navigate to Configure > Views

  2. Click the padlock icon in the upper-right to enable editing

  3. Click the plus icon to add a new View

  4. Fill in the Settings as follows or follow them as per the screenshot from the kit

    1. View Name: SF_Log4j

    2. Existing Category: General

    3. Expires in: 30 Days

    4. When Expired: Overwrite Data

    5. Do NOT check “When overdue by 1 day (s)”

    6. Set the Refresh drop-down to Daily, Inside, 24x7, and “Every Day”

    7. Copy this SQL query, and paste it into the box under SQL Selection > Generic

    8. Click Test SQL. A Test Success message should appear. If the test is not successful, the query may have been copied incorrectly

  5. Click Create View at the top-right

To assign the new View:

  1. Navigate to Configure > Roles

  2. Use the drop-down at the top to select the SF_Log4J Role.

  3. Click Views, then check the box next to SF_Log4j

  4. Click Save Changes at the top-right

Copy SF_Log4j

Copy 
SELECT
    T0.WGUID,
    GETUTCDATE() AS VWTIME,
    Add_Date AS RunTime,
    S0.STRVALUE AS FULLPATH
FROM DYNI_log4j AS T0
INNER JOIN SASTR_DYN AS S0 ON T0.FullName = S0.STRINGID

Import Log4J Role

This solution requires you to assign the SF_Log4J Role to the relevant Configurations:

  1. Navigate to Configure > Configurations

  2. Click the padlock icon in the upper-right to enable editing

  3. Use the drop-down at the top to select a relevant Configuration, or create a new Configuration

  4. Assign the SF_Log4J Role to the Configuration by dragging it from Available Roles to Assigned Roles

  5. Click Save Changes at the top-right

  6. Repeat this process for any other relevant Configurations

Enable Collection Extensions

  1. In Configure, click Collection Extensions on the left

  2. Click the Action Governance tab at the top

  3. Find log4j in the list and check the Enabled box for both

  4. Click Save Changes at the top right