Having problems with your account or logging in?
A lot of changes are happening in the community right now. Some may affect you. READ MORE HERE

Migration from BES 5.2.1 to BES 6.5

Migration from BES 5.2.1 to BES 6.5

Borland Enterprise Server 6.5 : Migration from Borland Enterprise Server 5.2.1

Tool Information

Status: Candidate [1.0]
Tool Location: BES6.5_Install/lib/migrate.jar
Release Date (mm/dd/yyyy): 1/14/2005
Platforms: All platforms supported by the product. See product platform information.
Prerequisite: Borland Enterprise Server 5.2.1 [05.02.01.P1.xx] and Borland Enterprise Server 6.5 [06.05.00.C1.15 for Solaris or Windows x86]
Base: Borland Enterprise Server 6.5
Obsoletes: None
Dependencies JDK 1.4.x is required

 

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:

Aspect
Migration Status
User Smart Agent: Uses managed_objects/migration/visibroker/services/osagent template.
localaddr
Copied to configuration.
agentaddr
Copied to configuration.
osagent.properties
Migrated.
service.description
Migrated.
Management Smart Agent: Not migrated.
OTS: Uses managed_objects/visibroker/services/ots template.
service.description
Migrated.
Sonic MQ: Not Migrated.
Apache 2: Uses managed_objects/web/apache template.
UriMapFile.properties
Copied to configuration.
WebClusters.properties
Copied to configuration.
httpd.conf
Smart copied to configuration and migrated to mod_iiop2.
apache2_0.properties
Migration presumes no post 5.2.1 installation customizations.
service.description
Migrated.
Partitions: Uses the managed_objects/migration/partitions/5_2_1 template.
partition instance libraries
Copied to configuration.
partition instance classes
Not migrated.
common libraries
Copied to configuration, replacing any partition instance libraries of the same name (thereby preserving BES 5.2.1 library precedence order).
archives (ears, wars, rars, dars and ejb_jars)
Copied to configuration and stubs regenerated.
vbroker.properties

Migrated. Any existing security properties are commented out and replaced by the default BES 6.5 security configuration.

partition.properties

All migrated, except for: runas [yet] and logging properties, trace.

partition service properties All migrated, except for logging properties, and partitionagent.properties.
partition_server.config partition_optimizeit.config

Migrated. Note:

  • javahome is only migrated when it references a default 5.2.1 JVM shipped with BES. If it references any other VM it is not migrated and a warning is issued requiring the user to manually set javahome in the .config file.
  • vmtype is set to jvmdefault if it's not already set to jvmdefault.
Server:  
Service start order
Migrated. Shutdown order is presumed to be the inverse.
Partition start order
Migrated.
server.description
Migrated.
Log configuration
Not migrated [yet].
Run as
Not migrated [yet].
Trace
Not migrated.
server.config
Not migrated.

"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:

Property
Required
Default
Meaning
migration.gui.disabled No False When set to true, run in command line mode.
bes6.root
Yes

Automatically set to the BES 6.5 installation containing the migration tool

The root directory of the BES 6.5 installation where the new configurations will be created.
bes521.root
Yes
None The root directory of the BES 5.2.1 installation where the server instance is migrated from.
bes521.server.name
Yes
bes The name of the BES 5.2.1 server instance to migrate.
server.migrate.all
No
False If true, migrate all services and partitions, otherwise only migrate enabled services and partitions.

partitions.migrate.libs

No
True Migrate server and partition instance libraries.

partitions.migrate.

repository.archives

No
True Migrate all archives deployed to the partition.

partitions.migrate.config.files

No
True Migrate partition_server.config and partiton_optimizeit.config.

partitions.migrate.properties

No
True Migrate partition and partition service properties.

partitions.archive.

stubs.regenerate

No
True Regenerate application archive stubs.

configuration.template.root

No

${bes6.root}/var/templates
/configurations/migration/

${bes521.server.name}

The location where the configuration template and it's data directory will be created.

configuration.template.name

No
${bes521.server.name}.xml The name of the new configuration template for the migrated server instance.

configuration.template.overwrite

No
False By default, if the configuration template or data directory exists the migration does not proceed.

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.

 

DISCLAIMER:

Some content on Community Tips & Information pages is not officially supported by Micro Focus. Please refer to our Terms of Use for more detail.
Version history
Revision #:
1 of 1
Last update:
‎2014-08-19 10:13
Updated by:
 
The opinions expressed above are the personal opinions of the authors, not of Micro Focus. By using this site, you accept the Terms of Use and Rules of Participation. Certain versions of content ("Material") accessible here may contain branding from Hewlett-Packard Company (now HP Inc.) and Hewlett Packard Enterprise Company. As of September 1, 2017, the Material is now offered by Micro Focus, a separately owned and operated company. Any reference to the HP and Hewlett Packard Enterprise/HPE marks is historical in nature, and the HP and Hewlett Packard Enterprise/HPE marks are the property of their respective owners.