Upgrading to 4.

6C Support Release 2: UNIX

Release 4.6C SR2

SAP AG • Neurottstr. 16 • D-69190 Walldorf 51 013 879

®

Upgrading to 4.6C Support Release 2: UNIX

SAP AG

Copyright
©Copyright 2001 SAP AG. All rights reserved. No part of this brochure 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. Microsoft®, WINDOWS®, NT®, EXCEL®, Word® and SQL Server® are registered trademarks of Microsoft Corporation. IBM®, DB2®, OS/2®, DB2/6000®, Parallel Sysplex®, MVS/ESA®, RS/6000®, AIX®, S/390®, AS/400®, OS/390®, and OS/400® are registered trademarks of IBM Corporation. ORACLE® is a registered trademark of ORACLE Corporation, California, USA. INFORMIX®-OnLine for SAP and Informix® Dynamic Server Informix Software Incorporated. are registered trademarks of

UNIX®, X/Open®, OSF/1®, and Motif® are registered trademarks of The Open Group. HTML, DHTML, XML, XHTML are trademarks or registered trademarks of W3C®, World Wide Web Consortium, Laboratory for Computer Science NE43-358, Massachusetts Institute of Technology, 545 Technology Square, Cambridge, MA 02139. JAVA® is a registered trademark of Sun Microssystems, Inc. , 901 San Antonio Road, Palo Alto, CA 94303 USA. JAVASCRIPT® is a registered trademark of Sun Microsystems, Inc., used under license for technology invented and implemented by Netscape. ADABAS® is a registered trademark of Software AG. SAP, SAP Logo, mySAP.com, mySAP.com Marketplace, mySAP.com Workplace, mySAP.com Business Scenarios, mySAP.com Application Hosting, WebFlow, R/2, R/3, RIVA, ABAP, SAP Business Workflow, SAP EarlyWatch, SAP ArchiveLink, BAPI, SAPPHIRE, Management Cockpit, SEM, SAP DB are trademarks or registered trademarks of SAP AG in Germany and in several other countries all over the world. All other products mentioned are trademarks or registered trademarks of their respective companies.

Documentation in the SAP Service Marketplace
You can find this documentation at the following address: http://service.sap.com/instguides

2

April 2001

SAP AG

Upgrading to 4.6C Support Release 2: UNIX

Typographic Conventions
Type Style Interface Text Represents Words or characters that appear on the screen. This includes system messages, field names, screen titles, pushbuttons, menu names, and menu options. Cross-references to other documentation Exact user entry. These are words and characters that you enter exactly as they appear in the documentation. File names, batch files, paths or directories, and screen messages Variable user entry. Pointed brackets indicate that you replace these words and characters with appropriate entries. Names of elements in the SAP System. These include report names, program names, transaction codes, table names, and ABAP language elements. Keys on your keyboard. These include function keys (for example, F2) and the ENTER key.

Document Title User Entry File Name <Variable User Entry> NAME

KEY

Icons
Icon Meaning Caution Example Note Recommendation Syntax Tip

April 2001

3

Upgrading to 4.6C Support Release 2: UNIX

SAP AG

Contents Upgrading to 4.6C Support Release 2: UNIX ................................. 8
New Features ......................................................................................... 9 Naming Conventions........................................................................... 12 Checklist for the Upgrade................................................................... 13 Planning the Upgrade ......................................................................... 18
Planning the Upgrade Strategy...............................................................................................20 When to Restart Production Operation...................................................................................25 Runtime for the Import of the Substitution Set........................................................................26 Database-Specific Aspects .....................................................................................................27 Incremental Table Conversion................................................................................................30 Drawing Up an Upgrade Schedule .........................................................................................32 Examples of Upgrade Scheduling........................................................................................34 Upgrading in an SAP System Group ......................................................................................36 Planning the Modification Adjustment.....................................................................................37 Time Frame for Upgrading the Frontend Software.................................................................39 Notes for the Upgrade.............................................................................................................40 Checking Structural Requirements .........................................................................................44 Checking Hardware Requirements.........................................................................................45 Checking Software Requirements ..........................................................................................47 Checking the SAP Source Release .....................................................................................47 Meeting the Requirements for the Upgrade Assistant .........................................................48 Meeting the Operating System-Specific Requirements .......................................................49 Accessing Documentation Before and During the Upgrade ...................................................50 Meeting the Requirements for the SAP Internet Solution.......................................................51 Importing Additional Languages .............................................................................................52 Upgrading the Operating System and Database System: Overview......................................53

Upgrade Preparations ......................................................................... 57
Determining the Host for the Upgrade Preparation ................................................................59 Creating the Upgrade Directory ..............................................................................................60 Checking Database-Specific Prerequisites for PREPARE .....................................................62 Substituting the SAP Kernel (Source Release 3.x) ................................................................63 Checking SAP Programs (Source Release 4.x) .....................................................................64 Starting PREPARE from the CD.............................................................................................66 Starting the Upgrade Assistant Server ...................................................................................67 Starting the Upgrade Assistant GUI........................................................................................68 Starting the Upgrade Assistant ...............................................................................................69 Restarting PREPARE from the Upgrade Assistant GUI .........................................................72 Resetting PREPARE...............................................................................................................73 Importing Software After Starting PREPARE .........................................................................74 Making Entries for the Parameter Input Module .....................................................................75 Making Entries for the Initialization Module ............................................................................80

4

April 2001

.......125 Phase EU_IMPORT4.........................................................................................................................................................................................129 Phase RUN_RDDIT006 ................................................................................................................................................................................................105 The Upgrade.....................................................................................................................................0x/3......................................................................................................................103 Printing the Default Values for Document Type and Posting Key (FI Customers) ..................................................................................134 Continuing the Upgrade After Phase PRODCHK_<rel>...........................................................135 April 2001 5 .......................................................................................................................................................................................................119 Phase REPACHK1 ..................................................................................................................................................133 Phase ACT_<rel> ....................................................................................108 Restarting the Upgrade.......................................................................................................................................................................1x Only) ....101 Processing Batch Input Sessions (Source Releases 3..............................................126 Phase EU_IMPORT5........................116 Phase KEY_CHK .................................................................................................................................................................120 Phase JOB_RSVBCHCK3........116 Phase INITSUBST ................109 Phase INITPUT....................................6C Support Release 2: UNIX Making Entries for the Read CD Module ...................................................122 Phase FREECHK_X ...................................................................................127 Phase CNV_CHK_XT ........................... 106 Starting the Upgrade........119 Phase VIEWCHK1 ......................102 Converting the Translation Proposal Pool (Source Releases 3...................................................................131 Phase VIEWCHK2 ................................................102 Backing Up Wage Types in HR (T512W) (HR Customers) ...................100 Setting the Operation Mode for the Upgrade ...........................................115 Phases INTCHK and INTCHK_SW .................132 Phase ENVCHK...........................................................................................................1x)...............................................................................................................................124 Phase EU_IMPORT0...................................117 Phase CONFCHK_X.......................................................................................................82 Evaluating the Results of PREPARE...............................................95 Making Preparations at the SAP System Level ....................................131 Phase MODPROF_TRANS .....................................................................................................................................................................................................................................................107 Stopping the Upgrade ...............................................................................................104 Processing Direct Input Error Data (Source Releases 3..................................0x/3................126 Phase REPACHK2 ...........................................................................128 Phase TRBATCHK_XT.............................................121 Phase SPACECHK_ALL........................................................................................................0x/3...................................................130 Phase ADJUSTCHK ..........................................................1x) .......................................................................................................87 Making Preparations at the Operating System Level ..........................................114 Phase PATCH_CHK ................................................123 Phase LOCKEU_PRE..................................................................................98 Checking the User for the Upgrade .....................................................................................................111 Phase DBCHK ........................................113 Phase BATCHCHK .................112 Phase RFCCHK...................................................SAP AG Upgrading to 4.......................................................................................................................................................................................................................................................................................................................................120 Phase JOB_RSVBCHCK2..........................................................................................................99 Checking Requirements for the Modification Adjustment ................94 Making Preparations at the Database Level...........................................................................

.......................................................175 Correcting Errors in the ADOIM Phase.....................171 Analyzing the ELG Log Files .....................................149 Renaming the Local System Log (For Source Releases 3..................................................................156 Reimporting Additional Programs ......................................177 Cleaning Up Terminated Conversions in the DB Conversion Phases ...................................136 Post-Upgrade Activities ....................................................................156 Migrating Matchcodes to Search Help Objects (Source Releases 3....................................................................................0x/3..0x/3.......................147 Distributing SAP Programs ........................................166 Processing Table Clusters After the Upgrade (Source Release 3.........................................................................................167 Installing More Dialog Instances .............Upgrading to 4...........................145 Informix: Preparations ....................155 Adjusting Repository Objects .....192 6 April 2001 ................139 SAP DB: Backing Up the Database ......................159 Informix: Performing an Update Statistics...............................................184 Correcting Entries from the INITPUT and INITSUBST Phases..........186 Resetting the Upgrade ....................................................168 Evaluating the Upgrade Runtime ...........................160 Oracle: Actions ........................................................................................................1x) .............................................163 Actions for the SAP Online Documentation ...................................................................................153 Rescheduling Background Jobs...185 Preparing the Restart of the Upgrade After a System Failure ...................................................................................................................................................................................................................................................................................179 Correcting Lost Field Problems in the PCON Phase............................................... 137 Actions Before Starting Production Operation .......................................................1x Only).............................................................................173 Correcting Errors in the ACT Phase ..........................................................154 Rescheduling Jobs with Transaction DB13 (Source Releases 3...................................................................................................................................................187 Scroll Mode: Restart .........................................................................................150 Checking the Profile Parameters with Transaction RZ10 ....................................169 Troubleshooting ..................................6C Support Release 2: UNIX SAP AG Phase CHK_POSTUP .....157 Performing Post-Upgrade Activities for the Language Transport ........................................................................................................sh ................................163 Converting Batch Input Logs .1x).................................................................................................................................................................................................................................................................. 170 Upgrade Logs .................138 Executing the Script saproot......................................................................0x/3...................................................................................................................176 Correcting Errors in the XPRAS Phase .....................................................................................................................141 DB2 Universal Database .......................................................................................................158 SAP DB: Updating Optimizer Statistics.........................................................................164 Performing Post-Upgrade Activities in the Authorizations Area...................................................................................................................................................................................................................................................................0x/3...................................................................146 Oracle: Preparations .....................................................................1x)...............142 DB2 for OS/390: Preparations ...........................................160 Generating ABAP Loads .......................................... 152 Importing Support Packages After the Upgrade ....................................183 Correcting Errors in the Job Phases...164 Performing Post-Upgrade Activities for the Application ......182 Correcting Conversion Problems in the PCON Phase ................................................................................................................................................................191 Correcting Problems when Processing ABAP Steps.......................................................................153 Transport Management System: Distributing the Configuration ..........................................159 DB2 for OS/390: Actions ...151 Actions During Production Operation .......................................

........................................208 Reducing Upgrade Runtime in Modified Systems ...................243 Understanding the Upgrade Monitor Display ......................................SAP AG Upgrading to 4..........................................................................................................................239 Using the Upgrade Assistant.........................................................................225 Upgrade Assistant.... 211 PREPARE ............................................242 Starting the Upgrade Monitor ................................................................................................. 198 Alert Function............................................................................................................................244 April 2001 7 .............201 Isolating the Central Instance ............................................................................................207 Releasing and Confirming Open Repairs and Requests..................................................................200 Executing PREPARE and R3up in Scroll Mode ...........................................194 Correcting Administrator Profile Problems on Application Servers ..............................................................................199 Determining Versions.........................................................................................................................205 Deleting Archived Upgrade Logs ............................................................................................................................................................................210 Upgrade Tools ....................................................................................................................206 Using a Different Upgrade Directory..............................................................196 Upgrade Administration ..............................................................241 Upgrade Monitor ............................................................................................................212 PREPARE Phase List ...........................................................................195 Providing SAP Local Support with Information ...........................................................................................214 R3up.........................................................................224 R3up Phase List .............................................................................................................................193 Correcting Problems when Copying SAP Programs ......6C Support Release 2: UNIX Correcting Problems when Starting the SAP System.............................................................................................................................202 Changing the Database Recovery Mode..............................................................................................................

preparing. the Notes that are specific to this upgrade [Page 40]. database. the SAP Implementation Guide (IMG). Constraints This documentation only applies if you are upgrading your SAP System on UNIX. Read these sections for an overview of the actions required before. and any other documentation referred to in this documentation.6C Support Release 2: UNIX SAP AG Upgrading to 4. In addition to this documentation.Upgrading to 4. during and after the upgrade: • • • • Planning the Upgrade [Page 18] Upgrade Preparations [Page 57] The Upgrade [Page 106] Post-Upgrade Activities [Page 137] The next three sections of this documentation give you additional information on troubleshooting.6C Support Release 2: UNIX Purpose This documentation describes the upgrade and provides you with additional information on upgrade topics. and SAP Basis knowledge. The following four sections explain the procedure for the upgrade. performing and following up the upgrade. 8 April 2001 . the administration tasks you need to perform before and after the upgrade. The information in this documentation is intended for SAP system administrators with operating system. such as the Release Notes for the applications that you implement. this documentation also includes a checklist for the upgrade [Page 13] with all the necessary actions for planning. you require some other information. and the tools that you use to upgrade the system: • • • Troubleshooting [Page 170] Upgrade Administration [Page 198] Upgrade Tools [Page 211] As well as detailed descriptions of all the procedures.

The objects are sorted by their dependencies and split into different levels. • Using a Package Key to include Basis Support Packages To include the Basis Support Packages in the upgrade. This means that you must only include Basis Support Packages that have been released and listed in the above SAP Note.6C Support Release 2: UNIX New Features New Features in 4. Instead you can search for them and include them directly from the BIND_PATCH phase. but can be made unstable by any changes to the ABAP Dictionary that are delivered with the Basis Support Packages. New Features in 4. As of target release 4.6C productively without restrictions. the Support Packages are imported directly into the Shadow Repository in the SHADOW_IMPORT phase. The dependencies among the Dictionary objects do not allow multiple activation programs to be started as background jobs in parallel.6C Support Release 1: • • 4. unlike other tools (such as the conversion program). The exact procedure is described in the section Making Entries for the CD Read Module. you must include Support Package 1 in the upgrade for each of the components SAP_BC.6C Support Release 1 already includes Support Packages 1 through 6 of the components SAP_BASIS. which is in SAP Note 119738. New Features in Release 4. • As of source release 4. SAP_APPL and SAP_HR. SAP_ABA. before downtime begins. SAP_ABA.6C Support Release 2: • Including Support Packages In the phase BIND_PATCH.SAP AG Upgrading to 4. with each of the levels being made parallel with asynchronous RFC.0B: queue calculation when you include Support Packages The sequence in which you import Support Packages is now determined by the queue calculation function in the Support Package Manager (SPAM). This ensures that Add-On Patches (AOPs) and Conflict Resolution Transports (CRTs) are imported consistently. This is done during the BIND_PATCH phase of PREPARE. you now enter all Support Package types on one wizard screen.6C • Including Support Package 1 To be able to use GA Release 4. You can now also reduce the number of Support Packages that you want to include without having to reset PREPARE. • Mass activation of Dictionary objects The mass activation of Dictionary objects is performed in parallel. April 2001 9 . too. you need a Package Key. SAP_APPL and SAP_HR.6B. New procedure for including Support Packages in the upgrade You no longer have to use the report RSSPDASS to confirm the Support Packages. The number of parallel processes is controlled by the work process resources and the estimated capacity needed to activate the objects in one level. These levels are then activated in sequence. This procedure reduces the downtime during the upgrade.

6B • Shadow import To minimize the longer downtimes caused by including transport requests. This Java GUI is not yet available in Release 4. the transport requests for Support Packages. The upgrade tools provide this resource automatically if at least three background processes are permitted for the upgrade. which is loaded into the SAP System during the EU_IMPORT phase. The import (Dictionary and main import) is not made into the original Repository (source release). Instead. • No UNIX frontend available for 4. shadow imports are used as of Release 4. 32-Bit Windows is the only supported frontend platform. and the modification adjustment are now imported into the SAP System during production operation.6A The development of the UNIX frontend was frozen in Release 4. PREPARE determines the tables that would benefit from being converted incrementally and prompts you to start the transaction ICNV. This shadow import is performed in the SHADOW_IMPORT upgrade phase. New Features in Release 4. R3up informs you if not enough data has been converted incrementally. a cross-platform Java implementation is being developed that will also cover UNIX platforms. Industry Solutions. R3up checks the progress of transaction ICNV. For more information.6A • New Upgrade Monitor The Upgrade Monitor lets you follow the progress of the upgrade.Upgrading to 4.6A. see Planning the Upgrade → Incremental Table Conversion.6C Support Release 2: UNIX SAP AG The minimum number of dialog processes needed to start the mass activation in parallel is six. This technology will also be used in other cases to minimize upgrade downtime as much as possible. New technology implemented in R3trans allows you to use the shadow import and include the transport requests during production operation. For the A_switch and A_on strategies.6B when upgrading the SAP System.5B. and helps you recognize processes that are hanging. 10 April 2001 . • Integration of the incremental table conversion function (transaction ICNV) Transaction ICNV is now integrated in the upgrade. This makes sure that the conversion during downtime is as short as possible. For more information. • Language transport The technical basis of the language transport has been changed completely. For more information on transaction ICNV. New Features in Release 4. see the SAP Library under Help → SAP Library → Basis Components → Change and Transport System → Language Transport. see SAP Note 26417. Languages are now imported with the transport programs R3trans and tp as part of the table import phases. This makes the separate language import phases obsolete. Instead it occurs in the shadow repository (new Repository of the target release). In the CD Read module. For information on the language transport. see The Upgrade → Monitoring the Upgrade → Upgrade Monitor.

• Transaction SGEN for generating ABAP loads Transaction SGEN replaces the report RDDGENLD. The JOB_BTCTRNS1 phase schedules the background jobs. you had to manually schedule the jobs again. The Job Monitor (transaction SM37) gives the automatically descheduled jobs a special status.6C Support Release 2: UNIX • As of Source Release 4. you had to manually deschedule background jobs during the upgrade (when you isolated the central instance). The upgrade program now performs this task for you if your source release is 4.5B or higher. It offers you many more options for selecting the amount of objects that need to be generated and for controlling the background job that generates the objects. the JOB_BTCTRNS2 phase deschedules them. After the upgrade. For a detailed description of transaction SGEN. April 2001 11 . see the online documentation in the transaction by choosing Info.SAP AG Upgrading to 4.5B: Automatic scheduling and descheduling of background jobs Previously.

and Legal Change Patches are called R/3 HR Support Packages. SAP is also used as a synonym for R/3 in terms such as SAP start profile or SAP System language. DB2 for OS/390 is used to describe the database DB2 Universal Database for OS/390. If <sapsid> is used. in certain cases. you must write in uppercase letters. If <SAPSID> is used. such as Basis Support Packages or AddOn Support Packages. Hot Packages are now called R/3 Support Packages.6.6C Support Release 2: UNIX SAP AG Naming Conventions Release 4.6C Support Release 2 In this documentation. Windows. SAP DB is an enhanced and extended database offered by SAP since 1997 that is based on ADABAS database technology. There are other types of Support Packages.6C SR2. DB2 Universal Database for UNIX & Windows was known as DB2 common server (DB2/CS) or DB2 Universal Database for UNIX.6C Support Release 2. the SAP ID DB6 is used as well. SAP uses the term Support Packages instead of SAP patches. for example prd. DB6.Upgrading to 4. DB2 Universal Database for UNIX & Windows and DB2 common server In this documentation and in the upgrade dialogs. Existing customers on SAP DB/ADABAS receive SAP DB as a part of their maintenance contract. 12 April 2001 . for example PRD. The abbreviation 4. the term Release 4.6C and 4. This documentation only uses the name SAP DB. DB2 Universal Database (or the abbreviation DB2 UDB) is used to describe the database DB2 Universal Database for UNIX & Windows. your SAP system ID must be in lowercase letters. SAP-System-ID The SAP System ID is abbreviated as SAPSID or sapsid in this documentation.6C is also used as a synonym for the abbreviation 4. R/3 System and SAP System In this documentation. and in certain cases. SAP DB and ADABAS SAP now offers the database SAP DB.6C is the same as 4. and. Support Packages and Patches As of Release 4. the term SAP System is the same as R/3 System. In older versions of this documentation. DB2. the SAP ID DB2 is used as well. SAP plans to support all SAP Releases on SAP DB that were supported on ADABAS. DB2 for OS/390 and DB2 Universal Database In this documentation and in the upgrade dialogs.

Make sure that DIR_PUT in the instance profile of the central instance has the value <upgrade_directory> Include 20% extra space on the database if you intend to carry out a lot of development April 2001 13 . performing. If necessary. Prepare the empty upgrade directory with <sapsid>adm as the owner. If necessary. upgrade the operating system and database system Preparations for PREPARE Preparing for PREPARE Activity Choose the correct host for PREPARE and the Upgrade Assistant. since it does not include all the information relevant to the upgrade. Upgrade Assistant.6C Support Release 2: UNIX Checklist for the Upgrade Definition This checklist includes all activities necessary for planning.SAP AG Upgrading to 4. plan the modification adjustment Before you start the upgrade decide which database-specific actions you need to take and include them in your upgrade schedule Checking Structural Requirements Checking Hardware Requirements Check software requirements (SAP source release. preparing. It is not intended to replace the documentation Upgrade to 4. Planning the Upgrade Meeting the Requirements Activity You can upgrade the frontend software as soon as you receive the upgrade package Request current upgrade notes Define the upgrade strategy in connection with the operating system upgrade and the database upgrade Draw up the upgrade schedule If necessary. and following up the upgrade. operating system) Meet the requirements for installing the online documentation according to the guide Installing the SAP Library. meet the requirements for the SAP Internet Transaction Server and the SAP@Web Studio according to the installation guide SAP@Web Installation Guide.6C. make preparations for importing additional languages If necessary.

Make database-specific preparations for PREPARE For source releases 3. If you want to import languages other than English and German.0x/3.0x/3.1x. process batch input sessions For source releases 3. back up the SAP start and stop scripts.1x.0x.6C Support Release 2: UNIX SAP AG work. start transaction ICNV Checks Not Supported by PREPARE Preparing the Upgrade Activity Analyze the results of PREPARE Make a backup copy of the old SAP Kernel If changes are made to the standard SAP System.1x. such as including Support Packages. Also do this if you want to include Support Packages and add-ons. check the version of each SAP program Start PREPARE from the CD SAP Kernel User Actions During PREPARE Activity Make entries for the Parameter Input module.0x/3. material master (industry): process the direct input error data If necessary. 3.1x in translation systems. such as entering CD mount directories Making Entries for the Initialization Module Make entries for the Read CD module.x. upgrade frontend software 14 April 2001 . check version of SAP Kernel For source release 4. Make database-specific preparations Check the users and authorizations needed for the upgrade Make sure that the requirements for modification adjustment have been met Set the operation mode for the upgrade For source releases 3. convert proposal pool For HR customers only: save table T512W (Wage Types in HR) For FI customers only: print out the default values for document type and posting key For source releases 3.Upgrading to 4. Make operating system-specific preparations: Make sure that you can recover the database to the state it had before the upgrade. provide an extra 300 MB of memory for each language in the database.

determine P errors.6C Support Release 2: UNIX The Upgrade Activities Activity Check the general upgrade note and the database-specific upgrade notes for new entries or changes Select the correct host for the upgrade Start R3up Phase INITPUT: enter system-specific parameters Phase KEY_CHK: enter keyword from the current Upgrade Note If necessary. check converted percentage rate Phase REPACHK2: For A_switch and A_on. and change database recovery mode. change the database recovery mode if necessary Phase ENVCHK: if necessary. start secondary application server April 2001 15 . isolate central instance. specify the runtime of the import of the substitution set Phase LOCKEU_PRE: For A_switch and A_on. determine P errors. isolate central instance. and back up upgrade directory For A_switch. stop application server. confirm the transfer request if necessary Phase VIEWCHK2: delete customer tables if necessary Phase MODPROF_TRANS: For A_switch and A_on. stop application server.SAP AG Upgrading to 4. last chance to lock the ABAP Workbench Phase ADJUSTCHK: If there are modifications. lock the ABAP Workbench if necessary Phase EU_IMPORT0: For A_off. change database recovery mode. change database recovery mode. if necessary For ICNV. enter keyword for industry solution Phase INITSUBST: Determine when to restart production operation For A_switch and A_on. start secondary application server For A_switch and A_off. back up database. repeat changes to the environment Phase KX_SWITCH: as of this phase you can only log on with the new frontend software Phase ACT_<Rel>: For modifications. adjust any modified SAP objects with the SAP standard Phase PRODCHK_<Rel>: Choose a new time for restarting production operation or: For A_on.

reset to default value Actions After Starting Production Operation Activity Import any Support Packages that you need If you want to install additional languages. import them before you import the Support Packages as described in the guide Language Transport Perform post-upgrade activities for the Transport Management System (TMS) Reschedule background jobs whose released status was reset when isolating the central instance For source releases 3. post-upgrade activities: If necessary.0x/3.1x.sh Perform database-specific actions If there is no central software storage point.1x.1x: if remote application servers exist. distribute SAP programs For source releases 3. reschedule jobs with transaction DB13 If necessary. re-install additional programs such as RFC-SDK or CPIC-SDK from the CD Presentation For source releases 3. migrate matchcodes in search help objects. adjust Repository objects with transaction SPAU If necessary.0x/3.0x/3. install the SAP Internet Transaction Server and SAP@Web Studio according to the upgrade guide SAP@Web Installation Perform post-upgrade activities in the authorization area Perform application-specific. rename local system logs Check profile parameters using transaction RZ10 and if necessary.Upgrading to 4. if necessary Performing Post-Upgrade Activities for the Language Transport Perform database-specific actions Generate ABAP loads with transaction SGEN Converting Batch Input Logs Install the online documentation according to the installation guide Installing the SAP Library If necessary. perform upgrade and delta Customizing For HR customers: reload table T512W (Wage Types in HR) 16 April 2001 .6C Support Release 2: UNIX SAP AG Post-Upgrade Activities Activities Before Starting Production Operation Activity Execute the script saproot.

R/3 Frontend connection April 2001 17 . install more dialog instances Evaluating the Upgrade Runtime Activity Analyze the runtime of the upgrade using report RSUPGSUM / Send list to SAP with SAPNet .6C Support Release 2: UNIX Actions Before the Next Upgrade Activity For source releases 3.SAP AG Upgrading to 4.1x only: perform post-processing for table clusters EDIDOC and CDCLS If necessary.0x/3.

TeamSAP offers the free upgrade service SAP GoingLive Functional Upgrade Check. You can also convert some of the tables before you start the upgrade using incremental table conversion [Page 30]. A team of experts checks the parameter settings of your system in one session before the upgrade. 2. Your local support is your contact for ordering service. When you plan the upgrade. All the times specified in this guide are based on hardware with average performance. see SAPNet under Services → Consulting Services → SAP GoingLive Functional Upgrade Check. 4. 3. Do not forget the sequence of the upgrades in an SAP system group [Page 36]. Start planning your upgrade at least two to three weeks before you want to start. You can repeat the program as often as you need before starting the actual upgrade. the hardware requirements [Page 45] and the software requirements [Page 47] are met. To make sure that the requirements are met. You make sure that you can access the online documentation [Page 50]. and also means you must pay attention to certain database-specific aspects [Page 27]. For information on services. You plan the upgrade of the frontend software [Page 39]. This is the prerequisite for a successful SAP System upgrade. It is aimed in particular at SAP system administrators who are upgrading a system with the Repository Switch procedure for the first time.6C Support Release 2: UNIX SAP AG Planning the Upgrade Purpose Before you begin the actual upgrade.Upgrading to 4. The strategy you choose influences the time needed for the upgrade. run the PREPARE [Page 212] program as soon as possible. 7. you must do the following: 1. Process Flow Do not perform any additional actions during the upgrade that could place it at risk. and gives you detailed recommendations on the configuration. The successful execution of PREPARE is a prerequisite for starting the upgrade. If necessary. After the upgrade. This section helps you plan your upgrade so that downtime is reduced to a minimum. 5. 6. you must first plan it carefully. you plan a modification adjustment [Page 37]. You make sure that the structural requirements [Page 44]. You must decide on an upgrade strategy [Page 20]. You draw up your upgrade schedule [Page 32]. You request the necessary Notes [Page 40]. and the upgrade runs as efficiently as possible. the parameters and the entire system status are checked again in a second session. 18 April 2001 .

6C Support Release 2: UNIX 8. you plan the installation of the SAP Internet Solution [Page 51]. If you are upgrading a modified system where changes have been made to the standard system. you upgrade the operating system and database system [Page 53]. This procedure eliminates the need for time-consuming adjustments to the production system. preparing. April 2001 19 . We recommend testing the upgrade in a development system. and contains the same modifications.SAP AG Upgrading to 4. The adjustments you perform manually for the new standard in this system can be automatically exported to the global transport directory and are integrated in the production system upgrade from there. you have to start by upgrading a development or quality assurance system that has the same SAP release (including Support Packages). 9. performing and following up the upgrade. The checklist for the upgrade [Page 13] is a concise overview of all required actions for planning. If necessary. If necessary. which you can use to monitor your progress in the upgrade project.

− The Repository Switch can be divided into two parts: • Importing the substitution set into the shadow tables The database tables referred to as the substitution set comprise almost the complete SAP Repository. "Shadow tables" are tables which the running SAP System does not recognize at this point. • The time intervals in which the actions are saved on the database by database mechanisms This mode is database-specific and is defined as follows: SAP DB DB2 Universal Database DB2 for OS/390 Informix Oracle Logging is activated LOGRETAIN and USEREXIT set to ON No mode for deactivating logging Database backup mode activated Database is operated in ARCHIVELOG mode This determines whether the database system can recover lost data.Upgrading to 4. Database mechanisms save database actions that occur in the first half of the upgrade. The upgrade strategy also determines the times at which you must make a complete backup of the system. 20 April 2001 . You can no longer operate the system productively. The most suitable upgrade strategy depends on two factors: • • • The maximum downtime permitted in the system The size of the database The upgrade strategy defines: whether the substitution set is imported into the shadow tables during production operation or during downtime. In the second half of the upgrade.6C Support Release 2: UNIX SAP AG Planning the Upgrade Strategy Purpose Choose the upgrade strategy best suited for your SAP System. you can recover the database to its state after the import of the substitution set. This part of the procedure can run during production operation. SAP Upgrade Strategies There are three upgrade strategies available: A_switch • • • Imports the substitution set during production operation. • Substituting the old Repository with the new Repository This part of the Repository Switch substitutes the Repository by deleting the old Repository and renaming the shadow tables. You can recover the database to its current state during the first half of the upgrade.

With strategy A_off. April 2001 21 . For A_switch the mode in which the database operates is changed.SAP AG Upgrading to 4. The graphic below shows the upgrade procedure for the different strategies. A_on Shortest downtime No offline backup necessary after upgrade The runtime of the upgrade and the amount of uptime or downtime involved are heavily dependent on the upgrade strategy you choose. The procedure is the same for all the strategies up to phase EU_IMPORT0. A_on and A_switch are identical until phase MODPROF_TRANS. The important phases are EU_IMPORT2 and MODPROF_TRANS. Database mechanisms save database actions that occur in the during the entire upgrade. Database mechanisms do not save database actions during the upgrade. Comparing the Strategies A brief overview of the advantages and disadvantages of the individual strategies: Strategy A_switch Advantages Short downtime Medium storage requirements for ensuring database recovery Disadvantages Offline backup necessary after upgrade Monitoring necessary to determine if disks for ensuring recovery are full Greatest additional space requirements to ensure database recovery Monitoring necessary to determine if disks for ensuring recovery are full A_off No additional space requirements for ensuring possible recovery Offline backup necessary after upgrade Longest downtime No monitoring necessary to determine if disks for ensuring recovery are full. since these mark the beginning of downtime. Then downtime begins for both. but not for A_on. You can recover the database to its current state during the entire upgrade. It does not take differences in the duration of the upgrade into consideration. depending on the strategy chosen. the downtime begins in phase EU_IMPORT0. The mode in which the database operates changes. The upgrade is divided into phases. You can only recover the database to its state before the import of the substitution set. A_off • • • Production operation ends before the substitution set is imported.6C Support Release 2: UNIX A_on • • • Imports the substitution set during production operation.

6.0 0. you choose the runtime of the import [Page 26] yourself.0 0.0 13. Each additional language that you import increases the minimum duration of the import by about an hour. These sizes are based on sample data.5 15. The downtime depends on the upgrade strategy you choose.5 A_on 9. The following table shows the sizes of the archives created for the different upgrade strategies and databases.5 A_off 0. and the time it takes to create the database archives. If you choose the strategies A_switch or A_on. This data has not been sorted by operating system.5 7. Comparison of the Archives in GB A_switch SAP DB DB2 UDB Informix Oracle 7.4. 22 April 2001 .6C Support Release 2: UNIX SAP AG Upgrade Process Flow A_switch Start PREPARE Start R3up A_on PREPARE A_off R3up check phases Choose upgrade strategy Phase EU_IMPORT0 Import substitution set Phase MODPROF_TRANS Import substitution set Repository Switch Legend: Actions by R3up or PREPARE User actions Prompt for upgrade strategy Default: A_switch Repository Switch Repository Switch End of R3up Offline backup Online backup Offline backup Downtime Production The total runtime of R3up depends on how long it takes to import the substitution set.5 7.0 22. source release or database size.0 0. The longer the runtime you choose. database type.0 .Upgrading to 4.0 The following graphics show an analysis of the upgrade runtimes and downtimes registered by SAP customers for Releases 4.0 12. the better the performance during production operation.

SAP AG Upgrading to 4.6C Support Release 2: UNIX Runtime Distribution 250 Number of upgrades 200 150 100 50 0 0-4 4-8 8-12 1216 1620 2024 2428 2832 3236 3640 4044 4448 Runtime (hours) Downtime Distribution 300 Number of upgrades 250 200 150 100 50 0 0-4 4-8 8-12 1216 1620 2024 2428 2832 3236 3640 4044 4448 Downtime (hours) April 2001 23 .

Upgrading to 4. Strategy A_on also allows you to work productively at the end of the upgrade.6C Support Release 2: UNIX SAP AG Your source release can influence the runtime and downtime of the upgrade by up to approximately 25%. The following factors can also influence runtime and downtime of the upgrade: • • • • • • • Hardware Installed languages Number of clients A significant amount of customer developments Modifications to the standard SAP tables Add-on software Integrated Support Packages The hardware that you use has the greatest influence on total runtime and downtime. even though R3up is still running. 24 April 2001 . Guideline for the Duration of Production Operation During the Upgrade A_switch A_on From: Start of R3up To: Start of downtime Duration can be configured From: End of downtime To: End of R3up 1) 34 hours 1) 34 hours 1) 0 hours 1 hour 1) Minimal reduction in performance will occur during production operation. The following table shows you how much time you can gain for production operation by using strategy A_switch or A_on. Both strategies allow you to work productively during the first half of the upgrade. The size of your database only has a secondary role in determining the runtime of the upgrade.

When selecting this time. pay attention to the following: Production operation is only possible from upgrade phase PRODCHK_46C onwards. If R3up has reached the post-upgrade phases when this time is reached. You are also requested to carry out certain actions (for strategies A_off and A_switch. The upgrade always executes up to the PRODCHK_46C phase. for example. it is necessary to make an offline backup).SAP AG Upgrading to 4. even if the time you entered is earlier. April 2001 25 . This reduces the downtime towards the end of the upgrade and during post-upgrade activities.6C Support Release 2: UNIX When to Restart Production Operation Process Flow All three strategies allow you to enter the latest date and time by which you want to resume production operation of your SAP System. you do not need to wait until R3up completes its run before resuming production operation. In this case R3up informs you that the SAP System can resume production operation although R3up is still active.

