Configuring SAP for Use With an Independent ASP

Configuring SAP for Use with an Independent ASP

- 1 - Revised 05 October 2009

Contents

1 Introduction ...................................................................................................... - 2 -1.1 General Information .................................................................................... - 2 -1.2 Updating Existing Independent ASP Systems.............................................. - 2 -1.3 Scope .......................................................................................................... - 3 -1.4 Terminology ............................................................................................... - 3 -

2 Restrictions ....................................................................................................... - 4 -3 Prerequisites...................................................................................................... - 4 -

3.1 Software...................................................................................................... - 4 -3.2 Hardware .................................................................................................... - 4 -3.3 Operating System Configuration ................................................................. - 4 -

4 Preparation ....................................................................................................... - 5 -4.1 SAP System ................................................................................................ - 5 -4.2 Primary Host ............................................................................................... - 5 -4.3 Secondary Host ........................................................................................... - 6 -

5 Setup .................................................................................................................. - 7 -5.1 Primary Host ............................................................................................... - 7 -5.2 Secondary Host ........................................................................................... - 8 -

6 SAP System Configuration ............................................................................. - 10 -6.1 Profiles (ABAP Stack and Java Stack) ...................................................... - 10 -6.2 Transport (A, AJ) ...................................................................................... - 13 -6.3 System and Instance Configuration Files (6.40 Only) ................................ - 13 -6.4 Secure Store (J, AJ) ................................................................................... - 14 -6.5 Instance Properties (J, AJ) ......................................................................... - 15 -

7 Test and Verification ...................................................................................... - 16 -8 Post-processing ............................................................................................... - 17 -9 Installing Three-tier Application Servers ...................................................... - 17 -

9.1 IBM i ........................................................................................................ - 17 -9.2 Windows ................................................................................................... - 17 -9.3 Linux ........................................................................................................ - 17 -

10 Other Considerations .................................................................................. - 18 -10.1 Upgrading an SAP System ........................................................................ - 18 -

11 Toolset Overview......................................................................................... - 18 -12 Troubleshooting .......................................................................................... - 19 -



1 Introduction

1.1 General InformationConfiguring an SAP system (ABAP, Java or dual-stack) to run on a switchable independent auxiliarystorage pool (iASP) allows an SAP system to be switched from a primary host to a secondary hostwith minimal effort. The host system running the SAP system should be transparent to the end userand require no adjustments by the end user. The switchable iASP configuration also allows thecustomer to take advantage of other high availability solutions such as geographic mirroring or cross-site mirroring.

The SAP iASP configuration includes moving the SAP database libraries, IFS directories and files,and SAP kernel library (6.40 kernel or later only up to 7.10) to the iASP. The libraries R3400,R3WRK, R3400, R3SYS, and, for 7.10 or later, the kernellibrary, remain on the system ASP. Toenable switching from one host to another host, you must configure the SAP system to run on a virtualhost, which is a static IP address and a host name that can be switched between the primary andsecondary hosts.

1.2 Updating Existing Independent ASP SystemsAs of 1 September 2005, the iASP configuration for SAP systems was enhanced. We recommend thatfor iASP systems configured prior to 1 September 2005, that you modify the configuration to matchthe enhanced configuration.

The enhanced iASP configuration includes, but is not limited to, the following:o One configuration for both two-tier and three-tier systemso A virtual host is utilized for all iASP configurationso All IFS directories and files reside on the iASPo 6.40 to 7.02: The kernel library resides on the iASPo 7.02 and later: Since the introduction of sapcpe the kernel library resides in SYSBAS

again

To update an existing iASP system, you follow the same procedure as described below for configuringa new iASP system.

As of September 2008, the location of the dbs/db4/rdbname parameter was moved from theinstance profile to the DEFAULT profile.

NoteDo not use the old toolset to reconfigure the iASP system. A new toolset has been developed toreconfigure existing iASP systems and configure new iASP systems.



