Core Docker Startup Arguments Argument Description -h Display help with available arguments. -f Start the process in the foreground and use existing data and configuration. -i One-time command to initialize or update database and configuration files and do NOT start. -s Command to initialize or update database and configuration files and start OpenNMS in the foreground. -t One-time command to run the config-tester against the configuration. Environment Variables Table 1. Java options Environment variable Description Required Default value JAVA_OPTS Allows to add additional Java options optional - Table 2. PostgreSQL connection configuration in opennms-datasources.xml Environment variable Description Required Default value OPENNMS_DBNAME Database name used for Horizon Core instance required - OPENNMS_DBUSER Username with access to the database required - OPENNMS_DBPASS Password for user with acccess to the database required - POSTGRES_HOST Host with the PostgreSQL server instance running required - POSTGRES_PORT PostgreSQL server port optional 5432 POSTGRES_USER PostgreSQL super user to initialize database schema specified in OPENNMS_DBNAME required - POSTGRES_PASSWORD PostgreSQL super user password required - OPENNMS_DATABASE_CONNECTION_POOLFACTORY Database connection pool factory optional org.opennms.core.db.HikariCPConnectionFactory OPENNMS_DATABASE_CONNECTION_IDLETIMEOUT Database connection pool idle timeout optional 600 OPENNMS_DATABASE_CONNECTION_LOGINTIMEOUT Database connection pool login timeout optional 3 OPENNMS_DATABASE_CONNECTION_MINPOOL Minimal connection pool size optional 50 OPENNMS_DATABASE_CONNECTION_MAXPOOL Maximum connection pool size optional 50 OPENNMS_DATABASE_CONNECTION_MAXSIZE Maximum connections optional 50 Table 3. Timeseries storage configuration in opennms.properties.d/_confd.timeseries.properties Environment variable Description Required Default value OPENNMS_TIMESERIES_STRATEGY Used Timeseries storage strategy optional rrd OPENNMS_RRD_STOREBYFOREIGNSOURCE Store timeseries data by foreign source instead of the database node id optional true OPENNMS_RRD_STRATEGYCLASS Java RRD Strategy class optional org.opennms.netmgt.rrd.rrdtool.MultithreadedJniRrdStrategy OPENNMS_RRD_INTERFACEJAR Java RRD Interface library optional /usr/share/java/jrrd2.jar OPENNMS_LIBRARY_JRRD2 JRRD2 library path optional /usr/lib64/libjrrd2.so Table 4. SNMP Trap receiver configuration in trapd-configuration.xml Environment variable Description Required Default value OPENNMS_TRAPD_ADDRESS Listen interface for SNMP Trapd optional * OPENNMS_TRAPD_PORT Port to listen for SNMP Traps optional 1162 OPENNMS_TRAPD_NEWSUSPECTONTRAP Create new suspect event based Trap recipient for unknown devices optional false OPENNMS_TRAPD_INCLUDERAWMESSAGE Preserve raw messages in SNMP Traps optional false OPENNMS_TRAPD_THREADS Set maximum thread size to process SNMP Traps optional 0 OPENNMS_TRAPD_QUEUESIZE Set maximum queue for SNMP Trap processing optional 10000 OPENNMS_TRAPD_BATCHSIZE Set batch size for SNMP Trap processing optional 1000 OPENNMS_TRAPD_BATCHINTERVAL Set batch processing interval in milliseconds optional 500 Table 5. Karaf Shell configuration in org.apache.karaf.shell.cfg Environment variable Description Required Default value OPENNMS_karaf_SSH_HOST Listen interface for Karaf shell optional 0.0.0.0 OPENNMS_karaf_SSH_PORT SSH Port for Karaf shell optional 8101 Table 6. Cassandra and Newts configuration in opennms.properties.d/_confd.newts.properties Environment variable Description Required Default value REPLICATION_FACTOR Set Cassandra replication factor for the newts keyspace if Newts is used optional 1 OPENNMS_CASSANDRA_HOSTNAMES A comma separated list with Cassandra hosts for Newts optional localhost OPENNMS_CASSANDRA_KEYSPACE Name of the keyspace used by Newts optional newts OPENNMS_CASSANDRA_PORT Cassandra server port optional 9042 OPENNMS_CASSANDRA_USERNAME Username with access to Cassandra optional cassandra OPENNMS_CASSANDRA_PASSWORD Password for user with access to Cassandra optional cassandra Directory Conventions Mountpoint Description /opt/opennms-overlay Allows to overwrite files relative to /opt/opennms /opennms-data Directory with RRDTool/JRobin files and generated PDF reports sent to the file system Rule formats Minion Docker