the import will be slowed down accordingly.Upgrading to 4. DB2 Universal Database. DB2 for OS/390 and Informix) that need to be saved per hour. an import takes about six hours without delays. This enables you to sustain the performance of the system and also to reduce the number of archives (Oracle) or log files (SAP DB. If you enter a longer runtime.6C Support Release 2: UNIX SAP AG Runtime for the Import of the Substitution Set Process Flow With strategies A_switch and A_on you are asked to specify the total runtime for the import of the substitution set. Depending on the start time of the upgrade. Depending on the hardware. 26 April 2001 . specify total runtimes of about 24 hours.

the contents of the log are permanently lost.SAP AG Upgrading to 4. you need to create an online backup before you stop operating the system productively. they are updated automatically. The concatenated archive logs can be located on one disk without a loss of performance. in the EU_IMPORT2 phase with A_off). in the EU_IMPORT2 phase with A_off). create an online backup before the system starts operating productively again. at the latest. You can decide if you want a very fast import which switches logging off completely for the import. For all strategies. an incremental backup is sufficient (save updated pages). If the statistics for less than 15 tables are out-of-date. you are requested to stop all work in the system. The log configuration can be changed with the database command alter log in the database tool xcontrol. Make sure that the log devspaces are on different hard disks. when the system stops operating productively. To activate these parameters. If large amounts of data are involved. April 2001 27 . After the mode has been switched. you can choose to update them or to terminate the upgrade. R3up waits for your confirmation before it stops the central instance. If the statistics for more than 15 tables are out-of-date. DB2 Universal Database • Isolating the central instance When the central instance is isolated (in the MODPROF_TRANS phase with A_on and A_switch. you are requested to stop all work in the system. R3up switches the parameters LOGRETAIN and USEREXIT to OFF after confirmation. This means that you must back up the database for all strategies.6C Support Release 2: UNIX Database-Specific Aspects SAP DB The performance for the development environment (DE) import (mass insert) depends largely on the log devspace. At this point the tables relevant to the upgrade are checked to see if they contain sufficient statistical information. When the central instance is isolated (in the MODPROF_TRANS phase with A_on and A_switch. however. You must be able to recover the database to the state it has at this point. To ensure this. • Database backup before the upgrade You must be able to recover the database to its state before the upgrade was started. We recommend that you update the statistics values with the tool xpu shortly before the upgrade. With the strategies A_off and A_switch. their mirrors should be on other disks. shut down the database and reboot it. R3up waits for your confirmation before it stops the central instance. The statistics values for newly imported tables are updated automatically after the DE import. R3up switches the log mode to DEMO for the strategies A_off and A_switch. After the log backup has been confirmed and checked.

but not the database logging. The database forces you to create a complete backup (otherwise a CONNECT to the database is not possible). You are prompted to deactivate the database backup mode. in the EU_IMPORT0 phase with A_off) you are asked to stop all work with the system. continue in R3up. After the upgrade. After the database backup. Oracle At the start of the downtime (in the MODPROF_TRANS phase with A_switch and A_on. R3up switches the parameters LOGRETAIN and USEREXIT to ON for strategies A_off and A_switch after confirmation.6C Support Release 2: UNIX SAP AG • Database backup at the end of the upgrade At the end of the upgrade. You can choose between an online and an offline backup. you must make an online backup. Now make a complete backup of your database so that if you need to recover it you do not have to import all the archives created so far. DB2 for OS/390 Database actions are backed up during the entire upgrade by database mechanisms. You can also make an online backup after an upgrade with the strategies A_switch and A_on. For this reason.Upgrading to 4. Logging is always switched on regardless of the upgrade strategy. R3up waits for your confirmation before it stops the central instance. You can recover the database to its current state during the entire upgrade. The upgrade strategy influences the downtime. you must now create a complete backup for the strategies A_off and A_switch. You must make the online backup before the central instance is stopped. This has the following effects: • • • • There is no difference between the strategies A_switch and A_on. You must make the offline backup before you confirm that you want to deactivate archiving. You can choose an online or an offline backup. R3up waits for your confirmation before it stops the central instance. Informix When the central instance is isolated. You can find a description under Changing the Database Recovery Mode [Page 205]. 28 April 2001 . You must be able to recover the database to the state it has at this point. This makes sure that you do not need to perform a recovery that uses the logical log files created during the upgrade. including those written during the previous import. For strategy A_on we recommend that you create a full online backup at the end of downtime. you are asked to stop all work with the system. You must be able to recover the database to the state it has at this point. This makes sure that in the event of a database crash. you do not have to import all logical log files written until this time. • A_switch You are then asked to switch off database archiving. You can find the necessary commands under Changing the Database Recovery Mode [Page 205].

SAP AG Upgrading to 4. make a new complete backup now. End of the database-specific explanations April 2001 29 . Note that a large number of database archives have to be saved at regular intervals during downtime. If some time has elapsed since the last complete backup of your database. You can find a description under Changing the Database Recovery Mode [Page 205].6C Support Release 2: UNIX • A_on With strategy A_on you do not switch off database archiving. You can choose an online or an offline backup. • A_off You must be able to recover the database to the state it has at this point. You are then asked to switch off database archiving. so that you do not have to import all the archives created up to this point if there is a database failure. create a complete online backup (possibly as a postupgrade activity) to avoid a recovery based on upgrade database archives. At the end of downtime.

If these checks return positive values. The necessary data is converted during production operation. This gives you several advantages: • • • Reduced downtime during the upgrade You can return to the SAP standard more easily for modified tables You can use incremental conversion for large tables as well SAP DB SAP DB does not support incremental table conversions. the tables are converted in the phase PCON<rel>. you must first run PREPARE. PREPARE checks whether the system: • • runs on a database platform that supports incremental conversion contains tables for which an incremental conversion is useful. You can use the following functions: • • Display the tables determined by PREPARE (tables for conversion with ICNV) Choose − − which non-modified tables you want to convert incrementally. • • • Start the conversion. which modified tables you want to return to the SAP standard and convert incrementally.Upgrading to 4. Functions Incremental table conversion is performed using transaction ICNV. you may need to completely restructure the relevant tables by converting each data record. If you do not want to use this function. These table conversions used to only occur during the downtime of the upgrade (phase PCON_<rel>). In some cases. Estimate the runtime of the conversion. Examples of these are tables that contain large amounts of data and would significantly extend downtime if they were converted. By using incremental conversion. PREPARE asks you to start the incremental conversion. you can convert many of these data records before the upgrade. 30 April 2001 . More information is available online in transaction ICNV by pressing F1 or selecting the i button.6C Support Release 2: UNIX SAP AG Incremental Table Conversion Represents With each new release. Incremental conversion is optional. the structure of the tables in your database changes. End of SAP DB Prerequisites To be able to use this function. Monitor the conversion.

SAP AG

Upgrading to 4.6C Support Release 2: UNIX

What to look for: •

Whereas the PREPARE actions have an analyze function, the ICNV does not. Transaction ICNV already makes modifications to the database tables that you want to convert during the Initialization step. These modifications are not canceled by resetting PREPARE. In particular, you cannot directly upgrade the release of these modifications. For this reason, only start the incremental table conversion if you then want to perform the upgrade. If you use incremental table conversion, do not start an SAP archiving program for these tables in parallel, since this can lead to performance bottlenecks. Therefore, archive as much as possible before starting the conversion. After the incremental conversion starts, you cannot change any more Dictionary definitions for the relevant tables until the upgrade is complete. This affects changing, deleting or adding field definitions. Transaction SE11 is locked for these tables. Pay special attention to the resource usage of your database management system to detect bottlenecks early on. Incremental conversion requires double the space in the relevant database container (tablespace, dbspace, and so on) for each affected table during the conversion. The continuous data transfer results in more transactions. Therefore, also monitor the space for the rollback information. Do not begin the upgrade before at least 95% of the total data has been converted. R3up checks this at the beginning of downtime. If this percentage has not been reached, R3up displays a corresponding message. This gives you the advantage of reducing critical downtime. You can monitor the progress of the conversion using transaction ICNV. You can start the upgrade even if the 95% minimum is not reached. However, the remaining data is transferred entirely during the downtime.

Incremental conversion requires a sufficient number of background work processes. Ideally, there should be one process for each table to be converted. If you cannot have one process for each table due to a large number of tables, you can still convert the tables since transaction ICNV distributes the tables itself to the available background processes. However, the incremental conversion takes longer to complete, and the time for beginning the upgrade is pushed back.

April 2001

31

Upgrading to 4.6C Support Release 2: UNIX

SAP AG

Drawing Up an Upgrade Schedule
Purpose
Create an exact schedule for your SAP System upgrade.

Prerequisites
You have decided on one of the three upgrade strategies A_on, A_switch or A_off.

Process Flow
1. You decide when you want to begin the preparations for the upgrade.
At the latest, start preparing for your upgrade a week before starting the upgrade.

2. You decide when you want to begin the upgrade. If you have decided to use the A_off upgrade strategy, start the upgrade on the last day of production operation with the old release. If you have decided to use strategy A_switch or A_on, start the upgrade on the second to last day of production operation with the old release. In all cases, you can start the import of the substitution set with the phases EU_IMPORT0 to EU_IMPORT5 towards the end of the day.

You are prompted to change the CD at the beginning of the phases EU_IMPORT4 and EU_IMPORT5. Phase EU_IMPORT4 has a runtime of about 30 minutes, phase EU_IMPORT5 has a runtime of about 3-4 hours. If you miss this prompt, your time schedule could be seriously disrupted. 3. Take the necessary measures to extend the time in which the upgrade can run unmonitored. a. Specify all CD mount directories at the start of the upgrade
R3up lets you specify up to 16 CD mount directories when you start upgrading. This significantly increases the amount of time R3up can run without user input.

The prompt for the mount directories occurs during the INITPUT phase, which runs during PREPARE and during the upgrade itself. You are only prompted for the mount directories, which means that it does not matter where the CDs are mounted. As long as the program finds a CD with the correct label, it does not prompt the user to change the CD. If you do not have enough CD disk drives, you can copy the contents of each CD to separate directories on your hard disk (providing you have sufficient disk space). A maximum of 650 MB per CD is required. You then enter these directory names when prompted for the mount points. b. For a list of the CDs that PREPARE needs, see Making Entries for the Parameter Input Module. For a corresponding list for R3up, see The Upgrade. c. Early locking of the ABAP Workbench If you have decided to use upgrade strategy A_switch or A_on:

32

April 2001

SAP AG

Upgrading to 4.6C Support Release 2: UNIX

The phase LOCKEU_PRE is directly before the phase EU_IMPORT0. In LOCKEU_PRE you are asked when the ABAP Workbench can be locked. If you are sure that you do not need the ABAP Workbench from phase EU_IMPORT0 onwards, confirm the lock in LOCKEU_PRE. If you do not confirm the lock in LOCKEU_PRE, you are asked to confirm the lock in REPACHK2. Since phase REPACHK2 is after the last CD change (phase EU_IMPORT5), you may not want to do this. d. Avoiding long upgrade downtimes. The Upgrade Assistant can inform you if R3up waits for a long period of time for an entry. This can be either a standard user entry or an action taken to correct an error. To receive this alert information, you have to activate the alert function and supply the relevant parameters. You can specify an external program to be started if R3up has been waiting too long for an entry. This then triggers a communications service that informs the system administrator. You must provide this external program yourself. You can find more information on the alert function in the online help in the Upgrade Assistant in the section Set Alert Window. To access the online help, go to the main menu and choose Help → Introduction. Whether you use the Upgrade Assistant or not, the R3up control program stops the upgrade if errors occur so that you can take action. R3up indicates that you should take action as follows:
− −

A message appears on the screen. The file upalert.log is created in sub-directory tmp of the upgrade directory.

If you do not notice these errors, significant delays can occur in your time schedule. To avoid losing time unnecessarily, you can arrange to be notified automatically, for example, by telephone, that the upgrade has stopped. You can use the alert file to do this. You must provide the appropriate software for using the alert file. 4. You decide when you want to back up the database after the upgrade. If you decide to use upgrade strategy A_off, start the complete backup after the end of the upgrade on the evening of the second day. If you decide to use upgrade strategy A_switch, start on the morning of the third day. For all the upgrade strategies, you can resume production operation at the beginning of or during the third day. 5. Extend the time for the import of the substitution sets during production operation. You need approximately 6.5 hours to import the substitution sets. To avoid lowering system performance, extend this time. Set the time required for the import so that it ends at least 5 hours before the planned shutdown of production operation. At the latest, system downtime begins in the MODPROF_TRANS phase. The earliest you can resume production operation is approximately 10 hours later. During this time the SAP System is started up several times. 6. You decide when production operation resumes. If possible, do not resume production operation until all the necessary post-upgrade activities have been performed. The same applies to the complete backup of the database, which is a requirement for resuming production operation for upgrade strategies A_off and A_switch.

April 2001

33

Upgrading to 4.6C Support Release 2: UNIX

SAP AG

This has the advantage that all database changes resulting from post-upgrade activities are included in the complete backup. The earliest possible point for continuing with production operation is PRODCHK_<release>.

Examples of Upgrade Scheduling
The tables below show examples of an upgrade schedule for each of the three strategies. The modification adjustment was run during the night in order to show the shortest possible runtime. You can also run it during the day. The schedule would then take correspondingly longer. The language import was not taken into consideration in these examples. For SAP System languages other than 'EN' (English) and 'DE' (German), add approximately 1 hour. In the A_off strategy the import period is during the downtime, whereas in the A_on and A_switch strategies half of the import is while the system is operating productively, and half during downtime.
Example Schedule for Strategy A_switch Day Time Actions

Thursday Thursday

9:00 10:00

Start R3up Start import of the substitution set (slow) with R3up in phase EU_IMPORT0 Insert the last CD (title: Upgrade CD5) at the beginning of phase EU_IMPORT5 Stop production operation at the beginning of phase MODPROF_TRANS by isolating the central instance, as described under Isolating the Central Instance. Adjust modifications, if required. Back up database offline System in production operation

Thursday

19:00

Friday

20:00

Friday Saturday Saturday

23:00 9:00 After offline backup has been completed

Example Schedule for Strategy A_on Day Time Actions

Thursday Thursday

9:00 10:00

Start R3up Start import of the substitution set (slow) with R3up in phase EU_IMPORT0

34

April 2001

if required. if required. as described under Isolating the Central Instance. Start the import of the substitution set with R3up Friday 17:00 Insert the last CD (title: Upgrade CD5) at the beginning of phase EU_IMPORT5 Adjust modifications. as described under Isolating the Central Instance. Adjust modifications. Start post-upgrade activities Back up database offline Friday Saturday Saturday 21:00 9:00 April 2001 35 .6C Support Release 2: UNIX Thursday 19:00 Insert the last CD (title: Upgrade CD5) at the beginning of phase EU_IMPORT5 Stop production operation at the beginning of phase MODPROF_TRANS by isolating the central instance. Start post-upgrade activities Back up the database online Friday 20:00 Friday Saturday Saturday 22:30 10:00 After starting to operate the system productively Example Schedule for Strategy A_off Day Time Actions Friday Friday 15:00 16:00 Start R3up Stop production operation at the beginning of phase EU_IMPORT0 by isolating the central instance.SAP AG Upgrading to 4.

upgrade the systems as follows: 1. Do not copy your production system to your development system to test the upgrade. Development system 2. Only this SAP System offers you optimal support when you adjust modifications. 36 April 2001 . The version management functions of the SAP System only record all the changes you make in the system in which you made them (the development system). If you have modified SAP objects. Development system 2. upgrade your systems as follows: 1. Production system If you have made modifications to SAP objects that you want to retain.6C Support Release 2: UNIX SAP AG Upgrading in an SAP System Group Purpose If you have more than one SAP System. Quality assurance system 3. Process Flow If you have a development system and a production system. set up a quality assurance system between the development system and production system. make sure that your development system remains in existence.Upgrading to 4. you must consider the entire system group when you upgrade. Production system If your system group consists of three SAP Systems and includes a quality assurance system that has been set up between the development and production system. This system can be a copy of the production system. Use this procedure to avoid making time-consuming adjustments in the production system. you must proceed with the upgrades in the above sequence. To test the upgrade with realistic production data. You should upgrade your systems in the same sequence in which you transport your modifications. Changes made in the development system after the upgrade can be transported automatically to your other SAP Systems. for example a production system and a development system.

You can identify modifications as repairs to the SAP standard or as imports of SAP objects. Any preliminary corrections that you have imported as transport requests from one of the sapserv(x) SAP Support Servers may be lost when you upgrade.Basis Components → ABAP/4 Development Workbench → Enhancements to the SAP Standard → The SAP Software Change Registration Procedure (SSCR). The modification adjustment lets you make your modifications to the appropriate new objects in the upgrade. Release 3. To safeguard existing modifications of this kind. otherwise the SAP System would not be able to operate. the modifications have to be preliminary corrections. then contact an experienced Basis consultant for help.x Choose Help → R/3 library → BC .Changing the SAP Standard → The SAP Software Change Registration Procedure (SSCR). All other requests are dealt with as preliminary corrections.Basis Components →ABAP Workbench → BC . For more information.SAP AG Upgrading to 4. Release 4. a distinction is made between the following two classes of modification: • • Modification to an object from the central SAP Basis component Modification to an application object In the first case. including Support Packages. see the SAP online documentation. Objects belonging to the central Basis component are always returned to the SAP standard by the Repository Switch.x Choose Help → SAP Library → BC . Process Flow Adjusting Modifications in the First System (Development System) You must test the modification adjustment in a development system that has the same SAP Release and that has been modified to the same extent as the production system. the error message TG140 appears in phase RUN_RDDIT006. you might need an SSCR key. you lose any modifications you made to objects that conflict with SAP modifications. When you upgrade the system. If the development system contains more modifications. The following explanation assumes that the levels of modification are identical. During the Repository Switch. Requests in the customer namespace (number range 900000 to 999999) “modify” the SAP objects included in them.6C Support Release 2: UNIX Planning the Modification Adjustment Purpose If you are sure that your SAP System corresponds exactly to the SAP standard. which you should obtain before upgrading. Prerequisites To adjust modifications. you can skip this section. April 2001 37 .

before you upgrade the system. You can read documents on the 4. Repository objects (reports. If this is the case. The adjusted objects are collected in a repair that is released to a transport request. Towards the end of the upgrade. A check is performed to see if all the modifications identified in the system are handled by transport requests. and then registers it for transport in the file umodauto. 3. 38 April 2001 . However. you must perform additional steps for automatic acceptance. R3up exports this transport request into the transport directory /usr/sap/trans (UNIX) or \\$(SAPGLOBALHOST)\SAPMNT\TRANS (Windows NT). to get background information on the changes made. 2. and so on) are adjusted during downtime before the activation of the ABAP Dictionary. You cannot release this transport request. The ABAP Dictionary objects (tables. the transport requests are integrated into the upgrade. we recommend that instead of adjusting modifications manually. and so on) are adjusted towards the end of the upgrade. screens. the old. all adjustments are released to a transport request that is noted and then exported and registered by R3up.6C Support Release 2: UNIX SAP AG 1. Adjusting Modifications in Subsequent Systems For the quality assurance and production system. no adjustment needs to take place.lst. If you have not installed a central transport directory. At this stage the import of SAP objects has already been completed. These steps are described in Note 51046. In the ADJUSTPRP phase you are presented with the requests from the development system and can decide whether you want to accept them. the upgrade will import changes which previously did not exist in the system. As with Dictionary objects.6C documentation CD offline. If the number of objects in the adjustment transport requests exceeds the number of modifications in the next system. domains. The procedure is described on the cover of the CD. If you confirm here. You can find a detailed description of modification adjustment in the current online documentation under Help → SAP Library → Basis Components → ABAP Workbench → Changing the SAP Standard (BC) → The Modification Assistant.<SID> in the sub-directory log of your upgrade directory. instead it must be flagged for export in Transaction SPDD. This phase is executed in the PREPARE module Modification support and runs in the upgrade between the import of the substitution set and the end of the production period. You must consult the authors of the modifications named in the log UMODPROT. The list of objects that have to be adjusted in your SAP System is determined in the ADJUSTPRP phase.Upgrading to 4. modified version is still available in the versions database. data elements. you automatically transfer both the transport requests exported in the section Adjusting Modifications in the First System (Development System).

April 2001 39 . You can import the frontend software as soon as you receive the software package. This graphic shows the time period during which you can upgrade the frontend software: Time Frame for Upgrading the Frontend Software Earliest possible time Production operation Downtime As of this point. For more information. Preparations Processing Post-upgrade Receive the software package R3up starts Downtime begins Phase R3up KX_SWITCH ends The frontend software is upgraded directly from CD or from a file server. logging on with an old version of SAP GUI may cause errors. After this has taken place.6C Support Release 2: UNIX Time Frame for Upgrading the Frontend Software The new SAP release cannot run until the new version of the frontend software (SAP GUI) has been installed. see the SAP Frontend Installation Guide.SAP AG Upgrading to 4. log on only with new frontend software Production op. The latest possible time for upgrading is before you log on to the new version of the SAP System for the first time. The new SAP kernel is imported by R3up in the KX_SWITCH phase.

this documentation also refers you to other SAP Notes.6C Support Release 2: UNIX SAP AG Notes for the Upgrade Definition To prepare and perform the upgrade of your system. organized by database: 40 April 2001 . use the fax request form included in the software package. This information is kept in a number of SAPNet – R/3 Frontend Notes. You must read the general Upgrade Note before you prepare the upgrade. you are asked to enter a keyword. which you can get from the current general Upgrade Note 390062. The following is a list of the SAP Notes you need to prepare for the upgrade: SAP Note Number Database SAP Note Type 390062 197901 202790 386570 326658 201874 All databases SAP DB DB2 Universal Database DB2 for OS/390 Informix Oracle Specific to this upgrade SAP DB-specific / specific to this upgrade DB2 Universal Database-specific / specific to this upgrade DB2-for-OS/390-specific / specific to this upgrade Informix-specific / specific to this upgrade Oracle-specific / specific to this upgrade Keyword for the Upgrade When you start the upgrade. If you do not have a SAPNet link. you require some additional information. There are separate SAP Notes for the database-specific sections. SAP Notes for Preparing the Upgrade You must request the general Upgrade Note and the SAP Note for your database from SAPNet – R/3 Frontend before you start your upgrade. These SAP Notes are named at the appropriate places in this documentation. When you actually upgrade the system you need the information from some additional SAP Notes. if necessary. You cannot start the upgrade until you have entered the keyword. This SAP Note contains current non-database-specific information on preparing for the upgrade. not included in the documentation. Other SAP Notes As well as the SAP Notes you need for preparing the upgrade. The following is a list of these SAP Notes. which give you additional information.Upgrading to 4.

0A/4.SAP AG Upgrading to 4.1I Kernel Release SAP Releases for SAP add-ons (IS) Collection of notes on upgrade problems for the SAP component HR (human resources) Measures for optimizing upgrade runtime 4. runtime Conversion of address tables.R/3-Frontend Central Basis objects are modified Correction locks do not belong to system Copying the modification adjustment without a central transport directory Error message TG063 in the upgrade phase JOB_RADDRCHK Conversion of address tables.6C Resource requirements for Release 4.x Problems when upgrading patched source releases Downloading Support Packages from the SAP Service Marketplace Service Connection Upgrade Assistant in SAPNet .6B Resource requirements for Release 4.5 Resource requirements for Release 4.6A Resource requirements for Release 4.0B Preliminary information on freespace in the database System requirements for frontend workplaces / SAP GUI Installation of a 3.6C Support Release 2: UNIX SAP Notes for All Databases SAP Note Number Topic SAP Note Type 323263 178616 151508 113795 89305 203428 26417 102445 86985 156387 76431 73510 83458 125971 33888 62519 51046 96905 97032 82167 24864 10187 137478 Resource requirements for Release 4.x R/3 HR Support Packages SAP Support Packages Remote support for upgrade General upgrade Transport Organizer Change and Transport System ABAP Dictionary Address management Address management ABAP Dictionary / Phase PCON_<rel> User administration R/3 installation April 2001 41 . runtime No conversion of table BSEG User buffer too small Installing a dialog instance/gateway with R3SETUP Performance Performance Performance Performance Performance Specific to this upgrade Frontend/SAP GUI SAP Kernel IS-specific HR-specific Upgrade to Release 4.

2 Back up the database SAP DB 7.6x SAP DB SAP DB database upgrade to 7.1 SAP DB load with parallel R3LOADS Change a database parameter in SAP DB Release 7.Upgrading to 4.5 B00 Add Devspace under SAP DB (ADABAS for R/3) 6.6C Support Release 2: UNIX SAP AG 197746 86627 98752 195443 195446 195442 322982 73999 177680 Maintenance Strategy Internet Transaction Server Transaction types: Customizing for release upgrades Migrating the proposal pool Current SAP Note on the 4.2.6x DB2 UDB DB2 Universal Databasespecific 42 April 2001 .4/5 SAP DB-specific SAP DB-specific SAP DB-specific SAP DB-specific SAP DB-specific SAP DB-specific SAP DB-specific SAP Notes for DB2 Universal Database SAP Note Number Topic SAP Note Type 156553 Released operating systems for 4.6C language import Language import and Support Packages Install language during upgrade Upgrade phase PCON: TG450 to TG453 Correcting conversion problems during the PCON 46B / PCON 46C phase SAP@Web Customizing Translation tools Language transport Language transport Language transport Language transport General upgrade General upgrade SAP Notes for SAP DB SAP Note Number Topic SAP Note Type 156551 382741 34690 46430 201388 201390 327578 Released operating systems for 4.2 New software structure as of SAP DB Version 7.2.6C language import Space requirements for the 4.

6B) DB2/390: Free space for 4.Problems with Rollback segments Installation of the Oracle Client Software Oracle-specific Oracle-specific Oracle-specific Oracle-specific April 2001 43 .5B) DB2/390: DDIC corrections (4. ICLI servers DB2/390: Manual saposcol installation DB2/390: DDIC corrections (3. 4.0B) DB2/390: DDIC corrections (4.1I.6C upgrade DB2 for OS/390-specific DB2 for OS/390-specific DB2 for OS/390-specific ABAP Dictionary / phase CNV_SUBMIT DB2 for OS/390-specific DB2 for OS/390-specific DB2 for OS/390-specific DB2 for OS/390-specific DB2 for OS/390-specific DB2 for OS/390-specific DB2 for OS/390-specific SAP Notes for Informix SAP Note Number Topic SAP Note Type 50157 156549 22941 115619 Using recommended versions of Informix Released operating systems for 4.6A.6x Informix Reorganization of tables and dbspaces Informix Client versions Informix-specific Informix-specific Informix-specific Informix-specific SAP Notes for Oracle SAP Note Number Topic SAP Note Type 156548 11777 16951 303238 Released operating systems for 4.SAP AG Upgrading to 4.1H. 3.6x DB2/390 DB2/390: APAR list Conversion of partitioned tables SQL error -540 Maintaining catalog statistics DB2/390: Upgrade. 4.5A.0F. 4.6x Oracle Changing the storage parameters NEXT and MAX EXTENTS Oracle . 3.6C Support Release 2: UNIX SAP Notes for DB2 for OS/390 SAP Note Number Topic SAP Note Type 156554 81737 78354 83473 113008 136806 103135 162250 162818 184399 197772 Released operating systems for 4.

Check the profile parameter rdisp/mshost. Therefore. This parameter displays the number of update processes for the central instance. you can check the structural requirements using the following procedure.6C Support Release 2: UNIX SAP AG Checking Structural Requirements Use You must meet the following structural requirements before you upgrade your system: • The message server must run on the host with the central instance. check the profile parameter rdisp/wp_no_vb. This parameter contains the host name where the message server is running.Upgrading to 4. 44 April 2001 . versions of the modified objects are created by Version Management during the upgrade. Choose the server (host) where the central instance is running. The update program writes these versions. You can only guarantee this if the message server is located on the same host as the central instance. During the upgrade. the update program must be running on the central instance. A standard installation meets the specified structural requirements. This makes sure that the message server is active during downtime. and temporarily schedules ABAP report programs for background processing. If you have made modifications to the SAP standard. the message server must still be running after the secondary instances are stopped. • Update processes must run on the central instance when you make modifications to the standard. the upgrade control program R3up uses Remote Function Call (RFC) to call function modules. while the secondary instances are stopped. Choose Goto → Profile values → Of a server. Call Transaction RZ10. If you are not sure whether you have a standard installation. The number must be greater than 0. The profile parameters for this server are displayed with their values. because only the central instance runs during downtime. It must run on the same host as the central instance. For this reason. If you have made changes to the SAP standard. Procedure 1. 4. 2. 3.

x. You can find it at: http://service.6C SR2 compared to Release 4.650 MB of temporary disk space in the file system for the upgrade. • SAP Note 323263 This Note explains the resource requirements for Release 4. disk space.0B.OS Dependencies. main memory. • • SAP Note 113795 This Note explains the resource requirements for Release 4. You can use the following to help you: • Quick Sizing in the SAP Service Marketplace This is an interactive tool for an approximate sizing of the required hardware. and Swap Space Before the upgrade.5B. Space Requirements in the File System Make sure that you have about 1. Main Memory.6C Support Release 2: UNIX Checking Hardware Requirements CPU. You need this free space to create the upgrade directory. check whether you have enough hardware resources. DB2 Universal Database The database is extended by a maximum of 9 GB. Approximately 6. Space Requirements in the Database SAP DB You require a maximum of 8 GB of space in the database for the upgrade.0B compared to Release 3.sap. such as CPU. of which approximately 5 GB is filled permanently. UNIX Kernel Parameters You may need different values for the UNIX kernel parameters for a new SAP Release. For more information.5x compared to Release 4.0A/4.com/quicksizing.SAP AG Upgrading to 4. DB2 for OS/390 April 2001 45 .4 GB of this amount is filled permanently. see the documentation SAP Software on UNIX . The difference between the maximum disk space requirements and the permanent disk space requirements is available as free space in the database as soon as the upgrade is complete. SAP Note 89305 This Note explains the resource requirements for Release 4. and swap space. You can free space after the upgrade by deleting the substitution tablespaces of the source release.

Upgrading to 4. 46 April 2001 .1x 4.5B 13 GB 11 GB 10 GB 9 GB 7 GB 6. you can find the maximum free space requirements for the database in SAP Note 203428. PREPARE takes the status of your database into account and calculates the exact space requirements.5 GB The space requirements could be higher. End of the database-specific explanations The PREPARE program gives you information on how much free space is needed in the database. You can free space after the upgrade by deleting tablespaces that contain only substitution tables of your source release. Informix The database is extended by at least 13 GB. You can recover the difference between the minimum disk space requirements and the permanent disk space requirements by deleting the old substitution tablespaces.0B 4. depending on the source release: Space Requirements in the Database Source Release Minimum Free Space for the Upgrade Space Filled Permanently 3. depending on how much data you have. You can recover the difference between the maximum disk space requirements and the permanent disk space requirements by deleting the old substitution dbspaces. depending on how much data you have. If you cannot start PREPARE early enough. Approximately 7 GB of this amount is filled permanently. Oracle Make sure that the following amount of free space exists in the database. The space requirements could be higher.0x/3.6C Support Release 2: UNIX SAP AG SAP Note 197772 describes the free space requirements in the database.

6B End of the database-specific explanations Procedure To find out the release of your SAP System. Procedure 1.0B 4.5B 4.1H 3. Check the SAP source release [Page 47]. April 2001 47 .6C Support Release 2: UNIX Checking Software Requirements Use You must meet certain software requirements before you upgrade the SAP System.0B 4. Meet the requirements for the Upgrade Assistant [Page 48]. Checking the SAP Source Release Prerequisites Depending on the database system.5x The release appears in the SAP Release field.0D 3. your SAP System must have one of the following releases: Informix.x – 4. Oracle and SAP DB 3.1H 3.6A 4.0F 3. Release 3. choose System → Status. 3.SAP AG Upgrading to 4.6x The release is displayed in the field Component version.1I 4.6A 4. Release 4.0F 3. Meet the operating system-specific requirements [Page 49].5B 4.6B DB2 Universal Database and DB2 for OS/390 3. 2.1I 4.

find out about the status of the Java porting for your operating system from your Competence Center or with the following Internet URL of Sun Microsystems Inc.Upgrading to 4. If you have any doubts. This means that the browsers can only be used to execute the GUI and not the server. Restart your computer.cgi Procedure You can provide the Java Virtual Machine in several ways: • Java Runtime Environment (JRE) There is porting for all relevant platforms.7231x Netscape Communicator as of Version 4. Service Pack 3. End of Windows NT 48 April 2001 .exe) by double-clicking it and make the installation. Java Virtual Machine The Upgrade Assistant (server and GUI) is implemented in Java. You can also use a Java Development Kit (JDK) that contains the JRE. SAP delivers a Microsoft Virtual Machine on the CD SAP KERNEL NT. SAP supports the following browsers: − − • Microsoft Internet Explorer as of Version 4. Installation: Insert the CD SAP KERNEL NT into the CD drive. Open the file msjavx86. Open the Windows NT Explorer and switch to the directory <CD_DRIVE>\NT\I386 (DEC-ALPHA: <CD_DRIVE>\NT\ALPHA). At present.1x or preferably higher).exe (DEC-ALPHA msjavaxp.6C Support Release 2: UNIX SAP AG Meeting the Requirements for the Upgrade Assistant Network If you do not operate the GUI and server on the same host. you must be able to set up a TCP/IP connection between the GUI host and the server host.0. This means that it requires a Microsoft Virtual Machine for execution (Version 1.04 (Java AWT 1.sun. The prerequisite for the installation is Windows NT 4.4 or higher) Microsoft SDK for Java (Microsoft Virtual Machine) You can use this variant for Windows and Windows NT. Windows NT For Windows NT hosts.com/cgi-bin/java-ports.: http://java.1. • Internet Browser with integrated Java Virtual Machine Strict security rules apply to the execution of Java programs in Internet browsers.

End of the operating system-specific explanations April 2001 49 .SAP AG Upgrading to 4.Z.0 A00 or higher.6C Support Release 2: UNIX Meeting the Operating System-Specific Requirements Procedure AIX You must install the AIX packet perfagent so that the SAP Performance Monitor can function. contact your IBM or Bull Competence Center. The compressed file is called CDS_PL_PLRTS_NYMS_1_0C32. Check this using the following UNIX command: lslpp -l | grep perfagent If you have any questions. ReliantUNIX You must install the runtime system ReliantUNIX C++ Runtime System Version 2. you can install this software from the CD-ROM CD-DEV-MI.tar. which you received with your computer. Check this using the following UNIX command: pkginfo -l CDS++RTS If necessary. or which you can order from your technical consultant.

50 April 2001 .x Release. After the installation.htm.6C documentation from the CD Online Documentation .6C Support Release 2: UNIX SAP AG Accessing Documentation Before and During the Upgrade Use Before and during the upgrade you require 4. Procedure The instructions for installing the documentation are on the Online Documentation .SAP Library (for example. you can find most of the documentation online in the system before and during your upgrade to the new release. However.pdf or Onldoc_e.SAP Library offline before the upgrade. You first have to choose Help → SAP Library. you can use the same paths to find the documents online in the SAP System.SAP Library CD in the file Onldoc_e.Upgrading to 4. If you are upgrading from a 4. The documentation is not available online in your system until you have completed the upgrade and the installation procedure for the online documentation (SAP Library). to modify adjustments). This upgrade documentation includes the paths to specific information in the appropriate sections. you can make sure that you can read the CD Online Documentation .

If you want to modify Internet application components delivered in the standard system. April 2001 51 . We recommend waiting until after the upgrade before you install the ITS and SAP@Web Studio. Execute the report IAC_PUBLISH_SP directly after installing the ITS. the SAP@Web Studio. Read SAP Note 197746 to see if newer versions of the ITS and SAP@Web Studio are available. you can also install the development environment of the ITS. Prerequisites These prerequisites and the upgrade of customer-specific Internet application components are described in the guide SAP@Web Installation.6C. Execute the report IAC_PUBLISH_SP if you install the ITS later. you overwrite the application component objects (IAC objects) that are in the Support Packages included in the upgrade.6C Support Release 2: UNIX Meeting the Requirements for the SAP Internet Solution Use To use the SAP Internet Solution. 2. you must install the SAP Internet Transaction Server (ITS). Install the ITS and SAP@Web Studio as described in the SAP@Web Installation Guide. If you are already using the ITS and the SAP@Web Studio. you must reinstall this software in connection with an upgrade to Release 4. The IAC Object Receiver (IACOR) must be installed for the report to execute successfully. 3.SAP AG Upgrading to 4. The report IAC_PUBLISH_SP publishes the current version in the corresponding directories of the ITS. If you install the ITS at a later time. Procedure 1.

6C Support Release 2: UNIX SAP AG Importing Additional Languages After the upgrade you have the option of importing new languages into the SAP System. and importing them during the upgrade. Importing new languages during an upgrade is a highly efficient process. or did not import any additional Support Packages after the upgrade. This is the case if you did not include any additional Support Packages in the upgrade. For more information about this procedure. In this way you can avoid any sequencing problems arising from Support Packages included in the upgrade. see SAP Note 322982. SAP recommends that you only use this option if the system contains the Support Packages for the language CD you are using. For more information. you do have the option of classifying new languages in the SAP System before the upgrade with transaction SMLT. You cannot install any new languages during the upgrade. 52 April 2001 .Upgrading to 4. see SAP Note 195442. If you intend to use additional languages in your system in the future. import them during the upgrade. However. and is preferable to importing a language into a live system after an upgrade. or Support Packages you need to import after the upgrade. The upgrade procedure itself only offers to update existing languages.

Upgrade the system with your choice of upgrade strategy. All strategies are supported (A_switch. Start PREPARE and analyze the results. then the timing and the sequence of the individual upgrades is of great importance.6x DB2 UDB 156554 Released Operating Systems R/3 4. The procedure differs according to the database you use. If you have not already done so. upgrade the operating system. We have described the process flows specifically for each database in this section. 4.com/dbosplatforms If you need to upgrade an operating system or database.sap. 2. The migration guide is a PDF document on the software CD that contains Version 6 of the database. exit it. Start PREPARE and analyze the results. 2.4x (or higher) database software.6x DB2/390 156549 Released Operating Systems R/3 4.2. If necessary.6x Oracle For more information. Repeat the PREPARE module General checks to run through the CONFCHK phase once more and if the module ran successfully. 3. update the SAP DB release.2. see the SAP Service Marketplace under: http://service. For more information. 5. or migrate a database.6C Support Release 2: UNIX Upgrading the Operating System and Database System: Overview Purpose When you upgrade the SAP System.6C on SAP DB.5.6x Informix 156548 Released Operating Systems R/3 4. April 2001 53 . Proceed as follows: 1. When you import the 7.000 for Release 4. A_on and A_off). you may have to update your operating system and database to a new version.6x SAP DB 156553 Released Operating Systems R/3 4. you change the structure of the SAP DB software. DB2 Universal Database Proceed as follows: 1. see the following SAP Notes: 156551 Released Operating Systems R/3 4. Migrate the database to Version 6 if you have not already done so. as described in SAP Note 382741. For information on which versions have been released.SAP AG Upgrading to 4. see SAP Note 327578. Process Flow SAP DB You require at least Version 7.

the release and the minimum required patch level of the Kernel are described in one of the following SAP Notes: Source Release SAP Note Number 3.1H.2 or higher. The ICLI software is delivered using PTF.3. Depending on your source release. Upgrade the system with your choice of upgrade strategy.0.LINKLIB <HLQ> is identical for all three data sets and its default value is SYS1. Database version: DB2 Version 6. 6.6C Support Release 2: UNIX SAP AG 3.SAMPLIB <HLQ>.8 or higher. The import of the current downward-compatible SAP Kernel is described in SAP Note 102445.6A. The prerequisites and preparations are described in the SAP R/3 on DB2 for OS/390 Planning Guide. 54 April 2001 . 4. stored procedures are used for DB2 for OS/390.6C ICLI server is started for the upgrade tools alongside the ICLI server of the source release. 3. Operating system of the database server: OS/390 Version 2.1I.1. Stored Procedures: 162250 162818 184399 As of Release 4. see SAP Notes 81737 and 136806 and the IBM documentation SAP R/3 on DB2 for OS/390: Planning Guide. the transports.0F. DB2 for OS/390 Make sure that you meet the following requirements before you start PREPARE for the first time: 1. 4. 5. A PTF Check Tool is available for all source releases. 4.5A.Upgrading to 4. This tool is described in SAP Note 183311. 2. 3. Current downward-compatible SAP Kernel and required transports for source release Make sure that all required transports and the minimum required patch level of the current downward-compatible SAP Kernel for the source release have been imported into your system.5B 4. Required PTFs and APARs: SAP Note 81737 (APAR list) contains information on the PTFs that you need to import before the upgrade.0B 4. ICLI: The first time you start PREPARE.6B 7. 3. 4.SFOMDATA <HLQ>. For more information. You must install this before you start PREPARE for the first time.6B. A_on and A_off). The ICLI software must be in the following three data sets after you have installed the PTFs: <HLQ>. Operating system of the application server: AIX Version 4. All strategies are supported (A_switch. a 4. Any missing PTFs can lengthen the runtime of the upgrade significantly.

import the current downwardcompatible SAP Kernel (DCK). The import is described in SAP Note 102445. 2.31 of the Informix Dynamic Servers: UNIX.1I Kernel. Oracle Version 8. Source Release 3. A_on and A_off).6C Support Release 2: UNIX Informix For information on which version of the Informix Dynamic Server you need for this release. For more precise information on the combination you use. The import is described in SAP Note 102445. Import the current Kernel patches.6C on Oracle for the majority of operating systems at the time of going to print. 3. April 2001 55 . Also use the CD SAP KERNEL from the 3. If you have not done so.SAP AG Upgrading to 4.0. This is currently the 3. import the current downwardcompatible SAP Kernel (DCK).1I upgrade package that has already been sent to you. see SAP Note 156548. Repeat the PREPARE module General checks to run through the CONFCHK phase once more and if the module ran successfully. see SAP Note 326658. Proceed as follows: 1. If you change to HP-UX 11 between executing PREPARE and starting the upgrade. Upgrade the system with your choice of upgrade strategy.0x/3. HP-UX Depending on whether you have Version HP-UX 10 or HP-UX 11. If necessary. 5. 4. All strategies are supported (A_switch. exit it. This is currently the 3.1x: If you have not done so.6 is required for Release 4.1x: If you have not done so. Start PREPARE and analyze the results. upgrade the operating system. 6. Do not import the Informix version that was mentioned in the notes for the 3. You require at least patch level 3 of the 3.1I Kernel.0x/3.1I upgrade package that has already been sent to you.1I Kernel. since older versions contain errors that cause problems in PREPARE.31 as described in the next step. 3. Also use the CD SAP KERNEL from the 3. before you start the upgrade. upgrade Informix as described in the guide Installing Version 7. since older versions contain errors that cause problems in PREPARE. If necessary.1I DCK. Start PREPARE and analyze the results. Source Release 3. Proceed as follows: 1. instead use the Version 7. then you need to disassemble the SAP Kernel from the CD again. upgrade the operating system. PREPARE disassembles the correct SAP Kernel and copies it to the directory /put/exe. 2.

End of the database-specific explanations 56 April 2001 .6C Support Release 2: UNIX SAP AG The exact procedure is described in the section Starting the Upgrade [Page 107]. 6. exit it. A_on and A_off).Upgrading to 4. 5. migrate Oracle as described in the guide Migrating/Upgrading to Oracle Version 8. End of HP-UX 4. Upgrade the system with your choice of upgrade strategy.0. Repeat the PREPARE module General checks to run through the CONFCHK phase once more and if the module ran successfully. All strategies are supported (A_switch. If you have not already done so.6: UNIX.

You check the database-specific requirements [Page 62]. if the results from its first run make you want to repeat some checks. a. April 2001 57 . If you need extra software after starting PREPARE. c. Perform the user actions needed during PREPARE. followed by the Upgrade Assistant GUI [Page 68]. You first start PREPARE [Page 66] from the CD. 3. for example.x. for example. and finally the Upgrade Assistant [Page 69] itself.x. Prerequisites You have completed the planning of the upgrade. Start PREPARE as soon as possible before the upgrade so that you can initiate or perform the necessary preparations in time. a. Process Flow 1. Careful preparation of the upgrade is the best guarantee that it will run without errors. If you want to restart PREPARE [Page 72]. In the Parameter Input module [Page 75]. 2. If you have Source Release 4. import it now [Page 74]. You perform the user actions needed before starting PREPARE. see PREPARE Phase List [Page 214]. you must check the SAP programs [Page 64]. You can reset PREPARE [Page 73] at any time.SAP AG Upgrading to 4. if you want to use it for another system. For information on using the Upgrade Assistant. c. First you start the Upgrade Assistant server [Page 67]. a. The PREPARE program supports you here by making most of the necessary checks automatically. f. For a complete list of all PREPARE modules and phases. you can execute it directly. You create an upgrade directory [Page 60]. PREPARE requires you to make certain entries for its individual modules so that it can run. If you have Source Release 3. you need to provide information about the name of the SAP System or the central SAP server. The information required in the Initialization module [Page 80] is specific to DB2 for OS/390.6C Support Release 2: UNIX Upgrade Preparations Purpose You can prepare for the upgrade while the system is operating productively. You determine a host for the upgrade preparations [Page 59]. d. b. You make sure that there are 500 MB of freespace in the database for PREPARE. b. you must check the version of the SAP Kernel and substitute it [Page 63] if necessary. see Using the Upgrade Assistant [Page 241]. You use the Upgrade Assistant to start the PREPARE program. b. e.

the language CD is mounted and the Support Packages are included in the Read CD module [Page 82]. you can begin the upgrade. b. for example. default values appear that you can confirm or change. or you check the requirements for the modification adjustment. you read the results [Page 87] in the log file CHECKS.Upgrading to 4. for example. After PREPARE has run. for example. You make preparations at the system level [Page 98]. a. If possible.6C Support Release 2: UNIX SAP AG c. You make preparations at the operating system level [Page 94]. Result Once you have made all the preparations. You perform the user actions needed before starting the upgrade. you back up the database.LOG. 58 April 2001 . You make preparations at the database level [Page 95]. Among other things. you check the user for the upgrade. d. you back up the SAP Kernel. 4. c.

For a description of these actions.6C Support Release 2: UNIX Determining the Host for the Upgrade Preparation Use You need to prepare for the upgrade on the host with the central instance. April 2001 59 . Procedure Decide which hosts you need for the upgrade preparation and the actual upgrade of the SAP System: • Host with the central instance You must execute the upgrade process and PREPARE on the host where the central instance is running. Depending on your configuration. The Upgrade Assistant server also runs on this host. see Preparations at the Database Level. you may later also need or want to use your database host or another host. • Other hosts The graphical user interfaces (GUIs) provided by the Upgrade Assistant can run on any hosts that meet the necessary requirements. • Database host You must perform the actions that affect the database on the database host.SAP AG Upgrading to 4.

Upgrading to 4. The upgrade directory is required by the PREPARE program before the actual upgrade. since it copies data and programs into the directory Prerequisites The upgrade directory must be installed on the host with the central instance. This may vary by up to 25%. These directories can also be softlinks. chgrp sapsys . depending on your database and source release. chmod 755 . Disk Space Requirements in the Subdirectories of the Upgrade Directory data 700 MB exe 250 MB log 300 MB Remaining 400 MB Total 1. if systems include extensive own developments or large amounts of individual documentation. You need free disk space for the upgrade directory on the host with the central instance. We recommend that you create the directory with more space than specified in the table above. log and other subdirectories in the upgrade directory. The following table shows the sizes of these directories. user root must create it: mkdir <upgrade directory> cd <upgrade directory> chown <sapsid>adm . and it is divided into the subdirectories data. The standard path for the upgrade directory is /usr/sap/put. you can also give it a different name. you also need to make these directories larger.6C Support Release 2: UNIX SAP AG Creating the Upgrade Directory Use The system is upgraded using the upgrade directory. This space is required for the upgrade and the logs. there are dynamic percentages in the subdirectories data and log in the upgrade directory. If you want to include Support Packages and add-ons in the upgrade. however. which can be a softlink to another physical directory. Ensure that the SAP profile parameter DIR_PUT in the instance profile of the central instance has the value <upgrade directory>. You also require an additional 300 MB in the upgrade directory for each language other than English or German.650 MB In the Repository Switch. 60 April 2001 . For more information see Using a Different Upgrade Directory [Page 207]. exe. Procedure If the upgrade directory does not yet exist.

but be empty. If softlinks to subdirectories were created. but not the contents of the directories referred to. Before you start. log on as user <sapsid>adm. you must delete the directories one by one and redefine the links. this deletes the links. Switch to the upgrade directory and delete all the subdirectories. Copy any manually created directories before deletion if you want them to be kept.6C Support Release 2: UNIX The owner of the upgrade directory and of all the subdirectories must be the SAP system administrator <sapsid>adm.SAP AG Upgrading to 4. To delete these directories as well. To make any deletions. If it already exists. cd <upgrade directory> ls -ld * (for checking purposes) rm -rf * April 2001 61 . check whether it still contains data from the previous upgrade. the new upgrade the directory must exist.

you require at least the database versions released for the year 2000.6C Support Release 2: UNIX SAP AG Checking Database-Specific Prerequisites for PREPARE When you run PREPARE for Release 4. Install the software as described in Note 303238. End of the database-specific explanations 62 April 2001 . PREPARE and R3up need the Oracle Client Software under a fixed path.Upgrading to 4.5.6C. Informix Make sure that you have at least 200 MB of freespace available in the temporary dbspaces (TMPDBSx).0. Oracle If you already use database Version 8.

Procedure Proceed as follows to substitute the SAP Kernel: 1. All files and subdirectories in /usr/sap/<SAPSID>/SYS/exe/run are overwritten when the kernel is switched. For more information.1I Kernel with patch level 3 before you start PREPARE. see the PREPARE log CHECKS. since older versions contain errors that cause problems in PREPARE.6C Support Release 2: UNIX Substituting the SAP Kernel (Source Release 3. Mount the Kernel CD.LOG. For more information. if necessary.SAP AG Upgrading to 4. Also read the section Upgrading the Operating System and Database System [Page 53]. PREPARE checks the Kernel version and prompts you to switch the SAP Kernel. see SAP Note 102445. April 2001 63 . back up the existing kernel directory. Unpack the new Kernel. Prerequisites You can combine a database upgrade with the import of the new Kernel. Stop the services SAP<SAPSID>_<INSTANCES> and SAPOSCOL.1I Kernel Version. 4. Stop all SAP programs. The following PREPARE modules require a 3. 2. In the KRN_CHK_INI phase of the Initialization module. Before substituting the SAP Kernel. 3.x) Use Make sure that you are using at least the 3.

1999 40B_COM Kernel At least patch level 425 40B_COM Kernel No special requirements 40B_COM Kernel No special requirements Required Versions of the SAP Programs for 4.x) Use Make sure that the following programs meet the specified prerequisites in the SAP Kernel directory /usr/sap/<SAPSID>/sys/exe/run of your source release. • Finding out the version of the SAP Kernel Call the program disp+work with the following command: disp+work -V 64 April 2001 . • Finding out the version of tp in Release 4.5B Call tp with the following command: tp -V The last line displays the highest patch level.0B Database SAP Kernel tp R3trans DB2 Universal Database DB2 for OS/390 Informix ORACLE SAP DB DB2 Universal Database No special requirements No special requirements At least version from February 4th.5B DB2 Universal Database DB2 for OS/390 Informix ORACLE SAP DB No special requirements At least patch level 126 No special requirements At least patch level 573. Required Versions of the SAP Programs for 4. The program displays the date and the version number. corresponding dbadaslib At least patch level 606 At least patch level 607 Procedure This enables you to find out the versions of the SAP Kernel programs: • Finding out the version of R3trans Call R3trans without options.Upgrading to 4.6C Support Release 2: UNIX SAP AG Checking SAP Programs (Source Release 4.

0B Database Location DB2 Universal Database DB2 for OS/390 Informix ORACLE SAP DB DB2 Universal Database For R3trans: 4.6C Kernel CD. Directory /<CD mount directory>/UNIX/<OS>/40B For the SAP Kernel: sapserv<X> Locations of the Correct Versions of SAP Kernel Programs for 4. You can always find the correct versions of these SAP Kernel programs on the SAP Support Servers sapserv<X>. Directory /<CD mount directory>/UNIX/<OS>/45B April 2001 65 . You can also use the following options to obtain these versions more quickly: Locations of the Correct Versions of SAP Kernel Programs for 4.5B All databases For tp: 4.6C Kernel CD.6C Support Release 2: UNIX The last line displays the highest patch level.SAP AG Upgrading to 4.

Log on to the host on which the central instance is running as user <sapsid>adm. enter SCROLL when you are prompted for the display mode. 4. Now start the Upgrade Assistant Server [Page 67]. 66 April 2001 . Enter the following commands: cd <upgrade directory> /<CD mount directory>/UNIX/PREPARE This creates a directory <upgrade directory>/ua into which the Upgrade Assistant is unpacked.OS Dependencies. 5. followed by the Upgrade Assistant GUI [Page 68]. Log on to the Upgrade Assistant GUI as the administrator and restart PREPARE [Page 72]. The necessary commands can be found in the specific chapters for the operating system in the manual SAP Software on UNIX . 3. Procedure 1.6C Support Release 2: UNIX SAP AG Starting PREPARE from the CD Prerequisites • • You have met the requirements for PREPARE. see the section Executing PREPARE and R3up in Scroll Mode [Page 201]. Mount the CD SAP Kernel. If you want or have to run PREPARE in scroll mode. You have made the met the database-specific requirements for PREPARE [Page 62]. Make sure that the database and the SAP System have been started up. For information on how to activate scroll mode when you restart PREPARE. Confirm the prompt of the display mode with the default EXIT. 2.Upgrading to 4. We recommend that you use the Upgrade Assistant. This ends the program PREPARE.

Procedure 1.6C Support Release 2: UNIX Starting the Upgrade Assistant Server Prerequisites You must start the program PREPARE once from the CD. Open a new window at the operating system level as user <sapsid>adm: 2. Enter the following command: jre -cp <upgrade_directory>/ua/ua.jar UaServer April 2001 67 .SAP AG Upgrading to 4. This creates the subdirectory ua in the upgrade directory and disassembles the Upgrade Assistant in this directory.

Use the following URL to display the contents of the upgrade directory: http://<host_name>:4239 Starting the GUI on Windows Hosts 1. enter the following URL: http://<host_name>:4239/ua/UaGui. 2.Upgrading to 4. Starting the GUI from the Internet Browser To start the GUI from a browser.jar UaGui 68 April 2001 . you must copy the file uagui. You need to enter the full Internet name. 2. So that the GUI can also be used on other hosts.wdf.html Replace <host name> with the name of the host on which the Upgrade Assistant is running. The procedure depends on the host on which you are starting the GUI of the Upgrade Assistant.jar UaGui When using the Microsoft Virtual Machine: jview /cp <UaGuiDir>\uagui. Open a new window as user <sapsid>adm: 2.sap-ag. Start the GUI as follows: jre -cp <upgrade_directory>/ua/uagui.jar from the upgrade directory on this host to a directory <UaGuiDir> or mount it with NFS. hw1156.jar UaGui Starting the GUI on Other UNIX Hosts 1.6C Support Release 2: UNIX SAP AG Starting the Upgrade Assistant GUI Prerequisites The Upgrade Assistant server must be active [Page 67]. for example. Start the GUI in a command prompt as follows: When using the Java Runtime Environment (JRE): jre -cp <UaGuiDir>\uagui.jar from the directory <UpgDir>/ua on this host to any directory <UaGuiDir>.de. So that the GUI can also be executed on other hosts. Start the GUI as follows: jre -cp <UaGuiDir>/uagui. We recommend that you call the GUI from an Internet browser. copy the file uagui.jar UaGui Starting the GUI on UNIX Hosts Starting the GUI on the Host with the Central Instance 1.

you can leave the field Host name empty. Do not change the default value 4241 in the field Port number. the following connect screen appears: 1. Procedure If you did not start the GUI from an Internet browser.56.33 2. 3. Example of the format for the host name: hw1156 hw1156. In the field Host name.SAP AG Upgrading to 4.6C Support Release 2: UNIX Starting the Upgrade Assistant Prerequisites The Upgrade Assistant and the Upgrade Assistant GUI are already started. enter the name of the host where the central instance is running.wdf.202.sap-ag.de 155. You see the following screen: April 2001 69 . If you want to start the GUI and the server on the same host.

The initial passwords for the two roles are as follows: Role Initial Password admin observer Administrator Observer After logging on. you must enter a password that specifies if the GUI has the role of the administrator or the observer. In the fields User name / Phone number.Upgrading to 4. In the field Password.6C Support Release 2: UNIX SAP AG 4. 5. the following window appears with the main menu: 70 April 2001 . enter your personal information.

6C Support Release 2: UNIX April 2001 71 .SAP AG Upgrading to 4.

Select Administrator → Start PREPARE.6C Support Release 2: UNIX SAP AG Restarting PREPARE from the Upgrade Assistant GUI 1. some are optional. PREPARE must run through all mandatory modules before you start the actual upgrade. Make sure that the Upgrade Assistant server is active. Log on to the GUI.Upgrading to 4. 4. 72 April 2001 . Start a GUI as described under Starting the Upgrade Assistant GUI. A successfully executed module has the status succeeded. 3. You can select which modules you want PREPARE to run through on one of the following screens. Some modules are mandatory. 2.

April 2001 73 . If you have already triggered initialization in transaction ICNV. If you reset PREPARE between the phases mentioned above. but do not want to upgrade the system. then you have to reset PREPARE. In the following cases.SAP AG Upgrading to 4. you must perform the remaining phases up to at least NPREPCRE0 before you reset PREPARE. you can only reset PREPARE under certain conditions: • If PREPARE in the Import module is between the phases TOOLIMPD1 and NPREPCRE0. • Procedure 1. the command reset prepare does not reset these initializations. errors occur when you restart PREPARE. Enter the following commands as user <sapsid>adm: cd <upgrade_directory>/bin R3up reset prepare 2.6C Support Release 2: UNIX Resetting PREPARE Use If you have already executed PREPARE more than once. Delete the contents of the upgrade directory so that it has the same status it had the first time PREPARE was started [Page 66].

or add-ons (and add-on updates).6C Support Release 2: UNIX SAP AG Importing Software After Starting PREPARE Use After you start PREPARE.Upgrading to 4. 3. you may need to import software. 2. Start PREPARE again from the CD and repeat the required and optional modules. such as Support Packages. Reset PREPARE as described in the section Resetting PREPARE. 74 April 2001 . Procedure 1. languages. Import the required software.

6. Here you have to decide whether you want the upgrade to stop before the JCL job is executed. Data set for DSNTIAD library Enter the name of the data set that contains the DSNTIAD library. Stop before execution of the JCL job Several JCL jobs are executed during PREPARE and the upgrade. for example 00 Host name of the central SAP server Path to the SAP start and stop procedure (default is the home directory of user <sapsid>adm) Path to the active SAP Kernel Instance name of the database DB2 for OS/390 You are now prompted to make the following entries: 1. Default entries appear where possible. Confirm or change the default entry. User who starts the ICLI server Enter the name of the user who starts the 4. These jobs can also run at night. JCL Submission Service test Make the following entries as part of the JCL Submission Service test: − − MESSAGECLASS TCP/IP name of the database host April 2001 75 .6C ICLI server. so that you can make corrections to the job. Procedure The following parameters of your system are prompted (INITPUT phase): • • • • • • Name of the SAP System (<SAPSID>) Number of the instance. 4. 5. Data set for LOAD library Enter the name of the data set that contains the LOAD library. in particular RUNSTATS during the table import. 2. DB2 subsystem name Enter the name of the DB2 subsystem.SAP AG Upgrading to 4.6C Support Release 2: UNIX Making Entries for the Parameter Input Module Use PREPARE needs certain information from you so that it can run the Parameter Input module. For a list of the necessary entries for this PREPARE module. 3. The default name is ICLIRUN. see below. The name of the phase is given in parentheses to help you. You always have this option if the JCL job produces errors.

You are asked if you want to use this option. If you are working in scroll mode use ENTER to skip the prompts for extra mount directories. You can also use a job to start and stop the ICLI server (without any user action). 9. 76 April 2001 . You need at least 15 MB for this. Stop and start the ICLI server for each job In the TABUIMP_BAS phase. The OS/390 user (step 6) needs write and read authorization for this directory. R3up prompts you to specify a mount directory or to change the CD. Whenever necessary. 8. saposcol and librfc) to OS/390 while PREPARE is running.6C Support Release 2: UNIX SAP AG − − OS/390 user Password of the OS/390 user 7.6C ICLI servers.Upgrading to 4. • Temporary upgrade directory on OpenEdition You must create this directory now.6C ICLI PTF As part of the installation of the 4.6C ICLI server under this port number. in addition to the instance of the source release’s ICLI server. High level qualifier for 4. you do not have to enter any other mount directories. End of DB2 for OS/390 • • Host name of the database server Mount directories for CDs If you have only one CD drive. SAP software components You are asked whether you want to import some SAP software components (rfcoscol.6C ICLI server you must enter the High Level Qualifier under which the 4. Port number You are prompted to enter a port number for an instance of the 4. You can stop it again after the upgrade. You can also install this software as described in SAP Note 103135. see SAP Note 136806. you are asked to adjust the corresponding jobs. If you confirm this option. You are then prompted to start a 4. You can delete this directory after you complete the upgrade. If you confirm this prompt. 10. For more information. The OS/390 user (step 6) needs write and read authorization for this directory. This instance is needed during the upgrade only. you need to make the following entries: • • Program ID Specifies the TCP/IP connection used by rfcoscol saposcol-/rfcoscol directory Directory in which saposcol and rfcoscol are installed. you must stop the ICLI server of the source release and start the ICLI server of the target release.6C ICLI PTF was installed.

see Drawing Up an Upgrade Schedule [Page 32]. • Language key Enter E or D to define whether the help texts displayed by R3up in error situations appear in English or German. Add-Ons The other CDs in the upgrade package are not required by PREPARE or R3up. DB2 Universal Database • Update database statistics To avoid lock situations and any resulting problems during the upgrade. see the file README on the CD. you now have the chance to update the database statistics for tables and indexes. to import a new version of the database system. PREPARE and R3up require the following CDs as well as the SAP Kernel CD: Additional CDs CD Title Upgrade CD1 Upgrade CD2 Upgrade CD3 Upgrade CD4 Upgrade CD5 Language Disc Optional CDs CD Title Language Disc for your chosen language Add-On CDs Contents Transport requests imported during the upgrade (PREPARE) Transport requests imported during the upgrade (PREPARE) ABAP loads and transport requests imported in the upgrade (PREPARE/R3up) Transport requests imported during the upgrade (R3up) Transport requests imported during the upgrade (R3up) Standard languages English and German (PREPARE/R3up) Contents Languages other than English and German For the exact contents.6C Support Release 2: UNIX If you have more than one CD drive or you are able to copy the contents of the CD to disk. We recommend the 3 processes for machines with 512 MB main memory. enter all the mount directories used. However. we only advise you to do this if: − − you update the statistics regularly you already generated statistics the last time you ran PREPARE April 2001 77 . You can change your entries each time you run PREPARE or R3up.SAP AG Upgrading to 4. Up to 4 parallel import processes are possible for multiprocessor hosts with sufficient main memory. • Number of parallel import processes The number of parallel processes used by R3trans to import data into the database. but by other programs within the upgrade. For more information on using multiple CD drives. for example. You can skip this step.

PFL profile The DEFAULT. • Host name of the background server Normally a background service is available on the central instance. Check whether the password is correct by logging onto the system. R3up asks you to verify the password by entering it a second time. You can check this with transaction SM51. choose MEDIUM. see the start profile for the correct name. Password of user DDIC in the system. If you do not know the state of the database statistics.PFL can be found in directory /usr/sap/<SAPSID>/SYS/profile. 78 April 2001 . the background service may be elsewhere to improve load distribution. • Path of the DEFAULT. In this case. client 000 This password is needed for the RFC connection to the system. If it is not correct. If in doubt. However. Also make sure that the upgrade directory is mounted on the host with the background service. in larger systems.6C Support Release 2: UNIX SAP AG At the beginning of R3up (actual upgrade). enter the host name and the name of the relevant application server. If in doubt. see the script startsap for the correct name of the start profile. • Path and name of the profile of the central instance The profile for the central instance is also in the directory /usr/sap/<SAPSID>/SYS/profile and usually uses the following naming convention: <SAPSID>_DVEBMGS<instance number>_<host name> You must check here whether your default value is correct. End of DB2 Universal Database • Name of the SAP start profile The SAP start profile is used in the SAP start procedure and is in the general profile directory /usr/sap/<SAPSID>/SYS/profile. change it. Long runtime. You have the following options: MEDIUM HIGH = tables with cardinality = -1 or with cardinality = 0 (and any corresponding indexes) = all tables (and any corresponding indexes).Upgrading to 4. and that the background server can process background jobs of class C. you have another opportunity to update the statistics. It meets the following naming conventions: START_<instance name><instance number>_<host name> START_DVEBMGS00_hsi027 Always check that the default value is correct.

R3up must wait for this length of time at certain points during the upgrade so that all the instances are synchronized. If the time entered is too short. the local system log of the central instance and the central system log are renamed in a kernel substitution (KX_SWITCH phase). Check this value and correct it if necessary. This action cannot be performed automatically. in which users can make unchecked changes. • Directory for the local system log This is the local system log for the central instance. 60 seconds is entered for the bufreftime parameter in the instance profiles of the servers. April 2001 79 .6C Support Release 2: UNIX The server you select must be available for background operations round the clock. • The greatest synchronization time of the buffers of all the application servers Usually. time intervals might occur. Path to the EPS inbox The default value is proposed.SAP AG Upgrading to 4. For this reason. The system logs are recreated the next time the system is started with the new release. If you run the system with multiple application servers. Check the active operation modes with transaction SM63 to find out if it satisfies this requirement. The SAP Kernel of Release 4.x cannot read the system log of older releases since the format changed as of Release 4. you must manually rename the local system log of this remote server (see Renaming the Local System Log [Page 150]). • • Directory for the central system log See Directory for the local system log above. it is important that the largest value of all the profiles is defined here. If you installed several instances.x.

5B and later.pfl into the existing stogroups of the source release database layout. For source releases 4. The following lines contain information on the disks whose IDs are specified behind volume. the file volumes. The volumes. the disk ID. The volumes.6C Support Release 2: UNIX SAP AG Making Entries for the Initialization Module Procedure DB2 for OS/390 Depending on the source release. The first line without comments contains the characters VCAT and the disk catalog ID.smp. you may need to create new stogroups in the database. and then adapt it to the local hardware configuration. see Note 197772. You also have the option of inserting the volumes from volumes. #-----------------------# FILE: VOLUMES. the stogroups needed for the database layout of the target release are created with the volumes defined in the file volumes.pfl in the sub-directory bin of the upgrade directory contains the following disk entries: # volume VOLUME-ID '*' The following is an example of a sample file for the SMS: 80 April 2001 . you are prompted to create this file using the sample file volumes.pfl into the existing stogroups of the source release database layout. • For information on the amount of disk space needed in the database.pfl file contains the VSAM catalog ID and the disk ID.pfl to the sub-directory bin of the upgrade directory. To do this.0B. • For source releases up to and including 4.pfl file does not exist when PREPARE starts.SMP #-----------------------# VCAT-ID VCAT DSNOOE # VOLUME-ID volume DB2069 volume DB206A volume DB206B #------------------------ You must copy this volumes.smp in the sub-directory bin of the upgrade directory. The database layout was changed in Release 4. In the first SPACECHK phase.5A. VOLIDs). The Database Administration Guide describes the new database layout for the target release. you need information about the local hardware configuration (SMS/NON SMS. you have the option of inserting the volumes defined in the file volumes. R3up creates the following sample file volumes. If the database uses disks managed by the Storage Management System (SMS).Upgrading to 4. or extend existing stogroups.pfl .

SAP AG Upgrading to 4.PFL #----------------------------# VCAT-ID VCAT DSNOOE # VOLUME-ID volume '*' #----------------------------- End of DB2 for OS/390 April 2001 81 .6C Support Release 2: UNIX #----------------------------# FILE: VOLUMES.

If you have not installed any add-ons. A password is required for this alternative. and any add-ons that may have been added manually. You need to do this even if only the standard languages English and German are installed in your system. Phase IS_CHK You are asked if any add-ons are installed that are not automatically recognized. Legal Change Patches) are confirmed. see Importing Additional Languages [Page 52].6C Support Release 2: UNIX SAP AG Making Entries for the Read CD Module Procedure Phase LANG_SELECT You are prompted to mount the language CD. • Keep the present version of the add-on Only choose this alternative if the vendor of your add-on has confirmed that you can do this without losing data. If you exclude a language. you can exclude certain languages from the upgrade. it is possible to install additional languages during the upgrade. The standard languages are always imported. The following alternatives are offered for each add-on: • Upgrade the component with the CD for the add-ons When you choose this alternative. • Delete the add-on You can only choose this alternative if your add-on supplier has confirmed that this does not cause any problems. For more information. you are asked to insert the corresponding CD. In principle.0E and R3up is unable to determine a standard setting for the territory of your system. Phase IS_READ All add-ons appear that are found in the IS_CHK phase. Phase LANG_CHK If you have a source release lower than 3. 82 April 2001 . Phase PATCH_CHK3 The system tests to see if all the Support Packages (previously known as Hot Packages. confirm the prompt with nothing else. you cannot work in this language after the upgrade. If you have installed languages other than the standard languages. you are prompted to make the relevant changes.Upgrading to 4. The data is copied to the upgrade directory.

6C Support Release 2: UNIX Unconfirmed Support Packages are displayed on the screen and in the PATCHOUT. you need a Package Key as of 4. All software components appear whose Support Package level is more up-to-date than the status of the software components on the upgrade CD. the R/3 HR Support Packages already imported into your SAP System are canceled and data is lost. SAP Note 73510 specifies which R/3 HR Support Package in the target release is equivalent to your current state. you can find information about including the corresponding Add-On Packages or Conflict Resolution Transports in the SAP Note for the Add-On Supplement CD. Reimporting the R/3 HR Support Packages in the target release does not solve this problem. If you use SAP HR.6. However. If you upgrade your system without doing this.SAP AG Upgrading to 4. and all released Basis Support Packages. If you use an add-on component. you must include the HR Support Packages. This means that your system is completely up-to-date after the upgrade. For information on this and on other subjects. You can include the Support Packages for multiple software components in this phase. the overall runtime of the upgrade is reduced. If the source release contains Support Packages that are more recent than those in the delivered target release.6C Support Release 1. we recommend that you always include all available Support Packages for the target release. If R3up displays a warning that your Support Package level is too up-to-date and you want to include Support Packages in the upgrade. To include Basis Support Packages. Confirm these Support Packages with transaction SPAM. ACT_46C. TABIM_46C and XPRAS_46C increases. We recommend that you include all existing R/3 HR Support Packages in phase BIND_PATCH (see the next section) of the upgrade. As of Release 4.LOG file in the log subdirectory of the upgrade directory. a warning appears that informs you which Support Packages these are. see SAP Note 119738. One disadvantage of including Support Packages in the upgrade is that the runtime of the upgrade phases SHADOW_IMPORT_REP. then you need to do this in the next phase BIND_PATCH. April 2001 83 . the Hot Packages and Legal Change Patches are divided into several subpackages: • Hot Packages: − − − Basis Support Packages (software component SAP_BASIS) Cross-Application Support Packages (software component SAP_ABA) R/3 Support Packages (software component SAP_APPL) • Legal Change Packages: − − − − Basis Support Packages (software component SAP_BASIS) Cross-Application Support Packages (software component SAP_ABA) R/3 Support Packages (software component SAP_APPL) R/3 HR Support Packages (software component SAP_HR) In this case.

R/3 Frontend using transaction SPAM. Use the following command to unpack the archive that contains the Support Packages: Operating system Command SAPCAR -xvf /<CD_DIR>/<PATH>/<ARCHIVE>.15 1 .6C Support Release 2: UNIX SAP AG Phase BIND_PATCH You can include the Support Packages for the target release in this phase. you can find details about the archives and their paths in the readme file on the CD. If you choose this method. skip points 2 through 4 and proceed from point 5. Log on as user <sid>adm.15 1 .19 If you want to include additional Support Packages. 3. Download the Support Packages of the target release. the following Support Packages are already included in the upgrade: Component Support Package SAP_BASIS SAP_ABA SAP_APPL SAP_HR 1 .SAR UNIX Windows NT If you want to download the archives from a Support Package Collection CD. Switch to the following subdirectory in your system: Operating system Subdirectory /usr/sap/trans <DRIVE>:\usr\sap\trans UNIX Windows NT 4. Check whether the unpacked Support Packages are in the EPS Inbox of your transport directory: Operating system EPS Inbox of the transport directory /usr/sap/trans/EPS/in <DRIVE>:\usr\sap\trans\EPS\in UNIX Windows NT 84 April 2001 .Upgrading to 4. following its instructions 2. proceed as follows: 1. from the SAP Service Marketplace. following the instructions in SAP Note 83458 from a Support Package Collection CD. 5.15 1 . You can download the Support Packages in one of the following ways: − − − from SAPNet .6C Support Release 2. When you upgrade to 4.SAR SAPCAR -xvf <CD_DRIVE>:\<PATH>\<ARCHIVE>.

If you want to cancel the selection for a software component completely. The Package Keys are in SAP Note 119738. Phase ADJUSTPRP If you want to execute PREPARE in a target system and you made preparations for an automatic modification adjustment in the first system. you can use a single change request to avoid losing data. When you confirm the confirmation prompt you integrate all Support Packages up to the specified level into the upgrade for the selected components. You cannot include SPAM Updates in the upgrade. Answer the prompt about searching for new Support Packages with Search. The modification adjustment function ignores this request. Enter the Support Package level you want for your various software components. 8.SAP AG Upgrading to 4. All you need to do is overwrite the default Support Package level.0B: If you want to include Conflict Resolution Transports as well as Add-On Support Packages for Add-On components. Whether you have the option of including Conflict Resolution Transports (CRTs) or Collective Conflict Resolution Transports (CCRTs) in the upgrade depends on what is written in the SAP Note for the particular add-on component. call Transaction ICNV and choose Information. Phase ICNVREQ_PRP If PREPARE determined candidates for incremental table conversion (ICNV). You no longer need to reset PREPARE to reduce the number of Support Packages that you want to include. In certain situations. make sure that these packages are also in the EPS Inbox. 6. answer Yes to the prompt about including Support Packages in the BIND_PATCH phase. select the appropriate field if you are using the Upgrade Assistant. Any Support Packages that you cannot include in the upgrade must be imported into the system after the upgrade. 9. you are prompted to start transaction ICNV. you are prompted to choose a request. or enter NONE if you are using scroll mode. It may take a few minutes to unpack the Support Package data. you also have the option of including a single change request. April 2001 85 . You can skip this step with Skip if you have not downloaded any new Support Packages since the last time you searched. Using the single change request function is risky. If you want to include (more) Support Packages for your various software components. You need a Package Key to include a Basis Support Package in the upgrade.6C Support Release 2: UNIX For Source Release 4. For an online description of how to use this transaction. 7. Only use this function if the owner of the request can guarantee that it is compatible with the upgrade. As well as the software components.

Call the steps Initialization and Data Transfer in the ICNV only when all PREPARE actions. 86 April 2001 .6C Support Release 2: UNIX SAP AG If you do not want to use this option. in particular the inclusion of Support Packages. If you reset PREPARE. have been completed. see Planning the Upgrade → Incremental Table Conversion. For more information on incremental conversion. the tables are converted during downtime. this does not cancel any modifications made by initializing the ICNV.Upgrading to 4.

For more information. This file is located in the sub-directory log of the upgrade directory. The procedure is described in the following database-specific sections.exeauto Use if Multiple SAP instances are installed for this system (<SAPSID>) one SAP instance is installed for this system (<SAPSID>) Also make sure that the parameter rdisp/bufrefmode is not set in the instance profile.exeauto sendoff. PREPARE writes its results to the file CHECKS.SAP AG Upgrading to 4.LOG. Add the space that you will need for additional data before you actually upgrade the system. If you have distributed application servers that do not use NFS to share access to the profile of the central instance. Each run of PREPARE generates a header entry containing the text Starting new execution of PREPARE modules <modulename> at <time_stamp>. This is followed by the PREPARE results. The entries in the file CHECKS.PFL: Value sendon.6C Support Release 2: UNIX Evaluating the Results of PREPARE Use As mentioned in the section PREPARE [Page 212]. The incremental conversion is not yet finished from a previous upgrade. enter the value sendon. Procedure Most of the entries are self-explanatory. The parameter rdisp/bufrefmode must have on of the following values in the profile /usr/sap/<SAPSID>/SYS/profile DEFAULT. information or prompts for user action. The extensions required are specified in a table in CHECKS. You can find information and procedures for the other entries in the following: • Incremental conversion is not completed.LOG.exeauto in each local DEFAULT. April 2001 87 .PFL and make sure that the parameter rdisp/bufrefmode is not set in the local instance profile. see the online help for ICNV.LOG can be error messages. The data for the new release cannot be imported into the existing space in your database. Call transaction ICNV and finish incremental conversion. Use Transaction ICNV to lock this conversion. • The buffers of your R/3 instance are not automatically validated. • Insufficient freespace in the database as follows: The new release needs more space in the database.

you should have roughly the same size freespace 88 April 2001 . If you moved tables with delivery classes other than “L” to your own dbspaces. Create the new dbspaces as required by PREPARE. DB2 Universal Database Extend the listed tablespaces by at least the specified values.2 increases the page size of a database page from 4 KB to 8 KB. you can use the DB2 administration tools or a DB2 Command Line Processor Template generated by PREPARE (see file CHECKS. Informix Extend the listed dbspaces by at least the specified values. For an exact description. These are always the following dbspaces for the Repository Switch: psapes<rel> psapel<rel> <rel> stands for the current target release (lower case). The required freespace is based on the database version you are currently using. you must take the following restrictions into consideration when creating the new tablespaces (in the order they are listed): − − − Different containers of a tablespace should be located on different (physical) disks. Create the new tablespaces as required by PREPARE. Corresponding index and data tablespaces should not be on the same disk.LOG). You can find information on extending and creating dbspaces in the SAP online documentation on database administration for Informix. Database Release 7. When you create the dbspaces. These are always the following tablespaces for the Repository Switch: PSAPES<Rel>D PSAPES<Rel>I PSAPEL<Rel>D PSAPEL<Rel>I <Rel> stands for the current target release. For performance reasons. You can find more information in the SAP online documentation on database administration for DB2 Universal Database.6C Support Release 2: UNIX SAP AG SAP DB To extend your database. The space check is made at the dbspace level. see Note 34690.Upgrading to 4. create a new devspace with the database tools. To create or extend tablespaces. make sure that they are not located on the same disk: This improves performance. PSAPES<Rel>D and PSAPEL<Rel>D must not be on the same disk.

AIX If the AIX user parameter fsize (=maximum filesize) is set to the default value of 1 GB for the user ora<sapsid>. Choose a low degree of fragmentation when you create tablespaces. You can overwrite these values. Otherwise <sapsid>adm is unable to start up the database after large tablespaces have been created. - We recommend the following combination: Disk 1: PSAPES<Rel>D and PSAPEL<Rel>I Disk 2: PSAPEL<Rel>D and PSAPES<Rel>I To extend and create tablespaces. You can find further information in the SAP online documentation on the program sapdba. however. Where necessary. A typical example is moving the ATAB from the dbspace psappool. Avoid fragmenting the database too strongly. Note that the parameter fsize is increased by the same amount for the user <sapsid>adm. These are always the following tablespaces for the Repository Switch: PSAPES<Rel>D PSAPES<Rel>I PSAPEL<Rel>D PSAPEL<Rel>I <Rel> stands for the current target release. you must meet the minimum requirements of the list. increase the value of fsize. For performance reasons.SAP AG Upgrading to 4. You can now create tablespaces with sapdba. End of AIX sapdba suggests other values for the extension than those specified in the list. you must take the following restrictions into consideration when creating the new tablespaces: - index tablespaces and data tablespaces that belong together must not be on the same disk. Create the new tablespaces as required by PREPARE. use the program <upgrade_directory>/exe/sapdba as user ora<sapsid>. Be generous when you extend existing tablespaces. Oracle Extend the listed tablespaces by at least the specified values. April 2001 89 . error messages are issued if tablespaces greater than 1 GB are created. Reboot your AIX System to activate the new values.6C Support Release 2: UNIX available in these dbspaces as in the original dbspaces of the tables. and must not be in the same sapdata directory PSAPES<Rel>D and PSAPEL<Rel>D must not be on the same disk.

APO Support Packages and so on. For information on this. The programs that are affected are listed in the lines ERROR> No write permission for file <executable>. Note 62519 gives you possible solutions to this problem. These open repairs cannot be released in the normal manner. End of the database-specific explanations • In Release <rel> you applied the following unconfirmed patches to your system. add (n . For more information. otherwise the import of the substitution set will terminate. where n is the number of fragments. since the objects contained in them are locked.6C Support Release 2: UNIX SAP AG For the tablespace PSAPES<Rel>D.Upgrading to 4. 90 April 2001 . If you have to create a tablespace in more than two fragments. see Releasing Open Repairs and Requests [Page 208]. see the Online Documentation under Help → SAP Library → Basis Components → Change and Transport System → Language Transport. Their numbers are listed. you must release and confirm all the open repairs and requests listed by PREPARE. Correct this by changing the authorizations or the owner. for security reasons. R/3 HR Support Packages. such as R/3 Support Packages. BW Support Packages. Use the Transaction SPAM to confirm these Support Packages before the upgrade. then this system was created by a database copy. • no write permission on <file name>: The specified file in the directory of user <sapsid>adm cannot be overwritten because the authorizations were not correctly set or the owner of the file is not <sapsid>adm. If open repairs that do not belong to this system are displayed. Also check the extent structure of the tables. We do not recommend that you give write authorization to others. you must either change the group or add the user <sapsid>adm to the group temporarily. Before you begin upgrading. There are unconfirmed Support Packages in your system. • Release these open transport requests and repairs: Modifications can be lost if open repairs are ignored There are locked SAP objects in open repairs and/or requests in your system. create at least one data file with 2 GB. Change the write authorization with: chmod ug+w <executable> If the program does not belong to the group sapsys. • Change the permission of these executables: You must be able to overwrite the programs of the old SAP Kernel to be able to copy the new SAP kernel to the directory /usr/sap/<SAPSID>/SYS/exe/run during the upgrade.2) * 100 MB to the total size of the tablespace.

tp informs you in this file about any problems during processing. The list in CHECKS.Basis Components → Change and Transport System → BC ... • Restart logs of DB conversions found. The 14th character is an 'X' in one of the two names and is empty in the other.. TRBAT entry indicates that a batch job is running. First try to process the TRBAT entries from /usr/sap/trans/bin with the following command: tp getprots <SAPSID> Running imports or exports are not affected. Entries found in this table by R3up may be the remains of a terminated or running import or export. Corrupted TRBAT entry found.. Use Transaction SM31 to delete any entries in TRBAT that cannot be processed and that are no longer needed.x: Help → R/3-Library → BC .<SAPSID> where <YY> is the year (2 digits) and <WW> is the calendar week (2 digits).6C Support Release 2: UNIX You must log on to the system under the name of the relevant owner to release and confirm the open repairs. Do not delete entries for running imports or exports during production operation. The transport control program tp uses the table TRBAT to communicate with the SAP System. April 2001 91 .Basis →=System Administration → Transport Control → Transport Control Program tp in Release 4. ... Determine and clean up entries for terminated imports or exports during the upgrade preparations.. Clean these up as described under Cleaning Up Terminated Conversions in the DB Conversion Phases [Page 179]....Transport Tools → Transport Control Program tp • The following indexes <number> were read: Indexes whose names are identical up to the 14th character were found in a table belonging to the substitution set. This is an inconsistency and would result in an error during the import of the substitution set.. Outstanding DB conversions found.x: Help → SAP Library → BC . TRBAT entry indicates that a batch job has finished.. You can monitor the tp monitor file with the following command: tail -f /usr/sap/trans/log/SLOG<YY><WW>. ...... You can find more information about the transport control program tp in the SAP Library: Choose in Release 3.LOG contains these names. .. Your system contains outstanding conversions and restart logs of terminated conversions.SAP AG Upgrading to 4. • Unresolved request found in TRBAT.

DB2 Universal Database • DATABASE ERROR: There is an inconsistent index in your database: Index SQL<nnnnnnnnnnnnnnn> on table <TABNAME> The information about the primary index names was lost and was replaced with a name generated by the database system because the IBM export/import tool was used. 92 April 2001 . To do this. • Update records still exist . 2. Choose all the update requests. Terminated or outstanding updates have to be followed up or deleted in all clients. If you are still in the preparation phase (PREPARE) and therefore in production operation.<TABNAME> drop primary key" 3. Log on to the system as user DDIC and start Transaction SE14. Log on as user <sapsid>adm. If you need the table data later. Enter the following command: db2 "alter table sapr3. Therefore .. Repeat this check when the system stops operating productively (see Isolating the Central Instance [Page 202]). since otherwise table or index modifications could terminate. Use the SAP DB tool xcontrol to give MAXLOCKS the correct value. Consult a Basis consultant. 2.. The views will be created in this upgrade.please process Make sure that you have cleaned up all outstanding updates by the phase JOB_RSVBCHCK3 (during downtime) at the latest. These must be cleaned up before you start the upgrade. 3. Reconstruct the primary index (index ID 0) on the database. Start Transaction SM13. user and time. you must first make a backup. Delivered views may have names identical to the names of customer tables in the SAP namespace. Delete the default values for the client. proceed as follows: 1. You must delete these tables.Upgrading to 4. SAP DB • Insufficient DB parameter MAXLOCKS. To determine the terminated or outstanding updates. you only have to delete the terminated updates.6C Support Release 2: UNIX SAP AG The index with the 'X' at the 14th position can only have occurred in a Repository Switch or have been created outside the SAP System. • The following database tables have names that are identical to names of Basis views. proceed as follows: 1. The changed parameter only becomes active after you have stopped and started the database.

2. ---> Set the parameter to <new value>. Log on as db2<sapsid> and start up CLP with db2. The parameters do not become effective until the database is restarted. Proceed as follows: 1.SAP AG Upgrading to 4. End of the database-specific explanations April 2001 93 .6C Support Release 2: UNIX • DATABASE ERROR: The value <old value> of <param> database configuration parameter is too low. shut down the database with stopsap db and start it up again with startsap db. Certain database parameters are set too low for the upgrade. To do so. Set the parameter(s) to the required value. Increase <param> with the following command: update db cfg for <sapsid> using <param> <new value> 3.

6C Support Release 2: UNIX SAP AG Making Preparations at the Operating System Level Backing Up the SAP Kernel During the upgrade. Make a backup copy of these programs to guarantee this. Backing Up the Scripts for Starting and Stopping the SAP System During the upgrade. so that you can repeat the modifications after the upgrade. /install/os_version/Relia=SINIX 2. the scripts for starting and stopping the SAP System are substituted so that they correspond to the new release. Making Operating System-Specific Preparations ReliantUNIX You must change the instance profiles of all the SAP instances. End of ReliantUNIX 94 April 2001 .Upgrading to 4. /install/os_version/ReliantUNIX=SINIX 3. These profiles are in the directory /usr/sap/<SAPSID>/SYS/profile and usually stick to the following naming convention: <SAPSID>_<instance name><instance number>_<host name> Insert the following parameters: 1. If you have modified the standard scripts. you must back up the scripts before you upgrade. Make sure that you can recover the old Kernel if this becomes necessary. see the SAP Notes 39473 and 39475. Depending on the operating system setting displayed with the command uname. the SAP Kernel programs are replaced under /usr/sap/<SAPSID>/SYS/exe/run. also insert one of the following parameters: /install/os_version/ReliantUNIX-Y=SINIX (or (or /install/os_version/ReliantUNIX-M=SINIX) /install/os_version/ReliantUNIX-N=SINIX) For more information.

As of Source Release 4.6C Support Release 2: UNIX Making Preparations at the Database Level Backing Up the Database Make sure that you can reset the database to the state it had before the upgrade by using an existing database backup.indexes to user sapr3 DB2 for OS/390 We recommend that you update the statistics before the upgrade.SAP AG Upgrading to 4. April 2001 95 . Log on as user <sapsid>adm at the operating system level. Out-ofdate statistics can increase the runtime of the upgrade significantly. Check the value of the parameter shared_pool_size in the file $ORACLE_HOME/dbs/init<SID>. You must back up the log when you isolate the central instance. End of Oracle Making Database-Specific Preparations SAP DB For the upgrade. increase it to at least 50 MB and restart the database.tables to user sapr3 grant update on table sysstat. 2.ora. Oracle 1. If the value is lower than 50 MB. change the database parameter MAXUSERTASKS. Oracle You can find detailed information about making backups as well as about the programs brbackup and brarchive in the SAP online documentation on database administration for Oracle. Enter the following commands: grant update on table sysstat. DB2 Universal Database User sapr3 needs additional authorizations for updating the statistic values.0B: Make sure that the statistics are up-to-date for all tables.columns to user sapr3 grant update on table sysstat. Proceed as described in the section Oracle: Actions → Updating Statistics. see the section Planning the Upgrade Strategy [Page 20]. For a description of the upgrade strategies that you can choose from. Determine the number of started disp+work processes with Transaction SM50. Change MAXUSERTASKS for the upgrade so that it is at least 3 larger than the number of started disp+work processes. SAP DB We recommend that you make a complete backup of the database before upgrading. The procedure is described in Note 113008. The changed parameter only becomes active when the database is stopped and started.

The index names are not constant. The script psaptemp.adm='YES' grantee='SAPR3'. This procedure avoids upgrade errors caused by overwriting the executables during the upgrade.. 96 April 2001 . If your database version is already higher than the minimum version for the new release. 6. 7. This script sets the value of MAXEXTENTS for the tablespace PSAPTEMP to UNLIMITED.. Source Releases 3. c.0x/3. 10. Note 201874 contains the tables and the required minimum values. After the upgrade.. enter the SQLPLUS command: grant unlimited tablespace to sapr3. Otherwise. you can also determine these names with sapdba. Log on to the database as the Oracle user system with sqlplus (default password is manager). Log off the database with the command quit.sql is located in the bin subdirectory of the upgrade directory. If you are not sure. However.privilege='UNLIMITED TABLESPACE'. proceed as follows: a. delete the copy of brarchive. 4. For Upgrade Strategy A_on Only: If you want to leave brarchive running during the upgrade to avoid Archiver Stuck situations (brarchive -f . Check the resource quotas of the database user SAPR3: Oracle error 1536 can occur during the upgrade if the resource quotas of the database user SAPR3 are limited.1x Only: Make sure that the parameter OPTIMIZER_MODE has the following setting in the Oracle profile $ORACLE_HOME/dbs/init<SAPSID>. You can display the current settings with sapdba. Make sure that these quotas are unlimited. Make sure that the storage parameters MAXEXTENTS and NEXT have the correct values for certain tables and indexes. Make a temporary copy of brarchive: cp /usr/sap/<SAPSID>/SYS/exe/run/brarchive /tmp b. Note 11777 describes how to change the parameters NEXT and MAXEXTENTS. If this entry does not exist.ora: OPTIMIZER_MODE=RULE 8.Upgrading to 4. Check the value of the storage parameter MAXEXTENTS for the tablespace PSAPTEMP. they may overflow during the upgrade. we recommend that you switch the DBA tools (such as sapdba) for the upgrade. enter the following SQLPLUS command: select * from dba_sys_privs where grantee = 'SAPR3'.). 5. Start brarchive as user ora<sapsid> from the temporary directory: /tmp/brarchive -f .adm='NO' To do this. 9.sql as the database administrator..privilege='UNLIMITED TABLESPACE'. execute the script psaptemp. Check whether table DBA_SYS_PRIVS contains one of the following entries: grantee='SAPR3'.6C Support Release 2: UNIX SAP AG 3.

unpack this archive again into the subdirectory exe of the upgrade directory. End of the database-specific explanations April 2001 97 . After you execute PREPARE.SAP AG Upgrading to 4. This overwrites the DBA tools optimized for the minimum required database version with the tools best suited to your database version.6C Support Release 2: UNIX The RDBMS CD for the database contains the up-to-date tools that you unpacked on the current Kernel when you migrated the database.

0x/3.1x) [Page 105] 98 April 2001 .1x) [Page 102] Converting the Translation Proposal Pool (Source Releases 3.0x/3.1x) [Page 102] Backing Up Wage Types in HR (T512W) (HR Customers) [Page 103] Printing the Default Values for Document Type and Posting Key (FI Customers) [Page 104] Processing Direct Input Error Data (Source Releases 3. you also need to make preparations at the SAP System level: • • • • • • • • Checking the User for the Upgrade [Page 99] Checking Requirements for the Modification Adjustment [Page 100] Setting the Operation Mode for the Upgrade [Page 101] Processing Batch Input Sessions (Source Release 3.6C Support Release 2: UNIX SAP AG Making Preparations at the SAP System Level As well as the preparations at the operating system level and the database level.0x/3.Upgrading to 4.

This must be a user other than DDIC. Procedure To make sure that the authorization has been assigned. User DDIC needs to have the authorization SAP_ALL to be able to perform all the actions required during the upgrade. You must perform the modification adjustment during the upgrade in the ACT_<rel> phase. This means that you cannot create new users. The initial password for DDIC is 19920706 in a newly installed system.SAP AG Upgrading to 4. you must log on in the correct client as the user who performs the modification adjustment using transaction SPDD. Choose Tools → Administration → Maintain users → Users. Remove this assignment after the upgrade. April 2001 99 . we recommend temporarily assigning the SAP_ALL profile to the user who performs the modification adjustment with transaction SPDD. To perform the modification adjustment. make sure that the following users are assigned this profile in addition to their existing profiles: • • • DDIC SAP* The user who performs the modification adjustment with transaction SPDD If the SAP_NEW profile is not available in your system. because the system is undefined. or call transaction SU01.6C Support Release 2: UNIX Checking the User for the Upgrade Prerequisites You must be able to log on to the system in client 000 as user DDIC. If your system contains the SAP_NEW profile. go to user maintenance. You cannot use transaction SU01 at this point. DDIC cannot perform the modification adjustment.

Changing the SAP Standard → The Modification Assistant. In addition.Basis Components → ABAP Workbench → BC . we cannot guarantee complete support during adjustment. 100 April 2001 . make sure that changes to the Repository are allowed in the client in which you want to perform the modification adjustment. use Transaction SCC4.6C Support Release 2: UNIX SAP AG Checking Requirements for the Modification Adjustment If you modified SAP objects in your SAP System. see the documentation CD for the target release under SAP Library → BC .Upgrading to 4. In particular. make sure that you meet the requirements for the modification adjustment. If you do not make sure that you have met the requirements for the modification adjustment. To check this. For more information on the requirements for the modification adjustment. you might also risk losing the data for ABAP Dictionary objects.

Also check the operation mode DUMMY. When you schedule time-dependent jobs. but not set to status active (in theory. Enter the operation mode you have defined as an active operation mode for 24 hours using Transaction SM63. Delete the invalid operation modes. Prerequisites No operation modes must contain servers that do not belong to the current system. in particular. 2. update. use Transaction RZ04 to check the definition of your operation modes.6C Support Release 2: UNIX Setting the Operation Mode for the Upgrade Use Various background jobs are started during the upgrade. Enter a short description and then save the operation mode. d. Before starting the upgrade. background processing. Upgrade. and so on). The operation mode specifies which services are offered by the work processes (dialog. If operation modes contain names of servers other than those belonging to the system. f. for example. this affects all jobs scheduled to start on a specific server triggered by an event). Choose Operation mode → Create. g. Select Normal operation (24 hours). problems may arise in the background interface in some phases. spool. a check is made to see whether the SAP instance that you want to run them on is defined in an operation mode. Call Transaction RZ04. Enter a name for the operation mode. Change this entry to <host_name>_<SAPSID>_<instance_number>. Procedure 1. Choose Settings → Based on current status → New instances →=Generate. Position the cursor on the new operation mode and choose Operation mode → Maintain instances → Operation mode view. All instances and their current configuration appear. b. Make sure that the instance required for the upgrade has been started up. 3. In the case of operation mode DUMMY. create the operation mode for the upgrade as follows: a. Choose Save. April 2001 101 . the server name may be entered as <host_name>_<SAPSID>. The jobs may be released. enqueue.SAP AG Upgrading to 4. e. If the SAP instance on which you want to upgrade the system is not entered in an operation mode. c.

x. For more information.1H: Proceed as described in Note 98752. old sessions cannot be processed after the upgrade. the existing proposal pool will be lost.0x or 3.1x Only) Use If you have a production system for translation in your SAP System.1H: Use report RSTRMINI for the conversion.0x/3. see the documentation on the report in the system. Procedure Make sure that you have finished processing all your batch input sessions before the upgrade. 102 April 2001 .0x/3. Source release 3. Procedure • • Source release lower than 3. If you fail to do so.1x) Use Due to a change in the data structure.1x. you must convert the existing proposal pool before upgrading to Release 4. Prerequisites Your source release is 3.1x.Upgrading to 4. Converting the Translation Proposal Pool (Source Releases 3.0x or 3. Prerequisites Your source release is 3.6C Support Release 2: UNIX SAP AG Processing Batch Input Sessions (Source Releases 3.

However. evaluation class.SAP AG Upgrading to 4. Make sure you back up the data in the correct client. To do this. Procedure 1. check table TRESC by entering T512W as the table name and TABU as the object. You are using SAP model wage types. in the following cases. April 2001 103 . that is wage types beginning with '/' (adjustment of processing class. back up table T512W or selected areas of this table. To find out if this applies. and so on). RPU12W0S restores the entire backup or a generically selected area of the table. Prerequisites You use the SAP application component HR (Human Resources). This method is particularly suitable if you have exact documentation about the wage types you have modified. and you have modified these.6C Support Release 2: UNIX Backing Up Wage Types in HR (T512W) (HR Customers) Use We generally recommend backing up wage types table T512W before upgrading. Before the upgrade. Table T512W is client-specific. You can restore your backup copy after the upgrade. you can use the following reports: − − RPU12W0C restores selected parts of table T512W. You have defined wage types that are not within the customer name range. The documentation on the report includes instructions on how to proceed. use report RPU12W0S. you must back up table T512W: • • • You have modified 'technical' wage types. 2. that is wage types beginning with a letter. To do this.

Prerequisites You use the SAP application component FI (Financial Accounting). Enter TSTCP as the table name and then choose Enter. To do this. 104 April 2001 . This affects data in the table TSTCP. To do this.Upgrading to 4. enter F-01 to F-99. Reenter the data manually after the upgrade. In the field TCODE.6C Support Release 2: UNIX SAP AG Printing the Default Values for Document Type and Posting Key (FI Customers) Use The default values for document type and posting key. use Transaction SE16. use report RFTSTCP0. stored for posting transactions with transaction codes between F-01 and F-99 (such as F-52 Post Incoming Payments). are lost during the upgrade. Procedure 1. Back up the data before the upgrade by printing out the contents of the table. 2.

x.x release. As a result. check if there are any direct input jobs that have terminated abnormally or that have been completed with logical errors. you can no longer use standard functions (direct input administration.0 there are changes to the way error data that occurs during the transfer of data by direct input (material master (industry)) is stored. Prerequisites Your source release is 3.0x or 3. These changes are primarily intended to ensure upward compatibility in the future.x using program RMDATINF_3X. If jobs of this type exist. You can display the messages of previous direct input runs after the upgrade to 4. recover the errors and run the jobs again.0x/3. Procedure 1.1x.SAP AG Upgrading to 4. 2. program RMDATINF) to process any error data remaining from a direct input run performed with a 3.6C Support Release 2: UNIX Processing Direct Input Error Data (Source Releases 3.1x) Use In Release 4. Before upgrading to Release 4. April 2001 105 .

remove the cause of the error and repeat the phase [Page 109] in which it occurred. and helps you recognize any processes that have exceeded their runtime. 106 April 2001 . This documentation assumes that you only have one CD drive. You can use the Upgrade Monitor. During the upgrade. the abbreviation <rel> is used as a synonym for 46C. For a complete list of all phases. If an error occurs. You have made all manual preparations. as well as any particularly critical areas. R3up is located on the application server of the central instance. Some phases of the upgrade require you to make few user entries. You can use the alert function [Page 199] to gather information if the upgrade has stopped. you can ignore the information on changing CDs. We recommend that you perform the upgrade with the Upgrade Assistant. right up until the system starts operating productively again.Upgrading to 4. for example). as well as all structural requirements. you can enter multiple CD mount points in the phase INITPUT.6C Support Release 2: UNIX SAP AG The Upgrade Purpose The upgrade procedure updates your SAP System from a source release to a target release. In the following. you must perform the actions that affect the database on the database host. The Upgrade Monitor [Page 242] lets you monitor the upgrade. the log files and an alert function to monitor the upgrade. If you have multiple CD drives. The upgrade procedure is divided up into a number of different phases with the successful completion of a phase being in each case a precondition for the success of all subsequent phases. you can continue the upgrade. The program PREPARE has run successfully. see R3up Phase List [Page 225]. An upgrade with R3up requires the following CDs: • • • Upgrade CD3 (new Repository) Upgrade CD4 (new Repository) Upgrade CD5 (new Repository) To avoid having to change CDs. which you can use as the basis of any troubleshooting. User actions are generally required if problems arise (subdirectories are missing. or none at all. R3up logs all actions in the log files [Page 171]. This section describes all the required user entries and actions. you are prompted to insert a CD when necessary. If your central instance and database are running on different hosts. Process Flow You use the program R3up to upgrade the system. Prerequisites • • • You must meet the hardware and software requirements. The program R3up controls the complete upgrade from checking that the requirements for the upgrade are met. Once you have repeated the phase successfully.

Mount the CD SAP Kernel. The deletion of these files could lead to unpredictable inconsistencies.SAP AG Upgrading to 4. This screen will appear in each future restart. No files must have been deleted in the upgrade directory. April 2001 107 . It displays the R3up version. Enter the following command as user <sapsid>adm to switch the directory: cd <upgrade_directory>/bin 3. R3up displays the initial screen of the upgrade procedure. confirm this screen with CONTINUE. • • • • • You are logged on to the central instance as user <sapsid>adm. start R3up as described in the section Executing PREPARE and R3up in Scroll Mode [Page 201]. In the main menu. You have made the preparations that are not supported by PREPARE. the target release. then you need to disassemble the SAP Kernel from the CD again. If you have changed to HP-UX 11 between executing PREPARE and starting the upgrade. choose Administrator → Start R3up. You have completed the mandatory PREPARE modules. If you want or need to use scroll mode. 2. the SAPSID and the database you use. The server of the Upgrade Assistant is active on the host on which the central instance is running. Oracle on HP-UX Depending on whether you have Version HP-UX 10 or HP-UX 11. 2. before you start the upgrade. If the entries are correct. 3. Disassemble the SAP Kernel for HP-UX 11 with: R3up readCD cdpath=<CD mount directory> End of Oracle on HP-UX Procedure 1. PREPARE disassembles the correct SAP Kernel and copies it to the directory put/exe. Procedure: 1. Start an Upgrade Assistant GUI [Page 68] and log on as administrator.6C Support Release 2: UNIX Starting the Upgrade Prerequisites • This description assumes that you are using the Upgrade Assistant.

you need to do this if a Note tells you to correct a program before you execute it. You can also enter the following command in a second window at the operating system level: R3up stop Stopping the Upgrade at the Start of a Phase Enter the following command in a second window at the operating system level: R3up stop <phase name> R3up stop XPRAS_<rel> 108 April 2001 .Upgrading to 4. Stopping the Upgrade at the End of the Current Phase • • In the main menu of the Upgrade Assistant choose Administrator → Stop R3up after current phase. For example.6C Support Release 2: UNIX SAP AG Stopping the Upgrade Use You can stop R3up at the beginning of a specific phase or at the end of a current phase.

This mode returns the upgrade to the phase INITPUT. contact SAP Local Support. the phase in which the upgrade was interrupted is repeated from the beginning. Prerequisites • If you restart the upgrade due to an error or a termination during the upgrade. If the system is already in downtime. Support cannot be guaranteed if you do not consult SAP. The repeat mode does not necessarily mean that phases are repeated from the beginning. • init If you choose START mode init. always use START mode repeat. After this you can restart the upgrade only by resetting the database. If you have exited R3up by choosing exit.SAP AG Upgrading to 4. Other START modes can cause errors. If a phase terminates. • reset START mode reset enables you to start the upgrade from the beginning again. A password is generally necessary if you want to ignore an error. you only need to restart the upgrade if errors occurred or an upgrade phase has terminated. You can use the following START modes: • repeat When restarting R3up. Only in very rare cases does it make sense to bypass a phase with ignore by entering a password. at worst resulting in a database • April 2001 109 . other START modes are offered. This is only possible up to phase SUBSTNT_INS. Before using a password. R3up runs through the phase and checks where it needs to restart. R3up stops and suggests repeating the phase by letting you choose repeat. see Problems and Solutions During the Upgrade. Otherwise it is impossible to ensure that all upgrade phases will be completed correctly. or jump to a phase other than the one currently being executed. the cause of the error must be clear and the error must be corrected. SAP must approve their use in each case. you should have carried out a thorough problem analysis and discussed the problems with SAP. A large number of cases are known where ignoring an error resulted in serious inconsistencies. The START mode repeat leads to the upgrade being continued exactly where it was terminated. If you are unsure how to proceed. it has to be restarted manually once if reset is selected. Alternatively you can also correct entries with R3up set stdpar or R3up set DDICpwd (see description of phase INITPUT).6C Support Release 2: UNIX Restarting the Upgrade Use Normally. provided no other procedure is specified in this guide. For help on analyzing errors.

Start the upgrade as described in the section Starting the Upgrade. choose the option repeat. Procedure if You Have Exited R3up After a Termination 1. After a phase terminates. 110 April 2001 . Otherwise the error must be repeated. Procedure if You Have Left R3up by Choosing exit 1. R3up repeats the terminate phase and continues the upgrade. such as in the phases ACT_<rel> and XPRAS_<rel>. The system checks if an error can be reproduced.6C Support Release 2: UNIX SAP AG recovery. choose exit to leave R3up and correct the error.Upgrading to 4. When you choose repeat. You can ignore errors with repair severe errors in some exceptional cases. If it cannot be reproduced. If an error occurred. Use the Help key in R3up. R3up continues the phase at the point at which it terminated. the upgrade continues after the phase is completed. 2. 2. and the help offered in Problems and Solutions During the Upgrade to determine the cause of the error and to correct it. Choose the START mode repeat.

6C Support Release 2: UNIX Phase INITPUT Use In the Parameter Input PREPARE module you are prompted to enter values for certain systemspecific parameters needed by the upgrade. April 2001 111 . If the default values are correct. If you skip this phase and realize in the following phases that you made an incorrect entry. • • If you confirm this. for example. correct it as described under Correcting Entries from the INITPUT and INITSUBST Phases [Page 185]. You can modify the entries you made in PREPARE in the INITPUT phase. you are prompted for all the parameters. Activities At the start of this phase R3up asks you whether you want to change any parameters. confirm with ENTER. names.SAP AG Upgrading to 4. paths and passwords.

Choose Install. 112 April 2001 . which logs on to the database and reads the necessary information from there. Activities If the error message No information received from the database appears. To access this documentation. R3up calls the transport control program tp. Release 4. select Help → Application help in Transaction SE06. Choose Configuring the Workbench Organizer with Transaction SE06. 2. choose Information in Transaction STMS or go to the menu and choose Help → SAP Library → BC Basis Components → Change and Transport System → BC .Upgrading to 4.6C Support Release 2: UNIX SAP AG Phase DBCHK Use This phase determines the version of the database and the release of the SAP System. To see the documentation. Go to the initial screen of Transaction SE06. This takes you to the documentation Setting up the Workbench Organizer and the Transport System. Confirm any other dialog boxes with Yes or Continue until the system settings have been completed.Transport Management System. Release 3.5B: 1. For more information.6x: Use Transaction STMS (Transport Management System) to initialize the Change and Transport System. SE06 is described online. call Transaction SE06 in the SAP System as user DDIC. Then exit the transaction. Any problems in this phase are normally due to the database connection being broken. choose New installation as the system status and select the correct System configuration. see the TMS online documentation. check the file SLOG46C in the subdirectory log of the upgrade directory.x – 4. A frequent source of problems with tp is an incorrectly configured Change and Transport System. If this is the case.

it may be due to the following reasons: • • Your SAP System has not been started. Activities To correct your entries.SAP AG Upgrading to 4.6C Support Release 2: UNIX Phase RFCCHK Use In this phase. Your SAP System cannot be reached on the gateway you have specified. start R3up again using the following command: R3up set stdpar April 2001 113 . the RFC connection to your SAP System is tested. if you receive an error message.

2. − − If the job terminates. use transaction SM21 to check the system log of the SAP System. To change the entries. ii. make sure of the following i.Upgrading to 4. If the job is successfully. you either have to change the network configuration or change the entries made in the INITPUT phase. call transaction SM37 to check whether the background job has run. If errors occur. To do this. proceed as described in Correcting Entries from the INITPUT and INITSUBST Phases [Page 185]. ii. This job writes a test log in the tmp subdirectory of the upgrade directory. perform a test call of the function module TH_SERVER_LIST in transaction SE37. the background job RDDIT008 is started on the specified background server. To display the list. i. Procedure 1. Check whether the host specified in INITPUT is also in the list with a running background service. however R3up cannot find the log. Depending on the problem. double-click the table parameter LIST after executing the function module. 114 April 2001 . this is generally due to a problem with the name of the background server.6C Support Release 2: UNIX SAP AG Phase BATCHCHK Use This phase tests whether the background server can access the upgrade directory To do this. Choose repeat to repeat the phase. The value of the SAP profile parameter DIR_PUT must match the current upgrade directory. The file system of the upgrade directory must be mounted on the background server. − If no background job can be started.

repeat PREPARE. Whether the source release contains Support Packages that are more recent than those in the delivered target release • The phase PATCH_CHK3 in PREPARE has already made these checks.6C Support Release 2: UNIX Phase PATCH_CHK Use This phase tests: • Whether all Support Packages (such as Basis Support Packages) have been confirmed for the source release Unconfirmed Support Packages are displayed on the screen and in the PATCHOUT. see the description of the phase PATCH_CHK3 under Making Entries for the Read CD Module.SAP AG Upgrading to 4. call transaction SPAM and confirm the Support Packages that are proposed there. and include the necessary Support Packages. you will lose data if you continue with the upgrade. you can ignore the warning. and you have not included any Support Packages in the BIND_PATCH phase of PREPARE. In this case. If you still have to confirm Support Packages for the source release. Activities 1. 2. April 2001 115 .LOG file in the log subdirectory of the upgrade directory. − − and you have already included Support Packages in the BIND_PATCH phase of PREPARE. For more information about this. If a warning appears that the Support Package version of your source release is too high. you must reset the upgrade.

Activities If you have not already done so. For a list of the Notes you require for the upgrade.6C Support Release 2: UNIX SAP AG Phases INTCHK and INTCHK_SW Use This phase checks if the inactive nametab is empty An error is returned if it is not empty.LOG. request the most recent Notes now. If you use SAP add-on components in your system (such as IS components). Phase KEY_CHK Use This phase prompts you for the keyword specified in the current Upgrade Note. Call R3up again using repeat. Activities 1. you will also be prompted for other keywords. see Notes for the Upgrade [Page 40]. To determine the objects that are affected. SAP Systems which have other software components (add-ons) installed must wait until the upgrade has been released by the relevant add-on software vendor. display the log file DDXTTCHK. 3. 2. 116 April 2001 . Activate these objects with Transaction SE11. The Notes are continually being updated. The inactive nametab is then empty.Upgrading to 4.

End of DB2 for OS/390 • If you decide to use A_off. or A_off. you can resume production from the PRODCHK_<rel> phase once the SAP System has been stopped (see also Planning the Upgrade). • If you decide to use A_on or A_switch. DB2 Universal Database We recommend three parallel R3load processes. Enter a realistic value here. DB2 for OS/390 Note that DB2 logging is always activated. you are asked for the number of parallel processes for importing the substitution set. the system now prompts you to enter your runtime for the total import of the substitution set. If you answer the prompt define upgrade stop with yes. SAP DB The number of parallel R3load processes you choose depends on a number of factors. Your upgrade strategy does not influence logging.SAP AG Upgrading to 4. see SAP Note 46430. We recommend between two and five parallel processes. Oracle This prompt does not appear in Oracle and MS SQL Server. For the most up-to-date recommendations. A_on. DB2 for OS/390 We recommend ten parallel R3load processes. At the earliest. you are also asked to specify the time at which you want to restart production operation of your system. April 2001 117 . Informix The number of parallel R3load processes you choose depends on your upgrade strategy and hardware. see Planning the Upgrade Strategy. For information on how to choose the runtime.6C Support Release 2: UNIX Phase INITSUBST Use You must specify the following in this phase: • • • • The upgrade strategy The number of parallel processes available to import the substitution set The number of parallel background processes The number of parallel tp processes during the PCON_<rel> phase (DB2 for OS390) Activities • Upgrade strategy Choose one of the strategies described under Planning the Upgrade Strategy: A_switch.

otherwise you will not improve the runtime. If you want to create indexes with the DEFER YES option. We recommend ten tp processes. you are prompted to enter the table size from which you want to use this option. correct it as described under Correcting Entries from the INITPUT and INITSUBST Phases [Page 185]. End of DB2 for OS/390 If you realize in the following phases that you made an incorrect entry.Upgrading to 4. the SAP System is started with a modified number of background processes so that operations can be processed in parallel. DB2 for OS/390 • Number of parallel tp processes in the NEWTAB_CRE phase You have the option of specifying the number of tp processes in the NEWTAB_CRE phase. • The number of parallel tp processes during the PCON_<Rel> phase You are asked if you want to use multiple parallel tp processes in the PCON_<rel> phase. • Creating indexes with the DEFER YES option In the PCON_REL phase you can create indexes with the DEFER YES option.6C Support Release 2: UNIX SAP AG End of the database-specific explanations • The number of parallel background processes During downtime. We recommend six parallel tp processes. for hosts with up to 256 MB choose three background processes. For hosts with up to 128 MB choose two background processes. The upgrade tool sets up the indexes again in the STOPR3_IREL phase. 118 April 2001 . however the upgrade process deals with them by repeating a follow-up process. Note that deadlocks may occur if you use multiple tp processes. This function reduces the runtime in the PCON_<rel> phase. The central instance profile is modified temporarily. and for hosts with more than 256 MB. These deadlocks appear in the ICLI error log and in the MVS system log. choose four background processes. Only use this option for indexes on large tables.

SAP AG Upgrading to 4. April 2001 119 . Do not make any changes in the upgrade directory. This phase checks that the operating system and database versions installed on your computer satisfy the requirements for the upgrade. Phase VIEWCHK1 Use This phase displays conflicts between customer tables in the SAP namespace and views that are newly delivered. First save any data that you need in these tables. you can interrupt R3up at this point.6C Support Release 2: UNIX Phase CONFCHK_X Use This target release is released for certain combinations of operating system and database versions only. You must. Activities You can ignore the messages at this point. It also writes this information to the VIEWCHK1. however.LOG file. rename or delete the tables in the VIEWCHK2 phase at the latest. Activities If the system determines that the operating system must be upgraded to a new version.

Upgrading to 4.LOG. you can bypass these errors with ignore without entering a password. Activities If errors occur in this phase and you have not yet resumed production operation.6C Support Release 2: UNIX SAP AG Phase REPACHK1 Use This phase displays all repairs and requests containing objects locked by SAP. The PREPARE message is: Update records still exist .Please process 120 April 2001 . Activities You can ignore the messages at this point. see Evaluating the Results of PREPARE. However. These objects must be released and the repairs confirmed at the latest by phase REPACHK2. and writes them to the file REPACHK1. Phase JOB_RSVBCHCK2 Use The upgrade stops in this phase with an error message if there are any outstanding or incomplete updates. we recommend checking for outstanding updates and cleaning them up. For more information.

Activities In this phase you must clear or complete any outstanding updates.) 2. Repeat this phase.Please process 3.SAP AG Upgrading to 4. April 2001 121 . the upgrade stops in this phase. except for RDDIMPDP. (See Isolating the Central Instance. Make sure that the release for all background jobs was canceled. Clear the outstanding updates as described in Analyzing Results from PREPARE. The PREPARE message is: Update records still exist . Proceed as follows: 1.6C Support Release 2: UNIX Phase JOB_RSVBCHCK3 Use If there are any outstanding or incomplete updates.

This phase compares the freespace currently available in the database with the minimum requirements for the total amount of data to be imported.6C Support Release 2: UNIX SAP AG Phase SPACECHK_ALL Use This release requires more space in the database than the previous releases. this is shown on screen and in the file DBFPLUSD. since PREPARE already made these checks earlier. If more space is required in the database. The connect information ISOLEVEL and TIMEOUT is checked for the value 0. The corresponding PREPARE message in CHECKS. You can change these database parameters with the SAP DB tool xcontrol. the SAP System cannot be started without the minimum setting of MAXLOCKS. The changed parameters only become active when the database has been stopped and started.LOG is as follows: Insufficient freespace in the database as follows SAP DB • • • The database parameter MAXLOCKS is checked for the minimum SAP operational requirements. Activities The section Evaluating the Results of PREPARE contains a description of the procedure. You can change the connect information with the SAP DB tool xuser. ISOLEVEL and TIMEOUT. As of Release 3.Upgrading to 4.LOG.0D. End of the database-specific explanations 122 April 2001 . DB2 for OS/390 The required actions for the SPACECHK phases are described in the section Making Entries for the Initialization Module.

For more information. make sure that you are able to restore the old Kernel. see the PREPARE log CHECKS.LOG. This phase also compares the free disk space in the Kernel directory with the space requirements of the new SAP Kernel. Activities At this point. April 2001 123 . the SAP Kernel is switched in the Kernel directory /usr/sap/<SAPSID>/SYS/exe/run.SAP AG Upgrading to 4. You must have enough free space in the log directory so that the upgrade can run without errors. All files and subdirectories in /usr/sap/<SAPSID>/SYS/exe/run are overwritten during the upgrade when the kernel is switched.6C Support Release 2: UNIX Phase FREECHK_X Use This phase checks to see if there is enough free space in the upgrade directory for the logs written during the upgrade. During downtime. if this becomes necessary.

you can continue to use your SAP System productively. ABAP reports. you must confirm that the ABAP Workbench can be locked. since such modifications would be lost. Activities If you have chosen strategy A_switch or A_on. If you confirm the lock now: • R3up does not stop in phase REPACHK2 to allow you to confirm the lock on the Workbench.Upgrading to 4. If you want to do this. This increases the time in which R3up does not need user input after the last change of CD (EU_IMPORT5 phase). table definitions. R3up asks you in this phase if you want the ABAP Workbench to be locked on all SAP instances now or in the phase REPACHK2. R3up waits after input until the time entered in the INITPUT phase as the maximum synchronization time for all the instances has expired (see Phase INITPUT).6C Support Release 2: UNIX SAP AG Phase LOCKEU_PRE Use If you have chosen the upgrade strategy A_switch or A_on. This lock is needed to prevent development objects (for example. 124 April 2001 . and so on) from being changed during the upgrade. • • You may not perform any more transports into or out of the SAP System.

you are prompted at the beginning of this phase to do the following: • • • Isolate the central instance. Then confirm that you want to continue with the upgrade. the rest of the data is converted in the conventional manner during downtime. Activities If you have chosen upgrade strategy A_off. If you called transaction ICNV when you prepared the upgrade. the upgrade control program R3up stops and waits for user input.SAP AG Upgrading to 4. If you ignore the information from R3up. R3up checks whether you have already converted the recommended percentage of the selected data (see Incremental Table Conversion [Page 30]). R3up informs you if you have not.6C Support Release 2: UNIX Phase EU_IMPORT0 Use At the start of this phase. see Isolating the Central Instance. call transaction ICNV. Verify that you can recover the database to its current state at this point. Disable the ability of the database to continually recover data. April 2001 125 . For details on the status of the incremental conversion. For a description of this. See also Changing the Database Recovery Mode.

SAP DB and DB2 Universal Database The statistics for newly imported tables are updated automatically. Phase EU_IMPORT5 Use At the beginning of the this phase.6C Support Release 2: UNIX SAP AG Phase EU_IMPORT4 Use The runtime for this phase is approximately 30 minutes to an hour for upgrade strategy A_off. less the time taken up by EU_IMPORT2. the expected runtime is computed from the total time you specified for the import less the time computed in EU_IMPORT2. For strategies A_on and A_switch. your time schedule could be seriously disrupted. End of the database-specific explanations The runtime of this phase is approximately 3 to 4 hours for upgrade strategy A_off. If you miss this prompt. The majority of the substitution set is imported directly from CD-ROM into the database during this phase. you are prompted to change the CD. For strategies A_on and A_switch.Upgrading to 4. the expected runtime is made up of the total time you specified for the import. 126 April 2001 . EU_IMPORT3 and EU_IMPORT4.

Activities • Before you continue with the upgrade. you have to release and confirm all the open repairs.LOG. • Upgrade strategies A_switch or A_on: If you did not confirm locking of the ABAP Workbench in the phase LOCKEU_PRE. otherwise the objects contained in the repairs are locked. under: SAP Library →=Basis Components → =ABAP Workbench → Changing the SAP Standard →The Modification Assistant.LOG. If you ignore open repairs. you have to release these transport requests. For information on modifications are copied to the new SAP standard during the upgrade. no further transports can enter or leave the SAP System. R3up waits until the time entered in phase INITPUT as the maximum synchronization time for all instances has expired (see phase INITPUT).6C Support Release 2: UNIX Phase REPACHK2 Use In this phase. Once you have released and confirmed all the open repairs. see Releasing and Confirming Open Repairs and Requests [Page 208]. otherwise the objects in them are locked. you must do so now. After you have made your entry. For a description of this procedure. April 2001 127 . To be able to continue. all the repairs and corrections that are not released are displayed on the screen and written in file REPACHK2. They are also written in the file REPACHK2. After confirming locking of the ABAP Workbench. all the repairs which are still in open transport requests are displayed.SAP AG Upgrading to 4. Any modifications made to SAP objects in your repairs might be overwritten during the upgrade. you must repeat phase REPACHK2. you could lose modifications. In this phase. see the documentation CD for the target release.

128 April 2001 . proceed as described under Cleaning Up Terminated Conversions in the DB Conversion Phases [Page 179].6C Support Release 2: UNIX SAP AG Phase CNV_CHK_XT Use This phase checks if the following still exist: • • Conversion requests that have not yet been processed Restart logs Activities If you encounter errors.Upgrading to 4.

PREPARE already made this check... . The PREPARE messages are: Unresolved request found in TRBAT.. If this table contains entries. .. .. see Analyzing Results from PREPARE... Activities For information on cleaning up the table TRBAT. they could be the remains of an import or export that either terminated abnormally or is still running. ..6C Support Release 2: UNIX Phase TRBATCHK_XT Use The tp program uses table TRBAT to communicate with the SAP System.SAP AG Upgrading to 4. Corrupted TRBAT entry found. TRBAT entry indicates that a batch job has finished. TRBAT entry indicates that a batch job is running. April 2001 129 .

Upgrading to 4. Use transaction SE11 to check which table types are affected. skip the error message with ignore. You cannot adjust modifications at this stage of the upgrade. 130 April 2001 . If the tables are database tables. and your own developments. you can adjust and retain the modifications later in transaction SPDD. These modifications cannot be retained during the upgrade. This resets the modifications to the standard SAP version. Back up any contents of the table.6C Support Release 2: UNIX SAP AG Phase RUN_RDDIT006 Use This phase determines the set of objects that needs to be copied to the new Repository tables. since the structure of these tables must be adjusted to the target release before the SAP System can be started with the target release for the first time. see SAP Note 33888. modified objects that are not delivered. You can only skip the error message by choosing ignore. Procedure 1. Prerequisites The RUN_RDDIT006 phase ends with an error message stating that the central Basis tables have been modified. and continue with the upgrade. − − If the tables are structures. This mainly includes generated objects. contact SAP Local Support. For more information. If you have any questions. at least temporarily. If necessary. the SAP System might be unable to run with the target release. data might be lost if the table structures were modified. no data is lost. If the modifications are retained. 2.

you can still specify that you want R3up to stop in this phase. April 2001 131 . Phase VIEWCHK2 Use This phase displays conflicts between customer tables in the SAP name range and views delivered for the first time. Activities You have to delete these customer tables now.SAP AG Upgrading to 4. Pooled or cluster tables must be deleted manually in the SAP System. the modifications it contains are now compared with the modifications in the system. It also makes an entry in the file VIEWCHK2. Activities You are prompted to confirm the copying of the request. However. If you still need the data in these tables. R3up does not stop before the activation of the ABAP Dictionary objects. you have to save it first. you can use R3up for this. If this request contains all the modifications found in the system. at the latest. The result of this comparison appears. If the tables are transparent.6C Support Release 2: UNIX Phase ADJUSTCHK Use If you chose to copy a request in the ADJUSTPRP phase.LOG.

the changes made by the upgrade are reset. call transaction ICNV. so that you can reset the upgrade to this state at a later point. For details on the status of the incremental conversion. the rest of the data is converted in the conventional manner during downtime. Activities If you chose upgrade strategy A_on or A_switch: • Make sure of the following − − − All production work in the SAP System is stopped and no users are logged on to the SAP System. R3up informs you if you have not. All changes to the profile are written to the ALPXPOOL. All upgrade strategies: Back up the upgrade directory now.Upgrading to 4. which can cause the upgrade to stop running. start by reimporting the current version of the profile into your system.LOG file. If you want to use transaction RZ10 to adjust the instance profile during the upgrade. • DB2 for OS/390 If you use DB2 for OS/390. • If you called transaction ICNV when you prepared the upgrade. If you do not do this. depending on your database and the upgrade strategy you have chosen. R3up automatically shuts down the central instance and modifies the instance profile in directory /usr/sap/<SID>/SYS/profile (UNIX) or \usr\sap\<SAPSID>\SYS\profile (Windows NT) for the duration of the upgrade. Result Once you have completed and confirmed all the activities. If you chose the upgrade strategy A_switch. If you ignore the information from R3up. R3up prompts you to perform several activities. R3up checks whether you have already converted the recommended percentage of the selected data (see Incremental Table Conversion [Page 30]). End of DB2 for OS/390 So that you can recover your SAP System after errors. 132 April 2001 .6C Support Release 2: UNIX SAP AG Phase MODPROF_TRANS Use The R3up program stops the SAP System in this phase and modifies the instance profile for the duration of the upgrade. Isolate the central instance as described under Isolating the Central Instance. perform the following actions: Strategy A_switch: Make sure that you can recover the database to its current state. All secondary application servers are shut down. also make sure that you have switched off the capability of the database to continually restore data. you are not prompted to do this.

sapenv_<host name>.sh startsap_<host name>_<instance number> stopsap_<host name>_<instance number> Activities If you made changes to the environment of the user <sapsid>adm they are no longer active after the upgrade.sh . and the change you have made to the environment of user <sapsid>adm to these servers. The following files are changed: . The environment files previously used are copied to <upgrade directory>/exe/INSTALL before being overwritten.csh . copy the files listed above.SAP AG Upgrading to 4. Do not copy back the environment files that were saved to <upgrade directory>/exe/INSTALL. April 2001 133 .dbenv_<host name>. This can lead to incorrect settings being made.6C Support Release 2: UNIX Phase ENVCHK Use This phase tests the environment of the user <sapsid>adm. If you replace the profiles of this user you also prevent an obsolete user environment from causing problems during the upgrade. 2.csh . 1.dbenv_<host name>. Make the changes again if this is the case. If other application servers exist.sapenv_<host name>.

If you chose ignore here. This user is valid for a week. use the report program UPGADDUSR. You first have to remove the cause of the termination. you can correct these here. Otherwise. If you want to create a user for the adjustment at this point. You do not need a password to do this. since R3up stops when errors occur. otherwise data may be lost. You must make adjustments at this point if you have made structural changes to tables. you also have the option of choosing ignore to temporarily ignore these errors. Use Transaction SPDD to determine the ABAP Dictionary objects that need to be adjusted. In R3up. UPGADDUSER creates the adjustment user upg_tmp_user with the password init in the client where you run the report. You still need the authorization for creating users. For more information on this transaction. You cannot create any new users in Transaction SU01 at this point. confirm that you want to temporarily revoke the lock on logging on to the SAP System to allow a normal user logon for the purposes of modification adjustment. this means that the activation has been terminated and you must not continue with the next phase. 2. This leads to the loss of data in customer fields. If errors are reported when you activate your own developments after executing this phase. you have to activate these objects after the upgrade. see the documentation CD under Help → SAP Library → Basis Components → ABAP Workbench → BC . 1.Upgrading to 4. However. If you are prompted for a password anyway. because the system is undefined. Activities Do not attempt to import adjustment transport requests into the system manually in this phase.Changing the SAP Standard → The Modification Assistant → Upgrade Procedure/R/3 Support Packages → Adjusting ABAP Dictionary Objects. 134 April 2001 . you may be asked at the beginning of this phase to adjust your modifications to SAP objects so that they correspond to the new SAP standard version of the objects. Any requests for automatic adjustment from previous upgrades can be included in this upgrade in the PREPARE phase ADJUSTPRP only.6C Support Release 2: UNIX SAP AG Phase ACT_<rel> Use Depending on the results of the phase ADJUSTCHK. data will be lost.

After the PRODCHK_<rel> phase. or you can switch over to production immediately. R3up does the following: • • • • • It displays the P errors. It recreates the status of the system profiles before the upgrade. see Phase CHK_POSTUP [Page 136]. In the second case. You can then use your system for production again or begin the post-upgrade activities. If you decided to start production operation again now. and this time would be exceeded if you executed the next phase. If you did not specify a time. April 2001 135 . It prompts you to switch the database back to recovery mode. It starts up the SAP System for the last time. R3up does not expect any further user entries unless an error occurs. For more information on P errors. R3up displays the P errors (see Phase CHK_POSTUP [Page 136]). the procedure described above occurs in the phases MODPROFP_<rel>. Procedure Strategy A_on R3up stops the upgrade if you entered the latest time at which you want to start production. stops the system for the last time and recreates the status of the system profiles before the upgrade. the procedure described above occurs in the phases MODPROFP_<rel>. You are prompted to switch the database back to recovery mode and to create a complete backup of your database. STARTR3_P<rel> and CHK_POSTUP. It prompts you to start the secondary application servers. the way the upgrade proceeds depends on the strategy you have chosen. Strategies A_switch and A_off R3up stops the upgrade if you entered the latest time at which you want to start production. or you can start a database backup immediately so that you can switch to production operation again afterwards. Now you can either enter a new time at which you want R3up to stop again.SAP AG Upgrading to 4. You then have to start the secondary application servers. and this time would be exceeded if you executed the next phase. Now you can either enter a new time at which you want R3up to stop again. STARTR3_P<rel> and CHK_POSTUP. If you did not specify a time.6C Support Release 2: UNIX Continuing the Upgrade After Phase PRODCHK_<rel> Use Up to the PRODCHK_<rel> phase. You can then use your SAP System for production again or begin the post-upgrade activities.

136 April 2001 . Activities To remove errors. This type of problem is indicated by a P in the second column of the .6C Support Release 2: UNIX SAP AG Phase CHK_POSTUP Use You can remove some of the problems that occur during an upgrade after you complete the upgrade.Upgrading to 4. proceed as described in the long text of the message. R3up displays a complete list of these P-messages in this phase.ELG logs. You must usually remove the cause of these problems before you start using SAP applications again. Any messages that you do not handle immediately need to be handled at the next possible opportunity. Some of the secondary indexes may not have been created because they were not unique. Use the ABAP Dictionary tools (Transaction SE14) to create these indexes in the database.

We recommend completing the actions in the order given. it only displays documentation.1x). or until the next upgrade. April 2001 137 .SAP AG Upgrading to 4. You can use the System Administration Assistant to help you with the postupgrade activities. click the help button (? icon) for help on the System Administration Assistant. Then in the initial screen of the System Administration Assistant choose System Administration Assistant → Display.6C Support Release 2: UNIX Post-Upgrade Activities Purpose This section tells you how to complete and check the upgrade.0x and 3. such as executing the script saproot. The System Administration Assistant is a program in the SAP System that.sh. You can get more information online in the system. For certain actions. Prerequisites You have reached at least the PRODCHK_<Rel> phase of the upgrade. Some actions can wait until you have started operating the system productively [Page 152]. Depending on the actions. among other things. lists the post-upgrade activities for each platform. The prerequisite for this is that you have the current online documentation installed. such as subsequent processing of table clusters (for Source Releases 3. In the following screen. you can start transactions directly from the System Administration Assistant. Process Flow You must perform some of the actions before you start operating the system productively again [Page 138]. You start the System Administration Assistant by executing Transaction SSAA.

1x Only) [Page 150] Checking the Profile Parameters with Transaction RZ10 [Page 151] You can start operating the system again productively after these actions.6C Support Release 2: UNIX SAP AG Actions Before Starting Production Operation R3up stops at the latest in the phase MODPROFP_<rel> so that you can begin early with the post-upgrade activities. R3up then executes the last phases and completes the upgrade. Then perform the following actions: • • • • • • • • • Executing the Script saproot.sh [Page 139] SAP DB: Backing Up the Database [Page 141] DB2 Universal Database [Page 142] DB2 for OS/390: Preparations [Page 145] Informix: Preparations [Page 146] Oracle: Preparations [Page 147] Distributing SAP Programs [Page 149] Renaming the Local System Log (For Source Releases 3. At the same time you can perform the post-upgrade activities specified by R3up.Upgrading to 4. 138 April 2001 .0x/3.

sh. create the two new groups db<sapsid>adm and db<sapsid>ctl before you execute the script saproot. Execute the following command: April 2001 139 . Log on to the database server and all application servers as user root.sh Use After the upgrade. and change the assignments of the following users as follows: New User Group Concept Old User db2<sapsid> <sapsid>adm db2as New Primary Group sysadm sapsys db2asgrp Secondary Group Primary Group db<sapsid>ad m Secondary Group sysadm db<sapsid>ctl db<sapsid>admgroups for all sapsids on the database host sysctrl sysadm sapsys db2asgrp Change the group access authorizations as follows: 1. To do this. Procedure DB2 for OS/390. 2./saproot. You need the authorizations of the user root to do this.sh <SAPSID> exit 2.SAP AG Upgrading to 4. Oracle. Informix.6C Support Release 2: UNIX Executing the Script saproot. DB2 Universal Database For source releases lower than 4.6A only: A new user group concept has been introduced in Release 4. SAP DB 1. Start up the system with stopsap and startsap. you need to make a number of adjustments.6A that makes it easier to separate user authorizations when you operate multiple SAP Systems on a single host. Execute the following commands: su . The old groups sysadm and sysctrl must be replaced by the new groups db<sapsid>adm and db<sapsid>ctl.root cd <upgrade_directory>/exe .

/saproot. End of the database-specific explanations 140 April 2001 .sh <SAPSID> exit 4.root) 3. For all source releases: The script saproot.Upgrading to 4. Proceed as follows: 1. Execute the following command: su root (not su . 2. it adapts the database manager configuration to the new groups). Log on as user <sapsid>adm.sh performs additional database-specific actions (for example. since it needs the new groups.sh on the database server afterwards. Execute the script saproot. The script requires the environment variables of user <sapsid>adm. Start up the system with stopsap and startsap.6C Support Release 2: UNIX SAP AG find /db2/<SAPSID> \! -type l -group sysadm -print | xargs chgrp db<sapsid>adm 3. Execute the following commands: cd <upgrade_directory>/exe .

SAP AG

Upgrading to 4.6C Support Release 2: UNIX

SAP DB: Backing Up the Database
SAP DB

Prerequisites
You have not started to operate the system productively.

Procedure
1. Stop the SAP System as user <sapsid>adm with:
stopsap r3

Note that you have to stop and restart the database. 2. Give the database parameter the value it had before the upgrade. 3. This step depends on the chosen upgrade strategy: a. Strategies A_off and A_switch: Since the log mode is reset to the original value after the upgrade, you must back up the database completely (in operating mode COLD) before you can start the system again productively. b. Strategy A_on: We recommend making a complete backup so that you do not have to upgrade all the logs again in case of a recovery. Instead of a complete backup, you can perform an incremental online backup (save updated pages). This type of backup has the advantage that a recovery is significantly faster. 4. Start the SAP System as user <sapsid>adm with:
startsap r3 End of SAP DB

April 2001

141

Upgrading to 4.6C Support Release 2: UNIX

SAP AG

DB2 Universal Database
DB2 Universal Database

Prerequisites
You have not started to operate the system productively.

Installing and Updating the DB2 Administration Tools
You can install the administration tools in the following steps:

Installation of the administration frontend Install the new administration frontend as described in the BC R/3 Database Guide: DB2 Universal Database. You can install the frontend either during or after the upgrade. These functions are available only after you execute the script saproot.sh.

Creation/update of the administration database To store administration data (for example for log file handling), data is stored on the database server under the SAP database instance in the SAP database and in an additional administration database. The administration database has the name ADM<SAPSID> and is needed to store data while the SAP database is not available (for example during a backup). Log on as user <sapsid>adm and change to the user root with su root (not su root). Execute the following command (depending on your source release): Source Releases 3.0x/3.1x:
sddb6ins -s <SAPSID> -u 31I 46C -

Source Release >= 4.0B:
sddb6ins -s <SAPSID> -u <Start-Release> 46C

This creates the database ADM<SAPSID> with standard contents, if it does not yet exist. Otherwise, the database objects are adjusted to the new release in this database.
sddb6ins exchanges the program userexit that is responsible for saving log files in the log archive directory. The program userexit logs its actions in the database ADM<SAPSID>.

As of Release 4.0A, administration tools such as brarchive, brrestore and userexit do not log their actions at the file system level anymore. Instead, they log the actions in the database ADM<SAPSID>. This means that after the program userexit is substituted, you must use the old program brarchive to manually back up all the log files that have been created up to this point (for source releases smaller than 4.0A). You can find the old program brarchive on the CD SAP KERNEL under the following name:
<CD mount directory>/UNIX/AIX_32/BRARCH31

Activating Log Archiving

142

April 2001

SAP AG

Upgrading to 4.6C Support Release 2: UNIX

If you did not reactivate log archiving for the database with R3up, you must convert the database parameters LOGRETAIN and USEREXIT. To do this, enter the following commands in the DB2 command line:
db2 update db cfg using LOGRETAIN ON db2 update db cfg using USEREXIT ON

You must then perform a complete database backup before DB2 permits new database connections.

Backing Up the Database
Now back up the database completely.

Deleting Substitution Tablespaces
After the upgrade, a number of tablespaces are no longer used and you can delete them. These are always the following tablespaces for a Repository switch: PSAPES<source release>D PSAPES<source release>I PSAPEL<source release>D PSAPEL<source release>I where <source release> is the source release for the current upgrade. To delete a tablespace, enter the following command in the operating system:
db2 drop tablespace <Tablespace_name>

DB2 checks if there are still database objects in the specified tablespace before executing this command. If there are, the command is not executed.

Perform an Update Statistics
Proceed as follows: 1. Log on to the SAP System. You require the authorizations for database administration and background jobs. 2. Start Transaction DB13 (planning calendar) or choose
Tools → CCMS → DB Administration → DBA scheduling

3. Open the dialog box with the actions which you can schedule by double-clicking on the current day. 4. Select the action Upd. Statistics + Reorgcheck all tables 5. Choose Start immediately. Confirm the following dialog boxes to start the job in the background.
Runstat_all has been scheduled for the current day and started immediately.

The time required to update statistics depends on the size of the database. You need about an hour for a database of 2 GB.

April 2001

143

Upgrading to 4.6C Support Release 2: UNIX

SAP AG

6. Check the status of the job with the Job logs option for the current day.

Scheduling Update Statistics Jobs
To schedule update statistics jobs: 1. Log on to the SAP System. You require the authorizations for database administration and background jobs. 2. Start Transaction DB13 or choose:
Tools → CCMS → DB Administration → DBA scheduling

3. In the menu, choose Planning → Planning pattern. Several defined database actions are shown here. 4. Choose the following action:
Check Step, Upd.Statistics + Reorg. check on DBSTATC (daily)

Enter a start time (if possible, when the system is available but the system load is low) and confirm the subsequent steps. 5. Choose the following action:
Upd. Statistics & Reorgcheck all tables (Sun.weekly)

Enter a start time and confirm the subsequent steps.
End of DB2 Universal Database

144

April 2001

The following two queries specify which tablespaces might need to be reorganized. IXCREATOR. It searches for leaf pages that are not close together. SELECT DBNAME. Only reorganize now if you have enough time. (NEARINDREF + FARINDREF) * 100 / CARD.SYSINDEXPART WHERE (CARD > 0 AND (NEAROFFPOS + FAROFFPOS) * 100 / CARD > 10) The following query specifies indexes that might need to be reorganized. Otherwise reorganize the database according to the usual cycle. PERCDROP FROM SYSIBM. which uses the port indicated by the service entry sapdb2<SAPSID>. End of DB2 for OS/390 April 2001 145 .6C Support Release 2: UNIX DB2 for OS/390: Preparations DB2 for OS/390 Prerequisites You have not started to operate the system productively. The second query checks for rows that are out of sequence. CARD.SYSINDEXPART WHERE LEAFDIST > 200. TSNAME.SYSTABLEPART WHERE ((CARD > 0 AND (NEARINDREF + FARINDREF) * 100 / CARD > 10) OR PERCDROP > 10) SELECT IXNAME. SAP recommends that you reorganize any tablespaces and indexes that you find with the following SQL statements. We strongly recommend that you perform RUNSTATS on all tablespaces. (NEAROFFPOS + FAROFFPOS) * 100 / CARD FROM SYSIBM. For information on how to update the statistics. SELECT IXNAME. Reorganizing the Database Reorganizing the database at this point in time is optional. Backing Up the Database Perform a complete backup of the database. and replace it with a target release ICLI server. CARD. IXCREATOR FROM SYSIBM. Performing an Update Statistics (RUNSTATS) The system does not update statistics automatically. Switching the ICLI Server At the start of production operation (at the latest in the MODPROFP_<Rel> phase) you are prompted to stop the ICLI server of the source release. see SAP Note 113008. These pages cannot benefit from sequential prefetch.SAP AG Upgrading to 4. The first query checks for overflow conditions or space being filled by dropped tables.

First check that the dbspaces really are empty. make another complete offline or online backup of the database immediately. To do this. Otherwise restoring the database may be very time-consuming.partnum) = '<dbspace-name>' and partnum != 0. count(*) = 0 should be the result. and then create a complete backup of the database. depending on whether you have operated the database during the upgrade with the backup mode activated or deactivated. Backing Up the Database There are two different procedures when you back up the database. To delete the dbspaces use the database tool onspaces as follows: onspaces -d <dbspace-name> Before you can use the space freed by deleting the dbspaces. Proceed as follows: 1. You must make this backup offline.6C Support Release 2: UNIX SAP AG Informix: Preparations Informix Prerequisites You have not started to operate the system productively.Upgrading to 4. Execute this command for both of the dbspaces that you want to delete. Backup: Database Was Operated with Backup Mode Deactivated Reactivate the backup mode. Deleting dbspaces The dbspaces psapes<sourcerel> and psapel<sourcerel> (<sourcerel> stands for the source release for this upgrade) are empty after the upgrade. End of Informix 146 April 2001 . Backup: Database Was Operated with Backup Mode Activated Since the amount of logical log files increased during the upgrade. 3. This means that you can delete them. start dbaccess as user informix and enter the following SQL command: select count(*) from systables where dbinfo('DBSPACE'. you must make a level 0 database backup. 2.

If you make backups to a remote tape device (backup_dev_type = pipe pipe_auto pipe_box).x: UNIX). only the user ora<sapsid> can have DBA authorization in Release 4. Proceed as follows: 1. brarchive and brrestore. This means that you must execute the SQL script sapdba_role.x. 2. The upgrade imports additional objects which have to be adjusted.SAP AG Upgrading to 4.6C Support Release 2: UNIX Oracle: Preparations Oracle Prerequisites You have not started to operate the system productively.sap (For Source Releases Lower than 4. if it appears: Error accessing PRODUCT_USER_PROFILE Warning: Product user profile information not loaded! You may need to run PUBLD.5A) New parameters are used for in Release 4.sap. Log on as user ora<sapsid> at the UNIX level.SQL as SYSTEM. Adding New Parameters to the Profile init<DBSID>.5A) with the following parameters: remote_host = <remote_host_name> remote_user = <remote_user_name> April 2001 147 . you must use an editor to enter these parameters in the profile $ORACLE_HOME/dbs/init<DBSID>. replace the parameter read_fifo_cmd (no longer supported as of Release 4.sql sapdba_role. If you want to use the new functions of these programs. You have already performed most of the required manual changes when you migrated Oracle to Version 8.sql again.0.sql sqlplus internal @sapdba_role <SAPSID> UNIX You can ignore the following error message.0 (see the guide Migration/Upgrade to Oracle Version 8. Start the SQL script with: cd $ORACLE_HOME/dbs cp /usr/sap/<SAPSID>/SYS/exe/run/sapdba_role. Checking the Environment Variables for the Program sapdba Using the following information on the documentation CD.5 for creating backups with brbackup. Creating and Updating the SAPDBA Role To ensure the security of your system. check whether all the environment variables have been set correctly for sapdba at the UNIX level: SAP Library → Basis Components → Database Interface/Database Platforms → Database Administration (Oracle) with SAPDBA →=Using SAPDBA → Configuring SAPDBA → Environment Variables (UNIX).

This stops and starts up the database again. Otherwise restoring the database may be very time-consuming. Adding a New Parameter to the Profile init<DBSID>. When you have made the backup.5 → BRBACKUP.6C Support Release 2: UNIX SAP AG For detailed information. Backup: Database Was Operated in NOARCHIVELOG Mode Activate ARCHIVELOG mode again and create a complete backup of the database. Stop your SAP System as user <sapsid>adm with: stopsap r3 2. You can find more information about offline backups and brbackup in the SAP online documentation on database administration for Oracle. you can start up your SAP System again as <sapsid>adm with startsap r3 and continue working.ora: control_file_record_keep_time = 30 Backing Up the Database The procedure for backing up the database depends on the mode with which you operated the database during the upgrade.Upgrading to 4.ora (For Source Releases Lower than 4. see the documentation CD for the target release under SAP Library →=Basis Components → Database Interface/Database Platforms → Database Administration (Oracle) with SAPDBA →==New Features in SAP R/3 Release 4. End of Oracle 148 April 2001 . BRARCHIVE and BRRESTORE. make a complete offline or online backup of the database as quickly as possible. Backup: Database Was Operated in ARCHIVELOG Mode Since a large number of archives were produced during the upgrade.5A) So that you can use the Oracle Recovery Manager (RMAN) with brbackup. This must be done as an offline backup. You can find instructions on doing this under Changing the Database Recovery Mode [Page 205]. 3. 4. Start the offline backup of the database with the program brbackup. Activate ARCHIVELOG mode again with sapdba. Proceed as follows: 1. add the following new parameter to the profile init<DBSID>.

HP10_32. you can also save the programs locally on the servers and update them automatically with the program sapcpe. you have to distribute the programs in directory /usr/sap/<SAPSID>/SYS/exe/run to all servers. For more information on using sapcpe see Help → SAP Library → BC . You can copy the programs directly from the CD SAP Kernel to the target directory of the application server with R3up. April 2001 149 . DEC_64.Basis Components →=Client Server Technology → System Services → Setting Up Local Executables on UNIX R/3 Instances. RLX_32. 3. If you use distributed servers. Start R3up directly from CD with: /<CD mount directory>/UNIX/<OS>/R3UP readkernel Replace <CD mount directory> with the mount directory of the CD and <OS> with one of the following: AIX_32. Shut down the application server. To keep the network load low. HP11_32. This avoids inconsistent programs and having to distribute them manually. RLX_64. AIX_64. Procedure 1. Mount the CD. HP11_64. we recommend that you use NFS to share programs in /usr/sap/<SAPSID>/SYS/exe/run.SAP AG Upgrading to 4. 2. SUNOS_32 or LINUX_32.6C Support Release 2: UNIX Distributing SAP Programs Use If your SAP System has multiple application servers and you do not use NFS to share the kernel directory of the central instance.

0x or 3. a new one is created when you start the system.0.1x before the upgrade. This means that you must have an empty system log when you start the system with Release 4. Procedure Rename the file SLOG<instance_number> in the directory /usr/sap/<SAPSID>/<instance_name>/log. You can achieve this easily by renaming the old system log.old.6C Support Release 2: UNIX SAP AG Renaming the Local System Log (For Source Releases 3.x for the first time. This is not done automatically on the remote application servers.Upgrading to 4. for example. If a log does not exist.0x/3. 150 April 2001 . R3up has already renamed the central and local system logs. If you use the SAP System with multiple application servers then you have to rename the local system log on these remote servers. The SAP Kernel cannot correctly interpret entries in the old format. On the host with the central instance. Prerequisites You had Release 3.1x Only) Use The format of the system log was changed for Release 4. as SLOG<instance_number>.

Ensure that all active servers (SAP instances) are started. choose Help → Application Help from within Transaction RZ10. choose Goto → Profile values → Of a server.SAP AG Upgrading to 4. double-click the name of the server you want to display. a. 2. 5. 6. Whenever possible.6C Support Release 2: UNIX Checking the Profile Parameters with Transaction RZ10 Use After the upgrade. Choose Utilities → Import profiles → Of active servers. For more information about changing the profile parameters. return the parameter values to the default values. Check the parameters whose values differ from the default. If parameters are set incorrectly. Procedure 1. you receive a warning. 3. Alternatively. You can display the parameters with their current settings and the default value using Transaction RZ10. if you want to read the documentation offline from the documentation CD for the target release. Choose Utilities →Check all profiles → Of active servers. April 2001 151 . check the settings in your system profiles with Transaction RZ10. To display the values. b. 4. Transaction RZ10 checks the profiles of all servers. Call Transaction RZ10. Ensure that you have authorization S_RZL_ADM in the SAP System. choose SAP Library → Basis Components → Computing Center Management System → Computing Center Management System → Profiles. On the initial screen of RZ10.

0x/3.0x/3.6C Support Release 2: UNIX SAP AG Actions During Production Operation You can perform the following actions while the system is operating productively: • • • • • • • • • • • • • • • • • • • • Importing SAP Support Packages After the Upgrade [Page 153] Transport Management System: Distributing the Configuration [Page 153] Rescheduling Background Jobs [Page 154] Rescheduling Jobs with Transaction DB13 (Source Releases 3.1x) [Page 167] Installing More Dialog Instances [Page 168] Evaluating the Upgrade Runtime [Page 169] 152 April 2001 .1x) [Page 155] Adjusting Repository Objects [Page 156] Reimporting Additional Programs [Page 156] Migrating Matchcodes to Search Help Objects (Source Releases 3.1x) [Page 157] Performing Post-Upgrade Activities for the Language Transport [Page 158] SAP DB: Updating Optimizer Statistics [Page 159] DB2 for OS/390: Actions [Page 159] Informix: Performing an Update Statistics [Page 160] Oracle: Actions [Page 160] Generating ABAP Loads [Page 163] Converting Batch Input Logs [Page 163] Actions for the SAP Online Documentation [Page 164] Performing Post-Upgrade Activities in the Authorization Area [Page 164] Performing Post-Upgrade Activities for the Application [Page 166] Processing Table Clusters After the Upgrade (Source Releases 3.0x/3.Upgrading to 4.

If you want to install additional languages in your SAP System. Select the system that has been upgraded and choose SAP System → Update configuration. we recommend that you import new Support Packages into your system as soon as they become available. Always start with the newest SPAM update. you have to distribute the information about the new release to all systems in the transport domain.SAP AG Upgrading to 4. April 2001 153 . 3. This is how you avoid potential problems in your system before they occur. The Support Packages always contain the current language version for text-relevant objects. This is also applies after the upgrade. 2. Log on to the system that is configured as the domain controller. Procedure Import the newest Support Packages. you can also import them after the upgrade. For information on importing a language. Choose Extras → Distribute TMS configuration. Transport Management System: Distributing the Configuration Use After an upgrade. If have not included all the necessary Support Packages during the upgrade. This applies to Support Packages that cannot be included. 4. Call Transaction STMS and choose Overview → Systems. Procedure 1. such as the SPAM updates. perform the language import before you import the Support Packages. Add-On Support Packages and CRTs.6C Support Release 2: UNIX Importing Support Packages After the Upgrade Use To avoid problems with your SAP software. see Help → SAP Library → Basis Components → Change and Transport → Language Transport.

Log on as user DDIC in client 000. 154 April 2001 .5: 1. 2. Errors may occur if a background report was changed by the upgrade. Execute the report BTCTRNS2.6C Support Release 2: UNIX SAP AG Rescheduling Background Jobs Use Use this procedure to release all background jobs that were locked when you isolated the central instance. Procedure For Source Releases up to and including 4. 2. choose Job → Schedule → Release. since the report variants will no longer be correct. Call Transaction SM37. To release the jobs. Result The jobs are released. 3. you have to reschedule the job.Upgrading to 4. Log on as user DDIC in client 000.0B only: 1. If this is the case. Find all the relevant jobs. As of Source Release 4. 4.

Select the following jobs: Job name User name Start date from Start date to Only jobs with status DBA* * No entry No entry scheduled. April 2001 155 . Enter Transaction DB13 and reschedule your jobs.1x) Use You deleted all scheduled jobs at the start of downtime. Procedure 1. 2. 4. Enter Transaction SM37 in the SAP System. You can now schedule them again with Transaction DB13 (see also Isolating the Central R/3 Instance). ready.1x.0x or 3. Delete all the jobs displayed.0x/3. You have already checked that all old DB13 jobs were deleted properly. active 3.6C Support Release 2: UNIX Rescheduling Jobs with Transaction DB13 (Source Releases 3. released.SAP AG Upgrading to 4. Prerequisites • • Your source release is 3.

Reimporting Additional Programs Use During the upgrade. Log on as user <sapsid>adm. SUNOS_32 or LINUX_32. Procedure For more information on modification adjustment. you have to install them again from the CD Presentation. HP11_32. After you have completed the upgrade you have a maximum of 14 days to execute Transaction SPAU without a key check (SAP Software Change Registration) for the objects that you changed. HP11_64. see the documentation CD for the target release under Help → SAP Library → Basis Components → ABAP Workbench → BC . HP10_32. RLX_32. 2. Procedure 1. you must adjust these with Transaction SPAU. If you installed additional programs such as the RFC library or the CPIC library. the contents of directory /usr/sap/<SAPSID>/SYS/exe/run are completely deleted before the new SAP kernel is imported. in this directory. screens or interfaces (GUIs).6C Support Release 2: UNIX SAP AG Adjusting Repository Objects Use If you have made modifications to programs. Enter the following commands: cd /usr/sap/<SAPSID>/SYS/exe/run /<CD dir>/SDK/UNIX/<OS>/SAPCAR -xvf \ /<CD dir>/SDK/UNIX/<OS>/<additional package>. RLX_64. AIX_64.Upgrading to 4. 156 April 2001 .Changing the SAP Standard → The Modification Assistant → Upgrade Procedure/R/3 Support Packages → Adjusting R/3 Repository Objects. DEC_64.SAR Replace <CD directory> with the mount directory of the CD and <OS> with one of the following: AIX_32.

If you have already installed the current online documentation. Conversion Program.1x) Use As of Release 4.SAP AG Upgrading to 4. in the SAP System choose Help → Release Notes → Complete list from Rel. 4. DB Utility. Prerequisites Your source release is 3.0 → 40A → Basis Components → ABAP Workbench → ABAP Dictionary → Activation Program. MC. April 2001 157 . These exceptions are listed in the Release Note DDIC40_MC_MIGR Migration of Matchcodes to Search Helps. You can find this Release Note offline on the documentation CD. the matchcodes are migrated largely automatically to search helps. During the upgrade. Procedure Use Release Note Migration of Matchcodes to Search Helps to check if manual post-upgrade activities are necessary.0 the ABAP Dictionary objects help views and matchcodes are replaced by the new ABAP Dictionary object search help. SPDD → Migration of Matchcodes in Search Helps.6C Support Release 2: UNIX Migrating Matchcodes to Search Help Objects (Source Releases 3.1x.0x or 3. Only in exceptional cases do you need to perform postupgrade activities manually.0x/3.

The report unpacks the contents of the container tables and copies the data to the corresponding database tables. depending on the number of languages you have imported. use the following procedure to copy the data from the container tables to the database tables. If you want to use a glossary or terminology in your system. This data includes glossary and terminology data. Procedure Use the report RSTLAN_AFTER_UPGRADE to copy the data. This report may take a long time to execute. some data from the language CDs was only imported into container tables.Upgrading to 4. You are using a glossary or terminology in your system. The contents of the container tables are then deleted. and not yet imported into the actual database tables of the system. There are no input parameters. Prerequisites You have imported a language during the upgrade. 158 April 2001 . so execute it in the background.6C Support Release 2: UNIX SAP AG Performing Post-Upgrade Activities for the Language Transport Use To reduce downtime during the upgrade.

call Transaction DB13. you must update the optimizer statistics. End of DB2 for OS/390 April 2001 159 . Log on to the SAP System. Select a day in the Planning Calendar by double-clicking.SAP AG Upgrading to 4. 4.6C Support Release 2: UNIX SAP DB: Updating Optimizer Statistics SAP DB Use To improve the response of the database after the upgrade. In the role SAP_BC_DB_ADMIN_SAPDB. Procedure 1. to avoid a drop in your system performance. End of SAP DB DB2 for OS/390: Actions DB2 for OS/390 Removing Any Superfluous Database Objects Check if there are any empty database objects such as tablespaces. Do this with the report program RSDB2CLN. Plan this action as soon as possible. databases and stogroups. Select Create new optimizer/space statistics. 3. 2. The menu for scheduling database actions appears. delete them. If there are.

Use the sapdba program to delete the tablespaces. The program sapdba checks whether: 1. the tablespace is empty 2.Upgrading to 4. You can delete these tablespaces. 160 April 2001 . Procedure Enter the following commands as user informix: su . the space is actually released You may be asked whether you want to wait until Oracle releases the files. This applies to the following tablespaces in a Repository Switch upgrade: PSAPES<source release>D PSAPES<source release>I PSAPEL<source release>D PSAPEL<source release>I where <source release> is the source release for the current upgrade.informix /usr/sap/<SAPSID>/SYS/exe/run/ sapdba -updstat End of Informix Oracle: Actions Oracle Deleting Tablespaces After the upgrade. some tablespaces are empty and are no longer used.6C Support Release 2: UNIX SAP AG Informix: Performing an Update Statistics Informix Use To improve the response of the database after the upgrade. you must execute an Update Statistics as user informix.

6C Support Release 2: UNIX Delete the tablespaces as follows: 1. System performance is reduced considerably during this time. If the user system does not have the default password manager you need to append the following command options to the end of the sapdba calls: -u system/<password> Call the sapdba program with the following command: sapdba -analyze DBSTATCO You can do this during production operation.x. Actions for Cost-Based Optimizer Mode The following text only describes the actions for the database optimizer that you need to perform directly after the upgrade. Choose Tablespace administration. For background information on this subject. Enter the name of the tablespaces you want to delete. When you run the database in rule-based mode you significantly reduce the performance of the system. SAP no longer supports the parameter setting optimizer_mode = rule after the upgrade to 4. The cost-based optimizer requires table statistics to be created. Check the success of the action with one of the following options: April 2001 161 .1x) You must switch the database optimizer to cost-based mode after the upgrade.SAP AG Upgrading to 4. see the following documentation on the documentation CD for the target release under: • SAP Library → BC . 2. 4. Choose Drop tablespace.0x/3.Basis Components → Database Interface/Database Platforms → Database Administration (Oracle) with SAPDBA → Using SAPDBA Read about the following topics there: − − • Support for the Cost-Based Optimizer SAPDBA Command Options SAP Library → Basis Components → Computing Center Management System → Database Administration in CCMS → SAP/Oracle DBA in CCMS → CCMS Support for the Cost-Based Optimizer: Oracle Switching the Optimizer Mode (For Source Releases 3. If the tablespace is empty. You can make this switch during production operation. The runtime depends strongly on the size of your database and can take several hours. Proceed as follows: 1. 3. sapdba executes the Drop command on the database and deletes the data files at the operating system level. Start sapdba at the operating system level as user ora<sapsid>.

x before the upgrade. send a problem message and the log file to SAP. 2. System performance is reduced considerably during this time.x) If you had Release 4. Restart the database to activate the parameters. Scheduling Periodic Statistics Updates (For All Source Releases) Make sure that the statistics are updated at regular intervals.opt If there are errors. The Optimizer must be set to cost-based mode. $ORACLE_HOME/sapcheck/*. End of Oracle 162 April 2001 . Friday/Saturday night): sapdba -checkopt PSAP% (for example. Saturday/Sunday night): sapdba -analyze DBSTATCO You can schedule these actions with transaction DB13. Updating the Statistics (For Source Release 4. make sure that the return code is either 0 or 1 by choosing: Tools → CCMS → DB Administration → Operations Monitor Check the logs in the file system if necessary. see the online documentation under Help → Application help. Make sure that the following parameters are set in the file $ORACLE_HOME/dbs/init<SAPSID>. If the user system does not have the default password manager you need to append the following command options to the end of the sapdba calls: -u system/<password> Call the sapdba program with the following command: sapdba -analyze DBSTATCO You can do this during production operation.aly or *.Upgrading to 4. After the upgrade you only need to update the statistics. If you cannot solve the problem yourself.6C Support Release 2: UNIX SAP AG − − In the SAP System. your database is already running in cost-based optimizer mode. you can analyze the cause by double-clicking the log line and pushbutton SAPDBA Detail Log in the menu above.ora: optimizer_mode = choose db_file_multiblock_read_count = 8 3. For more information on DB13. Correctly created optimizer statistics are essential for the performance of your system. Schedule the following two phases periodically once the database has been in operation for one day following the upgrade: Phase I Phase II (for example.

All old batch input logs must be converted with the program RSBDCLCH in all clients.6B. However. Transaction SGEN offers the following functions: • • • • Selection of predefined generation tasks. Prerequisites Your source release is lower than 4.6A or 4. Converting Batch Input Logs Use Release 4. SAP_BASIS and so on) Generating in the background Job Monitor for checking the progress of the generation in the background Procedure If possible. When you call a program. or in the Job Monitor by choosing Job Monitor. however. For a detailed description of the features. see the online documentation in transaction SGEN by choosing Information on the SAP Load Generator. Choose Regenerate after an SAP System upgrade. if it does not already exist.6A. For more information on the free space requirements in the load tables.6C only supports the new batch input log procedure. This may. otherwise the system will no longer be able to read them. April 2001 163 .6C Support Release 2: UNIX Generating ABAP Loads Use The most important ABAP loads for the Basis system are upgraded with the new release. you can use transaction SGEN to generate the missing loads. Procedure For an exact procedure and other information. a load is automatically generated. there are not yet any generated ABAP loads for all the transactions from the different SAP application areas. The old log files are deleted after a successful conversion. see SAP Note 186066.SAP AG Upgrading to 4. or you have not yet converted your logs in Releases 4. see Note 175596 in SAPNet – R/3 Frontend. generate the loads directly after the upgrade. reduce production system performance. Selection of software components to restrict the amount of objects being generated (SAP_ABA. To avoid this.

164 April 2001 . For source releases as of 3. You can change these values with Transaction SU24.Upgrading to 4. Installation of a Web browser/viewer For instructions.6C Support Release 2: UNIX SAP AG Actions for the SAP Online Documentation Process Flow Certain actions are necessary before you can display the online documentation (SAP Library) in your SAP System: 1. This transaction • • displays the differences between your own check flags or authorization proposals and the new SAP default values for all the changes by SAP defines all the roles which will have to be generated later on using the profile generator in order to generate authorizations for all the current checks For more detailed information. use Transaction SU25 (steps 2 and 3).1G. Performing Post-Upgrade Activities in the Authorizations Area Procedure Adjusting the Assignments Between Check Flags and Transactions Transaction SU24 was introduced in Release 3. Maintain the settings variants for the Online Help in the IMG 4. You can use it to: • • Deactivate checks within a transaction Define proposals for the profile generator for activated checks Both the check flags and the proposed values are based on SAP default values. use Transaction SU25 (step 1). Only for help type PlainHtmlHttp: Set up the Web server 3. see the guide Installing the SAP Library. Installation of the online documentation 2.1G: To copy the SAP default values.1G: To copy the latest SAP default values while retaining your own modifications. For source releases before 3. see the online documentation for Transaction SU25.

April 2001 165 .0D Only: User SAPCPIC Must Be Assigned the Profile S_A. which is used for internal purposes and which in the past did not need any authorizations.6C Support Release 2: UNIX For Source Release 3. Release 3. For Source Release 3.0E contains a new authorization check against authorization object S_TCODE when starting all transactions. To do this. Enter the authorization profile S_A. If this is not the case. After the upgrade the user administrator should go through the profile SAP_NEW and decide for each authorization object. This defines which users can continue to carry out the corresponding actions. This is how the composite profile is also given the overall authorization for the check S_TCODE (exists since Release 3.CPIC . than was previously the case. Ensure that all the users have authorization profile SAP_NEW so that they can still start transactions. It contains the authorizations only for new checks in functions that were already delivered. Composite profile SAP_NEW contains all the individual SAP_NEW_<Rel> profiles since Release 2. Keep the single profiles SAP_NEW_<rel>. The authorizations for these new objects are in the single profiles SAP_NEW_<rel> .1E). This also has an effect on user SAPCPIC. This has made it necessary to assign new authorizations (see Release Note BC_30E_AUTHORITY). delete all the individual profiles from SAP_NEW that refer to releases that are lower than the source release for the upgrade. remove the single profile SAP_NEW_<rel> from the composite profile SAP_NEW. The composite profile SAP_NEW contains all single profiles SAP_NEW_<Rel> (as of Release 4. Before this. Empty and activate the profile SAP_NEW after finishing the analysis and maintenance. The profile SAP_NEW does not contain the authorizations for functions delivered in the upgrade.SAP AG Upgrading to 4. go to Transaction SU01 and enter the user SAPCPIC. This guarantees that users can continue to carry out those functions after an upgrade. In a later phase you can begin to assign special profiles with exactly the transactions to be executed by the users. so that you can find out later which authorization appeared in which release.0D Only: New Authorization Check when Starting all Transactions For security reasons. the naming convention S_NEW_<rel><number> is valid). Upwards Compatibility for Authorization Checks There are functions that are protected in more detail by new authorization objects in the new release. Assign user SAPCPIC (in the clients in which it exists) profile S_A. which they were able to carry out previously without an authorization check.6A. To do this. you can temporarily enter the profile SAP_NEW for all users with Transaction SU01. Choose User names → Change. into which customer profile the authorizations should be copied.CPIC and save. where <rel> is the release for which the new authorization check was delivered.1C. Every user should have the profile SAP_NEW in his or her master record.CPIC New authorization checks were introduced in the interface from the SAP System to the operating system. choose Environment → Mass changes. To do this.

For SAP Retail Customers Only: Replacing Short Texts You are advised to replace short texts for some languages.6C Support Release 2: UNIX SAP AG Handling Problems with User Buffers If the user master records were already very large before the upgrade. The precise procedure is described in the section Backing Up Wage Types in HR (T512W) [Page 103]. 166 April 2001 . You can make the necessary Customizing settings in the release-specific Customizing project by calling Transaction SPRO. Also check to see if you have to adapt your Customizing. see the Online Documentation under Help → SAP Library → Logistics → SAP Retail → Basic Principles → Retail Terminology. For more information. To do this call Transaction SPRO_ADMIN or choose Tools → AcceleratedSAP →Customizing →Project Administration. reload it now. HR Customers Only: Restoring Table T512W (Wage Types in HR) If you saved table T512W before the upgrade. see Note 10187.Upgrading to 4. If you encounter authorization problems after the upgrade where authorizations are missing for users although these are contained in the master record. the predefined buffer size might not be large enough for the newly delivered profiles. Performing Post-Upgrade Activities for the Application Use Some applications require specific post-upgrade activities without which the application cannot execute. Procedure These actions are described in the Release Notes for the particular application. You can create a release-specific view of a Customizing project by choosing the activities for delta or upgrade Customizing.

0x or 3. PREPARE warns you about any outstanding conversions.SAP AG Upgrading to 4. End the conversion. After a while.6C Support Release 2: UNIX Processing Table Clusters After the Upgrade (Source Release 3. Any data that has not yet been transferred is included in the process. Call transaction ICNV. Monitor the progress of the action.1x. The time when you process the table clusters is not critical. When at least 95% of the data has been converted. To do this. 5.0x/3. Read the online documentation. the table clusters EDIDOC and CDCLS are converted from Release 3. If you have not. choose the function button F1. As soon as the tables have the status Done.x. You will not be able to start the upgrade. Since there is often a large amount of data to handle. To do this. choose Control → Switch (STRG+F2). Directly after the upgrade. Procedure 1. If they do not. choose Control → Data transfer → Start. choose Control → Delete entry. 4. the estimated time for the remaining data transfer appears automatically. but it must be done before you begin the next upgrade. you can delete them from the list. This considerably reduces the downtime during the upgrade. You can then select the tables you want to delete and remove them from the list. For more information on the individual fields. create a problem message under the component BC-UPG-TLS. the tables EDIDOC and CDCLS must have the status Conversion.1x) Use After the upgrade. 3. switch to the new tables. 2.x to Release 4. You must complete step 5 before you start the next upgrade. Prerequisites Your source release is 3. You now have the option of selecting tables and starting the process in the background. you can use transaction ICNV to convert the table clusters during production operation of the system. To start the data transfer. April 2001 167 .

5B.Upgrading to 4.4. 168 April 2001 . Procedure Proceed as described in Note 137478 Installing a Dialog Instance/Gateway .6C Support Release 2: UNIX SAP AG Installing More Dialog Instances Use You can use the SAP tool R3SETUP to install more dialog instances in an SAP System.

3. Check if the SAPNet . 4.R/3 Frontend. The times are displayed in the file R3up. To display the data to be transferred. Execute the program RSUPGSUM using Transaction SE38. Choose Transfer data. Call Transaction SCUI. The procedure is very simple: 1. Result The report writes data into a log file and generates a list approximately two pages long.RTS in the subdirectory log of the upgrade directory which R3up automatically creates after the upgrade. Choose Customizing and select that at least the option Run time results of completed upgrades and return to the previous screen. 4. The data was formatted previously using RSUPGSUM.SAP AG Upgrading to 4. you can fax the RSUPGSUM list to us at: SAP AG Software Logistics department Fax number + 49 6227/7 46495 April 2001 169 . 2. Procedure 1.6C Support Release 2: UNIX Evaluating the Upgrade Runtime Use You can use the report RSUPGSUM to display the upgrade runtime. Prerequisites You are logged on to the SAP System. 3. 2. only those phases which have a significant effect on the runtime are displayed. Send the results of the report to SAP for further analysis.R/3 Frontend. for example. Enter the relevant information. Enter the time required for modification adjustments. If you keep the default settings. database size. you can send this data electronically. If you do not yet have a link to the SAPNet . Choose Program → Execute and print. choose Display data.R/3 Frontend connection exists. If you have a connection to the SAPNet .

also read the SAPNet .R/3 Frontend Notes.6C Support Release 2: UNIX SAP AG Troubleshooting • Logs − − Upgrade Logs [Page 171] Analyzing the ELG Log Files [Page 173] • Correcting Errors After Phases − − − − − − − − Correcting Errors in the ACT Phase [Page 175] Correcting Errors in the ADOIM Phase [Page 176] Correcting Errors in the XPRAS Phase [Page 177] Cleaning Up Terminated Conversions in the DB Conversion Phases [Page 179] Correcting Lost Fields Problems in the PCON Phase [Page 182] Correcting Conversion Errors in the PCON Phase [Page 183] Correcting Errors in the Job Phases [Page 184] Correcting Entries from the INITPUT and INITSUBST Phases [Page 185] • General Problems − − − − − − − − Preparing the Restart of the Upgrade After a System Failure [Page 186] Resetting the Upgrade [Page 187] Scroll Mode: Restart [Page 191] Correcting Problems when Processing ABAP Steps [Page 192] Correcting Problems when Starting the SAP System [Page 193] Correcting Problems when Copying SAP Programs [Page 194] Correcting Administrator Profile Problems on Application Servers [Page 195] Providing SAP Local Support with Information [Page 196] As well as the problems listed here. 170 April 2001 .Upgrading to 4. Request the Notes [Page 40] that are relevant to this upgrade.

open another terminal window and execute the following command: tail -f <upgrade directory>/log/SLOG46C Each tp-driven phase is divided up into a number of different steps whose start and end times are noted in the SLOG log. Additional detailed logs are usually written for these tp steps. A simple method of monitoring the progress of all tp-driven phases is to observe the SLOG log using tail. You can use these log files to monitor your upgrade. Functions R3up records all actions in the log file R3up. To do this.6C Support Release 2: UNIX Upgrade Logs Use R3up logs all actions in log files. If you encounter any errors you can analyze them to help you find a solution. The section in the SLOG relating to phase ACT_46C looks like this: START START STOP START STOP START STOP START START STOP STOP START STOP START STOP START STOP START STOP STOP put tpsetstopm tpsetstopm tplock_eu tplock_eu tpsapstart tpsapstart DD ACTIVAT tp_getprot tp_getprot DD ACTIVAT locksysX locksysX tpsapstart tpsapstart locksys locksys tpdequeue tpdequeue put Q1A Q1A Q1A Q1A Q1A Q1A Q1A Q1A Q1A Q1A Q1A Q1A Q1A Q1A Q1A Q1A Q1A Q1A Q1A Q1A ( ( 3 3 A A { { 3 3 | | 0000 19940905200903 19940905200903 19940905200903 19940905200903 19940905200904 19940905200904 19940905200935 19940905200936 19940905200936 19940905202559 19940905202559 19940905202559 19940905202559 19940905202600 19940905202631 19940905202631 19940905202631 19940905202631 19940905202632 19940905202632 q1aadm q1aadm q1aadm q1aadm q1aadm q1aadm q1aadm q1aadm q1aadm q1aadm q1aadm q1aadm q1aadm q1aadm q1aadm q1aadm q1aadm q1aadm q1aadm q1aadm hs0102 hs0102 hs0102 hs0102 hs0102 hs0102 hs0102 hs0102 hs0102 hs0102 hs0102 hs0102 hs0102 hs0102 hs0102 hs0102 hs0102 hs0102 hs0102 hs0102 Additional detailed logs are also written for most steps.SAP AG Upgrading to 4. The tp steps are also listed in the file SLOG46C in the subdirectory log of the upgrade directory.log in the subdirectory log of the upgrade directory. The start and end of a phase are indicated by the lines START put and STOP put. After the various steps of the April 2001 171 . These are in the tmp subdirectory of the upgrade directory. where you can also monitor them with tail -f.

If no errors occurred.<SAPSID> PL<DATE>.<SAPSID> SAPI??????. You should check at least level 2 to display any error messages this level may contain. After completing each tp-driven phase.<SAPSID> C<DATE>.<SAPSID> SAPA??????. enter the name of the transport request (for example. 172 April 2001 . The names of the summaries usually comprise the phase name (without the underscore) and the extension .Upgrading to 4. you can also display them in the SAP System. A brief overview of all the logs existing for this transport request is displayed. In the field Transport request.<SAPSID> SAPD??????.<SAPSID> PA<DATE>. At level 1 only the return code for the step is displayed.<SAPSID> PD<DATE>. you only need to check these summaries. If you double click one of the lines. SAPK46CD01) and then choose Execute. it displays all the logs for a specific transport request.<SAPSID> N<DATE>.<SAPSID> SAPR??????. their log names.6C Support Release 2: UNIX SAP AG phase have been completed. The summary contains the names of the individual logs. You can do this by executing program RDDPROTT with Transaction SE38. which means.<SAPSID> P<DATE>.<SAPSID> DS<DATE>.<SAPSID> Program executing the step R3trans R3trans SHADOW_IMPORT DD IMPORT (H) DD ACTIVATION (A) DISTRIBUTION OF DD OBJECTS (S) TBATG CONVERSION OF DD OBJECTS (N) tpmvntabs ABAP program (RDDMASGL) ABAP program (RDDDIS0L) ABAP program (RDDGEN0L) tp MAIN IMPORT (I) tpmvkernel (C) TBATG CONVERSION OF MC OBJECTS (N) IMPORT OF SELFDEFINED OBJECTS (D) VERSION UPDATE (V) EXECUTION OF REPORTS AFTER PUT (R) R3trans tp ABAP program (RDDGEN0L) ABAP program (RDDDIC1L) ABAP program (RDDVERSL) ABAP program (RDDEXECL) Once the logs are located in the subdirectory log of the upgrade directory. you branch to the log display for the step in question. The logs are broken down into several levels. When you double click an error line. any errors which occurred and the return codes.ELG). a description of the error is displayed. The table below contains the most important steps.<SAPSID> SAPH??????. R3up creates a summary of all individual logs in this phase.<SAPSID> SAPV??????. DDIC46C. RDDPROTT works based on transport requests. and specifies which programs carried out the steps: Step Log name SAPK??????.ELG (for example. tp moves the individual logs to the subdirectory log of the upgrade directory.<SAPSID> N<DATE>.

then tp or a program called by tp has terminated.SAP AG Upgrading to 4. Double-click the error line to display the long text for the error. enter the following commands: ls -ltr <upgrade directory>/log ls -ltr <upgrade directory>/tmp 3. If you use a user ID other than DDIC to log on to the SAP system and correct the error. and no error messages appear for that step. analyze the last log that was written. you must analyze the job log in the SAP System to determine the cause of the error. From these files. you can call up detailed log files that contain more information. Double-click the canceled job to display the log.. Errors have occurred if the return code is equal to 8 and preceded by error messages or if the return code is higher than 8. Determine when the program terminated from the last two lines of the SLOG log.exe/tp locksys <SAPSID> April 2001 173 . the SAP System may block the logon. 2. When errors are detected during a phase.exe/tp unlocksys <SAPSID> .exe/tp unlock_eu <SAPSID> Log on to the SAP system and correct the error. Analyze the errors. For a chronological list of the files in both log directories. The job overview normally displays one canceled job and one background job that completed normally.. Procedure 1.6C Support Release 2: UNIX Analyzing the ELG Log Files Use The <PHASE>. In this case. Log on as user DDIC and call transaction SM37. Enter the job name as the name of the report that usually processes the terminated step (RDDMASGL for DD ACTIVATION. for example). If tp or R3trans have terminated. The name of this log is listed in the header of each phase step. R3up displays an appropriate message and prompts you to repeat that phase. 4.. If a return code is greater than or equal to 12. Enter the following commands to lock the SAP System again: cd /usr/sap/put/bin . If a background step in the SAP System terminates. First check the <PHASE>. using the detailed log file if necessary. Make sure that the date in the SM37 input screen is correct and that an asterisk (*) appears in the Start after event field. proceed as follows: Enter the following commands to unlock the SAP system: cd /usr/sap/put/bin .ELG log files are summary log files that contain a list of all the errors that occurred during a specific phase of the upgrade.ELG log to find out why the phase terminated: No errors have occurred if a return code less than 8 appears in the log at the end of a step.

contact SAP Local Support. In this case. If you are not sure how to proceed. R3up does not require a password. you must get approval to ignore the error from SAP Local Support. Generally./exe/tp lock_eu <SAPSID> 5. 174 April 2001 . SAP Local Support also gives you the password that you need to correct the error. you can choose ignore in R3up to continue with the upgrade and avoid repeating the failed phase. R3up prompts you to enter a password if the errors are serious.Upgrading to 4. since the transport control program tp automatically starts from the point at which it terminated. Remove all errors to avoid the risk of follow-on errors.. When you choose ignore. A return code of 8 indicates that some individual objects have not been processed or not been processed completely. A return code of 8 indicates that some errors have occurred. repeat the phase by selecting repeat in R3up. Result In some exceptional cases. The repeated phase is usually completed quickly.6C Support Release 2: UNIX SAP AG . otherwise the phase is complete. Once you have found and corrected the error. you must always remove the cause of the error. In this case.

you can proceed with the upgrade where it terminated in the ACT_<rel> phases by selecting repeat in R3up. If you had to unlock the SAP System. Log off the SAP System. Workbench Organizer) Release 4. 2. 7. The user DDIC cannot make any changes to the SAP System. If you choose ignore severe errors. 6. Log on to the SAP System as user DDIC.. Choose Release 3. Proceed as follows: 1.... April 2001 175 .exe/tp unlocksys <SAPSID> Procedure 1. error messages with return code 8 might occur during the ACT_<Rel> phase.SAP AG Upgrading to 4.. 2.6C Support Release 2: UNIX Correcting Errors in the ACT Phase Use If your SAP System has been modified. cd <upgrade_directory>/bin.exe/tp locksys <SAPSID> Result When you have manually corrected all the error situations displayed for the objects.x: Expert tools → . 5. Log on as a user other than DDIC.x: Administration → Set System Change Option → Global setting. Return the system change option to its previous value. you might need to unlock the SAP System. Log on as user <sapsid>adm. This procedure tells you how to remove these errors. Make the required corrections. Enter the following command: cd <upgrade directory>/bin . Prerequisites Before you can correct ABAP Dictionary objects that cannot be activated. as described under Prerequisites. 3. Call Transaction SE03. all error messages with return code 8 are ignored. 8. → Modifiable 4.for setting the system → Set System Change Option → All objects (w. lock it again with the following command..

• 176 April 2001 . error messages with return code 8 may occur during the ADOIM_<rel> phase. The objects with errors are not imported into the SAP System.Upgrading to 4. Before you can choose ignore. Result • If you choose repair severe errors. R3up goes to the next phase without dealing with the rest of the objects. The errors must be removed after the upgrade. you must have approval from SAP Local Support. R3up gives you two options for continuing the upgrade: • • repair severe errors ignore all errors Procedure Choose repair severe errors. If you choose ignore all errors. You require a password for ignore all errors.6C Support Release 2: UNIX SAP AG Correcting Errors in the ADOIM Phase Use If your SAP System has been modified. If you choose ignore. R3up repeats the phase and ignores all error messages with return value 8 (eight).

If you need more information. R3up stops and informs you that all errors which occurred have been recorded in the XPRAS_<rel>.SAP AG Upgrading to 4.6C Support Release 2: UNIX Correcting Errors in the XPRAS Phase Use If errors occur during the execution of XPRA reports in the XPRAS_<rel> phase. position the cursor on the error message and choose Long text. Log on to the SAP System. These texts usually contain all the information you need to correct the error. The file name always has the following format: SAPR<ID>. To display the individual transport logs. 3. To navigate to the log display for this step. choose Goto → Transport logs. To access this information. Correcting Errors 1. The help text helps you correct the error. 2. You can display a detailed help text for each of these error messages in the SAP System.ELG file is important for finding help. 3. log April 2001 177 . The file name <file_name> given in the heading of the XPRAS_<rel>. In the log XPRAS<Rel>. Replace the ‘R’ with a ‘K’ and delete the period and all characters that follow it. Choose Request/task → Display individually and enter the name of the transport request. 5. You can expand the log to view it in more detail. Procedure Finding Help Texts for Error Messages 1. repeat the upgrade phase with R3up. You now have SAPK<ID> as the name of the transport request. 4. Call transaction SE09. 2. When you have corrected all the errors. double-click the line Exec after put. This file contains error messages with the following header: ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ XPRA ERRORS and RETURN CODE in <file name> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ If this header is followed by lines other than the return code. The name of the relevant transport request can be derived from the two names. or if the report still results in errors after repeating the XPRAS_<rel> phase. Follow the instructions in the help text precisely. In addition to the actual error lines.ELG look for the file name <file name> displayed in the heading.ELG log. 6. see the documentation on the report. To display a help text. a separate line indicates the names of the reports that generated the preceding error messages. then errors have occurred while the reports were being executed. The error messages will generally be visible as of the second level.<SAPSID> where <ID> can be any string of six characters.

If you choose ignore. and the corresponding specialists are not available right now. The objects with errors are not imported into the SAP System. Correcting Errors After the Upgrade We recommend correcting errors as soon as they are detected. If you cannot execute an XPRA later and still want to skip it. This option makes sense. you can correct some errors that occur during the execution of XPRA reports after you have completed the upgrade. 4. contact SAP. Only skip an XPRA report program if you are sure you can execute it later (for example. R3up gives you two options for continuing the upgrade: • • repair severe errors ignore all errors Choose repair severe errors. without executing the following XPRAs. R3up then continues with the next phase. you must suppress the execution of the corresponding report before you repeat the upgrade phase. After the upgrade. for example. R3up repeats the phase and ignores all error messages with return code 8.6C Support Release 2: UNIX SAP AG on to the SAP System. you must have approval from SAP Local Support. For technical instructions on skipping an XPRA. when special measures in the SAP application areas are necessary to correct the errors. correct the error and run the report manually using transaction SE38. if an SAP Note tells you that this is allowed). This documentation is always available in English and German. 178 April 2001 . You require a password for ignore all errors.Upgrading to 4. Before you can choose ignore. To do this. The errors must be removed after the upgrade. see SAP Note 122597. Call transaction SE38 and display the documentation for the report that is named in the error log. However.

This prevents the conversion being continued automatically. Continue with step 4 (Continuing the conversion to the end). Also check if the table contains the data you expect.5A). You can do this with Transaction SE16. You can now use Transaction April 2001 179 . choose Object log.5A) is harmless in this case. You can see the detailed display for a particular table by double-clicking. CNV_CHK_XT and CNV_CHK_SW.SAP AG Upgrading to 4. The log does not contain an error message. If the data does not exist. You could encounter the following problems here: a. This shows that the conversion process was stopped by an external event. CNV_CHK_IMP.6C Support Release 2: UNIX Cleaning Up Terminated Conversions in the DB Conversion Phases Use These errors are indicated by the following PREPARE and R3up error messages: • • Restart logs of DB conversions found Outstanding DB conversions found These errors can occur in the phases CNV_CHK_GEN. Procedure for Restart Logs of DB Conversions Found To clean up terminated conversions indicated by the message Restart logs of DB conversions found. If both messages appear. Check the meaning and status of the table. however. the table was already corrected without the reset log being deleted. proceed as follows: 1. You cannot find a log because it was deleted at some time in the past. In some cases. choose the function Cancel adjustment in the detailed display (Unlock table as of Release 4. process the message Restart logs of DB conversions found first. 3. Find out if the table is still needed. Start up the database utility (Transaction SE14) and choose DB requests → Terminated. Contact your Basis consultant or SAP Local Support for assistance with saving this data. The function Cancel adjustment (Unlock table as of Release 4. but ends abruptly. A list of the terminated conversions appears. Any data which is still in the temporary table is lost during the next conversion. If the table is no longer needed. Ask the last person who changed a table or to the table owner to find out its status. Look for error messages that explain the cause of the termination. The table itself does not return to a consistent status. If you find out that the table is still needed. You can determine the status of the table with the function Check → Database object and Check → Runtime object. Determine the cause of the error. it could still be in the temporary table. for example. Sometimes there are test tables which are no longer needed. 2. b.

You now have two possibilities: a. Repeat the analysis from step 3 (Determining the cause of the error). views and matchcode objects. contact a Basis consultant or SAP Local Support. 3. and to look for the cause of the error. proceed as follows. Choose the function All requests. after several attempts. If the user does not want this. the Check function does not display any further problems. 1. A log now exists. you must correct it. Process the outstanding requests. if the log clearly gives a reason for the error.6C Support Release 2: UNIX SAP AG SM21 to read the system log to find out the approximate time of termination. choose the processing type Background. a. b. This displays the worklist that was not processed correctly during the last upgrade. Ask the last person who changed the object if the request should still be processed. Start up the database utility (Transaction SE14) and choose DB requests → Mass processing. b. The requests which are found do not always have to be terminated. select the request and choose the function Delete selected. If.Upgrading to 4. b. They might not even have been started. Continue the conversion to the end. This worklist was generated by developments or modifications in your SAP System. You now see the worklist of the conversion program. execute the function Continue adjustment. proceed as follows: Process this message after you have processed the message Restart logs of DB conversions found. Procedure for Outstanding DB conversions found To clean up terminated conversions indicated by the message Outstanding DB conversions found. you still cannot complete the conversion. 180 April 2001 . Choose DB requests → Created with import. The conversion finished successfully. a. 2. but has not yet been processed. However. and there is a success message in the object log. c. The objects are thus removed from the work list of the conversion program. this procedure can also include requests for indexes. Determine the objects that are affected. In contrast to the procedure for the message Restart logs of DB conversions found. You can see this because the error message disappears. 4. In the detailed display. Check the meaning and status of the requests. Do not remove requests from the last upgrade. The conversion terminates again. Since you do not know how long this will take.

or continue it. April 2001 181 . choose the processing type Background.6C Support Release 2: UNIX You can select the requests from the list of mass processing requests and schedule a job for execution with the function Schedule selections. Schedule the request. a. b. Since you do not know how long this will take. Go to the detailed display of the object by double-clicking it in the list of requests created by the import.SAP AG Upgrading to 4.

although it did not appear in SPDD In this case. If table BSEG is specified. a further check is made in phase PCON_<rel>. If you do not want to keep the fields name in the log. continue the upgrade with do not repeat check. Read the information in Note 73999.Upgrading to 4. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 2WETG450 Table <name> is losing customer fields. The transaction does not recognize any modifications that were already made without the correction system.<SID>. In addition. 182 April 2001 .. conversions could take a very long time. a. Normally. do not choose suppress.. 2. you must insert them in the ABAP Dictionary.6C Support Release 2: UNIX SAP AG Correcting Lost Field Problems in the PCON Phase Use Transaction SPDD cannot find all the modifications to the standard and make the relevant decisions. Recommendation: Insert the lost fields in the identical positions before continuing. If you want to keep the fields named in the log. Then activate the corresponding table. b.. customer extensions to the standard are lost and indexes or views can become inconsistent. since conversion is only possible on database systems that allow a table to contain more than 254 fields. table BSEG is so large that you should avoid converting it. Also read Note 73999. tables that cannot be converted and RETURN CODE in FDSAVPRT. For this reason. Analyze the log FDSAVPRT. The log therefore might contain the following message: ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Lost fields. Also read Note 24864. Procedure 1.

This field was also used in an index or view. you decided to return to the standard definition of the table (using Transaction SPDD) and this additional field was removed. and the ACT_<REL> phase was completed with ignore. however. Some of them. In the above example. Procedure 1. To do this.ELG. 3. Logical errors in the object definition Correct the objects. are already detected by the system before a command can be given to the database. however. Also check whether the objects which are not contained in the standard and which are now incorrect can be deleted completely. you could. For more information on alternative procedures. a. If necessary. This type of error frequently occurs if you decide to revert to the SAP standard during Transaction SPDD (ACT_<rel> phase). Repeat phase PCON_<rel>. April 2001 183 . for example. b.6C Support Release 2: UNIX Correcting Conversion Problems in the PCON Phase Use This procedure enables you to correct problems that occur in phase PCON_<rel>. however. • Logical errors in the object definition These could also appear in the form of SQL errors. see Note 177680. is incorrect since the relevant table field is missing. In phase ACT_<rel>. Remove the cause of the error.SAP AG Upgrading to 4. The index or view definition. Technical problems on the database Read the documentation in the database system about how to correct the error. Often it concerns insufficient disk space. Analyze the log PCON_<rel>. extend. If the index definition is not corrected. remove the deleted field from the index or view definition or re-insert the deleted field into the table. there will be errors when the objects are created. you can use Transaction SE11. 2. A field was added to an SAP table. for example. tablespaces or dbspaces. The errors can roughly be divided into two classes: • Technical problems on the database You can recognize these in the SysLog (Transaction SM21) since they are marked with SQLERROR followed by an abbreviation with an error number.

start by checking if a background job was started at all. where <Name> is the name of the job or report. These error messages can sometimes be ignored. If there is no Note explaining this error. proceed as described in Providing SAP Local Support with Information. this is generally due to a syntax error in the calling program. If no background job was started. Procedure To analyze problems with a job phase. • The job was terminated normally. Enter Transaction SM37 and narrow down the start time and start date as far as possible. In this case R3up does not require a password if you choose ignore. contact SAP Local Support. there are two possible cases: • The job was abnormally terminated. In this case. Check if the error can be reproduced by selecting repeat in R3up. If the error occurs again. Proceed as follows: 1.6C Support Release 2: UNIX SAP AG Correcting Errors in the Job Phases Use A job phase starts a background job in the SAP System and waits for it to end. 2. If the background job was started. but with error messages.Upgrading to 4. If you are unsure how to proceed. Log on to the SAP System as user DDIC. call SAP Local Support. The naming convention for the job phases is JOB_<Name>. 184 April 2001 . contact SAP Local Support.

In the main menu of the Upgrade Assistant. enter the following command: set stdpar To change the password of the user DDIC. enter the following command: R3up set rswpar 3. use the start mode init. Procedure If you are using the Upgrade Assistant: 1. you can correct them. you have the option of only changing the password of the DDIC user. Choose exit to exit R3up and then restart the upgrade as described under Restarting the Upgrade [Page 109].SAP AG Upgrading to 4. choose Administrator → Start R3up with option.6C Support Release 2: UNIX Correcting Entries from the INITPUT and INITSUBST Phases Use If in later phases you find that entries you made in the INITPUT and INITSUBST phases were incorrect. April 2001 185 . the password of user DDIC is changed during the upgrade. enter the following command: set DDICpwd 3. If you need to correct entries made in INITSUBST . Frequently. enter the following command: set rswpar 4. If you are using scroll mode: 1. Restart R3up. To start the current phase. use the start mode init. If you need to correct entries made in INITPUT. So that you do not have to reconfirm all the entries you made in the INITPUT phase. To do this. This is the reason why background jobs could not be started in the JOB_<name> phases. 2. enter the following command: R3up set DDICpwd 2. If you need to correct entries made in INITSUBST . If you need to correct entries made in INITPUT. enter the following command: R3up set stdpar To change the password of the user DDIC.

and R3trans are no longer able to perform certain debugging operations. delete all the released background jobs related to the processing of a phase with the exception of RDDIMPDP. the logs from the subdirectory tmp of the upgrade directory are added to the logs in the subdirectory log and no logs are overwritten. 6. 186 April 2001 .. 2. Log on to the SAP System as user DDIC and delete all the entries from table TRBAT using Transaction SM31. This ensures that if there are identical names. Move all the logs contained in the subdirectory tmp of the upgrade directory into the subdirectory log of the upgrade directory. tp. 4. Start the SAP System. you must ensure that a number of requirements for successful restarting of the upgrade are met: Procedure 1. Using Transaction SM37. run the report RSBTCRPR. for example) R3up. 5. Before restarting the upgrade after a system failure. 3. To change the status of all the current or active background jobs to 'terminated'. cd <upgrade directory>/tmp cat <log name> >> .6C Support Release 2: UNIX SAP AG Preparing the Restart of the Upgrade After a System Failure Use If the system fails (due to power failure.Upgrading to 4. Use the following commands to copy a log to a new location. and then delete these jobs using Transaction SM37. Restart the upgrade as described under Restarting the Upgrade [Page 109]./log/<log name> rm <log name> 7. Cancel any background jobs that have already been restarted using Transaction SM50.

Also perform one or more of the following actions. 2.SAP AG Upgrading to 4.6C Support Release 2: UNIX Resetting the Upgrade Use You need to take different measures to reset the upgrade (because of hardware problems. The safest method is to reload a complete backup of the whole system. depending on the progress of the upgrade: If the phase MODPROF_TRANS ENVCHK KX_SWITCH has already been completed Reset the SAP profiles Reset the user profiles Reset the SAP Kernel 3. For additional information on resetting an upgrade. It could be necessary to downgrade these software components after upgrading the operating system and/or database system in order to restart the production system. Restart the upgrade with PREPARE. including the operating system. for example). see the log file R3up. see the vendor’s specifications. You need to distinguish between two cases: • • Database failure without loss of the upgrade directory Loss of the upgrade directory The actions you need to take are listed in the following section depending on the selected upgrade strategy and the progress of the upgrade. you might also have to reset the SAP Kernel and the SAP profiles. Delete the upgrade directory. Reset the database to the state it had before the SAP upgrade.log. These actions are listed in the tables below: The actions are explained in more detail later. For downgrading options. To perform these actions. 4. see the end of this section under Detailed Description of the Individual Actions. Upgrade Strategy A_off 1. For information on the progress of the upgrade. contact SAP Local Support. April 2001 187 . depending on what stage the upgrade has reached. Procedure After Database Failure Depending on the upgrade strategy you have chosen and the stage of the upgrade reached. If you have any questions. see SAP Note 158358. Some of the actions are listed in italics. In addition to resetting the database. you need to perform various actions.

If the MODPROF_TRANS phase has not yet been completed.Upgrading to 4. restart where it terminated. Upgrade Strategy A_off If the upgrade directory has been destroyed. Also perform one or more of the following actions. • • If the MODPROF_TRANS phase has not yet been completed.6C Support Release 2: UNIX SAP AG Upgrade Strategy A_switch 1. Procedure After Loss of the Upgrade Directory If the upgrade directory is affected by the hardware problem. In this case. If the MODPROF_TRANS phase has already been completed. Recover the last state of the database (if the database is affected). Before you delete the upgrade directory. Restart the upgrade. If the MODPROF_TRANS phase has already been completed. 188 April 2001 . proceed exactly as described in the Database Failure section above. There is then enough space. 2. it is irrelevant whether the database. reset the database to the state it had when the central instance was isolated. restart in MODPROF_TRANS. skip the phase by entering a password (which you can get from SAP Local Support). or whether it is in downtime. proceed as follows: 1. Recover the database up to the point at which the upgrade was interrupted. you must also recover it. Downtime begins at the MODPROF_TRANS phase. Reset the database. Since the database and the upgrade directory match only at the beginning of the upgrade. the SPACECHK phases tell you that there is not enough free space. back up all data from this directory that can be recovered. Upgrade Strategy A_on 1. depending on the progress of the upgrade: If the phase MODPROF_TRANS ENVCHK KX_SWITCH has already been completed Reset the upgrade directory Reset the user profiles Reset the SAP Kernel 3. Delete the upgrade directory and restart the upgrade with PREPARE. Upgrade Strategies A_switch and A_on This procedure depends on whether the system is operating productively. • • If the MODPROF_TRANS phase has not yet been completed. 2. perform a point-in-timerecovery to the last state of the database. 2. so that it corresponds to the state of the database. If the substitution tables have already been created on the database. R3up deletes these substitution tables at the start of the EU_IMPORT phases before re-importing the data. the upgrade directory or both are destroyed. Restart the upgrade at the point at which it was interrupted.

Detailed Description of the Individual Actions Reset the SAP profiles After phase MODPROF_TRANS (or EU_IMPORT0 for upgrade strategy A_off). For strategy A_on. the instance profile and the default profile of the SAP System are changed by R3up. we recommend that you delete the tables manually. Try to start. proceed as follows: 1. stop and log on to the system as user <sapsid>adm. Reset the database to the state it had when the central instance was isolated. Only recover the old user profile if problems occur when you do this. (which means that you have already isolated the central instance. PSAPES<target release>I. PSAPEL<target release>D and PSAPEL<target release>I and then join the free space segments together with the following SQL command (available as of Oracle version 7.SAP AG Upgrading to 4. If the MODPROF_TRANS phase has already been completed. a point-in-time recovery is necessary. Delete all the tables in the tablespaces PSAPES<target release>D.cshrc . If this phase has been completed.login .3): alter tablespace <name> coalesce. see Isolating the Central Instance [Page 202]). depending on the progress of the upgrade: If the phase ENVCHK KX_SWITCH has already been completed Reset the user profiles Reset the SAP Kernel 4.6C Support Release 2: UNIX Oracle For Oracle. before you restart the upgrade. The following files are affected here: . Recover the upgrade directory as described in Reset the upgrade directory. 3. If you let R3up delete the tables. Do this even if the database has not been corrupted. Restart the upgrade in the MODPROF_TRANS phase. This is the only way to restore consistency with the upgrade directory. If you cannot recover the upgrade directory.BCK. Also perform one or more of the following actions. The instance profile is saved in PROFX. contact SAP for help with choosing the jump option. the fragmentation of the free space segments leads to an increase in required space of up to 10% of the entire of the tablespace. you must retrieve these two files from the sapnames subdirectory of the upgrade directory.kshrc April 2001 189 . Reset the user profiles The new user profiles are normally also valid for the old SAP System version.BCK. the default profile in DEFPROF. 2.

dbenv_<host name>. The old files are in <upgrade directory>/exe/INSTALL. You can exclude the data directory if you have space problems. You must reimport the old Kernel when you make the recovery.SAR from the CD.csh . Reset the SAP Kernel The new Kernel is active after the KX_SWITCH phase. You must unpack the packages SAPEXE.profile startsap_<host name>_<instance number> stopsap_<host name>_<instance number> . You must have backed up the upgrade directory when you isolated the central instance if you want to do this (see Isolating the Central Instance [Page 202]). You can recover the Kernel directory from a backup created before the upgrade or from the Kernel CD of the source release.6C Support Release 2: UNIX SAP AG .dbenv_<host name>. Then delete the contents of the upgrade directory. These profiles have the latest state after the ENVCHK phase.Upgrading to 4. Reset the upgrade directory You must recover the whole upgrade directory with all its subdirectories.SAR and SAPEXEDB. 190 April 2001 .sh All the files are in the home directory of user <sapsid>adm. Delete the upgrade directory We recommend that you archive all the subdirectories before you delete the contents of the upgrade directory.

note the process number. Check whether a tp process still exists. R3up does not need to wait if the processes found are of a different type. both in the SAP System. a check is made to see if any of the processes you noted are still running. Check whether R3up is running in the background on the host. April 2001 191 . use the command kill to stop R3up. and at the operating system level. You must prevent R3up from starting two processes of the same type. R3up logs any processes it has started. 3. If it is. R3up must wait until these processes have ended. If the transport control program was active when R3up terminated.SAP AG Upgrading to 4. When you restart R3up. If so. it keeps running independently of the upgrade.6C Support Release 2: UNIX Scroll Mode: Restart Prerequisites You are upgrading the system in scroll mode from a PC or X Terminal and the terminal connection has broken. If so. Restart the upgrade as described under Restarting the Upgrade [Page 109]. Procedure 1. 2.

These are: • • • • • • • Dictionary activation (A) Distributing Dictionary objects (S) Table conversion (N) Matchcode activation (M) Importing application objects (D) Updating version management (U) Executing XPRAs (R) The interface between the transport control program tp and the SAP System is formed by table TRBAT. as these steps are not carried out by transport request.6C Support Release 2: UNIX SAP AG Correcting Problems when Processing ABAP Steps Use Some of the ABAP steps are performed in the SAP System. Enter an asterisk (*) in the field or after event.Upgrading to 4. Result For more information on the transport control program and on communication between tp and the SAP System.x: Choose Help → SAP Library → Basis Components → Change and Transport System → BC Transport Tools → Transport Control Program tp. To trigger an ABAP step. The table must have one HEADER entry and should contain one entry for each transport request. proceed as follows: 1. Enter Transaction SM37 and check if background job RDDIMPDP has been scheduled. so that event-driven jobs are also displayed. Check when RDDIMPDP last ran and if it ran without errors. Use Transactions SM37 and SM50 to check if RDDIMPDP has already started the actual background job for editing the ABAP step. 3. Procedure If you encounter problems when editing the ABAP steps. table TRBAT may contain only one HEADER entry. tp writes control information into this table. In phase JOB_RDDNEWPP the background job RDDIMPDP is scheduled to run when certain events occur to process the entries in table TRBAT.x: Choose Help → R/3 Library → BC Basis → System Administration → Transport Control → Transport Control Program tp. Check if the control information in table TRBAT has been entered correctly. Log on as user DDIC in client 000. see the documentation Transport Control Program tp. Check that the SAP System was started correctly. To access this documentation: In Release 3. During distribution of the Dictionary objects (S) and table conversion (N). 2. 4. In Release 4. 192 April 2001 .

for example). according to SLOG. tp. R3up. If this is the case. check whether the SAP System is supposed to be started up or shut down at this point. Check whether all processes of the SAP System were actually stopped. increased demands on computer resources may have caused the problems.SAP AG Upgrading to 4. and some shells. tp waits without success for this step to end. You can do this with the command: ps –fu <sapsid>adm The output should consist only of database processes. try to run the SAP System with fewer dialog processes April 2001 193 . the SAP System should have been started up. 4. 2. Using the SLOG log (SLOG46C). shut down any SAP processes that may be running with the command: stopsap r3 3. Starting at the end of the log. transport control program tp restarts the SAP System automatically several times. but you are unable to log on as user DDIC. MODPROF_BAS and MODPROFP_<rel> or by SAP programs being exchanged in the KX_SWITCH phase. If. Try to start up the SAP System with the command: startsap r3 If you cannot start up the system manually. this is probably caused by changes to the SAP profile made in the phases MODPROF_TRANS. search upwards for the latest entry marked tpsapstop or tpsapstart. Procedure 1. If the SAP System is not successfully started up and the next step requires processing to take place within the SAP System (table conversion.6C Support Release 2: UNIX Correcting Problems when Starting the SAP System Use In the course of the various phases. In both cases.

6C Support Release 2: UNIX SAP AG Correcting Problems when Copying SAP Programs Use In the phase KX_SWITCH.Upgrading to 4. 2. Analyze the log of the copy process. otherwise. the SAP programs in the directory /usr/sap/<SAPSID>/SYS/exe/run are replaced. It is located in the subdirectory log of the upgrade directory and is called C<DATE>. Procedure 1.<SAPSID>. Repeat the phase or copy the program manually from subdirectory exe of the upgrade directory to directory /usr/sap/<SAPSID>/SYS/exe/run. 194 April 2001 . it cannot overwrite the old files. Do not start the SAP System during this period.

/R3up update_user R3up displays every <sapsid>adm profile and asks you whether you want to replace it. the UNIX user profiles. 2. Procedure 1. if necessary you can use R3up to update these profiles as well. are automatically adjusted on the host with the central instance. However.6C Support Release 2: UNIX Correcting Administrator Profile Problems on Application Servers Use During the upgrade. R3up replaces the placeholders in the templates and writes the result to the home directory of <sapsid>adm. Enter the following commands as user <sapsid>adm: cd /<new directory name> . and also the scripts for starting and stopping the system. Mount the upgrade directory from the host with the central instance: mount <host_name>:<upgrade_directory> /<new directory name> 3. Log on to the application server. 4. The profiles on the secondary application servers only need to be adjusted if the <sapsid>adm users do not have the same home directory. April 2001 195 .SAP AG Upgrading to 4. Confirm the update for the relevant profiles. The templates for the new profiles are in the subdirectory exe/INSTALL of the upgrade directory.

create an error message in the SAPNet – R/3 Frontend and assign it to the component BC-UPG. Answer the following questions and put these answers in your SAPNet . contact your SAP Local Support. see SAP Note 40024. if one exists (use transaction ST22 to find this out). What was the original release of your SAP System? 5.log <name of the phase with errors>. For which SAP component do you want to perform the upgrade? 2. assign your error message to the appropriate product-specific component.R/3 Frontend.6C Support Release 2: UNIX SAP AG Providing SAP Local Support with Information Use If none of the measures described in Problems and Solutions During the Upgrade solves your problem. For more information about using the SAP support server to transfer files.ELG suffix and the detailed log file that contains the error message For the phases JOB_<name> or RUN_<name>. 196 April 2001 .ELG or the last file written with the .R/3 Frontend customer message: 1.log file located in the upgrade directory. The following table gives you information on the different components to which you can assign your message in SAPNet . 6. In which R3up phase does the error occur? This information is listed at the end of the of the R3up. Which operating system version are you using? 4. If you are certain that the problem is not an upgrade-specific one but a product-specific one. Which release are you upgrading from? Which release are you upgrading to? 3.Upgrading to 4. • For transport phases we also require SLOG46D. we also require − − − Last job log of user DDIC written in client 000 (use transaction SM37 to find it) Last lines written in the system log of the SAP System (use transaction SM21 to find them) Last short dump written to the system log at the time in question. Procedure If you encounter problems that are specific to the upgrade. To enable us to help you as quickly and effectively as possible. follow the procedure given here. Did you have problems with the SAP System before upgrading? Also provide us with the following logs (if they exist in the upgrade directory) using ftp on the SAP support server that is closest to you (sapserv<x>) or by fax: • • • R3up.

Communication and Development Station .CRM Server .Internet Pricing and Configurator (IPC) .Mobile Client .R/3 SAP DrFuzzy Search Engine SAP Frontend SAP Internet Transaction Server SAP Knowledge Management SAP R/3 Enterprise SAP Strategic Enterprise Management SAP Web Application Server SAP Workplace Server SMART Installation BC-SRV-TRX BC-UPG BC-UPG BC-UPG-ADDON APO-BAS BC-MID-BUS BW-SYS BBP-SAD CRM-MW BC-MID-INT-SRV CRM-MT-IU-SPE CRM-WBT-IU BC-UPG BC-SRV-TRX BC-INS BC-FES-ITS KM-KW BC-UPG BC-UPG-ADDON BC-UPG BC-UPG BC-UPG April 2001 197 .6C Support Release 2: UNIX SAP Product Component in SAPNet – R/3 Frontend Index Management Server OLTP R/3 System R/3 Standalone Gateway SAP Add-On SAP Advanced Planner & Optimizer SAP Business Connector SAP Business Information Warehouse SAP Business-to-Business Procurement SAP Customer Relationship Management .SAP AG Upgrading to 4.

Upgrading to 4. • • • • • • • • • Using the Alert Function [Page 199] Determining the Operating System Version.6C Support Release 2: UNIX SAP AG Upgrade Administration This section contains additional information on the various administrative tasks which are necessary before and during the SAP upgrade. Database Version and the SAP Release [Page 200] Executing PREPARE and R3up in Scroll Mode [Page 201] Isolating the Central Instance [Page 202] Changing the Database Recovery Mode [Page 205] Deleting Archived Upgrade Logs [Page 206] Using a Different Upgrade Directory [Page 207] Releasing and Confirming Open Repairs and Requests [Page 208] Reducing Upgrade Runtime in Modified Systems [Page 210] 198 April 2001 .

Activities To activate the alert functions of the Upgrade Assistant. April 2001 199 . This alert file is deleted when the upgrade is continued. You can then be informed if the control program R3up waits longer than a predefined period of time for input. to indicate that action is necessary. go to the main menu of the Upgrade Assistant and choose Administrator → Set Alert. As with the alert file.SAP AG Upgrading to 4. due to an error). An alert file upalert. instead of analyzing the alert file. you must also provide the external software for starting a communication service. of if the upgrade terminates (for example. then go to the section ‘Set Alert’ window. You can use this to notify the system administrator. You see the following screen: You can get more information online in the Upgrade Assistant.log is also created in the sub-directory tmp of the upgrade directory. and minimize downtime.6C Support Release 2: UNIX Alert Function Use Use the alert function to inform yourself if the upgrade waits for a long time. for example by telephone. Functions • Alert file An appropriate message appears on the screen if the upgrade stops. • Alert Function of the Upgrade Assistant When you use the Upgrade Assistant for your upgrade. Go to the main menu and choose Help → Introduction. you can use an alert function.

enter the following command as user informix: onstat Oracle Execute the following SQL command: SELECT BANNER FROM V$VERSION. The first line of the output contains the Oracle server release.6C Support Release 2: UNIX SAP AG Determining Versions Determining the Operating System Version At the UNIX level enter the following command: uname -a Determining the Database Version SAP DB Execute the following operating system command: x_cons <SAPSID> show version Informix With the database running.Upgrading to 4. 200 April 2001 . End of the database-specific explanations Determining the SAP Release You can determine the SAP Release by selecting System → Status in the SAP main menu.

enter SCROLL for the line-oriented mode. 2. Log on to the host on which the central instance is running as user <sapsid>adm. April 2001 201 . Log on to the host on which the central instance is running as user <sapsid>adm. Executing PREPARE in Scroll Mode To execute PREPARE in scroll mode. enter the following command: cd <upgrade_directory>/bin . since PREPARE is started from the CD. 2. enter SCROLL for the line-oriented mode.SAP AG Upgrading to 4. or do not want to.6C Support Release 2: UNIX Executing PREPARE and R3up in Scroll Mode Use You can execute PREPARE and R3up in scroll mode. start the program as follows: 1./PREPARE When you are prompted for the display mode./R3up [gt=SCROLL] When you are prompted for the display mode. respond to the prompt for the display after you start PREPARE with SCROLL. Executing R3up in Scroll Mode If you want to execute R3up in scroll mode. To run R3up. When you restart PREPARE you need to proceed as follows: 1. The commands for starting PREPARE for the first time [Page 66] are the same for display mode Server (Upgrade Assistant) and display mode Scroll. You need to do this if there is some reason why you cannot use the Upgrade Assistant. Enter the following commands: cd <upgrade_directory>/bin .

These must have the following values: cpu=-1 fsize=4194302 core=100000 202 April 2001 . A list of all the parameters is displayed. You can use Transaction SM02 to inform the users logged on to the system. you can rename it as follows: cd /usr/sap/<SAPSID>/SYS/exe/run mv saprouter saprouter. backing up the database or similar actions. R3up asks you to isolate the central instance when downtime begins.busy Delete saprouter. This means that you can use the central instance exclusively for the upgrade.Upgrading to 4. b. 4.busy after you have started up the new SAProuter. Enter the command lsuser as user root. You have two options: a. The SAProuter in the directory /usr/sap/<SAPSID>/SYS/exe/run must not be active while the new SAP Kernel is being imported. all users must be logged off the system.6C Support Release 2: UNIX SAP AG Isolating the Central Instance Use You need to isolate the central instance so that only the upgrade program can work with the system during downtime. To get more information about the SAProuter : − − Enter saprouter at the operating system level. Stop the SAProuter now and restart it after the upgrade./saposcol –d . 3. AIX Check the restrictions for cpu. During downtime. If you need the SAProuter during the upgrade./saposcol –d Collector> leave rm saposcol 2. Make sure that no CRON job is scheduled that affects the system. Stop and delete saposcol as user root: cd /usr/sap/<SAPSID>/SYS/exe/run . This could affect R3up's control of the system. See the documentation CD for the target release (SAP Library → Basis Components → Kernel Components → BC SAProuter). fsize and core for user <sapsid>adm. Procedure 1. such as starting and stopping the SAP System.

b. The To date must be far enough in the future that you can display the background jobs which could become active during the upgrade. Call Transaction SM37. Clean up all outstanding updates as described in Evaluating Results from PREPARE [Page 87] when the message Update records still exist . schedule it by executing the report RDDNEWPP (Transaction SE38). c. If this is not the case. d. You must do this in every client. d. use Transaction SM63 to either choose a single operation mode for all time spans or delete all the assignments. Execute b) and c) until all jobs that were not yet executed have been deleted. these jobs are automatically descheduled by R3up . you have to cancel the release of all background jobs except RDDIMPDP before the upgrade. The upgrade is not affected if RDDIMPDP is also scheduled in other clients. If this is the case in normal operation.6C Support Release 2: UNIX If this is not the case.0B. f. Double-click on the corresponding day in the header line in order to see the job overview for this day. Cancel the release by choosing: Job → Schedule Job → Cancel. To do this: a.0x/3. In the field Start date. These changes only take effect for user <sapsid>adm when you have logged on again as <sapsid>adm. you must delete all future schedules. Special feature in client 000 The background job RDDIMPDP must be scheduled in client 000. c. b. e. As of Release 4. End of AIX 5.Please process appears. check that the from date is in the past. Determine the jobs involved. No background job other than RDDIMPDP may be active during the upgrade. Position the cursor on the job that you want to delete and choose Delete.5B. 6. 7. For Source Releases 3. Make sure that no change of operation mode is defined on the central instance during the upgrade. Start Transaction DB13. Transaction DB13 uses different internal job formats. 8. Fill in the necessary information on the screen Select background jobs as described in the example below. Then start up the SAP System with stopsap and startsap. Choose Execute. April 2001 203 .SAP AG Upgrading to 4. Log on as user DDIC in the relevant client. As of Source Release 4. For all other source releases. change them with the command chuser (Entry: chuser cpu=-1 <sapsid>adm) and correspondingly for fsize and core. Proceed as follows: a. Since the old job formats can no longer be read by Transaction DB13 after the upgrade.1x Only: Delete scheduled actions in Transaction DB13.

Shut down all application servers. 12. So that R3up has the correct control information. If a hardware problem occurs during downtime. These tables are now empty. delete the corresponding tablespace and recreate the table with Transaction SE14. You can lock the database against remote access. if there are any (secondary SAP instances). VBDHR and VBMOD If you want to partition the tables VBDATA. Contact the database administrator. 11.Upgrading to 4. 13. you may have to reset the upgrade to its status when the system was isolated. then you must reset the partitioning of these tables now and recreate them in segmented tablespaces. Make sure that you can recover the database to its current state. by manually importing requests for the automatic adjustment. you may lose all your modifications to the SAP standard. Application tables remain partitioned. Otherwise you may lose data.6C Support Release 2: UNIX SAP AG 9. End of DB2 for OS/390 204 April 2001 .B only: Partitioning of tables VBDATA. 10. Back up your upgrade directory now if you chose strategy A_switch or A_on. VBDHR and VBMOD as described in Note 122599.0. To reset the partitioning. Make sure that no transport requests are imported into the system during downtime. the upgrade directory must have the same status as at the beginning of the phase MODPROF_TRANS. For example. DB2 for OS/390 For Source Releases up to and including 4. This only applies to these three basis tables.

SAP AG

Upgrading to 4.6C Support Release 2: UNIX

Changing the Database Recovery Mode
Use
If you use the upgrade strategies A_switch and A_off, you need to change the recovery mode of the database at the beginning and end of downtime.

Procedure
SAP DB

The recovery mode is changed automatically by R3up.
DB2 Universal Database

When you set LOGRETAIN and USEREXIT to OFF, make sure that you can restore the current state of the database. If the last full backup was a long time ago and the number of archives collected up to that point is large, SAP recommends performing a full backup before setting the parameters to OFF.
Informix

Ensure that the current state of the database can be restored when backup mode is deactivated. If the last complete backup was some time ago and a large amount of logical log files has been created since, make a complete backup of the current database state before deactivating the backup mode. Deactivate the backup mode as follows: 1. Stop the database as user informix with:
onmode -yuk

2. Edit the file $INFORMIXDIR/etc/$ONCONFIG as user informix and change the parameter LTAPEDEV to /dev/null. 3. Start the database as user informix with:
oninit Oracle

When you deactivate database archiving, you must make sure that the current state of the database can be recovered. If the last complete backup was some time ago and a large set of archives has since been collected, we recommend a complete backup of the current status of the database before deactivating archiving. Deactivate the archiving as follows: 1. Log on as user ora<sapsid>. 2. Start the program sapdba and use the option Archive Mode → Toggle Database log mode. In the same way as when you deactivate the archiving, you can reactivate it as user ora<sapsid> with the program sapdba.
End of the database-specific explanations

April 2001

205

Upgrading to 4.6C Support Release 2: UNIX

SAP AG

Deleting Archived Upgrade Logs
Use
You can make more space by deleting archived logs from earlier upgrades that you no longer need.

Procedure
To do this, delete the subdirectories <target_release> along with their contents:
/usr/sap/trans/upgrade/<SAPSID>/<target_release>

If you no longer need the logs of the upgrades to 3.0D and 3.0F, then you can delete the subdirectories 30D and 30F: /usr/sap/trans/upgrade/P11/30D /usr/sap/trans/upgrade/P11/30F /usr/sap/trans/upgrade/P11/30I ..... /usr/sap/trans/upgrade/T11/30D /usr/sap/trans/upgrade/T11/30F /usr/sap/trans/upgrade/P11/30I .....

206

April 2001

SAP AG

Upgrading to 4.6C Support Release 2: UNIX

Using a Different Upgrade Directory
Use
You can use an upgrade directory other than /usr/sap/put/. This is useful if you have several SAP Systems on a single host and you want to upgrade them all to a new release. The name of the directory must include put, for example /usr/sap/put_C11/ or /free/PRD_put/.

Prerequisites
In the instance profile of the SAP System, you have to set the parameter DIR_PUT to the upgrade directory that you want to use: DIR_PUT = <upgrade_directory>
R3up checks at startup if the entry in the instance profile matches the specified upgrade directory.

Procedure
Call PREPARE or R3up with the following parameter:
PREPARE upgdir=<upgrade_directory> R3up upgdir=<upgrade_directory>

You must specify the parameter upgdir each time you call PREPARE or R3up, otherwise the default value /usr/sap/put is used.

If you want to use another upgrade directory, make sure that no /usr/sap/put/ directory exists on this host.

April 2001

207

Upgrading to 4.6C Support Release 2: UNIX

SAP AG

Releasing and Confirming Open Repairs and Requests
Use
Before starting to upgrade, release and confirm all open repairs and requests that conflict with the SAP delivery. PREPARE determines a list of these repairs and requests. If you ignore open repairs, you could lose modifications. To release and confirm open repairs, you must log on to the system as the owner of the repairs. You can find the user names of the owners in CHECKS.LOG.

Procedure in Release 3.x:
1. Log on to the SAP System as the owner of an open repair. 2. Enter Transaction SE01. 3. Choose Find.

You can also release the repairs from the Workbench Organizer (Transaction SE09). 4. Make sure that the field User name contains the correct name. 5. Enter REPA in the field Type. Leave all the other default values unchanged. 6. Choose Execute. A list of all the open repairs for this owner appears. 7. Select the repair that you want to release. 8. Choose Repair → Release repair. 9. If the repair is assigned to a higher-level transport request, this transport request must also be released.

If you are unable to log on with a specific user ID, you can change the owner of the repair in Transaction SE01. 1. In the list of open repairs, position the cursor on the repair. 2. Choose Edit → Change owner. To be able to change an owner in Transaction SE01, you need project authorization for the Workbench Organizer (S_CTS_PROJEC).

208

April 2001

select everything except Released. Choose Request/task → Find requests… 4. 10. 6. Choose Change owner. Position the cursor on the request that you want to release. 7. April 2001 209 . For Request status. 5. Choose Release. you need project authorization for the Workbench Organizer (S_CTS_PROJEC). Release the request to which the repair is assigned. you can change the owner of a repair as follows using Transaction SE09: In the list of open repairs. If you are unable to log on with a specific user ID. The repair must be confirmed. 2.SAP AG Upgrading to 4.x: 1. 9. Choose Execute. Choose as the Request type only the task Repair. position the cursor on the repair. 8. A list of all open repairs for the selected user appears. choose Request/task → Confirm repair. If it is not confirmed. 3. Log on as the owner of the open repair. Enter Transaction SE09.6C Support Release 2: UNIX Procedure in Release 4. To be able to change an owner in Transaction SE09.

5. This alternative is based on the modification status of the objects. 210 April 2001 .6C Support Release 2: UNIX SAP AG Reducing Upgrade Runtime in Modified Systems Use Under certain conditions. If many objects were at one time modified in your system. If PREPARE is still active.<SAPSID>. Choose Yes to confirm that you want to restrict the objects copied to those displayed in Transaction SE95. 6. The corresponding log is called CUSTEXP. the Repository Switch automatically copies objects from the SAP namespace to the new Repository. Restart PREPARE.5A. then you can speed up the upgrade. exit it by choosing exit. Only those objects are copied that appear here. there are no conflicts with changes made by SAP.Upgrading to 4. The Repository Switch detects these objects using the requests with which they were created or changed. and check whether the list is complete. however.5A. Procedure 1. You created the object as a new object. The change now takes affect. This module writes the object list SAPKCCR<target release>. To do this. administered by the Modification Assistant as of Release 4. you need to specify that R3up excludes any objects that no longer count as modified from being copied to the Repository. 2. Enter the following commands at the operating system level as user <sapsid>adm: R3up set sapmodi 4. You cannot have finished the PREPARE preparation phase. Prerequisites You must have at least Source Release 4. Use Transaction SE95 (Modification Browser) to display all objects that have been modified in your system. Do not use this runtime optimization option if you are not sure whether the list is complete. Use the PREPARE module Modification support to check that the amount of objects copied has been restricted. • • You modified the object. but now are no longer classed as modified. 3.

6C Support Release 2: UNIX Upgrade Tools The following tools support you in upgrading the SAP System: • • • • PREPARE R3up Upgrade Assistant Upgrade Monitor April 2001 211 .SAP AG Upgrading to 4.

R3up assumes that the mandatory modules have run through successfully. Afterwards. since production operation could have created a new situation. For example. Functions All the actions performed by PREPARE execute in phases. Import a number of tools into your database.Upgrading to 4. PREPARE performs the majority of the required checks automatically. you must also check the operating system. It copies data and programs to the upgrade directory. These are described in the section User Actions Before Starting PREPARE. PREPARE modules can be executed individually. A complete list of the modules and the phases which execute in these modules can be found in the phase list for PREPARE. The following graphic gives an overview of all the PREPARE modules and their predecessors. Prerequisites You must meet a number of requirements before you run the PREPARE program. They can have predecessors which must first be executed. 212 April 2001 . database and SAP System manually as well. R3up then repeats a number of the checks (not all of them). the analysis tools must be imported before they can be executed. It checks the requirements for the upgrade and provides further information when executing the optional module. The PREPARE modules have the following features: • • • • They can be mandatory or optional. These phases are combined into PREPARE modules.6C Support Release 2: UNIX SAP AG PREPARE Use Use the PREPARE program to prepare your SAP System for the upgrade. Integration When the upgrade is started. There are PREPARE modules which you must only execute once and those which you can execute as often as you require. • • • • You can execute this program while the system is running.

6C Support Release 2: UNIX Parameter entry Initialization Import CD Read General checks Activation checks Required checks for conversions Optional checks for conversions Modification support Preliminary execution For more information about the contents and features of the PREPARE modules. To be sure that all the requirements are met. If the file CHECKS.SAV.LOG already exists. languages. April 2001 213 . Activities • • Start PREPARE as soon as possible before the upgrade so that you can initiate or perform the necessary preparations in time. Results of PREPARE PREPARE writes the results for the modules that you selected for execution to the file CHECKS. For more information. You can find it easily by choosing Help when selecting the modules. Look at this file and carry out the necessary measures based on the information it contains.LOG. This file is in the subdirectory log of the upgrade directory. such as SAP Support Packages. or add-ons (and add-on updates). you can choose certain PREPARE modules more than once. it is overwritten each time a module is executed again. Its contents are saved in file CHECKS.SAP AG Upgrading to 4. see Importing Software after Starting PREPARE. you may need to import software. see the online help for PREPARE. After you start PREPARE.

LOG EXECCT. if necessary 214 April 2001 .6C Support Release 2: UNIX SAP AG PREPARE Phase List PREPARE Module Parameter Input Phase BEGIN_PRE INITPUT_PRE Actions Taken by PREPARE Log User Actions Checks upgrade directory Initialize R3up DB2 Universal Database DB2 Universal Database DB6RUNST.LOG Unlock clients for SAP upgrade. if necessary VALCHK.LOG VALCHK_INI Tests target system: is it a preliminary version? (Cannot upgrade the system) Checks whether clients are locked for SAP upgrade CLNT_CHK_INI CLNTOUT.Upgrading to 4.LOG Enter parameters DB2 Universal Database Update database statistics DB2 for OS/390 Choose MEDIUM or HIGH DB2 for OS/390 Tests JCL submission Test JCL submission Start second ICLI server DBCHK_PRE INIT_CBU_REQ_READ NOTE CHECKGROUP_END Determines DB and SAP version --End of module PREPARE Module Initialization Phase DBCHK_INI RFCCHK_INI VERSCHK_INI Actions Taken by PREPARE Log User Actions Determines DB and SAP version Tests the RFC connection Checks SAP version RFCCHK_INI.LOG Upgrade to a valid source release.

6A or 4.1H.1I or 4.5B. if necessary DBPREP_CHK CHECKGROUP_END --End of module PREPARE Module Import Phase REQIMPORT READDATA0 Actions Taken by PREPARE Log User Actions Displays prompt Reads data files for Source Releases 3.LOG EXECPT.SAP AG Upgrading to 4.0F and data files required for all source releases from Upgrade CD1 Source Releases 3. upgrade OS or DB April 2001 215 .1I or 4. if necessary Import current downwardcompatible Kernel. 3.1H. 3.0D or 3. 4.6C Support Release 2: UNIX PATCH_CHK1 Determines nonconfirmed Support Packages and displays results Check whether the inactive nametab is empty Check free space in DB Checks the version of the SAP Kernel PATCHOUT.6A or 4.6B: Mount Upgrade CD3 READDATA2 CPYFIL0_CBU EXEC_CPYFIL1_CBU INFO_STORE_READ CONFCHK_IMP If necessary.0B: reads data files from Upgrade CD2 Source Releases 4.6B: reads data files from Upgrade CD3 ------Tests operating system and database Confirm execution of Import module Mount Upgrade CD1 READDATA1 Source Releases 3.LOG KRN_CHK. 4.LST Extend free disk space.LOG Use transaction SPAM to confirm any unconfirmed Support Packages INTCHK_INI SPACECHK_INI KRN_CHK_INI DBFPREP.0B: Mount Upgrade CD2 For Source Releases 4.5B.

1x: Prepares ABAP Dictionary for DBFPREP.LOG SCRIPTCHK.LOG ICNVCOUNT.LOG EXECCT.LOG PATCHOUT.LOG ALTER_TO TOOLIMPD1 ALTER_TO.LOG ICNVLIST. if necessary CLNT_CHK_IMP INTCHK_IMP SPACECHK_IMP PATCH_CHK2 Extend free disk space.6C Support Release 2: UNIX SAP AG version CNV_CHK_IMP to required version Make conversions (after discussion with Basis consultant). if necessary Use transaction SPAM to confirm any unconfirmed Support Packages NTHISTCRE NTABHIST.LOG TOOLIMPD. if necessary ICNVCHK.LOG CLNTOUT.LOG CLCNVTAB.LOG CNVTST.Upgrading to 4.LOG EXECPT.LOG Determines outstanding conversions and restart logs of terminated conversions Checks whether incremental conversion from previous upgrade has finished Source Release 3.x: Avoids critical conversions in tool import Source Release 4.LOG CLCNVTST.ELG 216 April 2001 .0x and 3.LOG ICNVEX.LOG CNVTST. if necessary SCRIPT_CHK_TOOL3 SCRIPT_CHK_TOOL4 TRBATCHK_IMP Perform any actions specified by R3up Unlock clients for SAP upgrade.x: Avoids critical conversions in tool import Checks whether table TRBAT is empty Checks whether clients are locked for SAP upgrade Check whether the inactive nametab is empty Check free space in DB Determines nonconfirmed Support Packages and displays results Creates tables for nametab administration so that new tools have access Deletes tables that describe the delivery Source releases 3.LOG ICNVCHK_IMP Complete incremental conversion with transaction ICNV.LOG CLCNVTST.LOG CLCNVTAB.LOG SCRIPTCHK.

6C Support Release 2: UNIX upgrade tools TOOLIMPD2 For source release 4.ELG PRE_IMPORT0 April 2001 217 .0B.ELG TOOLIMPI.ELG PREPIMP.ELG UVERS_INIT UVERS_CHK_IMP BATCHCHK_IMP UVERSINI.LOG UVERSCHK_IMP. prepares ABAP Dictionary for upgrade tools For source release 4.LOG JOB_RDDGENRS RUN_RDDITCUG RUN_RSINCGEN_IMP RDDGENRS.LOG PSCVINIT.ELG MVNTAB_TOOL TOOLIMPI TOOLIMPM NPREPCRE0 MVNTTOOL.ELG NPREPCRE1 DDYIMP. prepares ABAP Dictionary for upgrade tools Activates nametabs for upgrade tools Imports tools for SAP upgrade Imports tools for SAP upgrade Imports tables that describe the delivery from Upgrade CD1 Imports tables that describe the delivery from Upgrade CD1 Writes entry in table UVERS Checks consistency of table UVERS Tests whether background server can access the upgrade directory Initializes table CVERS Reads table PUTTB and store in file system Generates tool reports Generate CUAs Adapts ABAP include RSTABINC to the system --- TOOLIMPD.ELG TOOLIMPD3 TOOLIMPD.ELG TOOLIMPM. LOG JOB_RSCVINIT READPUTTB PSCVINIT.LOG PSINCGEN.ELG RDPUTTB.LOG PDDITCUG.LOG PDDITCUG.5B.LOG MVNTTOOL.ELG PSINCGEN. LOG BATCHCHK_IMP.SAP AG Upgrading to 4.

0D: determines language area PATCHINT.0D: enter language area.LOG Include Support Packages in the upgrade.LOG Add add-ons manually.LOG LANGOUT. if necessary IS_READ Copies data for addons to the upgrade directory Determines unconfirmed Support Packages and checks if the source release contains Support Packages that are more recent than the version of the target release. if necessary Source release 3. check using Note 73510 if upgrade can be performed or which Support Packages are equivalent in the target release.6C Support Release 2: UNIX SAP AG PRE_IMPORT1 CHECKGROUP_END --End of module PREPARE Module Read CD Phase ADDSPAREQ_0 JOB_CBUIFCHK EXECIS IS_CHK Actions Taken by PREPARE Log User Actions Prepare space check on DB --Determines add-ons Displays installed add-ons EXECIS.LOG PATCH_CHK3 Use transaction SPAM to confirm any unconfirmed Support Packages If necessary. or confirm with nothing else Mount add-on CDs.LOG Delay upgrade until next release. if necessary EXECLANG LANG_CHK EXECLG. PATCHOUT. BIND_PATCH Includes Support Packages for the target release Determines installed languages Checks whether the new release supports the installed languages Source release 3.Upgrading to 4. if necessary 218 April 2001 .LOG EXECPT. if necessary.LOG ISOUT.

ELG TPSHBUF.LOG LANGSEL. if necessary.LOG PDDIT021.LOG April 2001 219 .LOG PCMDIMP.LOG INTEG_PATCH INTGPTCH.ELG ICNVXRQ. TR_CMDIMPORT_ PATCH TR_TODIR_MERGE_ PATCH GETSPAREQ_N DBFINTEQ.<SID> PCMDIMP. Confirm language selection.ELG JOB_RDDIT021 TR_TRK2HEAP_ADDON PDDIT021.ELG Mount language CDs.ELG PEVALLAN.SAP AG Upgrading to 4. imports command file marked in another system Imports command files for add-ons Evaluates command files imported in ISC_IMP Merges add-ons with the delivery directory Places add-on upgrade requests in the R3up buffer Selects Support Package integration file and includes the contained requests Writes ICNV add-on candidates to the R3up buffer Imports the ICNV add-on candidates Checks the LANGSEL.ELG If necessary.6C Support Release 2: UNIX LANG_SELECT Copies data for language import to the upgrade directory Imports piece lists for included Support Packages Merges included Support Packages with the delivery directory Determines freespace needed for the language data on the database Prepare space check on DB Prepare space check on DB Prepares adjustment calculation: if necessary.LOG TR_HYP2HEAP_ICNV TRICVNBUF.LOG ICNV_CND_IMP ICNVXRQ ICNVCNDI. select command file ISC_IMP IS_MERGE ISC_IMP.LOG ADDSPAREQ_N ADDSPAREQ_T ADJUSTPRP ADJUSTPRP.

if necessary UVERS_UP_T CHECKGROUP_END PREPARE Module General Checks Phase CONFCHK Actions Taken by PREPARE Log User Actions Tests operating system and database version Check free space in DB Checks disk space for logs and Kernel Checks whether the SAP Kernel can be overwritten. if necessary Make conversions (after discussion with Basis consultant).6C Support Release 2: UNIX SAP AG prerequisites for ICNV and filters candidates for ICNV ICNVINIT ICNVXRQ. if necessary Perform any actions specified by R3up CNV_CHK_GEN TRBATCHK_GEN 220 April 2001 . REPACHK.Upgrading to 4. initializes ICNV tables with the successful candidates Prompts you to call transaction ICNV after candidates have been written to the ICNV tables Changes status in table UVERS End of module ICNVREQ_PRP ICNVREQP.ELG DDICNV. if necessary If necessary. if necessary Increase disk space. DBFPLUSD. check write authorizations for SAP Kernel.LOG DDICNV.LOG ICNVREQP.LOG If necessary.LOG Call transaction ICNV.LOG SPACECHK_GEN FREECHK REPACHK Determines SAP objects locked in repairs or requests Determines outstanding conversions and restart logs of terminated conversions Checks whether table TRBAT is empty Release repairs and requests. update OS or DB to required version Extend free disk space.LOG Checks the volumes of the candidates.ELG DDICNV.LOG ICNVINIT.ELG ICNVCAND.LOG ICNVINIT.

SAP AG Upgrading to 4.LOG PSVBCHCK. if necessary VIEWCHK VIEWCHK. if necessary JOB_RS_NAMT_CL NTACT_CHK NTCHK.ELG JOB_RSVBCHCK1 Delete any terminated updates CHECKGROUP_END April 2001 221 . if necessary ENVCHK_PRE If necessary assign write authorization to the user profile Upgrade the frontend software. if necessary UVERSCHK_GEN.ELG NTCHK.LOG Delete tables. LOG BATCHCHK_GEN.LOG Perform any actions specified by R3up INTCHK_GEN SINXCHK Delete indexes.LOG Unlock clients for SAP upgrade.LOG FRONTREQ_PRE UVERS_CHK_GEN BATCHCHK_GEN PROFCHK PROFCHK. if necessary JOB_RXPRECHK_PRE PXPRECHK.LOG Correct entries with R3up set stdpar.LOG PXPRECHK.6C Support Release 2: UNIX CLNT_CHK_GEN Checks whether clients are locked for SAP upgrade --Checks the consistency of the nametab entries Check whether the inactive nametab is empty Checks the consistency of the indexes in the substitution tables Checks collisions between customer tables in the SAP namespace and delivered views Checks whether profile of user <sapsid>adm can be modified Displays information about the upgrade of the frontend software Checks consistency of table UVERS Tests whether background server can access the upgrade directory Checks if the profile names specified in INITPUT correspond to the names used by the system Preliminary checks for XPRA RLXPRA40 Checks whether outstanding updates exist End of module CLNTOUT.ELG PSVBCHCK.LOG EXECCT.

ELG User Actions Finds tables that can be reduced in size before the upgrade to speed up the conversion Prepares for the address data conversion If necessary reduce size of tables as described in Note 76431 If necessary.ELG CHECKGROUP_END PREPARE Module Necessary Checks for Conversions Phase CNV_AVOID Actions Taken by PREPARE Log RSUPGTAA.ELG User Actions Prepares for renaming the data elements Checks whether activation errors could occur during the upgrade End of module Correct name conflicts as described in Note 96905 Remove references to SAP data elements and domains ACTREF_CHK RSTODIRX.Upgrading to 4.LOG RSUPGTAA.LOG RSUPGTAL.ELG User Actions Determines tables that are converted during the upgrade (known to SAP) and writes them to a file for information purposes Totals results of all space checks ADDSPAREQ_AD 222 April 2001 .ELG CHECKGROUP_END End of module PREPARE Module Optional Checks for Conversions Phase CNV_LIST Actions Taken by PREPARE Log TABCONV. start report for preparing the address data conversion as described in Note 82167 JOB_RSCNVADR PSCNVADR.LOG PSCNVADR.LST RSUPGTAL.LOG RSTODIRX.LOG PADDRCHK.6C Support Release 2: UNIX SAP AG PREPARE Module Activation Checks Phase JOB_RADDRCHK Actions Taken by PREPARE Log PADDRCHK.

ELG ADJUSTMT.LOG Extend free disk space.ELG User Actions Determines collision with central Basis objects Contact SAP to get modifications to central Basis objects.6C Support Release 2: UNIX DYNSPCADD Checks space requirements in the database dynamically: 1. if necessary PREPARE Module Modification Support Phase RUN_RDDIT006_PRE Actions Taken by PREPARE Log DIFFCALC. if necessary Use transaction SPDD or SPAU to display modifications ADJUSTCHK_PRE Determines objects to be adjusted (preparation for SPDD and SPAU) End of module ADJUSTCK.LOG PSWBO230. Space needed temporarily for conversion 2.LOG DIFFCALC.INF CHECKGROUP_END PREPARE Module Pre-Processing Phase RUN_RSWBO230_ PRE CHECKGROUP_END Actions Taken by PREPARE Log PSWBO230.LOG ADJUSTCK.LOG SPACECHK_OPT CHECKGROUP_END Check free space in DB End of module DBFPLUSD.SAP AG Upgrading to 4.ELG User Actions Deletes SAP requests from previous upgrades End of module April 2001 223 . Space for new secondary indexes DYNSPC.

This occurs sequentially in phases where one phase must end successfully before the next one can begin. If you choose the default value repeat. checks the results and creates a series of logs. to restarting production operation. In the individual phases. Activities • • You start R3up.Upgrading to 4. you only need to restart the upgrade if errors occurred or an upgrade phase has terminated. There you can also find the main log file R3up. Normally. R3up makes the necessary checks and then starts at the point in the phase where the program terminated. • You can continue the upgrade by restarting R3up. These logs are stored in the log subdirectory of the upgrade directory. from checking the requirements. The upgrade strategies are differentiated by the type of backup. R3up stops and gives you several modes for restarting the upgrade. 224 April 2001 .log. When downtime begins and how long it lasts depends on the strategy you choose. In this case. and helps you recognize frozen processes. and when production operation stops. You can stop R3up at the beginning of a specific phase or at the beginning of the next phase. you need to do this if a Note tells you to correct a program before you execute it. to importing the necessary programs. You can find a list of all R3up phases under Phase List for R3up. the disk space requirements. At the beginning of its run. Prerequisites The mandatory PREPARE modules have run successfully. refer to the following Phase Lists for R3up. The Upgrade Monitor lets you follow the upgrade as it occurs. you can still use the SAP System productively. R3up starts various tools. For example. R3up repeats all essential checks made by PREPARE. During the checks. For a complete list of all phases.6C Support Release 2: UNIX SAP AG R3up Use R3up controls the entire upgrade process for an SAP System.

LOG Enter parameters DB2 Universal Database 1% Update database statistics DB2 for OS/390 Choose MEDIUM or HIGH Checks parameters. The percentage duration of these phases can be very different in your upgrade. not all the logs can be specified in this column. The following assumptions are made: − − Only one CD drive is used.6C. the runtime depends to a great extent on your own data. • User Actions If nothing is entered here.SAP AG Upgrading to 4. April 2001 225 .6C. The runtime depends on the following criteria: − − − − • 1) Amount of customer data Number of SAP applications used Amount and type of modifications and customer developments Number of clients 2) Log If a phase name has comment .x to 4. R3up does not require an operator at this point. otherwise R3up requests that you make the entries described. also read the section Logs under Troubleshooting.6C Support Release 2: UNIX R3up Phase List Explanations of the columns: • Duration (percentage) This phase takes up this percentage of the total runtime of R3up. You have not specified a latest time at which you want to go live (query define upgrade stop in the INITSUBST phase).x to 4. If a phase is marked with comment . This is based on the upgrade from 3. Some phases are considerably shorter when you upgrade from 4. R3up Upgrade Phases Phase Duration (percent age) Actions Taken by R3up Log User Actions BEGIN INITPUT <1% --DB2 UDB Checks upgrade directory Initialize R3up DB2 Universal Database DB2 Universal Database DB6RUNST. If you have a problem.

LOG Use transaction SPAM to confirm any unconfirmed Support Packages Unlock clients for SAP upgrade.LOG EXECPT.used only for information Determines SAP objects locked in repairs or requests Informs users that they must import a new VIEWCHK1 <1% Delete tables. if necessary CLNT_CHK <1% CLNTOUT.6C Support Release 2: UNIX SAP AG ICLI server and JCL submission service DBCHK VERSCHK <1% <1% Determines DB and SAP version Checks SAP version Upgrade to a valid source release.LOG UVERS_CHK BATCHCHK <1% <1% Checks consistency of table UVERS Tests whether background server can access the upgrade directory Determines nonconfirmed Support Packages and displays results Checks whether clients are locked for SAP upgrade Check whether the inactive nametab is empty Queries keyword from Note If necessary. if necessary UVERSCHK.LOG FRONTREQ --- Confirm 226 April 2001 .LOG BATCHCHK. if necessary REPACHK1 <1% REPACHK1.Upgrading to 4.LOG EXECCT.LOG INTCHK <1% KEY_CHK --- Enter keyword for the upgrade Enter password for industry solution. if necessary Enter parameters If necessary. upgrade OS or DB to required version VIEWCHK1.LOG INITSUBST CONFCHK_X --<1% Initializes for Repository Switch Tests operating system and database version Determines collisions between delivered views and customer tables in the SAP namespace . asks for keyword for industry solution PATCH_CHK <1% PATCHOUT.

stops system.LOG PSWBO230. if necessary SAP DB Checks database parameter MAXLOCKS Raise the MAXLOCKS parameter to the minimum value.LOG EU_IMP0. if necessary JOB_RDDPURI2 <1% PDDPURI2.ELG LOCKEUPR.LOG PDDPURI2.ELG ICNVREQ.LOG SPACECHK_ALL <1% Extend the database.LOG PSVBCHCK2.SAP AG Upgrading to 4.LOG ICNVREQ.ELG For strategy A_off. but ICNV has not yet been started Deletes incorrect templates for Create Table statements Checks freespace in the database SAP DB PSVBCHCK2.LOG FREECHK_X <1% Checks freespace in file system JOB_BTCTRNS0 <1% As of Source Release 4.ELG ICNVCAND.ELG DBFPLUSD.LOG PXPRECHK. if necessary BTCTRNS1.LOG BTCTRNS1. if necessary Confirm Enlarge the file system.6C Support Release 2: UNIX version of the SAPGUI JOB_RSVBCHCK2 <1% Checks whether outstanding updates exist Deletes SAP requests from previous upgrades As in PREPARE Prompts you to start ICNV if there are candidates for the ICNV.LOG Delete any terminated updates RUN_RSWBO230 <1% JOB_RXPRECHK ICNVREQ <1% <1% Call transaction ICNV.ELG PSWBO230. isolate the central instance and stop all application servers Mount CD Upgrade CD3 April 2001 227 .ELG PXPRECHK.5B: Deschedules background jobs For strategies A_switch and A_on: Prompts time when ABAP Workbench should be locked LOCKEU_PRE <1% For strategies A_switch and A_on: Respond to prompt for lock time EU_IMPORT0 <1% If necessary. Imports information on code page conversion from Upgrade CD3 into shadow area EU_IMP0.

6C Support Release 2: UNIX SAP AG EU_IMPORT1 EU_IMPORT2 <1% <1% Creates substitution tables for ABAP loads Creates ABAP tables EU_IMP1.LOG EU_IMP3.LOG EU_IMP5.LOG REPACHK2 <1% REPACHK2.ELG Mount CD Upgrade CD4 EU_IMPORT5 14% EU_IMP5.BUF into the R3up buffer Puts upgrade requests of the buffer TABULONG.LOG Confirm locks for ABAP Workbench if not yet done in LOCKEU_PRE Make conversions (after discussion with Basis consultant).ELG Mount CD Upgrade CD3 EU_IMPORT4 9% EU_IMP4.LOG TR_BUF2HEAP_ TABULONG <1% TPSHBUF.BUF into the R3up buffer Copies upgrade EU_IMP3.LOG EU_IMP1.LOG TR_APPENDBUF_ <1% TRAPPB. if necessary CNV_CHK_XT <1% TRBATCHK_XT TR_BUF2HEAP_ INSTIMP <1% <1% Perform any actions specified by R3up TPSHBUF.LOG TRB2H.ELG Mount CD Upgrade CD5 EUVIEWIMP STARTR3_IMP <1% <1% ALTER34V.LOG EU_IMP2.LOG 228 April 2001 .ELG EU_IMP2.Upgrading to 4.ELG Mount CD Upgrade CD3 Mount CD Upgrade CD3 DB2 for OS/390 Edit RUNSTATS jobs.LOG EU_IMP4.LOG TRB2H. if necessary EU_IMPORT3 2% Imports substitution set from Upgrade CD3 into the shadow tables Imports substitution set from Upgrade CD4 into the shadow tables Imports substitution set from Upgrade CD5 into the shadow tables Imports views of shadow tables Starts system if it was stopped during EU_IMPORT0 Determines SAP objects locked in repairs or requests Determines outstanding conversions and restart logs of terminated conversions Checks whether table TRBAT is empty Puts upgrade requests of the buffer INSTIMP.

ELG ADJUSTMT.LOG PDDNT4MD.LOG ADJUSTCK.ELG DIFFCALC.LOG PDDNT4MD.ELG SHDTABU.SAP AG Upgrading to 4.ELG NTSHDCP.INF SHDTSEL. if necessary SHADOW_CAND_SEL <1% SHADOW_PUTTB_ FILL SHADOW_NTACT_CP <1% <1% PREPPCON_INIT RUN_RDDNT4MD <1% <1% April 2001 229 .LOG SHDTTABS.LOG XTTSIZE0.LOG RUN_RSINCGEN <1% PSINCGEN.ELG TRCMDUPG.SID PREPCON.LOG SHDTTABS.LOG SYSPREP.LOG JOB_RDDTAXIT SUBSTNT_INS <1% <1% SYSPREP.LOG LISTLOAD.ELG RUN_RDDIT0061) 1% ADJUSTCHK1) <1% ADJUSTCK.LOG DIFFCALC.LOG NEWTABCK.ELG Confirm R3up message.LOG PN*.LOG PSINCGEN.6C Support Release 2: UNIX UPG requests from the R3up buffer to the hyperbuffer <1% <1% Command file import of upgrade requests Determines which tables are new in this release Creates tables that are new in this release Creates list of programs to generate after upgrade Selects generated objects Creates nametab entries for the new substitution tables Generates include program for access to the substitution tables Determines deviations of the current system from the future SAP standard (objects and modifications that have to be copied) Determines DDIC objects to be adjusted Determines candidates for shadow import Generates entries in PUTTB for shadow import Generates nametabs of the shadow tables in the shadow nametab Prepares parallel DDL processing in PCON Adjusts structural changes to the source release TRCMDUPG.ELG NTSHDCP.LOG SHDTABU.LOG TR_CMDIMPORT_ UPG NEWTAB_CHK NEWTAB_CRE LIST_LOAD 2% <1% NEWTABCR.ELG STBNTINS.

ELG DIFFEXPA.ELG DIFFEXMO.LOG DIFFEXPO.ELG PSPUSCA4.ELG DIFFEXPR.LOG DIFFEXMO.LOG DIFFEXPR.ELG DIFFEXPD.Upgrading to 4.ELG DIFFEXPC.ELG DIFFEXPA.LOG PDDNT4DL.LOG DIFFEXPG.LOG DIFFEXPG.ELG JOB_RDDSAVTE RUN_RDDCP4TB <1% <1% PDDSAVTE.ELG SHADOW_IMPORT_ REP <5% SHDREPIMP.ELG JOB_RSPUSCAD1) <1% DIFFEXPADD <1% DIFFEXPGEN1) 2% DIFFEXPMOD1) <1% DIFFEXPCUST1) <1% DIFFEXPDDIV DIFFEXPDOCU1) <1% <1% DIFFEXPCDOC1) <1% DIFFEXCO.LOG DIFFEXCO.LOG PDDSAVTE.LOG 230 April 2001 .LOG PSPUSCA4.ELG DIFFEXPO.6C Support Release 2: UNIX SAP AG RUN_RDDNT4DL <1% Prepares nametabs in the shadow tables for the new tables Export documentation created/modified by the customer Copies objects for add-ons to the shadow tables Copies generated objects to the shadow tables Transfers unsent modified objects to the shadow tables Copies customer developments to the shadow tables Exports inactive DDIC versions Exports customer extensions to documentation on SAP objects Exports the documentation on customer objects Exports modifications to documents Exports local private objects and tests objects in SAP namespace Imports upgrade data and language data into the shadow tables and the new tables Imports Support Package data and add-on data into the shadow tables Copies technical settings in DDIC Copies TADIR entries PDDNT4DL.LOG DIFFEXPT.ELG PDDCP4TB.LOG DIFFEXPD.ELG DIFFEXPT.LOG DIFFEXPC.ELG DIFFEXPMDOC1) DIFFEXPTSAP1) <1% <1% SHADOW_IMPORT_ ALL <5% SHDALLIMP.

ELG STBNTDEL.LOG PDDPURIF.LOG NTSHDDEL.ELG NTMOVPRE.LOG For strategies A_switch and A_on.LOG STARTR3_TRANS JOB_BTCTRNS1 <1% <1% JOB_RDDPURIF SUBSTNT_DEL <1% <1% SHADOW_NTACT_ DEL CNV_CHK_SW <1% NTSHDDEL.LOG ALPXDEF.ELG PDDPURIF.LOG RSTRESNC.LOG NTACT_PREMV VIEWCHK2 <1% <1% Delete tables.ELG <1% TRBATCHK_SW INTCHK_SW <1% <1% April 2001 231 .ELG <1% Deletes entries of objects to be deleted in the TADIR shadow table Copies namespace reservations to the shadow tables Copies nametabs to the shadow tables Determines conflicts between delivered views and customer tables in the SAP name range Stops system and changes profiles PDDDL4TB.ELG VIEWCHK2.LOG BTCTRNS1. isolate the central instance and stop all application servers CONFCHK_BAS <1% Tests operating system and database version Starts system As of Source Release 4.ELG RUN_RSTRESNC <1% RSTRESNC. if necessary MODPROF_TRANS <1% ALPXPOOL.LOG NTMOVPRE.6C Support Release 2: UNIX that have not been delivered to the shadow tables RUN_RDDDL4TB PDDCP4TB.5B: Deschedules background jobs Deletes inconsistent values from tables Deletes nametab entries created in SUBSTNT_INS Deletes nametabs of the shadow tables in the shadow nametab Determines conversions that stopped Checks whether table TRBAT is empty Check whether the inactive nametab is BTCTRNS1.SAP AG Upgrading to 4.LOG PDDDL4TB.

ELG JOB_RDDGENBB <1% DUMP_CNV 1% 232 April 2001 .ELG BASDDIMP.ELG Clear all outstanding updates JOB_RDDINDPR JOB_RDDINDDL <1% <1% JOB_CLTAF1 PORT_IMP2) <1% <1% RDCLTAF1.ELG NTDELFIN.ELG NTACT_MV NTACT_DEL BASDDIMPORT2) <1% 1% <1% NTMOVFIN.LOG INXPREP.ELG DUMP_CNV.LOG PADISWTC.ELG UVERS_UP_B JOB_RSVBCHCK3 <1% <1% PSVBCHCK3.LOG INXDEL.Upgrading to 4.ELG PADISWTC.ELG PORT_IMP.ELG DISTBAS.ELG STOPR3_DIST STARTR3_DIST RUN_PRELDIST <1% <1% <1% DISTBPRE.LOG NTMOVFIN.LOG PDDYT2NT.6C Support Release 2: UNIX SAP AG empty RUN_RDDYT2NT PRUN_RADISWTC CNV_CHK_ICC <1% <1% <1% Prepares conversion of Basis tables Completes incremental conversion Determines halted conversions of the incremental conversion Copies nametabs to the shadow tables Adjusts nametabs of structures Imports DDIC source for tables relevant to Basis Changes status in table UVERS Checks whether outstanding updates exist Determines all secondary indexes Deletes inconsistent secondary index definitions for tables relevant to Basis Deletes table TATAF Imports requests for porting-dependent modifications Stops system Starts system Prepares distribution run for the tables relevant for Basis Distributor run for tables relevant for Basis Writes table contents for external conversion PDDYT2NT.LOG NTDELFIN.LOG RDCLTAF1.LOG DISTBAS.LOG PSVBCHCK3.ELG INXPREP.LOG DUMP_CNV.ELG INXDEL.LOG DISTBPRE.

LOG ALPXDP.LOG EUSWITCH.LOG VIEWIMP.LOG ALTERD4V.LOG VIEWIMP_BAS MODPROF_BAS2) ENVCHK <1% <1% <1% VIEWIMP.LOG April 2001 233 .LOG DEL_CNV.LOG LOADCRE.LOG NTNOBD.ELG ALTER_TAF EU_SWITCH LOADCRE NTACT_RWR <1% <1% <1% <1% NTACT_NOBD <1% NTNOBD.ELG ALPX.SAP AG Upgrading to 4.ELG XTERN_CNV.ELG UVERS_UP_S ALTER_VBDAT ALTER_D4V EXEC_SMOFF <1% <1% <1% <1% ALTERVB.LOG NTRWR40.LOG LOADCRE.LOG XTERN_CNV.LST ALTERTF.LOG VIEWPRP <1% VIEWPRP.LOG EXECSMF.ELG CNV_SUBMIT2) STOPR3_BAS XTERN_CNV 1% <1% 2% CNV_SUB.ELG XTERN_CNV.6C Support Release 2: UNIX to file system DEL_CNV <1% Deletes table contents written to the file system from the system Converts tables relevant to Basis Stops system Converts tables externally and writes contents into system Special handling of table TATAF Switches to new Repository Creates new ABAP load tables Adjusts substituted nametab entries for DB objects to the target system Deletes inactive nametabs of nondatabase objects Changes status in table UVERS Creates table VBDATA on the database Deletes views of the shadow tables Deactivates Session Manager for the upgrade Cleans up conflicts between delivered views and tables delivered previously Creates Basis views Stops system and changes profiles Tests/switches environment of the DEL_CNV.ELG NTRWR40.LOG CNV_SUB.

LOG PDDMCMRG.ELG RSWBOUP1.LOG RDDNEWPP.LOG ADDMCM.ELG RPU510Q2.LOG TABUWBO.LOG RDCLTAF2.LOG RPU510Q2.LOG TABUIMP.ELG DDIC_46C2) <1% 234 April 2001 . imports the result of transaction SPDD from a development system KX_SW.LOG PDDDL4TA.ELG PDDMCMRG.6C Support Release 2: UNIX SAP AG user <sapsid>adm KX_SWITCH TABUIMP_BAS2) <1% <1% Switches SAP Kernel Imports (a few) table entries needed to start the system with the new SAP Kernel Creates table DDLOG Imports standard transport layers Source Release 3.Upgrading to 4.ELG RSUMOD03.ELG RDDNEWPP.ELG ADDMCM.ELG LANGAREA.LOG RSUMOD03.ELG ALTER_DLG TABUIMP_WBO2) AREA_SET <1% <1% <1% ALTERDLG.0D: Sets table for the language area Starts system Deletes table TATAF Initializes and adjusts tables for Workbench Organizer Reschedules RDDIMPDP Initializes new administration of customer modifications Clears defective records in table T510Q Adjusts matchcodes automatically Marks matchcodes for activation Appends shadow import in upgrade No actions Imports requests for porting-dependent modifications Deletes TADIR entries of temporarily generated objects If necessary.ELG JOB_RDDNEWPP JOB_RSUMOD03 <1% <1% JOB_RPU510Q2 JOB_RDDMCMRG ADDTOBUF_MCM APPENDBUF_ UPGRADE APPENDBUF46C PORT_IM22) <1% <1% <1% <1% <1% <1% PORT_IM2.LOG STARTR3_NBAS JOB_CLTAF2 JOB_RSWBOUP1 <1% <1% <1% RDCLTAF2.LOG RSWBOUP1.ELG DDIC46C.ELG JOB_DL4TA_46C <1% PDDDL4TA.

LOG PREPCON.ELG PMVNT46C.LOG INDEXCHK.LOG ALTER_VID JOB_RSDB2XTT <1% <1% Generates control entries for parallel conversion JOB_RSDB4XTT PREPPCON_INX <1% <1% No actions Prepares parallel DDL processing in PCON.ELG PDDMVSUB.ELG PADDREXE.ELG PCON46C.LOG PCON_46C1)2) 7% PCON46C.LOG RUN_DREXE_46C <1% JOB_RUTTYREP <1% JOB_UMOD20_46C ACT_46C1)2) <1% 2% Use SPDD to adjust ABAP Dictionary objects.LOG STOPR3_I46C TMPLDINV <1% <1% PMVNTAB_46C 3% PMVNT46C.6C Support Release 2: UNIX SVERSCHK_46C <1% Checks table SVERS to see whether the new SAP version was created successfully Renames data elements with naming conflict in customer namespace Checks and repairs entries in the table DDTYPES Adjusts structure of tables to DB Activates DDIC customer objects Checks secondary indexes Removes table TMF18 from the set of substituted tables Deletes inconsistent views DB2 for OS/390 PSUMOD20.SAP AG Upgrading to 4. if necessary RUN_INDC_46C JOB_MVSUB_46C <1% <1% INDEXCHK.LOG SQLLDINV.LOG PSDB2XTT.ELG PDDMVSUB.LOG ACT46C.LOG April 2001 235 . selects tables that get an index Converts application tables and activates their nametab entries Stops system Validates ABAP loads created since the STARTR3_NBAS phase was generated Converts application views and activates remaining nametab TMPLDINV.LOG ALTERVID.ELG PSDB2XTT.LOG XTTSIZEI.ELG PSUMOD20.LOG PADDREXE.

LOG REIMPDDN.LOG PDDLDINV.ELG PSDCDDXT.ELG ADOIM46C.LOG PSWBOUP2.ELG REIMPCDOC_LOG REIMPCDOC1) <1% 236 April 2001 .LOG VIEWIM46C.6C Support Release 2: UNIX SAP AG entries STARTR3_I46C JOB_DCXTF_46C JOB_LDINV_46C STOPR3_L46C LD_SWITCH_46C VIEWIMP_46C STARTR3_NL46C JOB_DBDIF_46C TABIM_46C2) ALTER_TABIMUPD STARTR3_TB46C JOB_RSWBOUP2 <1% <1% <1% <1% <1% <1% <1% <1% 12% <1% <1% <1% Starts system Deletes and recreates table DDXTF Deletes temporary loads again Stops system Switches to new ABAP loads Creates Basis views (DROP/CREATE) Starts system Clears table DBDIFF on the database Imports entries to the control tables Updates statistics for some tables Starts system Initializes and adjusts tables for Workbench Organizer Imports ADOs Converts matchcodes Activates lock objects Automatically repeats phase once if an error occurs PSWBOUP2.LOG REIMPDOC.ELG UEXP_46C REIMPDDN_46C REIMPDOC1) <1% <1% <1% If necessary.ELG REIMPDDN. exports adjusted DDIC objects Re-imports inactive DDIC versions Reimports customer extensions to SAP object documentation Re-imports UEXP46C.LOG LDSWITCH.ELG PDDLDINV.ELG TABIM46C.ELG REIMPDOC.LOG PSDCDDXT.LOG VIEWIM46C.Upgrading to 4.LOG PADDBDIF.ELG TABIMERR.ELG ADOIM_46C1)2) 9% XPRAS_46C1)2) 11% Executes XPRAs Automatically repeats phase once if an error occurs XPRAS46C.ELG PADDBDIF.

LOG JOB_RSTLANUPG .LOG REIMPMDOC.LOG RDDIT022.ELG PDDNTPUR.ELG PSDBPROD.LOG PDDNTPUR.SAP AG Upgrading to 4. ELG PSDBPROD.LOG ALPXP.ELG TR_PATCH_STATUS _UPGRADE <1% Updates status information for Support Packages that have been included Checks and repairs entries in the table DDTYPES Executes DB-specific operations for restarting the system Checks requirements for production operation Updates table AVERS Activates CMOD enhancements Cleans up database Cleans up screen sequence control Cleans up nametab Reactivates Session Manager Stops system and resets profiles SAP DB DBCLEAN46C.ELG REIMPMDOC. LOG PSDLDSEQ.LOG JOB_RUTTYREP1 <1% JOB_DBPROD_46C1) <1% PRODCHK_46C <1% JOB_RDDIT022 JOB_RSMODACU DBCLEAN_46C1) JOB_RSDLDSEQ JOB_RDDNTPUR EXEC_SMON MODPROFP_46C <1% <1% <1% <1% <1% <1% <1% Confirm SAP DB Strategies A_on or A_switch: Prompts you to back up the Back up the database and confirm April 2001 237 .ELG PUTTYREP1.LOG RDDIT022.LOG PSDLDSEQ. starts system Sets the status of the installed languages STARTR3_46C JOB_RSTLANUPG <1% <1% JOB_RSTLANUPG .ELG <1% Reimports modifications to documents If necessary.6C Support Release 2: UNIX documentation on customer objects REIMPMDOC1) REIMPCDOC.ELG EXECSMN. LOG PUTTYREP1.

ELG PSUPGEND.ELG UEXPSPAU <1% JOB_UPGDELPROG SAVELOGS <1% <1% Choose between: normal (only important) all none EXITINFO EXIT --<1% Displays Notes on post-upgrade activities Ends R3up Confirm 238 April 2001 . exports objects adjusted with transaction SPAU --Copies upgrade logs to /usr/sap/ trans/upgrade SAVELOGS.Upgrading to 4.6C Support Release 2: UNIX SAP AG database STARTR3_P46C REQJOBRES <1% <1% Starts system As of Source Release 4.LOG UEXPSPAU.ELG EWTCH066.ELG PADDRDOC.5B: Prompts you to schedule background jobs Imports authorizations into client 066 (EarlyWatch) --Tests target version Changes status in table UVERS Updates DB table statistics Sets installation status to OK Adjusts documentation for renamed data elements (executes report RADDRDOC) Prompts start of transaction SGEN Displays P errors PDDDBSTA.LOG PDDDBSTA.LOG PADDRDOC.ELG EWIMPORT_46C <1% END ENDCHK UVERS_UP_END JOB_RDDDBSTA JOB_UPGEND_46C JOB_DRDOC_46C <1% <1% <1% <1% <1% 2% REQGENLD CHK_POSTUP ----- Confirm Correct P errors before restarting production operation Confirm SPAUINFO --- Displays information for adjusting objects with transaction SPAU If necessary.LOG PSUPGEND.

SAP AG

Upgrading to 4.6C Support Release 2: UNIX

Upgrade Assistant
Use
The Upgrade Assistant is the frontend for the upgrade process. It provides one or more graphic user interfaces (GUIs) for controlling and monitoring the upgrade. The Upgrade Assistant simplifies the upgrade procedure.

Integration
The Upgrade Assistant is a distributed program consisting of a server component and several GUI components. Only one person can control the upgrade from the GUI components.
• Server component

The server ensures communications between the upgrade control program R3up and the GUIs of the Upgrade Assistant. It must be started on the host on which you want the upgrade process to run.
• GUI components

The GUI components can be executed on any other hosts. You can log on to the server as the observer or the administrator. The observer role only authorizes you to monitor an upgrade. An administrator is authorized to take actions affecting the progress of the upgrade, for example an administrator can start or stop the upgrade and can enter any necessary commands. Only one GUI can assume the role of administrator. However, the GUI with this role can change in the course of the upgrade. The graphic below illustrates the architecture of the Upgrade Assistant and the interaction between the Upgrade Assistant and the R3up upgrade control program.
Upgrade Assistant

GUI GUI (Observer) (Observer)

Central Instance

GUI GUI (Administrator) (Administrator)

Server Server

R3up R3up

GUI GUI (Observer) (Observer)

Functions

You can control and monitor the progress of the upgrade from a number of different places.

April 2001

239

Upgrading to 4.6C Support Release 2: UNIX

SAP AG

Frontend and upgrade process are divided into separate components so that the entire upgrade does not terminate if a connection fails. This provides optimal support for a remote upgrade.

• •

You have an alert mechanism that lets you start an external program. Provided you have access to the Internet, you can access the SAP Notes database in the SAP Service Marketplace from a GUI.

The Upgrade Assistant is implemented in Java. A scroll mode is provided for the upgrade for platforms not supporting Java. We recommend using the Upgrade Assistant, since scroll mode does not provide the above features.

240

April 2001

SAP AG

Upgrading to 4.6C Support Release 2: UNIX

Using the Upgrade Assistant
Use
The Upgrade Assistant offers you a number of functions. You can change the passwords for the roles, change roles, use and monitor PREPARE, or look for Notes.

Changing the Passwords
The passwords for the two roles can only be changed from the administrator GUI. In the main menu choose Administrator →Change passwords.

Changing the Role
By choosing File → Change role you can change role dynamically. The following dialog box appears:

If, for example, you are in the role of the observer and enter the password for the administrator you change to the administrator role. If an administrator already exists at this time then the administrator role is taken away from them. If you only want to change the User name or the Phone number, then enter the password of the role you are in. In this case only the entered data is updated.

Searching for Notes from the GUI
If you have an Internet connection, you can access SAP Notes in SAPNet using the GUI. In the main menu, choose Services → SAP Notes Search.

More Information on the Upgrade Assistant
To display a description of the Upgrade Assistant with all its functions, choose Help → Introduction in the main menu.

April 2001

241

Upgrading to 4.6C Support Release 2: UNIX

SAP AG

Upgrade Monitor
Use
The Upgrade Monitor lets you monitor the upgrade, and helps you recognize any processes that have stopped.

Functions
The monitor estimates the time when the upgrade ends, as well as other important stages (milestones). These estimates are based on SAP reference times and the runtimes of upgrade phases that have already completed. The output of the monitor is updated every 60 seconds. The more advanced the progress of the upgrade is, the more precise the estimates are. If possible, the runtime estimate also includes any runtime that is lengthened for systematic reasons, however this is subject to restrictions. Systematic fluctuations can also occur if the upgrade phases run more quickly than expected. This means that the end of the upgrade cannot be estimated precisely. The data appears on the screen, but the way it is displayed depends on if you are upgrading the system with the Upgrade Assistant or in scroll mode.

Graphical Display in the Upgrade Assistant

242

April 2001

The monitor does not recognize any subprocesses of these processes. the bar appears in green. the Upgrade Assistant or the R3up program. the bars appear first in yellow and then in red. Note that the process bar is updated only every 60 seconds. so the progress of the upgrade and the estimated runtime until the next milestone are shown in numerals. As long as the runtime has not been exceeded. and therefore cannot display them. The upgrade processes that are running appear under Current activities. Procedure in Scroll Mode: 1. Open another window at the operating system level. Numerical Display in Scroll Mode No graphics are displayed in scroll mode. 2. If the runtime has been exceeded. This may be the Upgrade Monitor.6C Support Release 2: UNIX The total runtime of the upgrade and the runtime of the next milestone appear as bar graphs. An animated graphic displays the activity of the upgrade processes.SAP AG Upgrading to 4. Starting the Upgrade Monitor Procedure Procedure in the Upgrade Assistant: Go to the main menu and start the Monitor by choosing Services → Upgrade Monitor./R3up gt=SCROLL Monitor April 2001 243 . If the graphic is not moving. Enter the following commands in the new window: cd <upgrade_directory>/bin . one of the upgrade processes is stopped. The upgrade processes that are running appear under Current activities.

The restarted R3up must wait for these processes before the upgrade can continue with any other actions.6C Support Release 2: UNIX SAP AG Understanding the Upgrade Monitor Display Use The following Upgrade Monitor display indicates that you may have to intervene. Procedure for Status Red 1. If the previous steps are not successful. If step one is not successful. Procedure for Upgrade Processes that Are Frozen 1. restart R3up. First. Check the database and CPU activity. The graphic that displays the activity of the upgrade processes is not moving. If this is the case. or the upgrade is in an endless loop. 3. restart the Upgrade Assistant GUI only. 244 April 2001 . 2. try and find out why the runtime is so long. This means that the upgrade processes are hanging. restart the Upgrade Assistant server. any processes that are still running are displayed. contact SAP Local Support. If you are unsure how to proceed. then either runtime has been exceeded significantly. do not terminate the upgrade. instead. • • One of the bars showing the progress of the upgrade is red.Upgrading to 4. 2. If you can still detect activity. When R3up is restarted.

Sign up to vote on this title
UsefulNot useful