1.3 ScopeThis document describes the steps required to successfully configure an SAP system to run using aniASP. This includes moving data to the iASP and configuring the SAP system to be switched from aprimary to a secondary host. Switching an SAP system requires that an SAP system uses a virtualhost/IP address.

The instructions in this document also pertain to updating an existing SAP iASP system to the latestconfiguration.

This document does not discuss details of configuring iASPs, clustering, or virtual host/IP addresses atthe operating system level nor does it discuss configuring specific SAP transactions.

1.4 TerminologyUser-specified values are indicated with this syntax: . The following user-specifiedvalues are used throughout this document:

o SAP system IDo SAP instance numbero primary iASP nameo secondary iASP nameo kernel library nameo Java data library name (SAPDB)o ABAP data library name (R3DATA)o Java journal library name (SAPJRN)o ABAP journal library name (R3JRN)o Java library name on iASPo host nameo virtual host name

You can install SAP systems for the following variants:? ABAP only systems (AS ABAP) only contain the ABAP engine, but no

Java EE engine.? Java only (AS Java) systems only contain the Java EE engine, but no ABAP engine.? ABAP+Java (dual-stack, AS ABAP and AS Java) contain both the ABAP and the Java EE

engine.

Depending on your system variant, you have to execute different steps of this documentation. ForABAP only systems, only execute steps marked with A, for Java only systems, only execute stepsmarked with J, for dual-stack systems, only execute steps marked with AJ.

Operating System NamesAs of operating system version IBM i 5.4, the operating system has been renamed from IBM i5/OSto IBM i (short form: i). The names of previous operating system versions remain unchanged,they are still referred to as IBM i5/OS V5R3and IBM OS/400 V5R2. In this document, the newnameIBM i is used if we do not refer to a specific operating system version. If we refer to a specificversion, we use the relevant operating system name.



Database NamesAs of operating system version IBM i 5.4, the database has been renamed from IBM DB2 for i5/OSto IBM DB2 for i .In previous SAP documents, IBM DB2 for i was referred to as IBMDB2 for i5/OS, IBM DB2 Universal Database for iSeries, IBM DB2 Universal Database forAS/400 or DB2/400.

2 Restrictions? Operating system releases prior to V5R2 do not have full iASP support? The Native JDBC driver is not supported for any Java iASP solutions. Instead, you must use

the Toolbox JDBC driver.? Moving the kernel library to the iASP is not supported for 4.6D or earlier? Opticonnect is not supported for any iASP solutions

3 Prerequisites

3.1 Software? OS/400 V5R2 or later? OS/400 5722SS1 Option 41, High Availability Switchable Resources? SAP release 4.6D or SAP release 6.40 or later? Valid SAP licenses for both primary and secondary hosts

3.2 Hardware? Consult high availability or hardware service representative

3.3 Operating System Configuration? Switchable iASP? Operating system clustering (required for switching iASP)? Virtual host/IP address



4 Preparation

4.1 SAP System? The operating system must include the latest PTF levels as specified by the Information

APAR.? The SAP kernel must include the latest patch levels and the components listed below need to

have at least the following patch levels:4.6D 6.40 NW04s

o APYJ2EELIB n/a 1 (J, AJ) n/ao APYR3KRN n/a 5 n/ao APYSAP n/a n/ao CMDMAINI n/a 1o IASPTOOLS OSS note 1o LIB_DBSL 2085 81o R3INLPGM 2 2 7o TP 1854 85o SAPSTART 10

? Test and verify the SAP system to determine the overall health of the system. For moreinformation, see the section Test and Verification. If possible, correct any existing problems.

? Make a full backup of your SAP system.? Download the latest set of the iASP tools for yor SAP version from the SAP Service

Marketplace. Do not use the file attached to this note, as it is intended for use with 4.6 systemsonly.

4.2 Primary HostYou can perform the following steps while the SAP system is still running:? Sign on to the host system with a user profile with *ALLOBJ authority, preferably QSECOFR.? Make sure the iASP is available using the following command:

