Wdebu7 Workshop Sap Netweaver 7.0 Bi Installation Java Stack
Wdebu7 Workshop Sap Netweaver 7.0 Bi Installation Java Stack
Chapter 05
1
SDN users please note the following
The Access of any material in the SAP community network and SAP
developer network (SDN) is free of charge with your user login.
If you see any occurrence of “SAP Note” or “SAP Hinweis” and you want to
access this Information, you have to logon to the SAP Marketplace (SMP)
Note search which needs an additional login to the SMP. The login to SMP is
depended to a valid customer contract and the S-user credentials.
Example for such a link: https://service.sap.com/sap/support/notes/
You can also add the Note Number directly at the end of the mentioned URL
or go to New Note Search
2
General Deployment of Business Intelligence
3
Installation Sequence of the AS-Java 7.00 Add-In (DS)
NetWeaver 7.0
Selected Java
Operating System Applications:
01
CI ABAP/JAVA (BIx) SLD
BI 7.00 JAVA 7.00 3 SLM
000 - 001 - xxx - 066 000
JAVA NWA
JDBC
ABAP 02 Selected
DBSL SCS Manager 1 usage types:
BI-Java
DI ABAP/JAVA
EP
Schema Schema (core)
ABAP JAVA 2
SAPBIx SAPBIxDB
Prior to EhP1
4
MCOD Scenario with ABAP and JAVA on separate Instance
NetWeaver 7.0x
Selected Java
Operating System Applications:
01 02
CI ABAP (BIx) CI Java (BJx) SLD
BI 7.00 JAVA 7.00 SLM
000 - 001 - xxx - 066 000
JAVA NWA
JDBC
ABAP 03 Selected
DBSL SCS Manager usage types:
BI-Java
DI ABAP DI Java
EP
Schema Schema (core)
ABAP JAVA
SAPBIx SAPBJxDB
Recommended!
From EhP1 default
5
Scenario with ABAP and JAVA and BO Enterprise
NetWeaver 7.0x
Operating System
01 02
CI ABAP (BIx) CI Java (BJx) BO Enterprise
BI 7.00 JAVA 7.00 Java Application
000 - 001 - xxx - 066 000
JAVA
JDBC
ABAP 03
DBSL SCS Manager
DI ABAP DI Java
MaxDB/SAP DB
MaxDB/SAP DB already supports Unicode and non-Unicode residing the same
database.
Both installation options are available
6
Concept Reflected in Installation Tools - SAPInst
Installation Options:
Please Note when you install the Java Add-In in HA clusters or distributed environments
you have to start the sapinst with the option SAPINST_USE_HOSTNAME
If the virtual hostname from the database server differ from the central instance server you
use the following scenario:
Central Services Instance (SCS) ./sapinst SAPINST_USE_HOSTNAME=<ci-server)
Database Instance ./sapinst SAPINST_USE_HOSTNAME=<di-server)
Central Instance ./sapinst SAPINST_USE_HOSTNAME=<ci-server)
To find out all sapinst options: sapinst -p
See also Note 774116 for more details. For Unix environments there are basically 2
installation options for installation of the J2EE Add-In:
1. Install with virtual hostname (recommended) Use SAPINST property
SAPINST_USE_HOSTNAME (available as of NW04SR1). Post-Installation tasks should also
refer to <virtual host>.
2. Install with physical hostname (before setup of HA environment) Please refer to SAP note
757692 for a description on the necessary changes when switching the J2EE Engine from
physical to virtual hostname.
Check also the new created file sapservices located under /usr/sap (Note 823941). Note
that there are different setting for the variable
pf=<DIR_START_PROFILE>/<INSTANCE_START_profile>.
With new installation /usr/sap will be used and after Upgrades /sapmnt will be created.
This can cause different Problems - if your file system is not the rule /sapmnt/<SID>/profile
7
Install Java as separate Instance (Central System Inst.)
8
Define Secure Store Settings (DI Java Add-In)
Additional Notes:
Note 669902 - Setting the national character set to UTF8
Note 838402 - Problems within non-Unicode system landscapes
Note 975768 - Deprecation of Java features with non-Unicode Backend
9
Check the right Version of the Java SDK (19 or higher)
Additional Remarks:
It is helpful not to use a Version Number in the Directory Name of the Java SDK - because
from time to time there is a need to update the Java SDK. If no Versioning is used the JDK
can be replaced very easily without changing various Java configuration files.
(e.g. /opt/javasdk142 or c:\javasdk142)
For the Sun Java JDK refer to the new Homepage
http://www.sun.com/software/javaseforbusiness/getit_download.jsp
Please consult the following Notes to find and Install the right Java SDK for you OS:
Note 716604 for the Sun JDK (Windows - Linux - Solaris)
Note 746666 - OutOfMemory or slowdown due to http response compression
Note 716926 for the HP JDK (HP-UX)
Note 722520 for the Tru64 JDK
Note 716927 for the IBM JDK (AIX)
Note 717376 for the IBM JDK (iSeries - OS/400)
Note 746299 for the IBM JDK (zSeries)
Note 746203 for the IBM JDK (zOS)
Note 810008 for the IBM JDK (Linux on POWER)
Note 861215 for the IBM JDK (AMD64/EM64T-Linux)
10
Locate the JCE (Security) files (CI Java Add-In)
Additional Remarks:
Please Note that for Linux Installations the JCE File must be downloaded from IBM and not
from SUN:
https://www6.software.ibm.com/dl/jcesdk/jcesdk-p
11
Prerequisites Checker - Data File for Check (Note 855498)
12
Check the result of the Prerequisites Checker
13
Check the SAPGLOBALHOST entry in the Default.pfl
14
Check the user for the RFC connection (at least 6 char.)
Note:
Please change all Users created by the Java Add-in Installation from user type “Dialog” to
“Service” to prevent unmeant Password changes. These are affected users:
ADSUSER for the Adobe Document Service
ADS_AGENT
J2EE_ADMIN for the Java Administration
J2EE_GUEST
NWDI_ADM If DI is installed
NWDI_CMSADM
NWDI_DEV
SAPJSF for the Java Communication with Abap
SLDAPIUSER for the SLD Administration/Communication
SLDDSUSER
15
Check the Authorization of the User in the ABAP Stack
Update on the User screen from NetWeaver 7.0 SR3 and above
16
Separate Java Instance – create these users beforehand
The switch to the User Type “service” prevents unwanted password changes.
Please change all Users created by the Java Add-in Installation from user type “Dialog” to
“Service” to prevent unmeant Password changes. These are affected users:
The user SAPJSF is dedicated to synchronize the Users between Abap and Java (UME)
with the Role SAP_BC_JSF_COMMUNICATION_RO.
To assign the “stronger” Role SAP_BC_JSF_COMMUNICATION you should first generate
this Role with Transaction SUPC before you can add them in SU01 to the user SAPJSF.
See Note 748195 and 891162 for more Details.
You must restart the ABAP/JAVA Engine after you change any role assignment.
User Role Profile
ADSUSER PFCG create Role ADSCallers
ADS_AGENT SAP_BC_FP_ICF
J2EE_ADMIN SAP_J2EE_ADMIN S_BW_RFC
SAP_SLD_ADMINISTRATOR S_BI-WX_RFCA
J2EE_GUEST SAP_J2EE_GUEST
SAPJSF SAP_BC_JSF_COMMUNICATION S_BW_RFC
S_BI-WX_RFCA
SLDAPIUSER SAP_SLD_CONFIGURATOR
SLDDSUSER SAP_SLD_ADMINISTRATOR
On Demand:
NWDI_ADM Note 840523
NWDI_CMSADM Note 840523
NWDI_DEV Note 840523
17
New with NW 7.0 SR1: Master Password for all Users
18
Choose your Buildings Blocks (Software Units)
choose the usage type DI if you plan to create your own *SCA files with versioning control
Please Note:
Note 669902 - Setting the national character set to UTF8
Note 968236 - Installing usage type BI Java subsequently/iView not found
Note 883948 - Enabling additional usage types / software units
19
Configure or Register the local/central SLD
20
Register in existing central SLD (default)
21
Specify the SLD user (local SLD configuration) Note 935245
With separate Java Installation use Transaction RZ70 in advance to synchronize with the SLD
Please Note:
Note 909797 - Missing Central Service instance in the SLD
Note 821904 - Separating SCS instances for ABAP and J2EE
If you have additional Problems to update the DDIC user together with the user mapping
like (user persistence failed or similar) you might want to run the Report RSADRCK2 once
to fix the Address mapping of the User DDIC (especially after new Abap Installations).
Note 976913 - The binaries of a WebDynpro application not synchronized
Note 1057720 - Missing configuration for JCO/RFC destinations of the SLD
Note 768452 - Troubleshooting SLDCHECK
22
With EhP1 Specify the Diagnostics Agent Note 1357812
With separate Java Installation use Transaction RZ70 in advance to synchronize with the SLD
Please Note:
Note 909797 - Missing Central Service instance in the SLD
Note 821904 - Separating SCS instances for ABAP and J2EE
If you have additional Problems to update the DDIC user together with the user mapping
like (user persistence failed or similar) you might want to run the Report RSADRCK2 once
to fix the Address mapping of the User DDIC (especially after new Abap Installations).
Note 976913 - The binaries of a WebDynpro application not synchronized
Note 1057720 - Missing configuration for JCO/RFC destinations of the SLD
Note 768452 - Troubleshooting SLDCHECK
23
Revise your Parameters if needed or start the Service
24
Creation of the Java DB (own table space)
25
How to uninstall a Java Add-In or separate Instance
In order to remove a J2EE stack or separate J2EE instance please proceed as follows :
1. Deinstall the J2EE DB tablespace - the schema and the SCS instance (the db schema for
this one SAP SID) with SAPInst.
2. Remove DIR_GLOBAL/security/data
3. Remove DIR_INSTANCE/SDM
4. Remove DIR_INSTANCE/j2ee
5. Revert CI instance profile to their original state (backup copies should exist in the profile
directory)
6. Revert sapservices profile to their original state (backup copies should exist in the
/usr/sap)
7. Remove all created User (see page 16 for details) and Restart ABAP
26
Tipp's and Notes for Patching the Java Instance
27
JSPM - Modify the file sdm_jstartup.properties
/usr/sap/<SID>/JC<nr>/SDM/program/config/sdm_jstartup.properties
How to synchronize the SCAs before patching with JSPM (Note 910073):
Go to the directory <drive>:\usr\sap\<sid>\JC<nr>\SDM\program
StopServer.bat (windows) or .sh (unix)
sdm.bat systemcomponentstate "mode=sync"
sdm.bat systemcomponentstate "mode=activate"
StartServer.bat (windows) or .sh (unix)
28
JSPM - Download the latest Java Patches (Note 1011241)
Note that when you use the option “SAP Support Package
Stacks” you only select the initial SPS - e.g. for Stack 16.
Java also releases Patches for the current stack -
which will not be covered by the collection process.
Download the latest files manually.
Description:
[Thr 34955] **********************************************************************
*** ERROR => The Java VM terminated with a non-zero exit code.
*** Please see SAP Note 943602 - section 'J2EE Engine exit codes'
*** for additional information and trouble shooting.
**********************************************************************
[Thr 34955] SigISetIgnoreAction : SIG_IGN for signal 20
[Thr 34955] JLaunchCloseProgram: good bye (exitcode = -11113)
Solution:
There is a Problem with the Abap UME (or - if available the connection to the LDAP Server)
during the Installation/restart of the J2EE engine. This is caused by some inconsistencies
with the user SAPJSF (User locked due to wrong Password) or one of the Users J2EE_* is
missing or also locked.
Unlock the User or reset the Password of the affected user - mostly SAPJSF
This will also appear - when the Abap License is outdated or the startup of Abap fails
unexpected (user has no authorization - etc.)
Note 943602 - Analysis of errors within the startup of J2EE Engine 7.0
Note 940893 - Analysis of errors within the startup of J2EE Engine 6.40
Note 748195 - Error when you create/change ABAP users in the UME
Note 999112 - J2EE Engine Errorcodes (released Internally)
Role SAP_BC_JSF_COMMUNICATION
Note 891162 - User SAPJSF does not have authorization for SYST
Transaction SUPC to activate Role SAP_BC_JSF_COMMUNICATION
29
JSPM – Java Support Package Manager
D:\usr\sap\N4S\DVEBMGS01\j2ee\JSPM\go.bat
/usr/sap/N4J/JC02/j2ee/JSPM/go
SAP AG 2007 - Install NetWeaver 70 Java / Roland Kramer / 30
30
Patching JSPM (mandatory) and SAP_JAVASL (optional) first
31
JSPM - Choose “Single Support Packages (advanced use)”
Deployed components after Java Stack Update (example from EhP1 Stack 3):
32
JSPM - JSPM always chooses the latest available file
33
JSPM - Validation of support packages (Check Queue)
Note: until SPS11 both the J2EE Engine and the Abap Engine will be restarted during this
process. This is not valid for separate stacks.
34
JSPM - Deploy whole Queue (~ 2h to 3h)
Typical JSMP Log after Java Stack Update (example from any SPS12 to any SPS13):
35
Start page of the Java Instance (HTTP Port 5<nr>00)
36
Check the System Information after the Installation
37
Note 937697 - BI Diagnostics & Support Desk Tool
Please Note that there is also an Abap correction included in this Note which has to
be applied to the connected Abap System.
38
local SLD NetWeaver 7.0 (check for latest content update)
http://server.domain.ext:<port>/sld
39
Apply latest SLD Update (update DB Statistics if Oracle)
40
Check for defined Systems and Landscape in the SLD
41
Log on to the NetWeaver Administrator
http://server.domain.ext:<port>/nwa
To set the required authorizations for the NWA - now choose the CIM Client Generation
Settings tab page - and activate the following entries in the list:
sap.com/tc~lm~webadmin~mainframe~wd/webdynpro/public/lib/
sap.com~tc~lm~webadmin~mainframe~wd.jar
sap.com/tc~lm~webadmin~sld~wd/webdynpro/public/lib/
sap.com~tc~lm~webadmin~sld~wd.jar
Ensure that the SLD connection data is entered on this tab page - and save your entries by
choosing Save.
Note 964988 - BIPostInstallProcess not visible in template installer
Note 1026840 - List of corrections for SP09 - 10 - 11 NW04s CTC Template BI-Java
42
Check all systems (Abap &Java ) are running
43
Check the Patch level of the NetWeaver Portal
http://server.domain.ext:<port>/irj/portal
44
Create new Plans in the Software Lifecycle Manager (SLM)
http://server.domain.ext:<port>/slm
Note:
Please make sure that the following Actions are available in the Role LcrInstanceWriterAll
to make sure that you can call the Application /slm:
45
Start of SDM (Software Deployment Manager) GUI
D:\usr\sap\N4S\DVEBMGS01\SDM\program\RemoteGui.bat
/usr/sap/N4J/JC02/SDM/program/RemoteGui.sh
SAP AG 2007 - Install NetWeaver 70 Java / Roland Kramer / 46
46
SAP J2EE Engine – Config Tool (offline)
D:\usr\sap\N4S\DVEBMGS01\j2ee\configtool\configtool.bat
/usr/sap/N4J/JC02/j2ee/configtool/configtool.sh
47
SAP J2EE Engine – Visual Administrator (online)
D:\usr\sap\N4S\DVEBMGS01\j2ee\admin\go.bat
/usr/sap/N4J/JC02/j2ee/admin/go
48
Standalone Java Log File Viewer
D:\usr\sap\N4S\DVEBMGS01\j2ee\admin\logviewer-standalone\logviewer.bat
/usr/sap/N4J/JC02/j2ee/admin/logviewer-stanalone/go
SAP AG 2007 - Install NetWeaver 70 Java / Roland Kramer / 49
49
Menu Based Java Monitor JCMON
jcmon pf=N4J_JC02_PWDF2142
50
Copyright 2008 SAP AG All rights reserved
No part of this publication may be reproduced or transmitted in any form or for any purpose without the express permission of SAP AG. The information
contained herein may be changed without prior notice.
Some software products marketed by SAP AG and its distributors contain proprietary software components of other software vendors.
SAP, R/3, xApps, xApp, SAP NetWeaver, Duet, SAP Business ByDesign, ByDesign, PartnerEdge and other SAP products and services mentioned herein as
well as their respective logos are trademarks or registered trademarks of SAP AG in Germany and in several other countries all over the world. All other
product and service names mentioned and associated logos displayed are the trademarks of their respective companies. Data contained in this document
serves informational purposes only. National product specifications may vary.
The information in this document is proprietary to SAP. This document is a preliminary version and not subject to your license agreement or any other
agreement with SAP. This document contains only intended strategies, developments, and functionalities of the SAP® product and is not intended to be
binding upon SAP to any particular course of business, product strategy, and/or development. SAP assumes no responsibility for errors or omissions in this
document. SAP does not warrant the accuracy or completeness of the information, text, graphics, links, or other items contained within this material. This
document is provided without a warranty of any kind, either express or implied, including but not limited to the implied warranties of merchantability, fitness
for a particular purpose, or non-infringement.
SAP shall have no liability for damages of any kind including without limitation direct, special, indirect, or consequential damages that may result from the
use of these materials. This limitation shall not apply in cases of intent or gross negligence.
The statutory liability for personal injury and defective products is not affected. SAP has no control over the information that you may access through the use
of hot links contained in these materials and does not endorse your use of third-party Web pages nor provide any warranty whatsoever relating to third-party
Web pages
Weitergabe und Vervielfältigung dieser Publikation oder von Teilen daraus sind, zu welchem Zweck und in welcher Form auch immer, ohne die ausdrückliche
schriftliche Genehmigung durch SAP AG nicht gestattet. In dieser Publikation enthaltene Informationen können ohne vorherige Ankündigung geändert
werden.
Einige von der SAP AG und deren Vertriebspartnern vertriebene Softwareprodukte können Softwarekomponenten umfassen, die Eigentum anderer
Softwarehersteller sind.
SAP, R/3, xApps, xApp, SAP NetWeaver, Duet, SAP Business ByDesign, ByDesign, PartnerEdge und andere in diesem Dokument erwähnte SAP-Produkte und
Services sowie die dazugehörigen Logos sind Marken oder eingetragene Marken der SAP AG in Deutschland und in mehreren anderen Ländern weltweit. Alle
anderen in diesem Dokument erwähnten Namen von Produkten und Services sowie die damit verbundenen Firmenlogos sind Marken der jeweiligen
Unternehmen. Die Angaben im Text sind unverbindlich und dienen lediglich zu Informationszwecken. Produkte können länderspezifische Unterschiede
aufweisen.
Die in diesem Dokument enthaltenen Informationen sind Eigentum von SAP. Dieses Dokument ist eine Vorabversion und unterliegt nicht Ihrer
Lizenzvereinbarung oder einer anderen Vereinbarung mit SAP. Dieses Dokument enthält nur vorgesehene Strategien, Entwicklungen und Funktionen des
SAP®-Produkts und ist für SAP nicht bindend, einen bestimmten Geschäftsweg, eine Produktstrategie bzw. -entwicklung einzuschlagen. SAP übernimmt
keine Verantwortung für Fehler oder Auslassungen in diesen Materialien. SAP garantiert nicht die Richtigkeit oder Vollständigkeit der Informationen, Texte,
Grafiken, Links oder anderer in diesen Materialien enthaltenen Elemente. Diese Publikation wird ohne jegliche Gewähr, weder ausdrücklich noch
stillschweigend, bereitgestellt. Dies gilt u. a., aber nicht ausschließlich, hinsichtlich der Gewährleistung der Marktgängigkeit und der Eignung für einen
bestimmten Zweck sowie für die Gewährleistung der Nichtverletzung geltenden Rechts.
SAP übernimmt keine Haftung für Schäden jeglicher Art, einschließlich und ohne Einschränkung für direkte, spezielle, indirekte oder Folgeschäden im
Zusammenhang mit der Verwendung dieser Unterlagen. Diese Einschränkung gilt nicht bei Vorsatz oder grober Fahrlässigkeit.
Die gesetzliche Haftung bei Personenschäden oder die Produkthaftung bleibt unberührt. Die Informationen, auf die Sie möglicherweise über die in diesem
Material enthaltenen Hotlinks zugreifen, unterliegen nicht dem Einfluss von SAP, und SAP unterstützt nicht die Nutzung von Internetseiten Dritter durch Sie
und gibt keinerlei Gewährleistungen oder Zusagen über Internetseiten Dritter ab.
Alle Rechte vorbehalten.
51