Skip to main content

Installation

Prerequisites

  • Java 17 or later

Program

EasySMF:Events is distributed as a self contained executable jar file.

Copy it to a directory according to your site standards.

License Key

Copy the license or evaluation key to a file e.g.

**License:
MQoyMDI2LTA4LTIzClRlbXBvcmFyeSBLZXkKSkUsUlRJLEVFVixDSUNTLFJBQ0YK
**Sig:
m/mBekoYeYZe77Pqd5uXtJntkusP8qos+MDWC/kBlyTLmfnL37zWSARSMmQ9bgw4
9Sr4iTF+1160kcTFM9JAmwrO5Gp7xdI5Gv+kX7p3urIn7mA4nszxhS4U/NNmf0Tl
YWRcAQ+15RukxlcIHEaaGW7q0nC1jHLLf5/f7WRyFFU=
**End

Set the EASYSMFKEY environment variable to point to the file, e.g.

export EASYSMFKEY=/etc/easysmf/key.txt

Configuration

Create a file for the configuration. This is a sample configuration showing the format:

"smf-in-memory-resource": "",
"timezones": {
"default": "America/Chicago",
"EG01": "America/Los_Angeles",
"EG02": "America/New_York"
},
"interval": 5,
"splunk-url": "https://splunk.example.com:8088",
"splunk-auth": "",
"max-post": 1048576,
"compress": "yes",
"zos": "yes",
"jobs": "yes",
"datasets": "yes",
"files": "yes",
"rmf": "yes",
"tcpip": "yes"

See Configuration File Options for details.

The current configuration will be output every time EasySMF starts, so you can copy and modify as required.

Credentials Directory

You can create a credentials directory to keep the Splunk HEC authorization token and the z/OSMF credentials if required. See Credentials Directory for more information.