WRKCFGSTS CFGTYPE(*DEV) CFGD(*ASP)? Check that a relational database entry (RDB) has been created for the iASP using the following

command:WRKRDBDIRE

? If necessary, add an RDB entry using the following command:ADDRDBDIRE RDB() RMTLOCNAME(*LOOPBACK)

? Make sure that the iASP device name in the device description equals the resource name andthe remote database name using the following command:DSPDEVD DEVD().

? You need space in *SYSBAS for savefiles of your data libraries.If you do not have enough capacity in ASP 1, or if the size of your data library exceeds 1terabyte, choose option *TAP for the STG parameter when running CFGSAPIASP.In this case, you have to move your data libraries into your independent ASP using save andrestore manually when CFGSAPIASP tells you to do so, for example using a tape device.Make sure that the libraries are still owned by their respective owners afterwards,



OWNER for R3DATA and SAPDB for SAPDB and the old journallibraries R3JRN and/or SAPJRN are deleted from *SYSBAS, so the tools areable to set up journaling in the independent ASP.

? Make sure there are no cross library relationships (for example logical files) that prevent thedata libraries from being deleted before they are restored into the independent ASP.

? During the database transfer phase the inquiry message CPA7025 may be sent, causing allprocessing to stop until the message is answered. To have the system automatically reply tothis message add CPA7025 to the System Reply List using the following commands:

o WRKRPYLE (to find an available sequence number)o ADDRPYLE SEQNBR() MSGID(CPA7025) RPY(I)o CHGJOBD JOBD(QGPL/) INQMSGRPY(*SYSRPYL)

4.3 Secondary HostYou can perform the following steps while the SAP system is still running:? Check that a relational database entry (RDB) has been created for the iASP. Normally, this is

done automatically by the iASP configuration using the following command:WRKRDBDIRE

? If necessary, add an RDB entry using the following command:ADDRDBDIRE RDB() RMTLOCNAME(*LOOPBACK)

? Copy the kernel library to the system ASP on the secondary host The name of the library mustnot conflict with any library on the iASP.If necessary, rename the library.

o 6.40 kernel or later up to 7.10: The library will not be used by a running SAP systemand you delete it after the setup is complete.



5 Setup

5.1 Primary Host? End all instances of the SAP system? Make sure all SAPSTRSRV jobs for this SID have ended using command WRKUSRJOB ADM? If you are using XDN make sure all XDNLSN jobs for this SID have ended using

WRKJOB JOB(XDNLSN)? Sign on to the host system with a user profile with *ALLOBJ authority, preferably QSECOFR? Make sure the iASP is available using the following command:

WRKCFGSTS CFGTYPE(*DEV) CFGD(*ASP)? Make sure the virtual host/IP address is configured and active using NETSTAT option 1? Make sure no locks are held on the database by using the command:

o A, AJ: WRKOBJLCK OBJ() OBJTYPE(*LIB)o AJ, J: WRKOBJLCK OBJ() OBJTYPE(*LIB)

? Add the kernel library to the library list using the following command:ADDLIBLE LIB()

? Move the database, IFS directories and files to the iASP and modify job descriptions, userprofiles, and data areas to utilize the iASP. In case of a dual-stack installation, you need todecide if a single journal for both database libraries should be configured. For moreinformation about configurating a single journal as a default journal for several data libraries,see SAP Note 744055. To move the database, use the following command:CFGSAPIASP STG() SID() IASPP() IASPS()VHOST() TRANS()SEP()Please note that there are special parameters available for CFGSAPIASP, see Chapter 11 fordetails.

? Configure default, startup and instance profiles. For more information, see the section SystemConfiguration.

? J, AJ Configure connection and instance properties. For more information, see the sectionSystem Configuration.

? NW04 :J, AJ Check JDBC driver symbolic links found at /usr/sap//SYS/jdbc/tbx.Remove this link and copy jt400.jar to this location.

