Installing IBM InfoSphere Information Server Pack for SAP Applications 7.1

Content

Before you begin

• Review the hardware and software requirements for the Pack.
• Install the prerequisite patches and libraries.
• Install the latest version of the InfoSphere Information Server Update Installer on the installation image of InfoSphere Information Server.
• Back up IBM InfoSphere Information Server:
• For version 9.1.2, see this document.
• For version 11.3, see this document.
• Ensure that you have administrative privileges to install the Pack.
• If you used an earlier version of IBM InfoSphere Information Server Pack for SAP Applications, export your existing jobs and configuration settings before you install the new version.

Upgrade scenarios

• Important: If version 7.0 of the Pack was installed on your computer, remove version 7.0 from both server and client computers and remove the is-suite/payloads/ISPackForSAP directory before installing version 7.1.
• The legacy IDoc Extract and IDoc Load stages as included in versions of the Pack up to 6.5 are deprecated and were replaced with the IDoc Extract Connector stage and the IDoc Load Connector stage in Pack 7.0. To keep using jobs that include the legacy IDoc stages, upgrade from the Pack for SAP R/3 6.5.0.2 on both the server and the client by doing the following:
  1. If the Pack version 6.5.0.2 is not already installed, install it.
  2. Install Pack version 7.1.
  NOTE: If you are performing an Information Server (IS) upgrade as well, make sure to perform the IS upgrade AFTER step 1 above. This is due to the fact that Pack version 6.5.0.2 cannot be installed on IS version 11.3 or later and Pack version 7.1 can only be installed on IS version 9.1.2 or later.
  For more information about migrating from the IDoc Extract and IDoc Load stages to the IDoc Connector stages, see this document.
• For general information on migrating jobs from older Pack versions, see this document.
• See the "Upgrade Troubleshooting" section in the known issues technote if you encounter issues during the upgrade.

Contents of the installation media

The installation media contains the following directories and files:

• ISPackForSAP

The installation package for the InfoSphere DataStage components (stages and administrator tool) for InfoSphere Information Server version 11.3 or later.
• ISPackForSAP.IS_912

The installation package for the InfoSphere DataStage components (stages and administrator tool) for InfoSphere Information Server version 9.1.2.
• ISPackForSAP/license

The license files.
• ISPackForSAP/RFC

The SAP server components (transport files).
• ISPackForSAP_RMRG (Microsoft Windows installation media only)

The installation package for the InfoSphere Data Architect components (InfoSphere Rapid Modeler and Rapid Generator for SAP Applications).
• i46depsr.pdf and i46djpsr.pdf

The product documentation (in English and Japanese).

Installing the SAP server components

The Pack includes components that need to be installed on each SAP application server that InfoSphere DataStage will communicate with. These include function modules and authorization role templates. These components are provided as SAP transport files for use with the SAP Transport Management System.
For detailed information about installing the SAP server components, see this document.

Installing the Pack

The Pack contains components for all three Information Server tiers: Engine (Server), Services and Client. The Engine and Client tier components are required for using the SAP connectivity in InfoSphere DataStage. The Services tier components include the Help files and the InfoSphere Rapid Generator services. Service tier installation is optional in case Rapid Generator will not be used.

You can install the IBM InfoSphere Information Server Pack for SAP Applications in graphical mode or in silent mode by generating and modifying a response file.

Important: Do not install the Pack along with InfoSphere Information Server. Make sure that InfoSphere Information Server is completely installed before you copy the Pack payload in to the is-suite/payloads directory.

Installing the Pack in graphical mode

To install the engine and/or services tier:

1. Log in as an administrator or root user.
2. From the product CD or the downloaded image of the module, extract the archive file for your operating system to your local computer.
3. From the directory where you extracted the file, copy the appropriate installation package directory into the is-suite/payloads directory of the InfoSphere Information Server installation image:
• If you use InfoSphere Information Server version 11.3 or later, copy the ISPackForSAP directory.
• If you use InfoSphere Information Server version 9.1.2, copy the ISPackForSAP.IS_912 directory.
4. From the is-suite directory of the InfoSphere Information Server installation image, run the installation program:
• On Linux or UNIX, enter ./setup .
• On Windows, run the setup.exe file.
5. Follow the prompts. When you reach the Product Selection page of the installation program, select IBM InfoSphere Pack for SAP Applications.
6. Follow the prompts to complete the installation.
7. If you are installing on Windows, restart your system to ensure that the DSSAPHOME environment variable is enabled.

To install the client tier (Windows only):

