Borland Enterprise Server 6.5 : Migration from Borland Enterprise Server 5.2.1

Tool Information

Tool Description

This add-on tool extends BES 6.5 to include migration of BES 5.2.1 server instances to BES 6.5 configuration templates. Once the tool is installed it simply needs to be run for each BES 5.2.1 server instance that requires migration. Each migrated server instance results in configuration template being added to the BES 6.5 installation. The BES console can then be used to create as many live configurations as required (typically just one) from each template, and to manage (start/stop) the configurations.

You access the new configuration templates using the Template Gallery. Each new configuration template is stored initially in the 'Configuration Category' 'other'.

Once started, a migrated configuration should offer all the same BES and application services as the previous BES 5.2.1 server instance. Note that the BES 5.2.1 server instance should be stopped before starting the new BES 6.5 configuration. See the Borland Op-Center Developer's Guide for details about using configurations.

Migration Details

The following list details which aspects of a BES 5.2.1 server instance are migrated into the BES 6.5 configuration template:

"Smart copied" means that file paths to locations in the BES 5.2.1 installation are updated during the copy to refer to the equivalent location in the BES 6.5 template.

Note that, except as noted, the contents of nativeservice.properties and service.properties for each service are not migrated to the configuration template at this time.

Running The Migration Tool

The migration tool can be run as a GUI tool or from the command line. Invoking the migrate command will launch the GUI. The command line variant is run by the migrate -Dmigration.gui.disabled=true command.

Each run of the migration tool can be configured by the following properties:

All of these properties can be specified as Java system properties. A properties file can be used when invoking the tool in command line mode. The file is specified by the "migrate.props" system property on the migrate command line. System properties override properties in the file. The GUI mode does not accept a properties file, and will ignore the "migrate.props" system property

GUI example usage:

C:\\Borland\\bes650c115\\bin>migrate -Dbes521.root=C:\\Borland\\bes521c135 -Dbes521.server.name=bes

Command line example usage:

C:\\Borland\\bes650c115\\bin>migrate -Dmigration.gui.disabled=true -Dmigrate.props=C:\\working\\migration.props

Artifacts Not Migrated

• Hosted modules are not migrated. The custom configuration necessary to host a module in 5.2.1 cannot be programmatically migrated to a 6.5 installation.

Known Issues

• GUI 'View Properties' viewer does not display current properties settings. Changes in properties using GUI are not reflected in the panel displayed when clicking the 'View Properties' button. The properties are respected during the migration itself.
• The tool may sometimes fail to 'smart copy' the Web Server configuration file httpd.conf. The tool will log a warning. You must manually migrate the Web Server configuration.
• The property 'service.description' is not migrated for OTS, the Borland Web Server (apache) or for the User Smart Agent.
• When migrating a Borland Web Server between UNIX or Linux and a Microsoft Windows platform, the file httpd.conf may need to be edited to remove modules that are available on one platform, such as the cgid_module or the isapi_module, but are not avaialble on the new host platform. You may need to manually remove such LoadModule directives. This is as designed.
• The 'javahome' directive for partition_server.config may not migrate properly when the target 6.5 installation does not have a default JDK. The BES installers for HP-UX and AIX do not include a JDK. When migrating from a 5.2.1 Solaris installation to a 6.5 HP-UX installation, for instance, the tool will not properly migrate the 'javahome' directive. The instantiated 6.5 configuration, will fail to start because the partition cannot find its configured JDK. If you encounter this problem, you must modify the file <6.x_inst_root>/var/domains/base/configurations/<configuration_name>/mos/partition/<partition_name>/adm/properties/partition_server.config. You must comment out or remove the 'javahome' directive and add an 'include' directive:

## add this line include
$var(installRoot)/bin/toolsjdk.config
## comment out this line or remove it. comment lines begin with '#'
#javahome $var(installRoot)/jdk/jdk1.4.2

Installation Instructions

Please follow the steps below to install the tool:

• Download the archive. Use the right mouse button on the link to bring up a menu, then select the "Save Link As..." option to save the file.
• Unpack the archive (using jar) in the <bes65_install> directory so the files in the archive unpack into the required subdirectory structure.