Copying the Data Receiver files to the target system

After you set up a working directory for the Z Common Data Provider Data Receiver, you must copy the Data Receiver files to the target system, which is the system on which you plan to run the Data Receiver. All the Data Receiver files are in the package DataReceiver.tar.gz.

Procedure

  1. After you received the media, you must copy the package DataReceiver.tar.gz from mount-point/splunk into the working directory you specify (CDPDR_HOME directory).
  2. Extract the package DataReceiver.tar.gz to a directory. There cannot be spaces in the path name of the directory.
    • DataReceiver.jar

      The Data Receiver is in this file.

    • cdpdr.properties

      The Data Receiver properties are defined in this sample file, and this file must remain in UTF-8 encoding.

    • DataReceiver.sh
    • DataReceiver.bat

      The DataReceiver.sh and DataReceiver.bat are used to start, stop or enable dynamic logging for the Data Receiver.

    • dynamiclogging.jar

      This file contains the codes of dynamic logging.

    • setupDataReceiverTLS.sh
    • setupDataReceiverTLS.bat

      setupDataReceiverTLS.sh and setupDataReceiverTLS.bat are used to set up the Transport Layer Security (TLS) protocol for the communication between the Data Receiver and the Data Streamer. For more information, see Configuring TLS on the Data Receiver.

    • migrateDataReceiverTLS.sh
    • migrateDataReceiverTLS.bat

      migrateDataReceiverTLS.sh and migrateDataReceiverTLS.bat are used to upgrade keystore files and renew certificates for the Data Receiver. For more information, see Configuring TLS on the Data Receiver.

    • importCertificate.sh
    • importCertificate.bat

      importCertificate.sh and importCertificate.bat are used to set up two-way TLS authentication for the Data Receiver. For more information, see Configuring TLS on the Data Receiver.

    • log4j2.xml

      log4j2.xml is used to configure the default logging of Data Receiver.

    • datareceiver.service

      The datareceiver.service is used to run Data Receiver as a service on Linux®.

    • importServiceFile.sh

      importServiceFile.sh is used to copy service file to systemd configuration directory.

    • DataReceiverService_alias.bat

      DataReceiverService_alias.bat is used to create command alias when you run Data Receiver as a Windows service.

    • DataReceiverService.exe

      DataReceiverService.exe is used to run Data Receiver as a service on Windows.

    • jvm.options

      jvm.options is used to configure additional JVM settings of the Data Receiver. The file contains a line-delimited list of JVM arguments.

    • version.txt

      The version.txt file contains the build APAR number and the build date for the Data Receiver.