NIH | National Cancer Institute | NCI Wiki  

Error rendering macro 'rw-search'

null

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin
Wiki Markup
{scrollbar:icons=false}

Page info
title
title

Directions are given on this page for configuring JBoss. This page includes the following topics:

Table of Contents
minLevel2

Info
titlecaIntegrator versions 1.4 and 1.4.x

All content on this page applies to both versions of caIntegrator.

Configuring JBoss

Note
titleFor 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.

  1. 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 with set JAVA_OPTS= -Dbda=bda -Dprogram.name=%PROGNAME% -server and modify the "-Xms256m -Xmx512m" to read "-Xms4096m -Xmx4096m" .

    Info
    titlePhysical 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
    titleWarning

    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.

  2. 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

    Multiexcerpt include
    nopaneltrue
    MultiExcerptNameExitDisclaimer
    PageWithExcerptwikicontent:Exit Disclaimer to Include
    for more information.

Configuring JBoss Servers and MySQL Server to Run as Services

Info
titleJBoss & 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

Note
titleBEFORE 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

Multiexcerpt include
nopaneltrue
MultiExcerptNameExitDisclaimer
PageWithExcerptwikicontent:Exit Disclaimer to Include
.

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/

Multiexcerpt include
nopaneltrue
MultiExcerptNameExitDisclaimer
PageWithExcerptwikicontent:Exit Disclaimer to Include
. You need to have access to the Windows Resource Kit.

Running MySQL as a Service

Info
titleServer 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

Multiexcerpt include
nopaneltrue
MultiExcerptNameExitDisclaimer
PageWithExcerptwikicontent:Exit Disclaimer to Include
.

Windows

When installing MySQL server on Windows, choose the option to run MySQL as a Windows service.

Wiki Markup
{scrollbar:icons=false}