Configuring your MiNiFi Java agent

After you install the MiNiFi Java agent, you need to update the configuration files.

If you want to configure your agent, use the conf/bootstrap.conf configuration file.

The MiNiFi java agent creates an auto-generated nifi.properties file at every startup. You should not use it for general agent configuration. If you want to override any property set in nifi.properties, you can do it using the NiFi Properties Overrides section at the end of the config.yml file.

For example, to change the content repository location, you need to override the default path:
NiFi Properties Overrides: {
  nifi.content.repository.directory.default:[***/path/to/repos/content***]
}

Follow these steps to configure the MiNiFi Java agent:

  1. From the MiNiFi home directory, open the bootstrap.conf configuration file.
  2. Configure the agent class so that you can logically group MiNiFi Java instances according to their functionality.
    c2.agent.class=[***AGENT_CLASS***]
  3. Configure the ID of the agent. If you do not specify an agent ID, MiNiFi generates a unique ID per agent instance.
    c2.agent.identifier=[***AGENT_ID***]
  4. Set the c2.enable property to true to inform MiNiFi that run time flow instructions will be received from EFM.
    c2.enable=true
  5. Configure your EFM server endpoint:
    c2.rest.path.base=[***REST API_BASE URL***]
    c2.rest.path.heartbeat=[***HEARTBEAT_RELATIVE URL***]
    c2.rest.path.acknowledge=[***ACKNOWLEDGE ENDPOINT_RELATIVE URL***]
    For example:
    c2.rest.path.base=http://localhost:10090/efm
    c2.rest.path.heartbeat=/api/c2-protocol/heartbeat
    c2.rest.path.acknowledge=/api/c2-protocol/acknowledge
    
  6. Configure your heartbeat interval:
    c2.agent.heartbeat.period=[***HEARTBEAT_INTERVAL***]
  7. Configure the config directory to be used by MiNiFi:
    c2.config.directory=./conf
  8. Configure the C2 runtime properties:
    c2.runtime.manifest.identifier=minifi
    c2.runtime.type=minifi-java
  9. Configure MiNiFi to recognise the changes in the config.yml file during publishing:
    nifi.minifi.notifier.ingestors=org.apache.nifi.minifi.bootstrap.configuration.ingestors.FileChangeIngestor
    nifi.minifi.notifier.ingestors.file.config.path=./conf/config-new.yml
    nifi.minifi.notifier.ingestors.file.polling.period.seconds=5
  10. Restart the agent.