Increase Heap Memory via Startup Script

Repertoire 2022+
,
1

Overview

This guide explains how to increase the Java heap memory allocation for Elixir Repertoire by modifying the startup script. Adjusting heap settings can improve performance for large reports, memory-intensive chains, or high-concurrency environments.

Step 1: Locate the Startup Script

  1. Navigate to your Elixir Repertoire/Ambience installation directory.

  2. Open the /bin folder.

  3. Locate the appropriate script:

    • startServer.sh for Linux/macOS
    • startServer.bat for Windows

Step 2: Configure Heap Parameters

Edit the startup script to include custom Java memory options, e.g:

java -Xms1024M -Xmx3072M -XX:PermSize=128M -jar RepertoireServer-Launcher.jar

Parameter Breakdown:

  • -Xms1024M: Sets the initial heap size to 1024 MB.
  • -Xmx3072M: Sets the maximum heap size to 3072 MB.
  • -XX:PermSize=128M: Allocates 128 MB for the permanent generation (used by class metadata).

You may adjust these values based on your server’s available memory and workload requirements.

Step 3: Save and Restart

  1. Save your changes to the script.
  2. Restart the Repertoire/Ambience server using the updated startup script.

Step 4: Verify Configuration

After restarting:

  • Monitor memory usage via system tools or Java profiling utilities.
  • Check server logs for any memory-related warnings or errors.