? Start the SAP system on the virtual host.? Test and verify the SAP system. For more information, see the section Test and Verification.? End the SAP system, but do not switch the iASP to the secondary host.



5.2 Secondary HostYou can perform the following steps while the SAP system is still running:? Sign on to the host system with a user profile with *ALLOBJ authority, preferably QSECOFR.? Add the previously copied kernel library to the library list.? To minimize iASP vary-on time, the UIDs and GIDs for matching user profiles on the primary

and secondary hosts must be synchronized. To do this, you can use the System i Navigator andyour clustering software. You will find the necessary tools for sending users from the primaryto the secondary host under management central/system groups//. Open Users and Groups and copy OWNER,SAPDB, ADM and OFR to your secondary host. You can also create anadministrative domain in your cluster that synchronizes users, passwords and other objects inthe cluster for you.

? For 7.10 or later, log on to the primary host as ADM and look for the environmentvariable CLASSICUSERCONCEPT using the command WRKENVVAR. Now set or add thisvariable on the secondary host to this value before the next step. Please also note that thecommand CRTR3INST that will be used in the next step now has an additional parametercalled Type of Executables. Set is to *UNICODE or *ASCII when running CRTR3INST, donot use *DEFAULT.

? Create a new SAP system with the same SID as the original system using the followingcommands:

6.40:o A: CRTR3SYS SID() KRNLIB() JRNRCVASP(1)

SYSTYPE(*NOJAVA)o AJ: CRTR3SYS SID() KRNLIB() JRNRCVASP(1)

SYSTYPE(*DEFAULT) SCSINST()o J: CRTR3SYS SID() KRNLIB() JRNRCVASP(1)

SYSTYPE(*JAVAONLY) SCSINST()o J: CRTSAPUSR USER(*J2EEDB) SID()

NW04s:o CRTR3SYS SID()

? Create new SAP instances with the same instance numbers as the original system using thefollowing commands:

