/
Install ServiceManager Deploying ServiceManager Client
Document toolboxDocument toolbox

Install ServiceManager Deploying ServiceManager Client

Owned by Andrew Hill (Deactivated)
Last updated: Nov 02, 2017Version comment

On This Page:

The ServiceManager client application is mainly a set of HTML and Javascript pages viewable within a suitable browser (see reference [2]).  However the ServiceManager Local Knowledge control has been implemented using Sun Microsystems Java Applet technology and requires the client browser to have both the appropriate Java Runtime Environment available and enabled.  Without the appropriate JRE installed this control will not execute correctly.  

Enabling the JRE

To check the JRE deployment of the client machine, review Internet Explorer's settings on the Advanced tab of the Internet Options dialog.  The following dialog shows a client machine with Internet Explorer incorrectly configured (no Sun JRE available):

JRE technology is made available to the browser via the Java Plug-in Control Panel.  Once a JRE has been installed this plug-in control is available from within the "Settings\Control Panel" application of the client machine. 

The Java Plug-in Control Panel is a dialog tabbed control.  Selecting the "Browser" tab displays the following settings:

Ensure that Microsoft Internet Explorer option is checked.  After clicking "Apply" all subsequent invocations of Internet Explorer should now have the correct JRE as the default:

Heap Space Allocation

The following only applies to sites using the Local Knowledge applet control who envisage assigning significant numbers of regions to individual operatives. 

The control is a Java Applet and runs within the browser's JRE instance - (Java Virtual Machine - JVM).  Each JVM is allocated an amount of memory which cannot be exceeded by the applet (more accurately, cannot be exceeded by the JVM).  If exceeded the JVM will throw an OutOfMemory exception and fail.  If this happens the client machine requires its JVM to be configured to allocate more memory which is achieved using the Java Plug-in Control Panel. 

From the "Advanced" tab, of this control, there is an edit control entitled "Java Runtime Parameters" and it can accept a space delimited list of any valid runtime parameters sequence.  In order to increase the default heap size, the parameter -Xmx is required, this allows the user to specify, in terms of megabytes how much memory to allocate. 

The format of this parameter is: -Xmx=<some value>M

Note there are no spaces between the equals sign, and <some value> and no space between <some value> and the M character.  The following diagram depicts the Java Plug-in Control Panel being used to set the heap size to 256 megabytes:

It should be noted that because of restrictions within the Java model it is not possible for the Applet to extend the maximum heap size allocated to the JVM.