Download Java 1.4. Plug-In Settings on Windows – by Ben Patridge 4/17/06 Go

Java 1.4. Plug-In Settings on Windows – by Ben Patridge 4/17/06
Go to START --- SETTINGS --- CONTROL PANEL and double click on Java Plug-in
This next screen is the basic java screen. Leave it as is.
*note: TRC may ask you to turn on the Java Console for troubleshooting, and this screen is
where you would set it by selecting the “show console” radio button.
These options are left at the defaults for the purposes of HSSM.
Java 1.4. Plug-In Settings on Windows – by Ben Patridge 4/17/06
TRC support may request that logging be enabled as well as the console during troubleshooting,
and this is where you would enable/disable them. Enabling the console will display a window
like the following once you close and restart your browser.
*note: that this window will not display until Java is accessed.
Java 1.4. Plug-In Settings on Windows – by Ben Patridge 4/17/06
Once accessed it will display A LOT of messages.
The advantage of enabling this feature during troubleshooting is if you are receiving Java errors
during an HSSM operation, you may enable logging, then display the console; select copy; then
paste the contents into notepad and email it back to TRC. This will aid in establishing a
connection between the HSSM appiq.log errors and the Java client messages.
Java 1.4. Plug-In Settings on Windows – by Ben Patridge 4/17/06
Back at the Java Control panel, select the ADVANCED TAB. The following is how it looks by
DEFAULT
For HSSM Tuning, The -Xmx maximum heap size should be set to 1/4th of the machine's
physical memory (up to 1 GB max). The default is only 64Mb which is inefficient for HSSM.
For example, in an environment where the HOST machine has 1Gb of RAM, then the –Xmx
should be set as follows to ¼ 1024 or –Xmx256m. For a 2G machine the –Xmx should be ¼
2048 or –Xmx512m:
Note that the values ARE case sensitive, and it should be –Xmx512m and NOT –xmx512m.
Note: If you are requested by TRC to set additional Java Runtime Parameters, they should be
separated by a “space”
According to Java BUG ID 4697804 there exists a bug where the Java VM will exit when it
cannot expand the memory heap, rather than throw an out of Memory exception error, that would
allow the application to continue and recover. The workaround (as this bug is still in progress by
SUN) is to set the –Xms equal to the –Xmx value.
Java 1.4. Plug-In Settings on Windows – by Ben Patridge 4/17/06
For Example, if you have a machine with 2G RAM then you would set the –Xms value to “Xms512m” and –Xmx value to “-Xmx512m.” you would set as follows
The following tab is the Browser Tab. If you are using Internet Explorer (IE) then leave the
default:
Java 1.4. Plug-In Settings on Windows – by Ben Patridge 4/17/06
This next screen allows you to set java so it will utilize either your browser proxy settings, or
you can customize which ones you want it to use.
I often find it helpful (though not required) to put the IP address or hostname of the HSSM
server under No Proxy Host.
The next screen is for caching. Caching is when Java has utilized the contiguous memory
allocated and requires additional memory space. It writes this data to disk in a “cache” location.
The amount of space allocated for the “cache” is customizable and is set here. By default it is
50Mb
Java 1.4. Plug-In Settings on Windows – by Ben Patridge 4/17/06
For HSSM it is recommended that this value be extended to at least 150Mb.
This next screen should contain the APPIQ certificate and should be left AS IS.
Java 1.4. Plug-In Settings on Windows – by Ben Patridge 4/17/06
This next screen controls whether Java automatically checks for updates:
This should be disabled ESPECIALLY on the HSSM server as it is important to control the
version of Java run in an HSSM environment. Therefore, uncheck this box:
Java 1.4. Plug-In Settings on Windows – by Ben Patridge 4/17/06
Lastly, the About tab will display the version and build level of Java being run.
After you have made all your changes click Apply, then click the “X” in the upper right hand
corner to close Java. If you have a browser open, then you must close and re-start the browser for
the new java settings to take place.
Note: you DO NOT have to reboot after making changes to Java
Java 1.4. Plug-In Settings on Windows – by Ben Patridge 4/17/06
Lastly, it is important to ensure your Browser is configured to use Java.
Start Internet Explorer (IE) and select TOOL --- INTERNET OPTIONS
Java 1.4. Plug-In Settings on Windows – by Ben Patridge 4/17/06
Now select the Advanced Tab
Java 1.4. Plug-In Settings on Windows – by Ben Patridge 4/17/06
Scroll down to where you see the Java option and ensure the Java [Sun] box is enabled.