Deploy Crystal Server components to IBM® Enterprise
Records.
Before you begin
Configure and deploy
IBM Enterprise
Records by
completing the following steps:
- Removing existing Crystal Reports server software, if any exists.
- Installing Crystal Server 2011 components.
- Reconfiguring and redeploying the IBM Enterprise
Records web application
Review the overview topic about installing Crystal Server, especially
the instructions about setting
Application Engine or
Workplace XT site preferences.
Procedure
To configure and deploy the Crystal Server components
to IBM Enterprise
Records:
- Remove the existing IBM Enterprise
Records web
application from the application server:
Option |
Description |
WebSphere® Application
Server |
From the WebSphere Application
Server administrative
console:- Stop the IBM Enterprise
Records web
application process.
- Remove the IBM Enterprise
Records web
application from Enterprise Applications.
|
WebLogic Server |
From the WebLogic Server Console,
remove the IBM Enterprise
Records web
application. |
JBoss Application Server |
For JBoss Application Server:- Stop the JBoss Application Server.
- Remove the IBM Enterprise
Records application
by removing the RecordsManager.war directory
from JBOSS_HOME/server/default/deploy/.
- Remove the RecordsManager temporary working
directory for IBM Enterprise
Records from JBOSS_HOME/server/default/work/MainEngine/localhost/.
|
- Copy the crystalreportviewers directory
from the Crystal Reports server, C:/Program Files (x86)/SAP
BusinessObjects/Crystal Reports 2011/crystalreportsviewers,
to the server with IBM Enterprise
Records, ier_install_path/IBM/EnterpriseRecords/RecordsManager/.
- If you have an existing installation
of Crystal Reports 11, you must delete the previously installed Crystal
Reports 11 JAR files in the ier_install_path/IBM/EnterpriseRecords/RecordsManager/WEB-INF/lib folder. Otherwise, skip this step.
- cecore.jar
- celib.jar
- ceplugins.jar
- cereports.jar
- cesession.jar
- ceutils.jar
- cexsd.jar
- corbaidl.jar
- ebus405.jar
- MetafileRenderer.jar
- rasapp.jar
- rascore.jar
- Serialization.jar
- URIUtil.jar
- webreporting.jar
- If you have an existing installation of Crystal Reports
Server 2008, you must delete the previously installed Crystal Reports
Server 2008 JAR files in the ier_install_path/IBM/EnterpriseRecords/RecordsManager/WEB-INF/lib folder. Otherwise, skip this step.
- biarengine.jar
- biplugins.jar
- cecore.jar
- celib.jar
- ceplugins_client.jar
- ceplugins_core.jar
- ceplugins_cr.jar
- cereports.jar
- cesession.jar
- ceutils.jar
- corbaidl.jar
- ebus405.jar
- flash.jar
- legacy_SL_plugins.jar
- logging.jar
- MetafileRenderer.jar
- pluginhelper.jar
- rasapp.jar
- rascore.jar
- reporttemplate.jar
- serialization.jar
- webreporting.jar
- xcelsius.jar
- backport-util-concurrent-2.2.jar
- derby.jar
- Copy the following Crystal Server JAR files to ier_install_path/IBM/EnterpriseRecords/RecordsManager/WEB-INF/lib from
the C:/Program Files (x86)/SAP BusinessObjects/SAP BusinessObjects
Enterprise XI 4.0/java/lib folder. Or you might
need to copy them from C:/Program Files (x86)/SAP BusinessObjects/SAP
BusinessObjects Enterprise XI 4.0/java/lib/external on
the Crystal Server.
- activation-1.1.jar
- aspectjrt.jar
- axiom-api-1.2.5.jar
- axiom-impl-1.2.5.jar
- axis2-adb-1.3.jar
- axis2-kernel-1.3.jar
- axis2-saaj-1.3.jar
- backport-util-concurrent-2.2.jar
- bcm.jar
- biarengine.jar
- ceaspect.jar
- cecore.jar
- celib.jar
- ceplugins_core.jar
- cereports.jar
- cereports_tr.jar
- ceresprops.jar
- certjFIPS.jar
- cesession.jar
- com.sap.js.passport.api.jar
- commons-beanutils.jar
- commons-collections-3.1.jar
- commons-digester-1.6.jar
- corbaidl,jar
- cryptojFIPS.jar
- CrystalReportsSDK.jar
- CrustalReportsSDK_tr.jar
- derby.jar
- ebus405.jar
- freessl201.jar
- icu4j.jar
- logging.jar
- ras21sdk.jar
- SL_plugins.jar
- ssljFIPS.jar
- stax-api-1.0.1.jar
- TraceLog.jar
- webreporting-jsf.jar
- webreporting.jar
- webreporting_tr.jar
- wsdl4j-1.6.2.jar
- wstx-asl-3.2.1.jar
- XmlSchema-1.2.3.jar
- Copy the IBM Enterprise
Records web.xml file
from the deployment location. Copy the file to the installation directory
at: ier_install_path/IBM/EnterpriseRecords/RecordsManager/WEB-INF.
Table 1. Deploy locations
of web.xml fileOption |
Deploy location |
WebSphere Application
Server |
C:/Program Files/IBM/EnterpriseRecords/Recordsmanager
/WEB-INF/web.xml
|
Oracle WebLogic Server |
C:/Program Files/IBM/EnterpriseRecords/Recordsmanager
/WEB-INF/web.xml
|
JBoss Application Server |
C:/Program Files/IBM/EnterpriseRecords/Recordsmanager
/WEB-INF/web.xml
|
- Modify the web.xml file for Crystal
Server 2011.
- In the context-param section, change the param-value
section from crystal_image_uri value to crystalreportviewers.
<context-param id="ContextParam_15">
<param-name>crystal_image_uri</param-name>
<param-value>../crystalreportviewers</param-value>
</context-param>
- Add the following entries into the servlet section.
<servlet>
<servlet-name>CrystalReportViewerServlet</servlet-name>
<servlet-class>
com.crystaldecisions.report.web.viewer.CrystalReportViewerServlet
</servlet-class>
</servlet>
- Add the following entries into the servlet-mapping
sections.
<servlet-mapping>
<servlet-name>CrystalReportViewerServlet</servlet-name>
<url-pattern>/CrystalReportViewerHandler</url-pattern>
</servlet-mapping>
- Save your changes to the web.xml file.
- Redeploy the IBM Enterprise
Records web
application by using the instructions provided in the Configuration
Manager. Complete the redeployment after following the instructions
for installing Content Engine and Process Engine or Content Platform Engine clients in the configuring
topic.
Important: You must regenerate and redeploy
the WAR or EAR files for the changes to the web.xml file
to take effect.
- Run Application Engine or Workplace XT with by using an administrator
account.
- From the Site Preferences menu,
go to General. In the Report application
server path field, enter the name of the Crystal Server
2011 server.