Directions are given on this page for configuring JBoss. This page includes the following topics:
caIntegrator versions 1.4 and 1.4.x
All content on this page applies to both versions of caIntegrator.
Configuring JBoss
For Optimal Performance
You must modify your JBoss 5.1.0 configuration to increase the amount of available memory for the caIntegrator application. Directions for doing this in Windows are in the following step 1.
To configure JBoss in Windows, follow these steps.
Modify the following entry to the JBoss run.bat file which is located at
<application_root_directory>/jboss-5.1.0.GA-nci/bin/run.bat
. Find the line that begins withset JAVA_OPTS= -Dbda=bda -Dprogram.name=%PROGNAME% -server
and modify the"-Xms256m -Xmx512m"
to read"-Xms4096m -Xmx4096m"
.Physical memory
If 4096m is higher than the physical memory on the machine, then performance could be severely impacted with performance degradation and errors. 4096m of physical memory is recommended.
Warning
Be careful when copying and pasting from this installation guide. No spaces must come before and after the columns. A safe way to ensure that the text has no unwanted space and unwanted characters is to copy the text into a blank text editor such as NotePad first. Then you can correct the spacing and copy-paste back into the run.bat file.
Restart your JBoss 5.1.0 server for the changes to take effect. The method of doing this may depend on the start/stop/restart scripts you created after the installation. Most commonly, you can execute shutdown.bat and then
run.bat
under$JBOSS_HOME/bin
. Refer to the publicly available JBoss user's guide for more information.
Configuring JBoss Servers and MySQL Server to Run as Services
JBoss & MySQL as services
MySQL and the JBoss server that make up caIntegrator, and the JBoss server optionally installed for UPT, must run continually as services. The instructions in this section cover all of these scenarios. For a caIntegrator deployment, there are at least three servers, and if UPT is installed, four servers:
- JBoss 5.1.0 for UPT (optional)
- JBoss 5.1.0 (for caIntegratorapplication)
- MySQL 5.0.x
Running JBoss as a Service
BEFORE YOU BEGIN
The default caIntegrator installation runs JBoss as a command line process using the user currently logged on. Therefore, when you log out as this user, JBoss will no longer be available for caIntegrator. For that reason, it is recommended that you configure your JBoss servers to run as a Linux or Windows service. The instructions are contained in this section.
Before starting the caIntegrator JBOSS server, change the default location for user data. User data consists of various files that are saved by caIntegrator during the deployment and querying of studies. The default location for user data should be changed via the Djava.io.tmpdir
jvm parameter in the Jboss run.conf
file.
Example jvm parameter: -Djava.io.tmpdir=/local/content/caintegrator/jvmtmp
To run JBoss as a service, follow these steps:
Linux
See http://wiki.jboss.org/wiki/Wiki.jsp?page=StartJBossOnBootWithLinux .
Windows
To run an existing JBoss command line installation as a service, follow the directions for creating a user-defined service at http://support.microsoft.com/kb/137890/EN-US/ . You need to have access to the Windows Resource Kit.
Running MySQL as a Service
Server installed?
It is assumed that your MySQL server was installed as a service. If it was not, follow these recommendations for installing this server as a service.
To run MySQL as a service, follow these steps:
Linux
See http://www.redhat.com/docs/manuals/enterprise/RHEL-AS-2.1-Manual/cluster-manager/s1-service-mysql.html .
Windows
When installing MySQL server on Windows, choose the option to run MySQL as a Windows service.