IQX Add-On Installation

FAB is a certified SAP Add-on that is packaged using the SAP Add-On Assembly Kit (AAK). The FAB add-on consists of a series of transport requests grouped together as a delivery package. When imported, the FAB add-on is registered as an additional software component in the system. Instead of sending transport requests to customers, new features and bug fixes are installed in the SAP system as a package. The transaction SAINT (SAP Add-On Installation Tool) is used in a fresh installation of the FAB add-on or for a major version upgrade. On the other hand, the transaction SPAM (Support Package Manager) is used to install minor updates in support packages (patch). The following steps are relevant for a fresh FAB Add-On installation or when upgrading an existing FAB Add-On to the latest version.

Package Installation

Installation Packages will be provided by IQX depending on the deployment method and version of the SAP system. It will be labeled as either Frontend or Backend.

Central Hub Deployment

• In SAP Backend, install the package for Backend using transaction SAINT in Client 000

• In SAP Frontend Gateway, install the package for Frontend using transaction SAINT in Client 000

Embedded Deployment

• Install the package for Backend using transaction SAINT in Client 000

Installation Steps via SAINT/SPAM transaction

Fresh Installation Excluding Any Patch Release

1. Login to client 000, go to transaction SAINT

2. Load Installation Packages

3. Decompress file as necessary.

4. Once package is uploaded, click on START to begin the installation process.

5. Select the installable IQX component and click on CONTINUE.

6. Choose on Target Support Package if available. Click on CONTINUE to proceed.

7. CONTINUE on Calculated installation queue.

8. Confirm on processing mode.

9. Wait while SAP is in progress installing.

10. Once Add-On was successfully imported, you may click on LOGS to display transport messages or FINISH to proceed on SAINT Runtime Analysis.

11. View Runtime Analysis

Fresh Installation Including a Patch Release

1. Login to client 000, go to transaction SAINT.

2. Load Installation Packages. We need to include two (2) different files:

   1. Base installation file with pattern ECC_VVV_K-YYYCOINIQX.SAR where VVV is the minimum SAP version required and YYY is the FAB version release.

   2. Patch installation file with pattern K-YYYB1INIQX.SAR where YYY is the FAB version release.

**Please note that filename may differ depending on the deployment option done in your system.

*Customers may also opt to upload the files in their EPS Inbox. In this case, packages must be loaded from their application server.

3. Decompress files as necessary. Repeat this process for both the base installation package and the patch package.

4. Once packages are uploaded, click on START to begin the installation process.

5. Select the installable IQX component and click on CONTINUE.

6. Choose on Target Support Package if available. Click on CONTINUE to proceed.

7. CONTINUE on Calculated installation queue.

8. Confirm on modification adjustment added by the patch package. Then, click on CONTINUE.

9. Confirm on processing mode.

9. Wait while SAP is in progress installing.

10. Please note that these warnings are to be expected. Click on IGNORE button at the top part.

11. Once Add-On was successfully imported, you may click on LOGS to display transport messages or FINISH to proceed on SAINT Runtime Analysis.

12. View Runtime Analysis

Upgrade Installation Including a Patch Release

The steps required for an upgrade installation with a patch release are identical to those for a fresh installation, including a patch release, except for the files to be uploaded. Please follow the steps outlined for a Fresh Installation Including a Patch Release but utilize the file packages listed below.

• Upgrade installation file with pattern ECC_VVV_K-YYYCHINIQX.SAR where VVV is the minimum SAP version required and YYY is the FAB version release.

• Patch installation file with pattern K-YYYB1INIQX.SAR where YYY is the FAB version release.

**Please note that filename may differ depending on the deployment option done in your system.

Patch Installation for Customers on latest major FAB release version (3.3.0)

Please note that patch package cannot be installed independently. For customers already in the latest major release, FAB v3.3.0 as of this writing, follow the steps below. Otherwise, kindly follow steps for Fresh or Upgrade Installation Including Patch Release above.

1. Login to client 000, go to transaction SPAM.

2. Load Patch installation file with pattern K-YYYB1INIQX.SAR where YYY is the FAB version release.

**Please note that filename may differ depending on the deployment option done in your system.

*Customers may also opt to upload the files in their EPS Inbox. In this case, packages must be loaded from their application server.

3. Decompress file as necessary.

4. Choose the Component that is to be upgraded. Choose the Highest level that is available in the Queue.

5. Choose Support Package-> Import Queue from Menu. Choose to execute in background.

6. Confirm the Queue by choosing the Menu Support package->Confirm Queue.

7. Once Add-On patch was successfully imported, you may verify it in the installed software components in SPAM.

Post-installation steps

Import Table Contents

The Transport Requests for the FAB Sample Applications and the Table Contents are packaged in 3 additional ZIP files. These objects are required for the FAB Workbench configuration and layout and should be imported using the Transport Management System (Transaction STMS) in all active SAP Clients where FAB is being used for development and testing which may include Development, Testing, Sandbox, Quality, and Productive clients.

• For S4HANA deployment, please apply transport S4HK901471 to adjust changes for S4HANA.

Index Calculation

The SAPUI5 application index provides an indexing and caching mechanism for information related to apps, components, and libraries in the SAPUI5 ABAP repository and related to components and libraries in the SAPUI5 distribution layer. The index is calculated by the report Calculation of SAPUI5 Application Index for SAPUI5 Repositories (/UI5/APP_INDEX_CALCULATE). The report /UI5/APP_INDEX_CALCULATE has to be executed in the system where the FAB service is running whenever the content of the SAPUI5 ABAP repository has been changed.

Post-Installation Configuration and Validation

Perform the following configurations in the order below to completely set up the FAB add-on.

1. IQX Services Activation

2. General Configuration

3. Editor Configuration

4. App Configuration

5. Additional Configuration for Older SAP Systems ( < 7.40 )

6. Post Installation Validation

7. Troubleshooting Configuration