1. From the product CD or the downloaded image of the module, extract the archive file for your operating system to your local computer.
2. From the directory where you extracted the file, copy the appropriate installation package directory into the is-suite/payloads directory of the InfoSphere Information Server installation image:
• If you use InfoSphere Information Server version 11.3 or later, copy the ISPackForSAP directory.
• If you use InfoSphere Information Server version 9.1.2, copy the ISPackForSAP.IS_912 directory.
3. From the is-suite directory of the InfoSphere Information Server installation image, run the setup.exe file.
4. Follow the prompts. When you reach the Product Selection page of the installation program, select IBM InfoSphere Pack for SAP Applications.
5. Follow the prompts to complete the installation.

Installing the Pack in silent mode

When you install the Pack in silent mode, you use the InfoSphere Information Server installation image to create a response file. You then reference the response file that you created when you ran the installation program.

1. Create a response file:
1. Log in as an administrator or root user.
2. From the product CD or the downloaded image of the module, extract the archive file for your operating system to your local computer.
3. From the directory where you extracted the file, copy the appropriate installation package directory into the is-suite/payloads directory of the InfoSphere Information Server installation image:
• If you use InfoSphere Information Server version 11.3 or later, copy the ISPackForSAPdirectory.
• If you use InfoSphere Information Server version 9.1.2, copy the ISPackForSAP.IS_912 directory.
4. From the is-suite directory of the InfoSphere Information Server installation image, run the installation program:
• On Linux and Unix, enter ./setup .
• On Windows, double-click the setup.exe file.
5. Follow the prompts. When you reach the Response File Review page, select Do not install IBM InfoSphere Information Server and save my settings in a response file.
6. Optional: In the Response file location field, rename the default file.
7. Click Next, and then select Yes to exit the session.
2. Open the response file, and then edit the following two lines to set the passwords:
   app.server.password=<your_password>
   is.admin.password=<your_IS_password>
3. Save and close the response file.
4. Log in as an administrator or root user.
5. On a command line, browse to the is-suite directory of the InfoSphere Information Server installation image and run the installation program with a command that references the response file:
• Linux, UNIX: ./setup -rsp <response_file> –verbose
• Windows: setup.exe -rsp <response_file> –verbose, where <response_file> is the path and name of your response file.
6. If you are installing on Windows, restart your computer to ensure that the DSSAPHOME environment variable is enabled.

Removing the Pack

To remove the Pack, use the software removal program for IBM InfoSphere Information Server. You must have administrative privileges to run the software removal program. Complete the following steps for your operating system:

Operating system	Procedure
Linux or UNIX	Log in as the root user. Go to the <installation_directory>/InformationServer/_uninstalldirectory of InfoSphere Information Server. Enter ./uninstall . A message is shown that describes how to access the graphical user interface for the software removal program. Open a web browser, and go to one of the addresses that is listed in the message that was shown. Follow the instructions to remove the Pack.
Windows	Log in as an administrator. Go to the <installation_directory>\InformationServer\_uninstall directory of InfoSphere Information Server. Run the uninstall.exe file. Follow the instructions to remove the Pack.

Installing the InfoSphere Data Architect components: InfoSphere Rapid Modeler and Rapid Generator for SAP Applications

IMPORTANT

To use InfoSphere Data Architect on a system where the engine tier of Information Server 11.3 is already installed, download and install the IBM Installation Manager version 1.7 prior to installing InfoSphere Data Architect. This prevents a version conflict between the InfoSphere Data Architect installer and the Information Server installation.

To download IBM Installation Manager version 1.7, click the following link:

Download IBM Installation Manager, version 1.7

Client tier installation

1. Run launchpad.exe in the root folder of the installation package.
2. Follow the instructions in the installation wizard and make sure that you select the package group where you installed InfoSphere Data Architect.

Services tier installation

The services tier is installed with the services tier of InfoSphere Information Server Pack for SAP Applications.

To check if the services tier was installed successfully, specify the following URL in a browser:
https://<ISDomainName>:<ISDomainPort>/cwrapidgenerator/JobGenerator

Where <ISDomainName> is the domain name of the InfoSphere Information Server and <ISDomainPort> is the HTTPS port number of InfoSphere Information Server. The default port number is 9443.

Removing the InfoSphere Data Architect components: InfoSphere Rapid Modeler and Rapid Generator for SAP Applications

To remove the InfoSphere Data Architect components, use IBM Installation Manager.


Troubleshooting

If the installation fails or in case components appear to be missing after the installation, try reinstalling. Note that if the last installation was cancelled, you may need to follow technote 1679405 to resume or clean the failed installation. If this does not help, check the installation logs for error messages that may suggest the cause. If you need further assistance, open a PMR with Support and provide the installation logs from all applicable tiers (Engine, Client, Services). The log file locations are described in the online documentation.