Installing and Upgrading Add-Ons 

Use

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 there should be no background jobs running.

Otherwise, problems can arise, such as terminated transactions or problems with synchronization.

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

Prerequisites

●      You are logged on in client 000.

●      You have loaded the relevant installation packages into your system.

●      You have selected the required installation mode in the Add-On Installation Tool settings.

Procedure

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

...

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

       2.      Choose Start to begin the installation process. A screen now appears showing a list of installable Add-On Packages.

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

See 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 cannot be installed in this system, as not all installation conditions have been met. If this happens, you are informed of the conditions in question.

○       Additional packages (Support Packages or CRTs) are needed for the installation. The system specifies which packages are missing. The installation does not start.

Load the missing packages.

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

○       If all installation requirements have been met, and all required Support Packages are available, the relevant queue is displayed (all packages that make up the installation in the correct order). You can now 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, 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.      Once 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/Commentsection, whilst the resulting queue is listed in detail on the Installation Queue tab page. At the same time, the Support Package Level reached 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 using a comparison symbol. This provides you with a rapid 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 your chosen target Support Packages. For certain components, the chosen target Support Package levels could not be reached using the calculated queue, or more Support Packages from a component had to be included in the queue than had originally been required, in order to ensure a consistent queue. These variances occur because of the dependencies between Support Packages from different components. These make it impossible to completely match the target Support Package levels that you have chosen. This can happen if you need to include Conflict Resolution Transports (CRTs).

○       The system could not extend the installation queue consistently. An error message is displayed to this effect.

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

       7.      If the queue does not meet your requirements, choose Back to return to the Support Package selection. Modify your selections and start a new queue calculation.

       8.      If the queue does meet your requirements, choose Continue.

       9.      The system prompts you to decide whether to include the modification adjustment transports in the installation queue.

You can suppress this question in the Add-On Installation Tool settings.

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 need to notify the system of the transports. To do this, 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 as modification adjustment transports and released in the export system.

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

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 when the modification adjustment transport is exported.

                            b.      If required, change the adjustment transport selection.

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

                            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. Requests are not forwarded to follow-on systems automatically. 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 QAS import queue 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 an installation queue, the adjustment transport is not forwarded to the PRD system’s import queue.

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

   10.      A dialog box is displayed, where you can select the Start Options. Define your required start options and choose Continue.

Conventional Import Mode

If you have not changed the default start options, Add-On Installation Tool now performs the entire process in the dialog. At this stage, your system should no longer be in production operation.

After starting installation, Add-On Installation Tool runs through a set series of phases. If errors occur in any of these phases, the installation process terminates, and a description of the error is provided. Once the problem has been corrected, choose Continue to restart the installation process.

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

In later phases, the content of the database has already been changed, meaning that you have no choice but to continue the installation process.

Import Mode Downtime-Minimized

If you have selected import mode downtime-minimized, some of the objects are imported inactively. You can continue using your system productively during this phase.

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

The development environment is blocked when module Import 1 starts, thus ensuring that modifications do not endanger the consistency of the system.

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

○       To stop the installation process and change the state of the system, choose Cancel.

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

○       To continue the installation process, choose Continue.

                            c.      Continue the installation process.

The next phase activates the inactively imported objects and imports the remaining objects from the Installation Packages in the queue. Once these phases have been completed, Add-On Installation Tool informs you that you can restart production operation in 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, Add-On Installation Tool prompts you to perform a modification adjustment during one of the subsequent phases. To do this, proceed as described under Adjusting Modifications.

   12.      To complete the installation process, choose Continue.

In the subsequent installation phases, program code and program texts that have been made obsolete by the imported objects are physically deleted from the database. The installation process is complete.