Page History

...

• Hostnames, IP Addresses, Ports
• Accounts
• Database Names

There are situations when where log files should be anonymized before forwarding to a 3rd party, to the SOS Ticketing System or to a public forum to receive community support.

...

Anonymization is available from a Java class and is invoked from by a shell script available at the following default locations:

...

• Options
  • -l | --log-file=<log-file>: Specifies the location of a the log file(s) to be anonymized.
    • This option can be specified repeatedly for a number of files. Wildcards can be specified and directories can be specified if all included files are to be anonymized.
    • Plain text log files with the .log file extension and compressed log files with the .gz file extension are considered - see the JS7 - Log Rotation article.
    • Anonymized log file names are prefixed with the string: anonymized- 
    • By default anonymized log files are stored in the directory in which original log files are found.
  • -o | --output-dir=<directory>: Optionally specifies the output directory in which anonymized log files are to be stored. If this argument is omitted then anonymized log files are stored in their original directory.
  • -r | --rules-file=<rules-file>: Optionally specifies the location of a file in YAML format that holds the rules to be applied for anonymization.
  • -e | --export-rules=<rules-file>: Optionally specifies the location of a file in YAML format to which the built-in rules for anonymization will be exported.

...

• Creates anonymized versions of the log files indicated from the given directory. The wildcard specifies any log files carrying a name that starts with joc will be used.
• The wildcard includes consideration of plain text log files available with the .log file extension and also consideration of compressed log files which are available with a .gz file extension.
• Anonymized log files are stored in the output directory.

...

Users who wish to run the Log Anonymizer outside of a JS7 installation can:

• copy a number of Java related files as available from the Controller or Agent installation,
• create a shell script to invoke the Log Anonymizer.

Java related Files required by Log Anonymizer

The following files can be found from in a Controller or Agent installation for Unix or Windows.

• Note that version numbers of binary files can change over time. The examples below examples assume binary files as provided with Release 2.4.0.
• Users can copy the following Java related files from the ./lib/3rd-party, ./lib/sos, ./lib/stdout directories to the location from which where they want to use Log Anonymizer:
  
  

...

The directory hierarchy is assumed to look like this:

• log-anonymizer.sh | .cmd
  • lib
    • sos

...