o A, AJ, J: CRTR3INST SID() INST()ROLE(*CENTRAL)(CODEPAGE(*ASCII/*UNICODE))

o J, AJ: CRTR3INST SID() INST() ROLE(*SCS)o J: CRTSAPUSR USER(*J2EEDB) SID()

? After creating the new SAP system on the secondary host, the SAP user profile passwords onthe primary and secondary hosts may not be identical. You must change the passwords on thesecondary host to match the passwords on the primary host. This is especially important for theSAP Java user profile SAPDB.

? If /sapmnt/ has been renamed before, delete the /sapmnt/trans directory createdby CRTSAPSYS and reset the former renamed link to the old value.



? J, AJ: Delete the SAP Java library. This is created as part of creating a new SAPinstance (additional application server instance or primary application server instance only)using the following command:DLTLIB LIB()

? Create IFS symbolic links, modify job descriptions, user profiles, and data areas using thefollowing command:CFGSAP2HO SID() IASPP() VHOST()

? Switch the independent ASP to the secondary host.? Make sure the iASP is available using the following command:

WRKCFGSTS CFGTYPE(*DEV) CFGD(*ASP)? Make sure the virtual host/IP address is configured and started using CFGTCP option 1.? Add the kernel library to the library list using the following command:

ADDLIBLE LIB()? 6.40 kernel or later up til 7.10 only: Apply the kernel that resides in the iASP to your SAP

systemo 6.40: RMVR3KRN SID()o NW04s: RMVSAP SID()o SETASPGRP ASPGRP()o 6.40: APYR3KRN SID() KRNLIB()o NW04s: APYSAP SID() KRNLIB()o FIXR3OWNS LIB()

? 6.40 only. J, AJ: Apply the Java library that resides in iASP to your SAP instances(additional application server instance and primary application server instance only)

o SETASPGRP ASPGRP()o RMVJ2EELIB SID() INST()o APYJ2EELIB SID() INST( LIB()

? 7.10 or later only: copy the libraries R3400, the menu library SAPM#NN andthe kernelibrary SAP71 to the secondary host, add SAP71 to your library list andrun FIXSAPOWN afterwards. Note that the kernellibrary will reside in *SYSBAS. Make surethat the userprofile ADM has has R3400/R3INLPGM as Initial program and*LIBL/SAPMAIN as Initial menu.

? Start the SAP system on the virtual host.? Test and verify the SAP system. For more information, see the section Test and Verification.



6 SAP System Configuration

6.1 ProfilesThe necessary modifications to the profiles consist of adding new profile parameters, replacing anyoccurrence of the host name with the virtual host name, and renaming start and instance profiles.The changes will be done by IASPPRFCFG when running CFGSAPIASP. For a manual setup, thesettings are listed as follows:

6.1.1 NW04 (6.40)

ABAP stack (A), dual-stack (AJ) and Java only (J)

Default Profile? In file /sapmnt//profile/DEFAULT.PFL replace the host name with the virtual

host name in the following profile parameters:o SAPDBHOSTo rdisp/mshosto rdisp/enqnameo rdisp/btcnameo rdisp/sna_gatewayo AJ, J: j2ee/dbhosto

? Modify or add the following profile parameter:dbs/db4/rdbname =

Instance Profile? You must replace the name of the instance profile using the virtual host name. For example,

you must rename _DVEBMGS_ to _DVEBMGS_. To do so,use the following commands:

o CD DIR('/usr/sap//SYS/profile')o A, AJ: REN OBJ(_DVEBMGS_)

NEWOBJ(_DVEBMGS_)o AJ: REN OBJ(_SCS_)

NEWOBJ(_SCS_)o J : REN OBJ(_JC_) NEWOBJ(_JC_)

? Modify or add the following profile parameters:o SAPLOCALHOST = o dbs/db4/opticonnect = 0o AJ, J : enque/serverhost =

Sapservices /usr/sap/sapservices



? If you are using sapservices, you must change all entries for your inthis file to the virtual host name.

Start Profile? You must rename the start profiles using the virtual host name. For example, you must rename

START_DVEBMGS_ to START_DVEBMGS_. To do so, use the followingcommands:

o CD DIR('/usr/sap//SYS/profile')o A, AJ: REN OBJ(START_DVEBMGS_)

NEWOBJ(START_DVEBMGS_)o AJ: REN OBJ(START_SCS_) NEWOBJ(START_SCS_)o J: REN OBJ(START_JC_) NEWOBJ(START_JC_)

? You must create a symbolic link for each real host name. The symbolic link(s) should pointto the renamed start profile. To do so, use the following commands:

o CD DIR('/usr/sap//SYS/profile')o A, AJ: ADDLNK OBJ(START_DVEBMGS_)

NEWLNK(START_DVEBMGS_)o AJ: ADDLNK OBJ(START_SCS_)

NEWLNK(START_SCS_)o J : ADDLNK OBJ(START_JC_)

NEWLNK(START_JC_)

? You must replace each occurrence of a host name in the profile with the name of the virtualhost name.

6.1.2 NW04s (7.0)


host name in the following profile parameters:o SAPDBHOSTo SAPGLOBALHOSTo rdisp/mshosto j2ee/dbhost


Instance Profile? You must rename the instance profiles using the virtual host name. For example, you must

rename _DVEBMGS_ and _SCS_ to_DVEBMGS_ and _SCS_. To do so, use the followingcommands:

o CD DIR('/usr/sap//SYS/profile')o REN OBJ(_DVEBMGS_)

NEWOBJ(_DVEBMGS_)



o REN OBJ(_SCS_) NEWOBJ(_SCS_)

? Modify or add the following profile parameter:SAPLOCALHOST =

Start Profile? You must rename the start profiles using the virtual host name. For example, you must rename

START_DVEBMGS_ to START_DVEBMGS_. To do so, use the followingcommands:

o CD DIR('/usr/sap//SYS/profile')o REN OBJ(START_DVEBMGS_)

NEWOBJ(START_DVEBMGS_)o REN OBJ(START_SCS_)

NEWOBJ(START_SCS_)

? You must replace each occurrence of a host name in the profiles with the name of the virtualhost name.

Sapservices /usr/sap/sapservices? You must change all entries for your in this file to the virtual host

name.

6.1.3 NetWeaver 7.1


host name in the following profile parameters:o SAPDBHOSTo SAPGLOBALHOSTo rdisp/mshosto j2ee/dbhost


Instance Profile? You must rename the instance profiles using the virtual host name. For example, you should

rename _DVEBMGS_ and _SCS_ to_DVEBMGS_ and _SCS_. To do so, use the followingcommands:

o CD DIR('/usr/sap//SYS/profile')



o REN OBJ(_DVEBMGS_)NEWOBJ(_DVEBMGS_)

o REN OBJ(_SCS_) NEWOBJ(_SCS_)

? Modify or add the following profile parameter:SAPLOCALHOST =


Sapservices /usr/sap/sapservices? You must change all entries for your in this file to the virtual host

name.

6.2 Transport (A, AJ, J in case of NW04s or later)If the SAP system configured for iASP is the domain controller, then all transport directories and filesreside on the iASP. The necessary modifications to the transport configuration files consist ofreplacing any occurrence of the host name with the virtual host name and renaming the instanceconfiguration files.

Depending on your system landscape, the /usr/sap/ link on other host systems mayneed to be changed to reference the trans directory on the iASP.? Using the command WRKLNK to ensure that the /usr/sap/ directory is a

symbolic link referencing the trans directory that was moved to the iASP.o Add a link for the virtual host in the QFileSvr.400 file system using the command

MKDIR DIR('/QFileSvr.400/').For more information about how to makethis link persistent across an IPL, see the section Post-processing

? Remove the old /usr/sap/ link and create a new link referencing the iASP transdirectory using the following commands:

o RMVLNK OBJLNK('/usr/sap/')o ADDLNK OBJ('/QFileSvr.400///sapmnt/')

NEWLNK('/usr/sap/')

6.3 System and Instance Configuration Files (6.40 only)? You must rename the profiles using the virtual host name. For example _.CFG,

you must rename _.CFG. To do so, use the following commands:o CD DIR('/usr/sap//config/')o A, AJ: REN OBJ(_.CFG)

NEWOBJ(_.CFG)o J: REN OBJ(_.cfg)

NEWOBJ(_.cfg)

? Modify the following profile parameters in the _.CFG profile(s):o INSTANCE_HOST =



? Modify the following profile parameters in the SYSTEM.CFG profile:o A,AJ: SAPDBHOST = o A,AJ: SAPMSHOST = o AJ,J: SAPJDBHOST = o AJ,J : SAPSCSHOST =


6.4 Secure Store (J, AJ)The necessary modifications to the secure store can be done by the ConfigTool. For changing theconfiguration on IBM i, use configtool.bat from a Windows host and configtool.sh from a UNIX host.These scripts are located in /usr/sap///j2ee/configtool/. Inaddition, you must use the Toolbox JDBC driver. For more information about configuration, see SAPNote 657117. The necessary modifications consist of replacing any occurrence of the host name withthe virtual host name.? Replace the host name with the virtual host name in the following parameters:

o admin/host/o jdbc/pool//urlo jdbc/pool/_REMOTE/url

? Add the parameter database name= to the following keys:o jdbc/pool//Urlo jdbc/pool/_REMOTE/Url



6.5 Instance Properties (J, AJ)You must do the necessary modifications to the instance properties using the OfflineConfigTool. Donot use other editors for changing the property files because your changes will be rolled back duringsystem startup. For changing the configuration on IBM i, use offlinecfgeditor.bat from aWindows host or offlinecfgeditor.sh from a UNIX host. These scripts are located at/usr/sap///j2ee/configtool/. The necessary modificationsconsist of replacing any occurrence of the host name with the virtual host name. You need to modifythe following instance properties:

6.40 and 7.0? cluster_data/Propertysheet instance.properties

instance.ms.hostinstance.box.numberNW04s: instance.en.host

? cluster_data/dispatcher/cfg/kernel/Propertysheet ClusterManagerms.host

? cluster_data/dispatcher/cfg/kernel/Propertysheet LockingManagerenqu.hostenq.profile.filename

? cluster_data/server/cfg/kernel/Propertysheet ClusterManagerms.host

? cluster_data/server/cfg/kernel/Propertysheet LockingManagerenqu.hostenq.profile.filename

? cluster_data/server/cfg/services/Propertysheet com.sap.security.core.ume.serviceume.r3.connection.master.ashost

7.1:? Configurations/cluster_config/systems//Propertysheet instance_profile/

ENQ_SRV.HOSTFULL_INSTANCE_NAMEINSTANCE_HOSTMSGSRV_HOST



7 Test and VerificationThis section does not attempt to provide a comprehensive list of all tests that can be used to determinethe overall health of a running SAP system, but rather provides a list of transactions that may indicatea problem with the iASP configuration. Certain transactions, especially those that may have adependency on a host name, you may need to reconfigure before testing.

A, AJ? The following transactions have a dependency on a host name and you may have to

reconfigure before testing:o Transport management system, including the regeneration of TP profiles (STMS)o Spool administration (SPAD)o RFC connections (SM59)

? Test the following transactions:o Initial consistency check (SICK, SM28)o TemSe consistency (SP12)o Transport management system (STMS)o RFC destinations (SM59)o Spool administration (SPAD)o System log (SM21)o Database consistency (DB02)o Server check (SM51)o Background processing (SM65)

J, AJ? Test the following from the Java browser interface:

o Verify that the System Information page is accessible on http://:500/o Test Java examples on the Java EE Engine Example page

? Verify that the Visual Admin Console can connect to the Java system? Verify that the Java config tool can connect to the Java system

o Verify that the secure store is accessible



8 Post-processing? Delete temporary library SAPTMP on system ASP? Delete directory /usr/sap/_bak on primary and secondary host? Delete directory /sapmnt/_bak on primary and secondary host? 6.40 kernel or later only: Delete any kernel libraries from the system ASP that are not being

used? Remove the system reply list entry that you added previously using the following command:

RMVRPYLE SEQNBR()? The iASP configuration creates a link to the virtual host in the QFileSvr.400 file system.

Unfortunately, links in the QFileSvr.400 file system are not persistent across an IPL. Werecommend that you modify the system startup program to automatically create this link aftereach IPL. To do so, add the following command to the system startup program for both theprimary host, secondary host, and any other host requiring a link to the iASP:MKDIR DIR('/QFileSvr.400/')

9 Installing Three-tier Application Servers

9.1 IBM i? Install the application server the usual way using SAPinst.? Add dbs/db4/rdbname = to the instance profile? Start the application server.? Test and verify the application server

9.2 Windows? Install the application server the usual way using SAPinst.? Add dbs/db4/rdbname = to the instance profile.? Add dbs_db4_rdbname = as a Windows environment variable for the instance? Start the application server? Test and verify the application server

9.3 Linux? Mount the file system at //sapmnt? Add dbs/db4/rdbname = to the instance profile? Add SAPLOCALHOST = to the instance profile? Start the application server? Test and verify the application server



10 Other Considerations

10.1 Upgrading an SAP SystemBefore beginning an upgrade of an SAP system configured to use an iASP, we recommend that youchange the configuration to use a real host name instead of a virtual host name For more information,see SAP Note 574310. All data should remain on the iASP. We recommend the following stepsbefore beginning an upgrade:? Reconfigure the system to use the real host name instead of the virtual host name. For more

information, see the section SAP System Configuration.? Reconfigure other objects that use the host name using the following command:

IASPOBJCFG SID() VHOST() PIASP()? 6.40 kernel or later only: Apply a kernel that does not reside in an iASP. This may require

copying the kernel library from the iASP.? J, AJ: Apply a Java library that does not reside in an iASP. This may require copying the Java

library from the iASP.? Proceed as described in the upgrade documentation.

11 Toolset Content OverviewSince the CFGSAPIASP toolset was created to move an existing SAP system to the iASP, it will nothandle other situations, for example moving existing SAP systems to a new host.For such a situation, you can do the steps manually instead of using the toolset commands or run thesubcommands standalone without using CFGSAPIASP.

The toolset mainly consists of the following four parts that are required to do the necessaryconfiguration steps:IASPDBSAVE, IASPIFSCRT, IASPPRFCFG, IASPDBCRT and, when using 6.40, IASPOBJCFG,all called in this sequence by CFGSAPIASP.

? IASPDBSAVE saves the data library(ies) and the kernel library to savefiles creating a librarySAPTEMP in *SYSBAS when choosing storage option *ASP. When using the *TAPoption for the STG parameter in CFGSAPIASP you will be prompted for doing thesave/restore of the data library(ies) manually.

? IASPIFSCRT creates a directory structure in the iASP as described in SAP Note 1309481, Itcopies the IFS content from *SYSBAS to the iASP and reconfigures the links for iASP usage.The old /usr/sap/ and /sapmnt/ directories gets renamed to_bak. If you do an iASP prepare, for example when moving to a new host, create theroot directory structure by running CRTR3SYS and CRTR3INST as described in the section Secondary Host (except running CFGSAP2HO), and run IASPIFSCRT afterwards. Youmust copy the original IFS system objects manually from the source to the target host.



? IASPPRFCFG does all necessary iASP changes to your profiles and the/usr/sap/sapservices (not 6.40) file. Note that the changes for Java will have to bedone manually using /usr/sap//DVEBMGS/configtool.

? IASPDBCRT restores the data library(ies) from the previously created savefiles to the iASP(*ASP option only), restores the kernel library to the iASP under a new name (Kernellocation*IASP only), creates (a) journal libraries(y) (R3JRN and/or SAPDB) withjournal receivers. Then FIXR3OWNS is run on the kernel library setting permissions andauthorities . Then, the kernel is applied to the system using APYR3KRN, APYSAP orAPYSIDKRN, depending on the SAP release you are using. Finally AS4FIXFILE is called forstart of database journaling.

? IASPOBJCFG is used for 6.40 only to change *DTAARAs R3400/R3_NN

Other commands not called automatically by CFGSAPIASP:

? CFGSAP2HO is used for the preparation of the secondary host. Sets up the links/samnt/, /usr/sap/ and /sapmnt/trans to the and providesa /usr/sap/sapservices entry for the new on the secondary host (not for 6.40).

Special Parameters:

? *NONE.This keeps CFGSAPIASP from using QFileSvr.400 and set /sapmnt/ directly to//sapmnt/. We do not recommend that you use this setting if you want touse application servers for this system later.

? *NONE.This setting can be used if you do not want CFGSAPIASP to modify your transportconfiguration. Note: In this case you have to configure the transport manually.

12 TroubleshootingCPF9801 message received followed by a SAP4020 messageEnsure that the profile parameter dbs/db4/rdbname is correctly set in the default profile. Thevalue for this parameter should be the name as for the primary iASP.

CPFB752 message receivedMake sure that the relational database (RDB) entry matches the value set in the dbs/db4/rdbnameprofile parameter in the instance profile. To check RDB entries , use the command WRKRDBDIRE .

CPE3429 message receivedEnsure that the switchable IP address is active and that the directory exists in the/QFileSvr.400 directory.



Two-tier systems connects over TCP/IP and not locallyMake sure that the value for the profile parameters SAPLOCALHOST and SAPDBHOST are both set to. For more information, see SAP Note 856855.

Documents

Configuring SAP for Use With an Independent ASP