...

Application Servers – Sun Java Systems Application Server (SJSAS) Installation

by user

on
Category: Documents
3

views

Report

Comments

Transcript

Application Servers – Sun Java Systems Application Server (SJSAS) Installation
Proven Practice
Application Servers – Sun Java
Systems Application Server (SJSAS)
Installation
Product(s): IBM Cognos 8, SJSAS
Area of Interest: Infrastructure
IBM Cognos Proprietary Information
DOC ID: AS07 Version 8.3.0.0
Title: Cognos ReportNet & WebSphere Clustering
Copyright
Your use of this document is subject to the Terms of Use governing the Cognos
software products and related services which you have licensed or purchased
from Cognos. The information contained in this document is proprietary
information of Cognos Incorporated and/or its licensors and is protected under
copyright and other applicable laws. You may use the information and
methodologies described in this document 'as is' or you may modify them,
however Cognos will not be responsible for any deficiencies or errors that result
from modifications which you make. Copyright 2006 (c) Cognos Incorporated. All
Rights Reserved.
You can print selected pages, a section, or the whole book. Cognos grants you a
non-exclusive, non-transferable license to use, copy, and reproduce the
copyright materials, in printed or electronic format, solely for the purpose of
providing internal training on, operating, and maintaining the Cognos software.
This document is maintained by the Best Practices, Product and Technology
team. You can send comments, suggestions, and additions to Best Practices,
Product and Technologies.
IBM Cognos Proprietary Information
Title: Cognos ReportNet & WebSphere Clustering
TABLE OF CONTENT
1 Introduction ...........................................................................................................................................1
1.1 Purpose..............................................................................................................................................1
1.2 Scope.................................................................................................................................................1
1.3 Definitions, Acronyms, and Abbreviations.......................................................................................1
1.4 References.........................................................................................................................................1
1.5 Assumptions......................................................................................................................................1
2 SJSAS 9.1 Installation...........................................................................................................................3
2.1 SJSAS Installer .................................................................................................................................3
2.1.2
Change Master Password ........................................................................................................8
2.1.3
Start the Application Server ....................................................................................................9
2.2 SJSAS Administration Console ........................................................................................................9
3 Configuring for IBM Cognos 8 ..........................................................................................................10
3.1 JVM Options...................................................................................................................................10
3.1.1
XML Parser ...........................................................................................................................10
3.1.2
Java Max Heap Size ..............................................................................................................10
3.2 Copy the XML Parser .....................................................................................................................11
3.3 Environment Varaibles ...................................................................................................................11
4 Deploy the IBM Cognos 8 Application ..............................................................................................12
4.1 Deploy a New Application..............................................................................................................12
4.2 Select the Application File ..............................................................................................................12
4.3 Verify the Deployment....................................................................................................................13
5 Stop and Restart the Application Server...........................................................................................13
6 Troubleshooting...................................................................................................................................14
6.1 Xerces ClassCastException Error ...................................................................................................14
6.2 JCAM_Crypto_JNI UnsatisfiedLinkError ......................................................................................14
IBM Cognos Proprietary Information
Title: Cognos ReportNet & WebSphere Clustering
1
1 Introduction
1.1
Purpose
This document is intended for those who have limited experience with Sun Java Systems Application
Server and who wish to set up an Application Server environment in which to run IBM Cognos 8.
Except where noted, the primary focus of this document will be to cover the setup steps required for IBM
Cognos 8.3.
1.2
Scope
The instructions in this document will work across supported operating system platforms however the
examples shown may be based on a Windows install. UNIX installations require slight modifications to
syntax but should otherwise be identical. For example, regarding the syntax for variables, use
${VARIABLE} for UNIX and %VARIABLE% for Windows. Consult your UNIX documentation for
more information regarding commands, syntax and scripting.
This document will take you through the steps to install SJSAS and setup an appropriate environment into
which you will be able to deploy and run IBM Cognos 8.
1.3
Definitions, Acronyms, and Abbreviations
Term
SJSAS
C8
1.4
Definition
Sun Java Systems Application Server
IBM Cognos 8 BI
References
Ref. ID
1.5
Author/Paper
Configuring SJSAS for ReportNet
Location
Devcentral->Foundation Services>Application Server->IBM SJSAS App
Server
Assumptions
Before continuing, make sure the following prerequisites have been met.
•
Licenses – SJSAS is (currently) free to download and use in production. Sun offers licensing and
support plans for purchase.
•
Hardware and Operating Systems– There are many dependencies for both SJSAS and IBM
Cognos 8. As these are numerous, please consult the Sun website and/or the SJSAS
documentation to determine the software and operating system requirements for SJSAS. The IBM
Cognos Support web site should also be consulted to determine the minimum requirements for the
IBM Cognos 8 product.
IBM Cognos Proprietary Information
Title: Cognos ReportNet & WebSphere Clustering
2
•
SJSAS Installation and Update software - That you have the necessary files to perform the
installation and any applicable updates. These can be acquired from Sun (customer) or internally
(IBM). Install kits from internal sources in IBM are not available for external distribution.
•
That you have the necessary access rights to perform the installation. It is recommended that the
user account used to install SJSAS is the same user account used to setup and run IBM Cognos 8.
Root access maybe required, at least temporarily, on some platforms. On Windows, the user
should be a member of the Administrators group.
•
That you have the necessary system resources to perform the installation. There is considerably
more memory, hard disk space and CPU power required to run any full Application Server than to
run Tomcat. The minimum requirements for SJSAS should be compared to available resources.
Running with less than 768MB of RAM for the Maximum Heap Memory is not suggested
(although it may be possible for testing purposes only), 1GB should be considered a minimum to
ensure performance and reliability.
•
500 MB of temporary working disk space must be available in addition to the Application Server
requirements to allow for building and deploying application files.
•
The JDK must meet minimum conformance levels for both SJSAS and IBM Cognos 8. A full
SDK is required, not just a JRE.
•
That you have the customer documentation for both SJSAS and IBM Cognos 8 available as a
resource.
•
That you are familiar with the operating system (O/S) with which you are using. This document
assumes you are familiar with the O/S. This includes user commands at the command line, syntax
and scripting.
•
That you are familiar with IBM Cognos 8. You should already know how to setup and run the
product using Tomcat
IBM Cognos Proprietary Information
Title: Cognos ReportNet & WebSphere Clustering
3
2 SJSAS 9.1 Installation
This section outlines the steps that are necessary to install SJSAS 9.1. The screen captures are
representative of a Windows installation. Ensure you install your JRE prior to commencing the SJSAS
installation.
2.1
SJSAS Installer
Download and launch the SJSAS installer. (Windows - sjsas-9_1-windows.exe)
2.1.1.1
Installer Welcome page
IBM Cognos Proprietary Information
Title: Cognos ReportNet & WebSphere Clustering
2.1.1.2
4
Software License Agreement
Read the License agreement and select the appropriate response. If you decline the agreement, you will not
be able to proceed.
2.1.1.3
Installation Directory
Select a drive and path that has ample space to perform the install.
IBM Cognos Proprietary Information
Title: Cognos ReportNet & WebSphere Clustering
5
If the install location does not exist, you may create it or make an alternate selection.
2.1.1.4
Java 2 SDK Location
Enter the location of the compatible Java 2 SDK (must be pre-installed)
IBM Cognos Proprietary Information
Title: Cognos ReportNet & WebSphere Clustering
2.1.1.5
6
Administration Configuration Information
Enter or alter the information to match your setup requirements. Make note of the port values as these will
be critical in performing other steps later on.
2.1.1.6
Installation Options
Select / unselect the options that you wish to perform as part of the installation. Adding the SJSAS bin
directory to the path environment variable automatically may simplify your installation.
IBM Cognos Proprietary Information
Title: Cognos ReportNet & WebSphere Clustering
2.1.1.7
7
Ready to Install
Use the “Back” button to alter any settings prior to performing the installation. This is the last step before
the installation actually takes place.
2.1.1.8
Installation in Progress
Wait while the installer performs the selected tasks.
IBM Cognos Proprietary Information
Title: Cognos ReportNet & WebSphere Clustering
2.1.1.9
8
Installation Complete
Once the installer has completed the selected tasks, verify that there were no errors on the summary page.
You may start eh Application Server using the button provided or wait until other tasks have been
completed.
2.1.2 Change Master Password
Run the Application Server Administration command “asadmin.bat” located in the <SJSAS_install>/bin
directory to change the master password if necessary. Once you have started the asadmin process, issue the
“change-master-password” command.
IBM Cognos Proprietary Information
Title: Cognos ReportNet & WebSphere Clustering
9
2.1.3 Start the Application Server
The “startserv” and “stopserv” commands can be used to start and stop the Application Server. These
commands can be found in the <SJSAS_install>/domains/<domain_name>/bin directory.
2.2
SJSAS Administration Console
Once the Application Server has started, you can access the Admin Console using the port indicated during
the install (default: 4848) as in the example below. Login using the name and password created during the
installation.
IBM Cognos Proprietary Information
Title: Cognos ReportNet & WebSphere Clustering 10
3 Configuring for IBM Cognos 8
This section outlines the changes that are necessary in order to run IBM Cognos 8
3.1
JVM Options
Set / Change the parameters passed to the JRE using the Admin Console. Navigate to Application Server ->
JVM Settings -> JVM Options.
3.1.1 XML Parser
Add an option to set the XML Parser to the parser provided with IBM Cognos 8. Save the change.
-Djavax.xml.parsers.DocumentBuilderFactory=org.apache.xerces.jaxp.DocumentBuilderFactoryImpl
3.1.2 Java Max Heap Size
Set the Maximum Java Heap Size using the –Xmx parameter. A starting value of 768M is shown in the
example above.
IBM Cognos Proprietary Information
Title: Cognos ReportNet & WebSphere Clustering 11
3.2
Copy the XML Parser
Copy xercesImpl.jar from your IBM Cognos 8 install <C8_install>\webapps\p2pd\WEBINF\lib\xercesImpl.jar to the SJSAS install under the domain you will be using
<SJSAS_install>\domains\domain1\lib\ext
3.3
Environment Varaibles
Set any environment variables that are necessary for your environment. There are multiple ways to
accomplish this and it is left to the user to determine which is the most appropriate for your individual
scenario.
Note: The path environment variable is reset in the <SJSAS>\domains\domain1\bin\sstartserv.bat startup
script. You should modify it to include the IBM Cognos 8 bin directory and any other variables that you
need (database drivers for example).
Depending on the number of changes and where you have set your environment variables you may want to
consider using:
Set PATH=%PATH%; AS_INSTALL%\lib;%AS_INSTALL%\bin
@echo off
rem
rem Copyright 1997-2007 Sun Microsystems, Inc. All rights reserved.
rem Use is subject to license terms.
rem
PORTIONS REMOVED TO SAVE SPACE
rem only needed for instances and node-agents
rem set D05=-Dcom.sun.aas.launcherReturn=
if "%CLI%"=="cli" set D06=-Dcaller=cli
rem --------------------------------------------------------------------------rem ------------------ Start -----------------------------------------------rem ---------------------------------------------------------------------------
Rem PATH Modified for Cognos 8
set PATH=%AS_INSTALL%\lib;%AS_INSTALL%\bin;C:\cognos\bin
if not "%NATIVE%"=="native" goto JAVA_LAUNCH
"%AS_INSTALL%/lib/appservLauncher.exe" "%AS_INSTALL%/lib/appservDAS.exe
%DOMAIN_NAME%" "\"%~df0\" %CLI% display %1 %2 %3 %4"
exit
PORTIONS REMOVED TO SAVE SPACE
IBM Cognos Proprietary Information
Title: Cognos ReportNet & WebSphere Clustering 12
4 Deploy the IBM Cognos 8 Application
Web Application Archives (WAR) and Enterprise Application Archive (EAR) files may be built and
deployed to JSAS. For the purposes of this example, an Enterprise Application Archive (EAR) file will be
used.
4.1
Deploy a New Application
Navigate to Applications -> Enterprise Applications and click the “Deploy” option.
4.2
Select the Application File
Browse or enter the path and name of the application file to be deployed. Optionally enter a name for the
application (spaces are not allowed in the name).
IBM Cognos Proprietary Information
Title: Cognos ReportNet & WebSphere Clustering 13
4.3
Verify the Deployment
Once the deployment has completed, verify that there were no errors (indicated by a yellow warning) and
check that the IBM Cognos 8 application now shows under the list of deployed applications.
5 Stop and Restart the Application Server
Stop and restart the Application Server to apply all the changes and load the configuration settings.
IBM Cognos Proprietary Information
Title: Cognos ReportNet & WebSphere Clustering 14
6 Troubleshooting
6.1
Xerces ClassCastException Error
Without copying the xercesImpl.jar file and/or failing to set the JVM parameter with the XML parser will
result in the following error in the pogo log:
2007-12-18 10:45:07.687 ERROR [com.cognos.pogo.bibus.SOAPMessageOutputter] findingActiveCmThread: Exception signing
trusted request: Reason: java.lang.ClassCastException:
com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderFactoryImpl
at com.cognos.accman.jcam.crypto.TrustedRequestSession.setMessageTrust(TrustedRequestSession.java:118)
at com.cognos.pogo.bibus.CryptoFacility.signRequest(CryptoFacility.java:125)
at com.cognos.pogo.bibus.SOAPMessageOutputter$Outputter.signTrustedRequest(SOAPMessageOutputter.java:225)
at com.cognos.pogo.bibus.SOAPMessageOutputter$SimpleOutputter.write(SOAPMessageOutputter.java:273)
at com.cognos.pogo.bibus.SOAPMessageOutputter.write(SOAPMessageOutputter.java:124)
at com.cognos.pogo.bibus.BIBusCommand$SOAPBodyGenerator.writeBody(BIBusCommand.java:177)
at com.cognos.pogo.http.httpclient.RawPostMethod.writeRequestBody(RawPostMethod.java:131)
…..
Resolution: Copy xercesImpl.jar to the appropriate location and set the appropriate Java option to set the
XML parser.
6.2
JCAM_Crypto_JNI UnsatisfiedLinkError
If the PATH environment variable is not set correctly, or is overridden by startserv.bat, then the following
error will be thrown in the SJSAS server.log file:
[#|2008-01-14T16:28:57.960-0500|SEVERE|sunappserver9.1|javax.enterprise.system.container.web|_ThreadID=13;_ThreadName=pool-1thread-4;_RequestID=c6c32c87-e266-4772-860a9558dbc5c130;|WebModule[/p2pd]StandardWrapper.Throwable
java.lang.UnsatisfiedLinkError: no JCAM_Crypto_JNI in java.library.path
at java.lang.ClassLoader.loadLibrary(ClassLoader.java:1682)
at java.lang.Runtime.loadLibrary0(Runtime.java:822)
at java.lang.System.loadLibrary(System.java:993)
at com.cognos.accman.jcam.crypto.jni.JNISystemProperties.<clinit>
(JNISystemProperties.java:13)
at com.cognos.accman.jcam.crypto.SystemProtectionSession.<init>
(SystemProtectionSession.java:39)
at com.cognos.accman.jcam.crypto.misc.Configuration.<init>(Configuration.java:49)
at com.cognos.accman.jcam.crypto.misc.Configuration.getInstanceWithDefaultConfig
(Configuration.java:96)
at com.cognos.accman.jcam.crypto.CAMFactory.initialize(CAMFactory.java:131)
…..
Resolution: Set the PATH environment variable within startserv.bat .
IBM Cognos Proprietary Information
Fly UP