Installing and Upgrading Add-Ons


The Add-On Installation Tool can process two different types of add-on delivery packages: add-on installations and add-on upgrades.

Only import packages when the system load is low, since users must not be logged onto the system and no background jobs must be running.

If not, problems can arise (such as terminated transactions or problems with synchronization).

If you want to minimize the downtime when importing add-on packages, you can perform the import while in the import mode Downtime-minimized. The Add-On Installation Tool then performs many of the phases during productive operation and prompts you during the import to stop productive operation. The tool also tells you when you are able to resume productive operation. (See also: Import Mode: Downtime-minimized)


·        You are logged on to client 000.

·        You loaded the relevant loaded the relevant nstallation packages into your system.

·        You have selected the required import mode in the Add-On Installation Tool settings.


Since the add-on installation procedure is identical to the add-on upgrade procedure, the installation is used as an example here.


       1.      Call the Add-On Installation Tool (transaction SAINT). The initial screen is displayed, listing the add-ons that have already been installed.

       2.      Choose Start to begin the installation process. The subsequent screen shows you the Add-On Packages that can be installed.

       3.      To search in the EPS directory of the current system for additional installation packages, choose Load. The system displays any new packages it finds.

See also: Loading Installation Packages.

       4.      To prepare the installation queue for an add-on, select the add-on that you want to install, and choose Continue.

This can have varying results:

Ў        The add-on may not be installed in this system, as you have not met all of the import requirements. If this happens, you are informed of the import requirements in question.

Ў        Additional packages (Support Packages or CRTs) are needed for the installation. You are shown which packages are missing. The installation does not start.

First load the missing packages.

If errors occur during queue definition, see the queue calculation log.

Ў        If all the import requirements are met and all the necessary Support Packages are available, the relevant queue is displayed (all the packages that make up the installation in the correct order). You can start the installation process.

       5.      You can now add additional Support Packages to the installation queue. To do this, go to the Support Package Selection tab page for each component that you require and select the highest Support Package that you want to import from the selection list. If you do not want to add any other Support Packages for a component, then select the empty field from the selection list. The system automatically enters the Support Package Level of the chosen Support Package in the Level field.

       6.      When you have selected the target Support Packages for all the components you require, choose Continue. The system calculates the maximum possible queue using the chosen target Support Packages and the installation queue that has already been calculated. The results of the queue calculation are summarized in the Status/Comment section, whilst the resulting queue is listed in detail on the Installation Queue tab page. At the same time, the Support Package Level attained with the calculated queue is displayed on the Software Components tab page for each component, and linked to the Support Package Level of the chosen target Support Package by way of a comparison symbol. This enables you to have a quick overview of the result of the queue calculation.

The queue calculation can have the following results:

Ў        The extended queue is consistent and corresponds completely to the target Support Packages that you have chosen.

Ў        The extended queue is consistent but does not correspond completely to the target Support Packages that you have chosen. For certain components, the chosen target Support Package levels could not be attained using the calculated queue, or more Support Packages of a component had to be included in the queue than had originally been required, in order to ensure a consistent queue. The reason for variances of this nature is the dependencies that exist between Support Packages of different components. These make it impossible to match entirely the target Support Package levels that you have chosen. This is the case, for example, if you have to include Conflict Resolution Transports (CRTs).

Ў        The system could not extend the installation queue consistently. A corresponding error message is displayed.

If errors occur during queue definition, see the queue calculation log.

       7.      If the queue does not fit your requirements, you can choose Back to return to the Support Package selection, modify your selection, and start a queue calculation again.

       8.      If the queue matches your requirements, choose Continue.

       9.      The system queries you to find out whether you want to include the modification adjustment transports in the installation queue.

In the Settings for the Add-On Installation Tool, you can suppress this question.

If you confirm the question, a dialog box appears containing a list of the available modification adjustment transports.

                            a.      If no adjustment transports are displayed in the list, you first need to notify the system of the transports. To do so, choose Find Adjustment Transports.

The system searches for adjustment transports in the Transport Management System import queue and in the transport directory on the application server. The system lists the transport requests that you have selected in released as modification adjustment transports in the export system.

For each adjustment transport listed, the Status field shows whether or not it matches the current installation queue and can therefore be included.

The adjustment transports that match the queue are already selected in the table. An adjustment transport "matches" the queue if the target Package status of the current queue is the same as the one in the export system at the time when the modification adjustment transport is exported.

                            b.      If required, change the selection of adjustment transports.

You cannot select adjustment transports that do not match the queue. To hide the adjustment transports that do not match the queue, choose the Activate Filter pushbutton.

                            c.      To add the modification adjustment transports to the installation queue and start the installation, choose Continue.

When a modification adjustment transport is imported as part of an installation queue, it is deleted from the normal transport flow for Workbench requests. No automatic forwarding to the follow-on system takes place. For example, if you are working with the classic three-system landscape comprising a development system (DEV), quality assurance system (?QAS) and production system (PRD), the modification adjustment transport is put into the import queue of the QAS after being exported from the DEV system. Including the adjustment transport in an installation queue in system QAS means that it is deleted from the QAS import queue. Since no transport forwarding takes place when importing am installation queue, the adjustment transport is not forwarded into the import queue of the PRD system.

You then need to import the adjustment transport into the PRD system as part of an installation queue, using the he same procedure as in the QAS.

   10.      A dialog box appears which enables you to select the Start Options. Define the start options you required and choose Continue.

Conventional Import Mode

If you have not changed the default start options, the Add-On Installation Tool now performs the entire process in dialog. Note that at this stage, your system must no longer be in a state of productive operation.

After starting the installation, the Add-On Installation Tool runs through a set series of phases. If an error occurs in one of these phases, the installation terminates and the error is described, as far as possible. Once the problem is corrected, choose Continue to continue the installation.

If you cannot correct the problem, you can reset the installation up to module Import 1 (phase SCHEDULE_RDDIMPDP, see Phases in the Add-On Installation Tool) by choosing Back.

In later phases, the contents of the database have already been changed, meaning that you then have to continue the installation. During the import, you also need to perform a modification adjustment. To do this, proceed as described under Adjusting Modifications.

Import mode downtime-minimized

If you have selected the import mode downtime-minimized, some of the objects that are to be imported are imported inactively. During this phase you can continue to use your system productively.

                            a.      The Add-On Installation Tool performs all preparation and test steps, as usual (Preparation module). It then runs through the import steps for inactive objects that can be performed during production operation of the system (Import 1 module).

The development environment is blocked at the start of module Import 1, so that modifications to objects do not put the consistency of the system at risk.

                            b.      The Add-On Installation Tool then displays a dialog box informing you that you must stop productive operation for the next import module (Import 2).

Ў        To interrupt the import and change the state of the system, choose Cancel.

End any background jobs that are running. Prompt all users to close any transactions they are working in and to log off the SAP System.

Ў        To proceed with the import, choose Continue.

                            c.      Continue the import.

The next import phase activates the inactive imported objects and imports the remaining objects from the Installation Packages in the queue. Once these phases have been completed, the Add-On Installation Tool informs you that you can restart production operation of your system.

This applies only if you have made either no or very few modifications to SAP objects.

   11.      If you have modified SAP objects but have not included any adjustment transports, or if the included adjustment transports do not cover all objects that need adjusting, the Add-On Installation Tool prompts you during one of the following phases to perform a modification adjustment. To do this, proceed as described under Adjusting Modifications.

   12.      To complete the import, choose Continue.

In the subsequent import phases, the program code and program texts that have been made obsolete by the imported objects are physically deleted in the database. The import is completed.