Cognos ReportNetTM Installation and Configuration Guide
Cognos ReportNetTM Installation and Configuration Guide Cognos ReportNetTM Installation and Configuration Guide
Chapter 7: Advanced Configuration Options 20. Insert the P2PD_LIB environment variable and add the required jar files to the CLASSPATH value (WebLogic 6.1) or PRE_CLASSPATH value (WebLogic 7.0). If you use a WebLogic version other than WebLogic 6.1 SP4 or WebLogic 7.0 SP2, you may have to remove the chunking patch entry. Ensure that there are no spaces in the CLASSPATH or PRE_CLASSPATH value. Use the correct character format. For example, on Windows use "\" instead of "/", and "%%" instead of "$". Replace with the correct path. Tip: To make it easier to enter this information in the startWeLogic script file, you can copy the information from a template file included with the ReportNet installation. The templates include information for all supported versions of WebLogic. The templates, wblg_tmplt_ux.txt for UNIX and wblg_tmplt_win.txt for Windows, are located in the crn_location/webcontent/documentation directory. • For example, for WebLogic 6.1 SP4 on UNIX, insert the following information after the existing CLASSPATH entry: P2PD_LIB=/wlserver6.1/config/ReportNet/applications/p2pd/WEB- INF/lib CLASSPATH=/wlserver6.1/lib/CR102751_61sp4.jar:$P2P D_LIB/xml-apis.jar:$P2PD_LIB/xercesImpl.jar:$P2PD_LI B/xalan.jar:$P2PD_LIB/xtsext.jar:$P2PD_LIB/xsltc.jar: $P2PD_LIB/i18nj.jar:$P2PD_LIB/icu4j.jar:$P2PD_LIB /dom4j.jar:$P2PD_LIB/commons-discovery.jar:$P2PD_LIB /commons-httpclient.jar:$P2PD_LIB/commons-logging.jar :$P2PD_LIB/jaxrpc.jar:$P2PD_LIB/jcam_jni.jar:$CLASSPATH • For example, for WebLogic 7.0 SP2 on UNIX, insert the following information after the JAVA_OPTIONS entry: P2PD_LIB=/user_projects/ReportNet/applications/p2pd/WEB-INF/l ib PRE_CLASSPATH=/weblogic700/common/lib/
Chapter 7: Advanced Configuration Options Enable SSL for WebLogic 28. For WebLogic 6.1, configure a new Web application using the following settings: • name = p2pd • path = WebLogic_location/wlserver6.1/config/ReportNet/applications/p2pd Note: WebLogic 7.0 automatically creates a Web application. 29. Set the reload period for the Web application to -1. 30. Add the server to the targets, and then apply the changes. 31. Stop and then restart the WebLogic Application Server associated with the ReportNet domain. 32. If ReportNet was previously configured to use Tomcat, you must unregister the associated dispatcher (p. 86). If the Web server is configured (p. 34) and started, the configuration is complete and you can now test ReportNet. You must complete the following additional configuration to enable SSL. Steps 1. Configure WebLogic to use SSL. This will generate an SSL server certificate. For more information, refer to the WebLogic documentation. 2. Copy the CA certificate to the crn_location/bin directory and rename the file to ca.cer. This file must be Base-64 encoded X.509 format. 3. From the crn_location/bin directory: • On UNIX, type: ThirdPartyCertificateTool.sh -T -i -r ca.cer -k ../configuration/signkeypair/jCAKeystore -p password • On Windows, type: ThirdPartyCertificateTool.bat -T -i -r ca.cer -k ../configuration/signkeypair/jCAKeystore -p password Important: You must type jCAKeystore as the name of the certificate authority key store. This ensures that ReportNet trusts the certificate authority that generated the server certificate. Configuring ReportNet to Use a Customized WebLogic Application Server To help you configure ReportNet in a customized application server environment, we suggest that you review the steps for configuring a default WebLogic environment (p. 81) to obtain a general understanding of the requirements. To configure a customized environment, you must design a configuration process that is appropriate for your environment. Use the following checklist to ensure that the configuration process you design achieves the required results ❑ Create a new domain for ReportNet. ❑ Add environment variable information to the WebLogic configuration files. ❑ Generate an XML registry in WebLogic. ❑ Package ReportNet into a war file that you will install in the WebLogic environment. ❑ Modify the startWebLogic file. ❑ Configure the WebLogic web application. ❑ If required, enable SSL. For more information about working with WebLogic, see the documentation included with the WebLogic installation. Installation and Configuration Guide 85
- Page 33 and 34: Chapter 4: Configuring ReportNet Af
- Page 35 and 36: Chapter 4: Configuring ReportNet St
- Page 37 and 38: Chapter 4: Configuring ReportNet 3.
- Page 39 and 40: Chapter 4: Configuring ReportNet Co
- Page 41 and 42: Chapter 4: Configuring ReportNet Wh
- Page 43 and 44: Chapter 4: Configuring ReportNet Th
- Page 45 and 46: Chapter 4: Configuring ReportNet St
- Page 47 and 48: Chapter 4: Configuring ReportNet 3.
- Page 49 and 50: Chapter 4: Configuring ReportNet 4.
- Page 51 and 52: Chapter 4: Configuring ReportNet St
- Page 53 and 54: Chapter 4: Configuring ReportNet 6.
- Page 55 and 56: Chapter 4: Configuring ReportNet Ad
- Page 57 and 58: Chapter 4: Configuring ReportNet Ex
- Page 59 and 60: Chapter 4: Configuring ReportNet Sp
- Page 61 and 62: Chapter 4: Configuring ReportNet 3.
- Page 63 and 64: Chapter 5: Installing Framework Man
- Page 65 and 66: Chapter 5: Installing Framework Man
- Page 67 and 68: Chapter 6: Configuring Framework Ma
- Page 69 and 70: Chapter 6: Configuring Framework Ma
- Page 71 and 72: Chapter 6: Configuring Framework Ma
- Page 73 and 74: Chapter 6: Configuring Framework Ma
- Page 75 and 76: Chapter 6: Configuring Framework Ma
- Page 77 and 78: Chapter 7: Advanced Configuration O
- Page 79 and 80: Chapter 7: Advanced Configuration O
- Page 81 and 82: Chapter 7: Advanced Configuration O
- Page 83: Chapter 7: Advanced Configuration O
- Page 87 and 88: Chapter 7: Advanced Configuration O
- Page 89 and 90: Chapter 7: Advanced Configuration O
- Page 91 and 92: Chapter 8: Setting Up the Samples Y
- Page 93 and 94: Chapter 8: Setting Up the Samples 7
- Page 95 and 96: Chapter 8: Setting Up the Samples S
- Page 97 and 98: Chapter 9: Setting Up an Unattended
- Page 99 and 100: Chapter 9: Setting Up an Unattended
- Page 101 and 102: Chapter 10: Uninstalling Cognos Rep
- Page 103 and 104: Appendix A: Manually Configuring Re
- Page 105 and 106: Appendix A: Manually Configuring Re
- Page 107 and 108: Appendix B: Troubleshooting Use thi
- Page 109 and 110: Appendix B: Troubleshooting Unable
- Page 111 and 112: Appendix B: Troubleshooting For Con
- Page 113 and 114: Appendix B: Troubleshooting 2. If y
- Page 115 and 116: Appendix B: Troubleshooting Databas
- Page 117 and 118: Appendix C: Database Schema for Log
- Page 119 and 120: Appendix D: Database Clean Up Scrip
- Page 121 and 122: Glossary anonymous access A method
- Page 123 and 124: Glossary In Framework Manager, name
- Page 125 and 126: Index A adding resources, 103 AIX e
- Page 127 and 128: Index Framework Manager components,
- Page 129 and 130: Index server administration logging
Chapter 7: Advanced <strong>Configuration</strong> Options<br />
20. Insert the P2PD_LIB environment variable <strong>and</strong> add the required jar files to the CLASSPATH<br />
value (WebLogic 6.1) or PRE_CLASSPATH value (WebLogic 7.0).<br />
If you use a WebLogic version other than WebLogic 6.1 SP4 or WebLogic 7.0 SP2, you may<br />
have to remove the chunking patch entry.<br />
Ensure that there are no spaces in the CLASSPATH or PRE_CLASSPATH value. Use the<br />
correct character format. For example, on Windows use "\" instead of "/", <strong>and</strong><br />
"%%" instead of "$". Replace with<br />
the correct path.<br />
Tip: To make it easier to enter this information in the startWeLogic script file, you can copy<br />
the information from a template file included with the ReportNet installation. The templates<br />
include information for all supported versions of WebLogic. The templates,<br />
wblg_tmplt_ux.txt for UNIX <strong>and</strong> wblg_tmplt_win.txt for Windows, are located in the<br />
crn_location/webcontent/documentation directory.<br />
• For example, for WebLogic 6.1 SP4 on UNIX, insert the following information after the<br />
existing CLASSPATH entry:<br />
P2PD_LIB=/wlserver6.1/config/ReportNet/applications/p2pd/WEB-<br />
INF/lib<br />
CLASSPATH=/wlserver6.1/lib/CR102751_61sp4.jar:$P2P<br />
D_LIB/xml-apis.jar:$P2PD_LIB/xercesImpl.jar:$P2PD_LI<br />
B/xalan.jar:$P2PD_LIB/xtsext.jar:$P2PD_LIB/xsltc.jar:<br />
$P2PD_LIB/i18nj.jar:$P2PD_LIB/icu4j.jar:$P2PD_LIB<br />
/dom4j.jar:$P2PD_LIB/commons-discovery.jar:$P2PD_LIB<br />
/commons-httpclient.jar:$P2PD_LIB/commons-logging.jar<br />
:$P2PD_LIB/jaxrpc.jar:$P2PD_LIB/jcam_jni.jar:$CLASSPATH<br />
• For example, for WebLogic 7.0 SP2 on UNIX, insert the following information after the<br />
JAVA_OPTIONS entry:<br />
P2PD_LIB=/user_projects/ReportNet/applications/p2pd/WEB-INF/l<br />
ib<br />
PRE_CLASSPATH=/weblogic700/common/lib/