SAP Basis Tech Supports

Symptom
SAP NetWeaver 7.0 SR3 Installation: IBM DB2 for i5/OS
Solution Manager 4.0 SR4
Other terms

install, SAPinst, AS/400, J2EE, iSeries, IGS, Homogeneous system copy, UME, ISERPACK
Reason and Prerequisites

This SAP Note contains some important installation information which is also given in the documentation “SAP NetWeaver 7.0 SR3 : IBM DB2 for i5/OS”. This SAP Note is also valid for Solution Manager 4.0 SR4.
It also contains information that came after the documentation was published.
Solution

This SAP Note is available in English only.
Topics Date changed
====== ============
1 General Information Apr/2008
2 Pre-Installation Mar/2009
3 Installation Sep/2008
4 Post-Installation Jul/2008
5 Troubleshooting Mar/2009
+===================================================================+
1: General Information

+===================================================================+
———————–————————–
ABAP+Java, Java: Inst.guide correction: Default group of users
J2EE_GUEST and Guest
Symptom:
The following statement in “Basic SAP System Parameters” ->
table “User Management Engine (UME)” is wrong:
“Guest users belong to the default group Authenticated Users.”
Solution:
“Guest users areanonymousand belong to theAnonymous Users
group by default.”
——————– < D027171 OCT/29/07 > ———————–
SAPinst GUI: You cannot close message boxes of SAPinst GUI using the
close button (’X').
Solution:
Use the buttons of the message box (’Stop’, ‘Continue’, ‘Retry’,
‘Cancel’). For example, when you chose “File -> Exit” from the SAPinst
menu bar, you can only use either ‘Stop’ or ‘Continue’ to close the
message box.
———————–————————–
Running usage types directly on EPC
As of SAP NetWeaver 2004s SPS11 you can run usage types directly on EPC. For more information, see the Master Guide andSAP Note 982502.
+===================================================================+
2: Pre-Installation

+===================================================================+
—————–————————–
IBM i 6.1 & i5/OS V5R4
SAP system installation on a new System i/IBM i server
A new System i(V5R4)/IBM i(6.1) server has to be prepared before you can start to create a first SAP system.
1. Create the group R3GROUP manually:
CRTUSRPRF USRPRF(R3GROUP) USRCLS(*PGMR) INLMNU(*SIGNOFF) LMTCPB(*YES) TEXT(’SAP USER PROFILE’) SPCAUT(*NONE) SRTSEQ(*HEX) LANGID(ENU) CNTRYID(US) CCSID(500) GID( or *GEN)
Note:If you already have SAP systems on other servers it is recommended to use the same GID for all sapsys groups in the systems landscape. Replace with the GID for group R3GROUP on other IBM i systems or group sapsys on other UNIX systems.
2. Grant object authorities:
GRTOBJAUT OBJ(QSYS/QPMLPFRD) OBJTYPE(*PGM) USER(R3GROUP) AUT(*USE)
GRTOBJAUT OBJ(QSYS/QPMWKCOL) OBJTYPE(*PGM) USER(R3GROUP) AUT(*USE)
GRTOBJAUT OBJ(QSYS/QP0ZIPCS) OBJTYPE(*PGM) USER(R3GROUP) AUT(*USE)
GRTOBJAUT OBJ(QSYS/QPMLPMGT) OBJTYPE(*SRVPGM) USER(R3GROUP) AUT(*USE)
Now there will be no permission problem to create a first SAP system on your new server.
—————–< D019130, 19/SEP/08 + MAR/09 >—————-
Virtual hostname and High Availability (ASCS & SCS)
ABAP+Java,Java, Java Add-In
Symptom:
You intend to install an HA ASCS/SCS instance or an SAP system with virtual hostname using environment variable SAPINST_USE_HOSTNAME on a host (distributed system: several hosts) on which other SAP system(s) already exist(s).
If you do not apply the workaround described under “Solution”, you get various errors during the installation process (for example ‘instance has no properties’ in step ‘unpackJ2EEINSTALL’ if you install the Java Add-In).
Solution:
You have to replace the control.xml file of the Installation Master DVD with the modified control.xml file that is attached to this SAP Note.
Proceed as follows:
1. Copy the Installation Master DVD to a local directory on the installation host(s).
2. Go to tab “Attachments” of this SAP Note and download the attached control.zip file
3. Unpack the control.zip file.
4. Go to the folder /IM_OS400_PPC64/NW04S/WEBAS/IND and replace the existing control.xml file with the new one that you got from control.zip. You can now start the installation as described in the installation guide.
Note: If you did not apply this workaround and you run into this error during the installation, you have to restart the installation with option “New Installation Option” after having complete the modifications described above.
—————–———————–
Before performing the Export Preparation installation service, patch the installation DVD with the control.xml provided as an attachement in ths Note.
—————–————————–
jt400.jar / JTOpen / Toolbox JDBC driver
When you download the Toolbox JDBC driver from the web as described in the InfoAPAR take care you choose the right zip file.
Correct zip file: jtopen_x_y.zip
Wrong zip file: jtopen_x_y_jdbc40.zip
For more information seeSAP Note 1232613.
Note:To check whether you are using the right Toolbox JDBC driver version run following java call in QP2TERM:
java -cp jt400.jar utilities.AboutToolbox
If the JDBC driver version is okay you get following output:
“Supports JDBC version 3.0″
If the JDBC driver version is wrong you get following output:
“Supports JDBC version 4.0″ or
“java.lang.UnsupportedClassVersionError: utilities/AboutToolbox”
—————–————————–
IBM i 6.1
Before starting an SAP installation on V6R1M0 seeSAP Note 1148480.
—————–————————–
Export of a Java Stack (System Copy)
If you want to export your Java Stack while you are performing a System Copy of a Doublestack or a Java Only System make sure that you have at least SP14. LM-Tools must have at least SP14 patch 01.
If the export does not have the right SP stack your Java import on IBM System i (i5/OS) will fail because the script offlineCTC.sh (part of the export) will put the string “init” into the java parameters of the Java EE engine. This will break the start of the Java EE processes.
—————–————————–
You are planning to install an SAP system on IBM System i (i5/OS). As
of SAP NetWeaver 7.0 SR3, an SMD Agent installation is also performed when installing an SAP System containing a Java stack. The regular SAP System installation procedure doesn’t install it. To install the SMD Agent in standalone mode, follow SAP note 1152593. This procedure can be done either before or after the regular SAP system installation is performed.
—————–————————–
If you perform an installation and there is only one Windows DVD drive available on your Windows installation host, you must copy at least
the Installation Master DVD to the local file system on iSeries. However, we recommend that you copy all of the DVDs to your iSeries host as described in Installation documentation section “Preparing the Installation DVDs”.
——————————————–
Convert the profile file DEFAULT.PFL of all old EBCDIC SAP systems
At the beginning of the installation SAPinst checks all existing SAP systems installed on your iSeries. At that time SAPinst tries to read the file DEFAULT.PFL of each system. Files in EBCDIC cannot be read and the SAPinst will end with a read error. To avoid this error convert all DEFAULT.PFL files written in EBCDIC into ASCII. The EBCDIC SAP system will still be able to handle the converted profile DEFAULT.PFL!
——————————————–
Installing additional double byte language locales
The kernel shipped with NetWeaver 2004S, SR1, SR2 and SR3 contains all needed single byte language locales. If you need additional double byte language locales, you have to install the missing locales using additional language DVDs. To determine which language DVD and which language library you have to install, see the IBM internet link: http://publib.boulder.ibm.com/iseries/v5r3/ic2924/index.htm?info/apis/pase_locales.htm
For example for the double byte locales ZH_TW you need the language DVD “Traditional Chinese” to install the language library QSYS2987.
Before you install an additional double byte language library to create additional double byte locales, make sure that PASE is installed and up-to-date.
After you have installed a new double byte language also all locales of this language are created. As a final step check if there are any PTFs to be installed using the INFOAPAR.
+===================================================================+
3: Installation

+===================================================================+
————————————————
Uninstall Diagnostics Agent only: Manually delete the adm user.
Symptom:
You have uninstalled a Diagnostics Agent instance using SAPinst with
installation optionSoftware Life-Cycle Options -> Uninstall ->
Uninstall – Solution Manager Diagnostics Agent
After the uninstall with SAPinst has finished successfully, user adm is still existing.
Solution:
Delete user adm manually.
——————–—————————-
Fixed with NW701
Do not use an existing when installing a new SAP system.
For example, if you have already installed an ABAP system, and want to
install a Java system on the same host, make sure that you enter an that is different from the of the first (ABAP) system.
—————–—————————
Error when using the “Media Browser” screen
You get the following error while selecting an installation DVD on the
“Media Browser” screen:
Caught ESAPinstException in Modulecall: could not call evaluator in
class CCdCheckUserInput.
To solve the problem, restart SAPinst and continue with the old
installation option.

————————————————–
Java Add-In: Installation fails in phase ‘Create Java users’.
Symptom:
Installation fails in phase ‘Create Java users’.
WARNING[E] 2008-03-13 16:29:46.295
CJS-30196 The function module “PRGN_GEN_PROFILES_FOR_ROLES”
cannot be used for ‘remote’ calls.
Solution:
ApplySAP Note 1126481.
———————–————————–
Using “Back” button with “Typical” Mode
Note the following when you process the screen “Parameter Mode > Default
Default Settings”: If you chose the “Typical” setting and press “Back” after processing one or more input screens, the installer now guides you through all screens with default parameters that it has processed in the background so far.
—————–—————————
HA Java: SAPinst hangs during deployment30000009
Symptom: SAPinst hangs during deployment in a HA setup. SDM logs say that SDM is waiting for a control instance of the cluster to start.
Cause:
SDM uses as a SDM host the local host of the system on which it was installed, not the HA virtual host.
SDM requests JStartUp to start the central instance and asks regularly JStartUp if the instance is up and running.
JStartUp returns a list with instances and SDM searches in it for a control instance running on a host the same as SDM host.
But the control instance on HA system is running with the virtual host which is not equal with the SDM host (local host).
Solution:
ApplySAP Note 757692.
——————————————–
SAPCRYPTO.CAR
You do not have to mark the installation option of the security package SAPCRYPTO.CAR. All needed security files are part of the kernel.
But if you are asked to install the SAPCRYPTO.CAR you have to consider the following points:
iSeries uses the SAPCRYPTO.CAR of AIXthe SAPCRYPTO.CAR of AIX embodies different versions. Be sure to select the 64 bit version of AIX 5.1 when you are asked by SAPinst.

+===================================================================+
4: Post-Installation

+===================================================================+
——————-——————————–
ABAP+Java,Java: Keystore views are not created during the very first
start
Symptom:
You get an error like the following in
/usr/sap///j2ee/cluster/server0/log/defaultTrace.0.trc
File parsed: /usr/sap/QO1/JC00/j2ee/cluster/server0/log/defaultTrace.0.t
FOUND “Line 336: fatal” CREATED ON Wed Jul 2 15:09:28 2008 IN /usr/sap/Q
/JC00/j2ee/cluster/server0/log/defaultTrace.0.trc: #1.5#0017A41132BE002E
000002A000032850004510A33DD78DA#1215004168517#com.sap.engine.services.
keystore##com.sap.engine.services.keystore#######Thread[_keystore_manage
_system_thread_,10,SAPEngine_System_Thread[impl:5]_Group]##0#0#Fatal#1#/
System/Security#Java###Source: com.sap.engine.services.security.exceptio
.BaseSecurityException: Unexpected – cannot create a configuration.;
Description: system user based security support for view [TicketKeystore
and user [null] not generated; Consequences: keystore view [TicketKeysto
is not created for user [null]; Countermeasures:see log for details##
FOUND “Line 337: fatal” CREATED ON Wed Jul 2 15:09:28 2008 IN /usr/sap/Q
/JC00/j2ee/cluster/server0/log/defaultTrace.0.trc: #1.5#0017A41132BE002E
000002B000032850004510A33DD79AA#1215004168517#com.sap.engine.services.
keystore##com.sap.engine.services.keystore#######Thread[_keystore_manage
system_thread_,10,SAPEngine_System_Thread[impl:5]_Group]##0#0#Fatal##Jav
(thread: _keystore_managed_system_thread_, view:TicketKeystore , user: n
- create view permissions failed:
Solution:
Proceed as described inSAP Note 1230057.
———————-—————————
ABAP+Java: Individual passwords not assigned to ABAP UME users
Symptom:
You chose “Custom Mode” during the “Define Parameters” phase.
On the screen “SAP System > ABAP UME”, you overwrote the master password
and assigned individual passwords for ABAP UME users (administrator
user, communication user, SDM).
After the installation has finished successfully, you cannot log on with
these users using the individual passwords you assigned before.
Solution:
Log on using the master password and assign the required individual
passwords to the ABAP UME users.
——————-——————————–
BI Java: BEx Web Applications: Access denied
Symptom:
You get a portal runtime error (Access denied) when calling a BEx Web Application (Java).
Solution:
Proceed as described inSAP Note 1155392.
————————————————–
EPC, EP: “HTTP response: 500 – Internal Server Error” when accessing
Forms Builder iView
Symptom:
KM integration of CAF does not work at all.
A null pointer exception is thrown like the following:
class com.sapportals.portal.prt.service.soap.exception.PRTFaultInternalE
java.lang.NullPointerException
Solution:
ApplySAP Note 1143603.
—————-——————————
EP: KM integration of CAF does not work.
There is a null pointer exception like the following:
class com.sapportals.portal.prt.service.soap.exception.PRTFaultInternalE
java.lang.NullPointerException
To solve the problem, applyNote 1143603.

Wrong IGS permissions after installation.
When IGS is installed the wrong permissions are set. This will not hurt your running SAP system but when you try to patch the IGS using JSPM youwill get an error because of wrong permissions.
To set the right permissions to IGS do following steps.
1. Change the permissions of the IGS directory and all included files:
QSH CMD(’chmod -R 775 /usr/sap///igs’)
QSH CMD(’chown -R ADM:GROUP /usr/sap///igs’)
2. Change the permissions of all IGS files in the kernel directory:
QSH CMD(’cd /sapmnt//exe && chown -R R3OWNER:GROUP igsmux_mt igspw_mt igswd_mt bwgis.so gfwchart.so imgconv.so sgxgis.so xmlchart.so zipper.so’)
——————-——————————–
RAISE_EXCEPTION short dumps occur
RAISE_EXCEPTION short dumps occur when the system starts after it was
installed. To solve the problem, apply SAP Note 1120534.
————————————————–
For more information about unexpected hostnames of registered systems
in SLD, seeSAP Note 1020043.
————————————————–
Java VM Parameters
After a Java installation you should check the VM parameters of your
freshly installed SAP system as well as the global system parameters of
your System i host according toSAP Note 717376.
————————————————–
To use the Visual Administrator tool for reconfiguring your system,
seeSAP Note 937418.
——————————————–
Edit the SDM file sdm_jdk.bat in /usr/sap///SDM/ program.
When SDM is installed on iSeries all java path variables are set to
/QIBM/ProdData/Java400/jdk14.
This is wrong for a remote SDM call using a Windows PC.
To solve this edit the file sdm_jdk.bat. Change the following entry:
set sdm_java_home=/QIBM/ProdData/Java400/jdk14
to
set sdm_java_home=%JAVA_HOME%
Also change sdm_heap_size to 512. (set sdm_heap_size=512)

Now you can use for example RemoteGui.bat to start the SDM GUI remotely on your Windows PC to connect to the SDM Server running on iSeries. Make sure that the environment variable JAVA_HOME is set on your Windows PC.
+===================================================================+
5: Troubleshooting

+===================================================================+
———————–—————————
IBM i 6.1 & i5/OS V5R4
While installing an SAP system it does not come up when started for the first time.
Symptom:
When your system doesnot come up have a look into the work directory. There should be a file sapstart.log. In this file you will find following entry:
Cannot execute “/usr/sap//SYS/exe/run/cleanipc 01 remove” – as4_examine failed.
system(/usr/sap//SYS/exe/run/cleanipc 01 remove) failed(-1). 3474 Error 3474 occurred.
3474 means CPE3474 and points to missing permissions for some system objects.
Solution:
Grant missing object authorities:
GRTOBJAUT OBJ(QSYS/QPMLPFRD) OBJTYPE(*PGM) USER(R3GROUP) AUT(*USE)
GRTOBJAUT OBJ(QSYS/QPMWKCOL) OBJTYPE(*PGM) USER(R3GROUP) AUT(*USE)
GRTOBJAUT OBJ(QSYS/QP0ZIPCS) OBJTYPE(*PGM) USER(R3GROUP) AUT(*USE)
GRTOBJAUT OBJ(QSYS/QPMLPMGT) OBJTYPE(*SRVPGM) USER(R3GROUP) AUT(*USE)
Now there will be no permission problem anymore to start the new SAP system on your new server.
———————–—————————
Export Preparation fails in phase 2, step runR3ldctl with error:
MUT-03025 Caught ESAPinstException in Modulecall: You call the
function getValue for contextparameter doSplit, but there exist no
contextparameter with that name.
To solve this problem, replace the control.xml file in the installation DVD with the one attached to this Note. Start a new export preparation.

———————–—————————
ABAP,ABAP+Java: FJS-00003 TypeError: dir_instance.get is not a function
You get an error message like the following:
ERROR:
FJS-00003 TypeError: dir_instance.get is not a function (in script
NW_ABAP_Prepare ind ind ind ind, line 13937: ???) occurs during an
installation
Solution:
1. Stop SAPinst2. Change the following line in control.xml in the respective
sapinst_instdir directory:
var maybeName = fmgt.getFSPath(dir_instance.get()). …
into
var maybeName = fmgt.getFSPath(dir_instance.value()). …3. Restart SAPinst and continue your old installation

————————————————–
IBM i 6.1
SAPinst breaks in the step createPorts
When SAPinst breaks in the step “createPorts” check the file tmkliblog_nnnn in the installation directory. Following error message should be found:
…
[12:23:36] UERZS001:59976 Sending request EXECUTE (command: “ADDSRVTBLESERVICE(’sapmsC01′) PORT(3600) PROTOCOL(’tcp’) ALIAS()”)
[12:23:36] UERZS001:59976 TMKSVR returned 0 (return code: -1)
…
To solve the problem apply thePTF MF45089. An IPL is needed afterwards. For more details seeSAP Note 1148480.
————————————————–
IBM i 6.1
Java Development Infrastructure (DI)
Installation fails in the phase “Install software units”
When you install on IBM i 6.1 the usage type Java Development Infrastructure (DI) the installation will fail in the phase “Install software units”.
You will find in the SDM log an SQL error -356 when using the statement
CREATE TABLE “CBS_NODE” …
To solve this issue see theSAP note 1138824.
Afterwards you can continue your old installation.
————————————————–
Retry button and restart of TMKSVR
When an installation fails and the logs do not clearly indicate the error, it is always a good idea to press the Retry button to check if the error still exists.
If the installation fails a second time at the same point after pressing the Retry button, it is sometimes helpful to restart the TMKSVR. As the TMKSVR is a bridge between the iSeries and Windows it may happen that an unexpected event will put the TMKSVR into an unstable state.
Always stop the SAPinst before you restart the TMKSVR.
You can restart the TMKSVR in one of the following ways:
1. Enter ADDLIBLE TMKSVR00 (or any other number you are currently
using) and use ENDTMKSVR / STRTMKSVR to end and start the TMKSVR.
2. Just stop the process SAPINST in the subsystem TMKSVR00 (or any
other number) using option 4. The required SAPINST process will be
restarted automatically by SAPinst as long as the process DISPATCH is running.
3. Reinstall the TMKSVR using the command SETUP.EXE from the Installation Master DVD.
Now you can start the SAPinst again to continue your old installation.
——————————————–
SAPinst fails during SLD content import
In the java.log in the installation directory, you find an error message java.net.SocketTimeoutException: Read timed out or the import itself takes longer than 1,5 hours with little progress found in java.log (Import Status: LOADING xxx of 95791).
Solution: Shutdown the central instance, start j2ee\configtool\offlinecfgeditor.bat and decrease the -Xms value for the server instance from -Xms1024m to -Xms512m
Restart the central instance. In the SAPinst error dialog, press Retry.
——————————————–
SAPinst reports error during ABAP database import, but the TMKSVRnn subsystem still contains r3load jobs
The logfiles in the installation directory show no error.
Solution: Wait, until the TMKSVRnn subsystem contains only the DISPATCH and SAPINST jobs. That is, the R3LOAD jobs have finished.
Check for errors in the log files of the load. If there are no errors, press Retry or restart SAPinst.
——————————————–
Java call has return code 0, but SAPinst reports error
In the sapinst_dev.log, you find an entry similar to this:
INFO
CJSlibModule::writeInfo_impl()
Execution of the command “\QIBM\ProdData\Java400\jdk14\bin\java -classpath /usr/sap/SAPinst/NW04S/SYSTEM/DB4/CENTRAL/AS/install/sharedlib/launcher.jar -Xmx256m ” … finished with return code 0.
That is, this Java call finished successfully. Despite that, you find another entry similar to this:
ERROR
CJSlibModule::writeError_impl()
CJS-30059 J2EE Engine configuration error.
directly behind the first INFO statement. SAPinst fails and the installation stops.
Solution: With the configtool, switch off the JDBC tracing you had switched on before. Do this by removing the part “trace=true;errors=full” from the database URL.
——————————————–
ZDAEXIT error during Java database import
In case the installation fails in step IMPORT_JAVA_DUMP with the following error message in file jload.log:
com.sap.inst.jload.Jload logStackTrace SEVERE: java.sql.SQLException: [PWS9801] Function rejected by user exit program ZDAEXIT in R3SYS.
Please press Retry in SAPinst.