How to Edit the bb-config.properties File
- Open the bb-config.properties file in the following directory:
Edit the parameters using the information provided in the appropriate Performance Optimization section or as shown in the following table.
- Save and close the file.
- Update the configuration by running the PushConfigUpdates command. To learn more, see PushConfigUpdates.
Optimization Parameters in bb-config.properties
|bbconfig.appserver.minthreads||Minimum number of threads created for Tomcat|
|bbconfig.appserver.maxthreads||Maximum number of threads allocated to Tomcat for 64-bit 4 GB RAM in the JVM heap space. This setting limits the number of requests that can be simultaneously processed by Tomcat. Deviating from the suggested maximum setting can have serious repercussions when searching for users and courses with minimal filtering. To learn more, see Sizing the Maximum Thread Count.|
|bbconfig.min.heap size.tomcat||Minimum heap size allocated to the Tomcat JVM|
|bbconfig.max.perm size.tomcat||Maximum perm space allocated to the Tomcat JVM|
|bbconfig.max.stack size.tomcat||Stack size for each thread in the Tomcat JVM|
|bbconfig.jvm.options.extra.tomcat||Additional settings used to configure the JVM. To learn more, see Using Non-Standard (-XX) JVM Arguments.|
|bbconfig.database.instance.maxpoolsize||Maximum number of connections waiting to serve database requests |
The BBLEARN (legacy: BB_BB60) connection pool is the primary database connection pool interface for the Blackboard schema in Tomcat. Blackboard recommends that this value be sized conservatively based on need and usage. Start with a maximum value of 100, and then increase the maximum size as the Tomcat application threads increase.
Optimally, this value should be equal to, but not greater than, the bbconfig.appserver.maxthreads parameter setting.
JDBC connection consumption is a symptom of a performance issue or degradation. Increasing the JDBC connection count will not always solve a performance issue. Performance issues should be diagnosed with care and accuracy and identify bottlenecks at their source.
|bbconfig.database.instance.minpoolsize||Number of connections waiting to serve database requests|
|bbconfig.database.instance.mssql.initpoolsize||Initial number of connections waiting to serve database requests for SQL Server|
|bbconfig.database.instance.timeout||Time window in which database transactions must be processed before a timeout occurs|