Enabling the Preconfigured Username-password Option

Enable the preconfigured username-password authentication option by modifying the node1.xml and csi_local.xml files.

By default, the installation process creates a cluster configuration file called node1.xml. This file contains security information for the cluster, including a reference to the file that determines the authentication type. If you created a different cluster name during installation, your cluster configuration file will take the format <node-name>.xml.

When preconfigured username-password is the active authentication method, the <node-name>.xml file refers to the csi_local.xml file, which contains the username and password you configure. Event Stream Processor provides a default csi_local.xml file you can use as a basis for creating your own preconfigured username-password combination. This file may initially reside in the ESP_HOME/cluster/examples folder. In such cases, copy the file to the ESP_HOME/security folder.

Enabling the preconfigured username-password option requires that you create and encrypt the password, configure csi_local.xml to specify a username and enter the encrypted password, then modify the <node_name>.xml file to specify the preconfigured username-password option as the active authentication method.

Create and encrypt a password:
1. From a command line, run the encode_text command in the esp_cluster_admin tool:
  
  On Windows: esp_cluster_admin.exe --encode_text
  
  On Linux or Solaris: esp_cluster_admin.bin --encode_text
2. At the prompts, enter and then confirm the password you want to encrypt.
3. The encrypted password displays on screen. Copy the password to paste it into the csi_local.xml file.
Modify the csi_local.xml file to specify the username and password:
1. Copy the csi_local.xml file from ESP_HOME/cluster/examples to ESP_HOME/security.
2. Use a text editor to open ESP_HOME/security/csi_local.xml .
3. In the <Configuration> section, locate <options name="username" and change its value to the desired user name.
4. In the <Configuration> section, locate <options name="password" and change the value by pasting the encrypted password you copied from the CSI utility. Enclose the password in quotation marks.
5. Save and close the csi_local.xml file.
Set the preconfigured username-password option as the active authentication method:
1. Use a text editor to open the cluster configuration file, ESP_HOME/cluster/<node-name>/<node-name>.xml.
2. Within the <Security> section of the cluster configuration file, in the <CSI> section, change the <File> value to csi_local.xml, as follows:
```
<Csi>
  <File>csi_local.xml</File>
<Csi>
```
3. Save and close the file.
Restart the server and all of the cluster managers.