Installing JRun Previous Up One Level Next
Moving to JRun 4


Migrating from JRun 3.x

JRun provides a migration tool for moving JRun 3.x servers and configuration settings to JRun 4. Although you can deploy JRun 3.x J2EE modules in JRun 4 without using the migration tool, the tool exports many of the settings on which modules depend.

Note:   Before deploying a JRun 3.x web application in JRun 4, you must delete all compiled JSP classes from the web application's WEB-INF/jsp directory. You should also delete the corresponding .java source files.

The migration tool does not migrate the following items:

For more information, see the "Property migration chart".

For more information about JRun 4 configuration, see JRun Administrator's Guide and JRun Assembly and Deployment Guide.

Running the migration tool

To use the migration tool:

  1. At a command prompt, change to the jrun_root/bin directory of your JRun 4 installation.
  2. Enter the following command:
    migrate jrun3.x_root

    where jrun3.x_root is the root directory of a JRun 3.1 installation.

  3. After successfully running the migration tool, open the jrun_root/migration.html file in a web browser.

The migration.html page is a migration activity report that indicates what the tool successfully migrated and what it could not migrate.

Property migration chart

The following table lists JRun properties, whether the migration tool converts them, and their respective configuration files in JRun 3.1 and JRun 4. For directory locations of each configuration file, see "JRun 3.1 configuration file directories" and "JRun 4 configuration file directories"

.
Property
JRun 3.1 location
JRun 4 location
WebService port
Migrated
local.properties:
web.endpoint.main.port
jrun.xml:
WebService
The port value is reset.
ProxyService port
Migrated
local.properties:
jcp.endpoint.main.port
jrun.xml:
ProxyService
The port value is reset.
JNDI port
Migrated
local.properties:
control.endpoint.main.port
jndi.properties:
java.naming.provider.url
The port value is reset.
Method timing
Not migrated
global.properties:
method timing
jrun.xml:
InstrumentationService
Default security roles and users
Migrated
users.properties
jrun-users.xml
JRun 4 uses server-wide security rather than global security. To emulate 3.1 functionality, users and roles are added to all JRun servers during migration.
You cannot use the wildcard character (*) as a user name.
You must rewrite custom security modules to use the Java Authentication and Authorization Service (JAAS); for more information, see JRun Administrator's Guide.
Global web application properties
Not migrated
global.properties, local.properties
default-web.xml
Global web application properties are only server-wide in JRun 4.
JRun Tag Library Global Mapping
Not migrated
global.properties:
webapp.path-mapping./WEB-INF/jrun/
jruntags.jar
You must manually copy the jruntags.jar file to the WEB-INF/lib directory of your web applications that use the JRun Tag Library. Macromedia recommends that you use the new JSP Standard Tag Library rather than the JRun Tag Library for new projects; for more information, see jakarta.apache.org/taglibs/doc/standard-doc/intro.html.
Web application context root
Migrated
local.properties:
jrun.webapp-mapping
jrun-web.xml:
context-root
For enterprise applications, set the context root in the application.xml file.
Web application hotdeploy settings
Not migrated
global.properties:
Web application hot-deploy settings
jrun.xml:
DeployerService
By default, hot deploy is enabled.
Web application virtual paths
Migrated
local.properties:
Web Application Settings

webapp.properties:
webapp.path-mapping
jrun-web.xml:
virtual-mapping
The use-web-server-root property used in JRun 3.1 does not exist in JRun 4. The virtual-mapping property replaces it. You must manually replace use-web-server-root settings with virtual-mapping settings.
Launcher classpath settings
Not migrated
global.properties:
Java VM Settings
jvm.config:
java.home
java.args
classpath.dirs
java.library.path
You can also configure these properties in the JRun Management Console (JMC).
Disable JSP translation
Not migrated
webapp.properties:
webapp.servlet-mapping.*.jsp=jsprt
default-web.xml:
JSPServlet init-param: translationDisabled
Keep generated JSP .java files
Not migrated
JRun 3.1 always keeps the generated .java files.
default-web.xml:
JSPServlet init-param: keepGenerated
By default, JRun 4 does not keep the generated .java files.
JDBC data sources
Migrated
local.properties:
JDBC DataSource Binding Service
jrun-resources.xml:
datasource
You must remove the java:comp/env prefix from the JNDI lookups in your code.
JavaMail sessions
Not migrated
local.properties:
JavaMail Session Binding Service
jrun-resources.xml:
mailSession
You must remove the java:comp/env prefix from the JNDI lookups in your code.
JMS settings
Not migrated
local.properties:
JMS Queue/Topic Binding Service
jrun-resources.xml:
jmsDestination
jmsConnectionFactory
You must remove the java:comp/env prefix from the JNDI lookups in your code.
Logging settings
Not migrated
global.properties, local.properties:
logging services
jrun.xml:
LoggerService
Services to start automatically
Not migrated
global.properties, local.properties:
list of services to start

jrun.xml:
A service listed in jrun.xml starts automatically unless the deactivated attribute is set to true.
SSL settings
Migrated
local.properties:
ssl.endpoint.main.port
ssl.keyStorePassword
jrun.xml:
SSLService
The port is set to 9100. You must manually set it to a unique port number.

JRun 3.1 configuration file directories

The following table lists the directories that contain the JRun 3.1 configuration files referenced in the "Property migration chart":
Filename
Directory
local.properties
jrun_root/servers/jrun_server
global.properties
jrun_root/lib
users.properties
jrun_root/lib
webapp.properties
jrun_root/servers/jrun_server/web_app/WEB-INF

JRun 4 configuration file directories

The following table lists the directories that contain the JRun 4 configuration files referenced in the "Property migration chart":
Filename
Directory
default-web.xml
jrun_root/servers/jrun_server/SERVER-INF
jndi.properties
jrun_root/servers/jrun_server/SERVER-INF
jrun.xml
jrun_root/servers/jrun_server/SERVER-INF
jrun-resources.xml
jrun_root/servers/jrun_server/SERVER-INF
jrun-users.xml
jrun_root/servers/jrun_server/SERVER-INF
jrun-web.xml
jrun_root/servers/jrun_server/web_app/WEB-INF
jvm.config
jrun_root/bin

Previous Up Next

 

Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/jrun/4/Installing_JRun/migration2.htm