PCRE v2.6 to PCRE v 2.7 Upgrade Procedure For Java Customers
Download PDF version of this faq: 2_6 to 2_7 Java_Upgrade_Checklist.pdf
FAQ# 26-05090202

PCRE v2.6 to PCRE v2.7 Upgrade Procedure For Java Customers

Installation steps:

Server

1. Uninstall Parallel Crystal v2.6/3.6
   
   
2. Make the following registry edits
   From HKEY_LOCAL_MACHINE\SOFTWARE, make sure the Dynalivery registry key is deleted
   
   
3. Prerequisite Software for a Parallel Crystal v2.7/3.7 Server Installation
   1. Install MDAC v2.6 from PCRE CD.
      1. Run the PCRE install shield and it will detect the presence of MDAC and if it is not where PCRE expects it to be, it will give you the option to install it or exit from the installation. Install the MDAC and reboot.
   2. Install or update Internet Explorer to version 4.01 or above.
      
      
4. Install PCRE v2.7/3.7 from the CD.
   

Client (middle tier)

1. Uninstall Parallel Crystal v2.6/3.6 client libraries
   
   Please note that the version numbers of the Dynalivery client libraries and Dynalivery servers must match.
   
   
2. Make the following registry edits
   From HKEY_LOCAL_MACHINE\SOFTWARE, make sure the Dynalivery registry key is deleted.
   
   
3. Prerequisite Software for a Parallel Crystal v2.7/3.7 Client Installation
   1. Sun's Java Runtime Environment (JRE) v1.2.
   2. Install MDAC v2.6 from PCRE CD.
      
      
4. Install the PCRE v2.7/3.7 client libraries only, from the CD.
   
   

Jar files
Make sure your CLASSPATH includes the following entries:
<path_to_Dynalivery>\PCRE\jars\ PcreJavaClient.jar
<path_to_Dynalivery>\PCRE\jars\ PcreJavaClient_SunStubs.jar

Porting Java applications from PCRE 2.6 to PCRE 2.7

1. Please refer to the FAQ titled: Major API Changes from PCRE v2.6 to v2.7
2. Please make sure all occurrences of the package com.mobileapps.pcre in your existing applications are renamed to com.dynalivery.pcre
3. Make sure you rename all occurrences of com.mobileapps.dor to com.dynalivery.dor

Implementing key features new in Parallel Crystal 2.7:

a) Queuing and Priority Reports Handling Manager: With PCRE 2.7, reports can be designated as high, medium or low priority to finely control their queuing and processing under very high concurrency conditions.

For information on using the Queuing and Priority Reports Handling Manager, please refer to the section –“Priority Manager in Java” on page 101 of the PCRE 2.7 Developer’s manual.

b) Parallel Crystal Repository: is an EJB repository to store report templates to allow sharing of consistent report templates (.rpts) between report servers in a load balancing/fail over farm configuration. Also, report output can be stored in the repository to allow archiving and retrieval of older reports.

The repository provides a centralized, secure, and platform independent facility for the storage, retrieval, and management of report templates, report output, and XML data objects for Parallel Crystal.

For detailed information on using the repository, please refer to page 96 of the PCRE 2.7 Developer’s manual.

c) Saffron HTML, PDF and RTF outputs: These are high fidelity outputs generated from Dynalivery’s second product code named “Saffron”.

For instructions on using Saffron HTML, please refer to section entitled “Saffron Output Module in Java” on page 98 of the PCRE 2.7 Developer’s manual.

d) Dynalivery "Mango" C++ library: Includes multi-threaded "parallel print" for faster response time for PDF generation.

For instructions on using “Mango” library, please refer to the section “Multi-threaded Mango PDF Library in Java” on page 104 of the PCRE 2.7 Developer’s manual.

e) New ORB Settings: Registry settings for CORBA GIOP protocol level (1.0, 1.1, 1.2) to enable communication with web/portal servers based on older Object Request Brokers (ORBs).

Registry settings to force numeric IP address use by the ORB.

For notes on ORB settings, please refer to “Configurable ORB Settings in Java” section on page 107 of the PCRE 2.7 Developer’s manual.

f) Performance Factor Load balancing Algorithm: Performance Factor can be set in the PCRE registry to evenly balance load over dissimilar report servers, each potentially purchased at different times, with different processing power.

For instructions on setting this registry entry, please refer to “Modified Load balancing Algorithm in Java” section on page 105 of the PCRE 2.7 Developer’s manual.

g) Receiving Files as Streams: This feature enables report files to be received directly as streams to be displayed on browsers or any viewers without having to write them to disk.

For detailed instructions, please refer to page 106 of the PCRE 2.7 Developer’s manual.

h) Archived File Return: This feature allows generated reports to be optionally archived before file return. This feature enables to have a faster file return for very large reports or reports having multiple files like html outputs.

For instructions on using this feature, please refer to page 108 of the PCRE 2.7 Developer’s manual.

References:
http://www.dynalivery.com/products/parallelcrystal/parallelcrystaldoc.html
http://www.dynalivery.com/customersupport/faq/2_6-2_7API-changes.html