PCRE v2.6/3.6 to PCRE v2.7/3.7 Upgrade Procedure For COM Customers
Download PDF version of this faq: 2_6 to 2_7 COM_Checklist.pdf
FAQ# 26-05090204

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
   
   
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. Microsoft's Java Virtual Machine (Build 3802 or higher)
   3. 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 JVM CLASSPATH includes the following entries:
<path_to_Dynalivery>\PCRE\jars\ jacorb.jar
<path_to_Dynalivery>\PCRE\jars\ jacorb.properties
<path_to_Dynalivery>\PCRE\jars\ PCREJavaClient_JacOrbStubs.jar
<path_to_Dynalivery>\PCRE\jars\ PCREJavaClientCOM.jar

Porting COM applications from PCRE 2.6/3.6 to PCRE 2.7/3.7

1. Please refer to the FAQ titled: Major API Changes from PCRE v2.6 to v2.7
   

Implementing key features new in Parallel Crystal 2.7:

1. 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 COM” on page 182 of the PCRE 2.7 Developer’s manual.
   
   
2. 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 178 of the PCRE 2.7 Developer’s manual.
   
   
3. 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 COM” on page 179 of the PCRE 2.7 Developer’s manual.
   
   
4. 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” on page 187 of the PCRE 2.7 Developer’s manual.
   
   
5. 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 COM” section on page 189 of the PCRE 2.7 Developer’s manual.
   
   
6. 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 COM” section on page 188 of the PCRE 2.7 Developer’s manual.
   
   
7. 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 190 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