Configuring Glasgow Haskell Compiler Runtime System Options
PreviousObtaining a PoolTool API KeyNextReducing Missed Slot Leader Checks and Improving Cardano Node Performance
Last updated
Last updated
Depending on hardware specifications, in some implementations of Cardano Node configuring runtime system (RTS) options available for the Glasgow Haskell Compiler (GHC) may improve performance and/or stability.
The RTS offers many options for controlling behaviour. For example, depending on your system specifications and the Cardano Node version, your block-producing node sometimes may miss slot leader checks, as reported using the dashboard. Using custom RTS options, you may seek to reduce significantly the number of slot leader checks that your block producer misses, for example due to time spent in garbage collection (GC).
To display the default RTS options for Cardano Node:
In a terminal window, type:
In the results, the value of the Flag -with-rtsopts key displays the default RTS options. For example:
For details on available RTS options and setting RTS options using the command line, in the see the sections RTS Options for SMP Parallelism on page 136 and Running a Compiled Program on page 172.
For example, to produce runtime system statistics for each garbage collection in addition to using default RTS options, include the following RTS option in your cardano-node run command where <FileName> is the name of the file in the current folder where you want to output statistics and <Options> is the list of options that you use when running your node:
/usr/local/bin/cardano-node run +RTS -S<FileName> -RTS <Options>
If you are not satisfied with the performance or stability of an instance of Cardano Node, then subjectively you may notice improvement when adding custom RTS options such as:
Using similar syntax, you can configure custom RTS options when running the Cardano Command Line Interface (CLI).
To display the default RTS options for Cardano CLI:
In a terminal window, type:
If you identify different RTS options that noticably improve the performance or stability of your Cardano Node instance, then consider contributing the RTS options to so that other stake pools may also benefit.