Heapspace Out of Memory Error

From 360Works Product Documentation Wiki
(Difference between revisions)
Jump to: navigation, search
(Windows:)
(Added ready-made custom memorysize files in a few default sizes for less technically-inclined persons)
Line 1: Line 1:
By default, 360Works plugins use 96 MB of heap space for the JVM to run its code. When working with very large files or amounts of data, it is possible that a plugin may run out memory.  To correct this you may need to adjust the memory that the plugin has available. '''NOTE:''' Values higher than 1024 MB can cause FMP/A to crash.
+
By default, 360Works plugins use 96 MB of heap space for the JVM to run its code. When working with very large files or amounts of data, the plugin may run out memory.  You can adjust the amount of memory the plugin has available by creating a custom memorysize file. You must restart FileMaker after installing a custom memorysize to get the plugin to load the new file.
  
===Mac:===
+
=Pre-built custom memorysize files=
 +
These are ready-made custom memorysize files set to various amounts. You can download these and install them to the respective OS directories (''sizes are in MB'')
 +
 
 +
* [http://sc.360works.com/SuperContainer/RawData/pro/360/wiki/128 128]
 +
* [http://sc.360works.com/SuperContainer/RawData/pro/360/wiki/256 256]
 +
* [http://sc.360works.com/SuperContainer/RawData/pro/360/wiki/512 512]
 +
* [http://sc.360works.com/SuperContainer/RawData/pro/360/wiki/1024 1024]
 +
 
 +
 
 +
Place the memorysize file in one of these locations:
 +
* OS X: '/Library/Application Support/360FmKit/'
 +
* Windows:
 +
** XP:  'C:\Documents and Settings\All Users\Application Data\360Works\'
 +
** Vista, 7, and 8: 'C:\ProgramData\360Works\' The ProgramData folder may be hidden. Please see this [http://windows.microsoft.com/en-us/windows/show-hidden-files#show-hidden-files=windows-vista article on how to show hidden files on Windows]
 +
** Server 2008: 'C:\Users\Admin\360Works\'
 +
 
 +
 
 +
=How to create your own memorysize file=
 +
 
 +
==Mac:==
 
* create a file named memorysize with no extension at '/Library/Application Support/360FmKit/memorysize' which contains the required heap size, in megabytes (i.e. 128)
 
* create a file named memorysize with no extension at '/Library/Application Support/360FmKit/memorysize' which contains the required heap size, in megabytes (i.e. 128)
  
Line 13: Line 32:
 
*Type ":wq" and hit return. ":" takes you into command mode, "w" is for "write", and "q" is for "quit" so this command will take you out of edit mode, save the file, and go back to the command prompt
 
*Type ":wq" and hit return. ":" takes you into command mode, "w" is for "write", and "q" is for "quit" so this command will take you out of edit mode, save the file, and go back to the command prompt
  
===Windows:===
+
==Windows:==
 
* On Windows XP, the memorysize file should be located at 'C:\Documents and Settings\All Users\Application Data\360Works\memorysize'
 
* On Windows XP, the memorysize file should be located at 'C:\Documents and Settings\All Users\Application Data\360Works\memorysize'
  
Line 21: Line 40:
  
 
Create a blank text document and rename it to "memorysize". Enter the desired custom memory size in MB. There should only be numbers with no trailing spaces or carriage returns. You must ensure that the file has no extension (.txt, etc.). You can remove extensions by un-checking the "Hide extensions for known file types" box in Windows Explorer folder options. Then rename the file without the extension. You may need to create the "360Works" directory.
 
Create a blank text document and rename it to "memorysize". Enter the desired custom memory size in MB. There should only be numbers with no trailing spaces or carriage returns. You must ensure that the file has no extension (.txt, etc.). You can remove extensions by un-checking the "Hide extensions for known file types" box in Windows Explorer folder options. Then rename the file without the extension. You may need to create the "360Works" directory.
 
You will need to restart FileMaker in order for the changes to take affect. You may need to restart the machine you make this change on after creating the memorysize file.
 

Revision as of 17:57, 14 May 2014

By default, 360Works plugins use 96 MB of heap space for the JVM to run its code. When working with very large files or amounts of data, the plugin may run out memory. You can adjust the amount of memory the plugin has available by creating a custom memorysize file. You must restart FileMaker after installing a custom memorysize to get the plugin to load the new file.

Contents

Pre-built custom memorysize files

These are ready-made custom memorysize files set to various amounts. You can download these and install them to the respective OS directories (sizes are in MB)


Place the memorysize file in one of these locations:

  • OS X: '/Library/Application Support/360FmKit/'
  • Windows:
    • XP: 'C:\Documents and Settings\All Users\Application Data\360Works\'
    • Vista, 7, and 8: 'C:\ProgramData\360Works\' The ProgramData folder may be hidden. Please see this article on how to show hidden files on Windows
    • Server 2008: 'C:\Users\Admin\360Works\'


How to create your own memorysize file

Mac:

  • create a file named memorysize with no extension at '/Library/Application Support/360FmKit/memorysize' which contains the required heap size, in megabytes (i.e. 128)

Instructions for using Terminal to create custom memorysize file

  • Open Terminal
  • Type "cd /Library/Application\ Support/360FmKit". If this directory doesn't exist yet, you will need to create it using either the "mkdir" command or through Finder
  • Type "sudo vi memorysize". You may be prompted for your password
  • Hit the "a" key to start "append" mode.
  • Enter the desired custom memory size in MB. There should only be the numbers with no trailing spaces or carriage returns.
  • Hit the "esc" key
  • Type ":wq" and hit return. ":" takes you into command mode, "w" is for "write", and "q" is for "quit" so this command will take you out of edit mode, save the file, and go back to the command prompt

Windows:

  • On Windows XP, the memorysize file should be located at 'C:\Documents and Settings\All Users\Application Data\360Works\memorysize'
  • On Windows Server 2008 the file should be 'C:\Users\Admin\360Works\memorysize'

Create a blank text document and rename it to "memorysize". Enter the desired custom memory size in MB. There should only be numbers with no trailing spaces or carriage returns. You must ensure that the file has no extension (.txt, etc.). You can remove extensions by un-checking the "Hide extensions for known file types" box in Windows Explorer folder options. Then rename the file without the extension. You may need to create the "360Works" directory.

Personal tools
Namespaces

Variants
Actions
Plug-in Products
Other Products
Navigation
Toolbox