Skip to content
  • There are no suggestions because the search field is empty.

Guide to Increasing JVM Memory Allocation for Innoslate Enterprise

Three Methods to Optimize Memory Allocation for Enhanced Performance

This guide outlines three methods to adjust the Java Virtual Machine (JVM) memory allocation for Innoslate Enterprise, highly recommended for environments with extensive importing, exporting, picture handling, and high user concurrency. Select the method that best fits your environment:

  • modifying the Windows Registry
  • editing the catalina.bat file
  • creating a setenv.bat file

Each method allows you to configure the initial and maximum memory pool sizes (-Xms and -Xmx) and, optionally, the thread stack size (-Xss).

Method 1: Modifying JVM Memory via Windows Registry (Innoslate)

This method updates JVM memory settings for Innoslate using the Windows Registry Editor.

Steps:

  1. Open Registry Editor:
    • Press Win + R, type regedit, and press Enter.
  2. Navigate to the Registry Key:
    • Go to:
      Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Apache Software Foundation\Procrun 2.0\Innoslate4\Parameters\Java
  3. Modify Memory Settings:
    • Find the JvmMs (initial memory) and JvmMx (maximum memory) entries.
    • Increase these values (e.g., from 512 to 1024 or 2048) based on your needs.
    • Ensure values are in decimal notation.
  4. Apply Changes:
    • Save changes and close the Registry Editor.
  5. Restart Innoslate:
    • Restart the Innoslate Windows Service to apply the new settings.

Method 2: Configuring JVM Memory via catalina.bat (Tomcat)

This method adjusts JVM memory for Apache Tomcat by directly editing the catalina.bat file.

Steps:

  1. Locate the catalina.bat File:
    • Navigate to:
      C:\Innoslate4\apache-tomcat\bin
  2. Edit the File:
    • Open catalina.bat in a text editor (e.g., Notepad).
    • Add the following line near the top, before any JAVA_OPTS usage: 
      set JAVA_OPTS=%JAVA_OPTS% -Xms1024m -Xmx1024m
  3. Parameters Explained:
    • -Xms1024m: Sets the initial memory pool to 1024 MB (1 GB).
    • -Xmx1024m: Sets the maximum memory pool to 1024 MB (1 GB).
    • (Optional) -Xss: Sets the thread stack size (e.g., -Xss1m for 1 MB per thread). Include only if needed.
  4. Save and Restart:
    • Save the file and restart Tomcat to apply the changes.

Method 3: Configuring JVM Memory via setenv.bat (Tomcat)

This method uses a separate setenv.bat file to set JVM memory for Tomcat, providing a cleaner approach that persists across updates.

Steps:

  1. Navigate to the Tomcat Bin Directory:
    • Go to:
      C:\Innoslate4\apache-tomcat\bin
  2. Create the setenv.bat File:
    • Create a new file named setenv.bat in the bin directory.
    • Add the following code: 
      set JAVA_OPTS=%JAVA_OPTS% -Xms1024m -Xmx1024m
  3. Parameters Explained:
    • -Xms1024m: Sets the initial memory pool to 1024 MB (1 GB).
    • -Xmx1024m: Sets the maximum memory pool to 1024 MB (1 GB).
    • (Optional) -Xss: Sets the thread stack size (e.g., -Xss1m for 1 MB per thread). Include only if needed.
  4. Run and Restart:
    • Save the file.
    • Tomcat automatically executes setenv.bat on startup. Restart Tomcat to apply the changes.

Notes:

  • Memory Values: Adjust -Xms and -Xmx (e.g., 2048m for 2 GB) based on your system’s available RAM and application needs, especially in environments with heavy importing, exporting, picture processing, or many users. Ensure -Xmx does not exceed physical memory to avoid swapping.
  • Thread Stack Size: Only include -Xss if your application requires a custom stack size (default is typically sufficient).

Verification

After restarting, check logs or use a tool like VisualVM to confirm the new memory settings are applied.