Adding a new configuration parameter

To add a new configuration parameter in the config.ini file:

  1. Using a browser, navigate to the Cloudera Manager screen.

  2. Enter the Username.

  3. Enter the Password.

  4. Click Sign In.

    The Cloudera Manager Home page appears.

  5. Click BDP PEP. The BDP PEP page appears.

  6. Click the Configuration tab. The Configuration tab appears.

  7. In the Filters pane, under Scope, click Gateway. The options related to the config.ini file appear.

  8. To add a new parameter for the config.ini file, perform the following steps:

    1. Under the BDP PEP Client Advanced Configuration Snippet (Safety Valve) for bdp-conf/config.ini.properties box, enter the required parameter and the corresponding value in the group.key=value format. When you enter the parameter in the group.key=value format, Cloudera Manager appends the parameter in the config.ini file on all the nodes in the following format:
      [group]
      key = value
      
    2. Click Save Changes (CTRL+S).
  9. To verify whether the parameter is added to the config.ini file, perform the following steps:

    1. Log in to the Master Node.
    2. To navigate to the /opt/cloudera/parcels/PTY_BDP/bdp/data/ directory, run the following command:
      cd /opt/cloudera/parcels/PTY_BDP/bdp/data/
      
    3. Press ENTER. The command changes the working directory to /opt/cloudera/parcels/PTY_BDP/bdp/data/.
    4. To view the contents of the config.ini file, run the following command:
      vim config.ini
      
    5. Press ENTER. The command displays the contents of the config.ini file.
      [log]
      host=localhost
      port=15780
      output=tcp
      mode=drop
      [protector]
      cadence=60
      [core]
      emptystring=empty
      
  10. Using a browser, login to the Cloudera Manager home page.

  11. Click BDP PEP. The BDP PEP page appears.

  12. To generate the config.ini file on the nodes where you have installed the Gateway Role, select Actions » Deploy Client Configuration. The prompt to confirm the action appears.

  13. Click Deploy Client Configuration.

    Cloudera Manager generates the config.ini file to all the nodes where the Gateway role is installed.

Note: If you add or modify any parameter in the config.ini file, then you must restart all the dependent services to reload the configuration changes.


Last modified : February 20, 2026