Changing the default EIF Receiver or Data Collector password

You can change the default password that the Data Collector and EIF Receiver use to connect to IBM® Operations Analytics Log Analysis.

About this task

After you install IBM Operations Analytics Log Analysis, the EIF Receiver and the Data Collector are configured to use the default user name and password to connect to IBM Operations Analytics Log Analysis. The encrypted passwords are defined in the following files:
  • Data Collector client is named <HOME>/IBM/LogAnalysis/utilities/datacollector-client/javaDatacollector.properties.
  • EIF Receiver is named<HOME>/IBM/LogAnalysis/UnityEIFReceiver/config/unity.conf.
IBM Operations Analytics Log Analysis uses the Advanced Encryption Standard (AES) to encrypt and decrypt passwords for your installation, in the following format:
password={aes}<Unique_string_of_alphanumeric_characters>
For example, the javaDatacollector.properties file uses the unityuser user ID to access the Data Collector server. In this example, IBM Operations Analytics Log Analysis uses the Advanced Encryption Standard (AES) to generate the following password:
{aes}7DB629EC03AABEC6C4484F160FB23EE8
The encrypted password is replicated to the configuration files for the Data Collector and the EIF Receiver.

Procedure

  1. To change the default password, use the unity_securityUtility.sh command.

    For more information about this command, see unity_securityUtility.sh command.

  2. Update the configuration files for the Data Collector or the EIF Receiver.
  3. Optional: If you want to change the password on remote instances of the EIF Receiver, complete the previous steps and copy the unity.conf file from the <HOME>/IBM/LogAnalysis/UnityEIFReceiver/config/ directory on the local machine to the <remote_deployment_location>/LogAnalysis/DataForwarders/EIFReceivers/<eif_inst_#>/config/unity.conf directory on the remote machine. 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.

Example

For example, you want to change the default password for the default user that the Data Collector and EIF Receiver use to connect to IBM Operations Analytics Log Analysis to myNewPassword. Complete the following steps:
  1. Go to the IBM/LogAnalysis/utilities directory.
  2. Run the unity_securityUtility.sh command as follows:
     [utilities]$ ./unity_securityUtility.sh encode myNewPassword
 Using keystore file unity.ks
 <HOME>/IBM/LogAnalysis/utilities/../wlp/usr/servers/Unity/
keystore/unity.ks
 {aes}E6FF5235A9787013DD2725D302F7D08
  3. Copy the AES encrypted password to the relevant configuration files, for example copy it to the Data Collector file. You must copy the complete, encrypted string from the command output, including the {aes} prefix. For example:
    {aes}E6FF5235A9787013DD2725D302F7D088