Changes between Version 4 and Version 5 of Doc/compiler/running

Timestamp:

Mar 7, 2007, 2:57:45 PM (17 years ago)

Author:

/O=GRID-FR/C=FR/O=CNRS/OU=LAL/CN=Charles Loomis

Comment:

--

Doc/compiler/running

@@ -45 +45 @@
 == Adjusting the Java Virtual Machine Memory ==
 
+The performance of the compiler can degrade markedly if there is not sufficient memory to do a particular compile and build.  The mechanism for increasing the available memory differs depending on how the compiler in invoked.
+
+== Direct Invocation via Java ==
+
+If the java compiler class is being directly invoked via the {{{java}}} command, then the option "-Xmx" must be added.  For example to start java with 1024 MB, the following command and options can be used:
+{{{
+java -Xmx1024M org.quattor.pan.Compiler [options...]
+}}}
+For the panc command, currently the panc script must be edited to add this option.
+
+== Direct Invocation via Ant ==
+
+If the compiler is invoked via the panc ant task, then the memory option can be added with the ANT_OPTS environmental variable.
+{{{
+export ANT_OPTS="-Xmx1024M"
+}}}
+or 
+{{{
+setenv ANT_OPTS "-Xmx1024M"
+}}}
+depending on whether you use an "sh"- or "csh"-type shell.
+
+== Invocation via Eclipse ==
+
+If you use the default VM to run the panc ant task, then you will need to increase the memory when starting eclipse.  From the command line you can add the VM arguments like:
+{{{
+eclipse -vmargs -Xmx<memory size>
+}}}
+You may also need to increase the memory in the "permanent" generation for a Sun VM with
+{{{
+eclipse -vmargs -XX:MaxPermSize=<memory size>
+}}}
+This will increase the memory available to eclipse and to all tasks using the default virtual machine.  For Max OS X, you will have to edit the application "ini" file.  See the  [http://help.eclipse.org/help32/index.jsp?topic=/org.eclipse.platform.doc.user/tasks/running_eclipse.htm eclipse instructions] for how to do this.
+
+If you invoke a new java virtual machine for each build, then you can change the ant arguments via the run parameters.  From within the "ant" view, right-click on the appropriate ant build file, and then select "Run As -> Ant Build...".  In the pop-up window, select the JRE tab.  In the "VM arguments" panel, add the "-Xmx<memory size>" option without the quotes.  (You can also add other options here.)  The next build will use these options.