Configuring the EIF receiver user account

The Tivoli® Event Integration Facility (EIF) receiver uses the default unityuser user account to access the generic receiver. You can change the user account or the default user password in the unity.conf configuration file.

About this task

The following steps are the same for remote and local installations of the EIF unless stated otherwise.

Procedure

To change the default EIF user or password:

  1. Stop IBM® Operations Analytics Log Analysis:
    • If you use a local installation of the EIF, use the following command to stop IBM Operations Analytics Log Analysis:
      <HOME>/IBM/LogAnalysis/utilities/unity.sh -stop
    • If you use a remote installation of the EIF, use the eifutil.sh -stop command to stop the instances. For more information, see eifutil.sh command.
  2. Open the configuration file for editing:
    • If you use a local installation of the EIF, open the unity.conf file in the <HOME>/IBM/LogAnalysis/UnityEIFReceiver/config/ directory.
    • If you use a remote installation of the EIF, the unity.conf file is in the <remote_deployment_location>/LogAnalysis/DataForwarders/EIFReceivers/<eif_inst_#>/config/unity.conf directory. Where <remote_deployment_location> is the directory on the remote machine where you deployed the EIF instance. <eif_inst_#> is the folder that is used for the specific remote EIF instance.
  3. Change the following userid and password parameters to suit your operating environment: 
    unity.data.collector.userid=unityuser

unity.data.collector.password=password

    To encrypt the password, use the unity_securityUtility.sh command. For more information, see Changing the default password for the Data Collector and EIF Receiver.

  4. Save your changes.
  5. Restart IBM Operations Analytics Log Analysis:
    • If you use a local installation of the EIF, use the following command to restart IBM Operations Analytics Log Analysis:
      <HOME>/IBM/LogAnalysis/utilities/unity.sh -restart
    • If you use a remote installation of the EIF, use the eifutil.sh -restart command to restart the instances. For more information, see eifutil.sh command.

Results

The EIF receiver uses the new credentials to access the generic receiver.