HYPERION® DATA INTEGRATION MANAGEMENTData Integration Management Components Data Integration Management is integrated with Informatica PowerCenter and with adapters for Financial

H Y P E R I O N ® D A T A I N T E G R A T I O N M A N A G E M E N T

R E L E A S E 9 . 2 . 1

I N S T A L L A T I O N G U I D E

Data Integration Management Installation Guide, 9.2.1

Copyright © 2006, 2007, Oracle and/or its affiliates. All rights reserved.

Authors: Information Development Team

The Programs (which include both the software and documentation) contain proprietary information; they are providedunder a license agreement containing restrictions on use and disclosure and are also protected by copyright, patent, andother intellectual and industrial property laws. Reverse engineering, disassembly, or decompilation of the Programs, exceptto the extent required to obtain interoperability with other independently created software or as specified by law, isprohibited.

The information contained in this document is subject to change without notice. If you find any problems in thedocumentation, please report them to us in writing. This document is not warranted to be error-free. Except as may beexpressly permitted in your license agreement for these Programs, no part of these Programs may be reproduced ortransmitted in any form or by any means, electronic or mechanical, for any purpose.

If the Programs are delivered to the United States Government or anyone licensing or using the Programs on behalf of theUnited States Government, the following notice is applicable:

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered toU.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to theapplicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication,disclosure, modification, and adaptation of the Programs, including documentation and technical data, shall be subjectto the licensing restrictions set forth in the applicable Oracle license agreement, and, to the extent applicable, the additionalrights set forth in FAR 52.227-19, Commercial Computer Software--Restricted Rights (June 1987). Oracle USA, Inc., 500Oracle Parkway, Redwood City, CA 94065.

The Programs are not intended for use in any nuclear, aviation, mass transit, medical, or other inherently dangerousapplications. It shall be the licensee's responsibility to take all appropriate fail-safe, backup, redundancy and other measuresto ensure the safe use of such applications if the Programs are used for such purposes, and we disclaim liability for anydamages caused by such use of the Programs.

Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of theirrespective owners.

The Programs may provide links to Web sites and access to content, products, and services from third parties. Oracle isnot responsible for the availability of, or any content provided on, third-party Web sites. You bear all risks associated withthe use of such content. If you choose to purchase any products or services from a third party, the relationship is directlybetween you and the third party. Oracle is not responsible for: (a) the quality of third-party products or services; or (b)fulfilling any of the terms of the agreement with the third party, including delivery of products or services and warrantyobligations related to purchased products or services. Oracle is not responsible for any loss or damage of any sort that youmay incur from dealing with any third party.

Contents

Chapter 1. Installation Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Shared Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Installation Task Flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Data Integration Management Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Setup Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Operating Environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Chapter 2. Planning the Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Port Numbers Used by Hyperion Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Default Port Numbers for Remote Method Invocation (RMI) Servers . . . . . . . . . . . . . . . 11

Chapter 3. Installing and Uninstalling Data Integration Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Running the Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Installing Data Integration Management in Silent Mode . . . . . . . . . . . . . . . . . . . . . . . . . 22

Creating a Response File Using a Template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Creating a Response File During an Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Installing Data Integration Management in Console Mode . . . . . . . . . . . . . . . . . . . . . . . 23

Uninstalling Data Integration Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Uninstalling Data Integration Management in Silent Mode . . . . . . . . . . . . . . . . . . . . 24

Uninstalling Data Integration Management in Console Mode . . . . . . . . . . . . . . . . . . 25

Stopping Repository Server (UNIX) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Stopping Server (UNIX) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

About Hyperion Home . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Hyperion Home Location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Files Installed in the HYPERION_HOME Directory . . . . . . . . . . . . . . . . . . . . . . . . . 26

Changing the Hyperion Home Location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Chapter 4. Configuring and Setting Up Data Integration Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Hyperion Configuration Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Launching Hyperion Configuration Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Registering Products with Shared Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Contents iii

Deregistering Products from Shared Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Product-Specific Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Reconfiguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Configuration Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Configuring Data Integration Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Configuring Sample with PowerCenter Repository Server and PowerCenter Server onDifferent Computers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Accessing Informatica Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

Synchronizing Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

Batch Synchronizing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

Starting and Stopping Shared Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

Starting Shared Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

Verifying Successful Startup of Shared Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

Stopping Shared Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

Chapter 5. Installing, Configuring, and Uninstalling Data Integration Management Adapters . . . . . . . . . . . . . 49

Data Integration Management Adapters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

Installing Data Integration Management Adapters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

Installing Adapters in Silent Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

Installing Adapters in Console Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

Configuring Adapters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

Registering Adapters with a Repository . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

Configuring Hyperion Application Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

Configuring JVM Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

Uninstalling Adapters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

Uninstalling Adapters in Silent Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

Uninstalling Adapters in Console Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

Appendix A. Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

iv Contents

1Installation Overview

In This Chapter

Shared Services ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Installation Task Flow ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Data Integration Management Components.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Setup Options ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Operating Environments ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Shared ServicesOracle's Hyperion® Shared Services (formerly called Hyperion Hub) functionality isprogrammed into products, such as Oracle's Hyperion® Planning – System 9, Oracle'sHyperion® Financial Management – System 9, and Oracle's Hyperion® Business Modeling.

Note:

Oracle's Hyperion® Data Integration Management can be used with or without Shared Services,but Shared Services must be installed before you can configure Data Integration Managementfor Shared Services authentication.

Shared Services integrates the products to provide the following functionalities:

● User provisioning

● External authentication definition

● Metadata synchronization

● Data synchronization

● Task flow management

User provisioning functionality is described in the Hyperion System 9 Shared Services UserManagement Guide available on the Oracle E-Delivery site and Oracle Technology Network(OTN). External authentication definition is described in the Hyperion System 9 Shared ServicesInstallation Guide, available on the Oracle E-Delivery site and OTN. All other Shared Servicesfunctionality is described in the administrator’s and user’s guides for the products thatimplement Shared Services. Products that implement Shared Services functionality requireaccess to a Shared Services server running Shared Services client and server software, and to adatabase dedicated to Shared Services.

Shared Services 5

Installation Task FlowThe following table describes the task flow for installing Oracle's Hyperion EnterprisePerformance Management software and its components:

Table 1 Installation Task Flow

Task Number Task Product Component Documentation

1 Install Shared Services andShared Services ApplicationServer and relationaldatabase managementsystems (RDBMS)

Shared Services Installer,Oracle's Hyperion®Configuration Utility™

Shared Services InstallationGuide

2 Configure Shared Services toauthenticate user namesexternally stored in LDAP,Active Directory, or WindowsNT LAN Manager, enablingSingle Sign-on

Shared Services ExternalAuthentication ProviderConfiguration Console

Shared Services InstallationGuide

3 Install Hyperion EnterprisePerformance Managementsoftware

Hyperion EnterprisePerformance ManagementSoftware Installers

Product Installation Guides

4 Activate and configureHyperion EnterprisePerformance Managementsoftware and register themwith Shared Services. You canconfigure multiple products atone time, provided that theyare installed on the samecomputer.

Hyperion Configuration Utility Product Installation Guides

5 Set up projects, createapplications, and provision(assign) users to projects

Oracle's Hyperion® SharedServices User ManagementConsole

Shared Services UserManagement Guide

Data Integration Management ComponentsData Integration Management is integrated with Informatica PowerCenter and with adaptersfor Financial Management and Planning. It provides a way of uniting disparate data sourcesacross an enterprise. For example, it can integrate data stored in multiple warehouses and datamarts, RDBMS, and online analytical processing (OLAP) stores.

Components of Data Integration Management:

● PowerCenter applications:

❍ PowerCenter Client

❍ PowerCenter Server

❍ PowerCenter Repository Server

6 Installation Overview

● Web Hub

Web Hub is a PowerCenter Service gateway for external clients that processes client requeststo access PowerCenter Web services. Capabilities provided by Web Hub:

❍ Access PowerCenter functionality through the Web services gateway

❍ Use workflows that read or write to or from Web services

The hub hosts these Web services:

❍ Batch Web Services, which run and monitor workflows and administer the PowerCenterServer

❍ Metadata Web Services for logging on to the repository and browsing metadata

❍ Real-time Web Services for creating service workflows that enable you to read and writemessages to a Web service client through the hub

Setup OptionsData Integration Management provides two setup options:

● Typical—Installs the PowerCenter Client, PowerCenter Server, and PowerCenterRepository Server components but does not install the Web Hub component.

● Custom—Installs the components that you select.

See “Running the Installer” on page 13.

Operating EnvironmentsYou can install Data Integration Management on Windows (XP Pro(client), 2000 / 2003 Server)and UNIX (Red Hat Linux AS 4.0, AIX (Power PC 64–bit) 5.2 ML7 and 5.3 ML3, Solaris (SPARC)9 and 10, and HP-UX 11i RISC:v1 (11.11)) platforms. The PowerCenter Client component canbe installed only on Windows platforms, including Windows XP.

Setup Options 7

8 Installation Overview

2Planning the Installation

In This Chapter

System Requirements ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Port Numbers Used by Hyperion Products.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Default Port Numbers for Remote Method Invocation (RMI) Servers .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11

System RequirementsThe following table shows the minimum system requirements for running InformaticaPowerCenter 7.1.4:

PowerCenter Client Repository Server PowerCenterRepositoryDatabase

PowerCenter Server

Operating system Windows (2000 SP4, 2003 SP 1, XP)

● Windows (2000SP 4, 2003 SP1)

● UNIX (AIX, HP-UX, Linux,Solaris)

● Windows (2000SP 4, 2003 SP 1)

● UNIX (AIX, HP-UX,Linux, Solaris)

● Windows (2000SP 4, 2003 SP 1)

● UNIX (AIX, HP-UX,Linux, Solaris)

Disk space 200 MB 80 MB 150 MB of databasespace

70 MB

RAM 256 MB 256 MB 128 MB 256 MB

Databaseconnectivity

ODBC drivers Native drivers Native drivers Native or ODBCdrivers

Note:

Informatica recommends a screen resolution of at least 1024 x 768 for computers runningPowerCenter Client.

Port Numbers Used by Hyperion ProductsDuring the Hyperion Enterprise Performance Management software installation, the defaultport number for application servers is automatically populated. You can change the default port

System Requirements 9

number during the configuration process. If you do not modify the value during the installation,the software is installed with the settings in the following table. For information on modifyingthe default ports after installation, see Chapter 4, “Configuring and Setting Up Data IntegrationManagement”.

Each application port number must be unique. If you modify a default port number, change itto a port number not currently used. After modifying the default port number, if your applicationdoes not launch, or an error message is displayed similar to “port already in use” or “bind error,”there may be a port number conflict.

Hyperion Product Listen Port SSL Listen Port Shutdown Port for ApacheTomcat

Shared Services 58080 58090 58005

Oracle's Hyperion® ApplicationBuilder J2EE

21080 21090 21005

Oracle's Essbase® AdministrationServices

10080 10090 10005

Analytic High Availability Services 11080 11090 11005

Planning 8300 8300 8301

Data Integration Management 4001, 5001 (default), 7333(Web Hub)

Oracle's Hyperion® TranslationManager

14080 14090 14005

Oracle's Hyperion® FinancialReporting – System 9

8200 8201

Oracle's Hyperion® Web Analysis– System 9

16000 16001

Oracle's Hyperion® BusinessModeling

17080 17090 17005

Oracle's Hyperion® PerformanceScorecard – System 9

18080 18090 18005

Oracle's Hyperion® PerformanceScorecard – System 9 Alerting

18081 18091 18006

Hyperion® System™ 9 BI+™Enterprise Metrics™

8180 828091, 8205 8105

Oracle's Hyperion® Essbase® –System 9 Smart View Provider

13080 13090 13005

Oracle's Hyperion® Workspace 19000 45001

10 Planning the Installation

Default Port Numbers for Remote Method Invocation (RMI)Servers

RMI Port

Oracle's Hyperion® Remote Authentication Module™ 58000

Oracle's Hyperion® Financial Reporting – System 9 1099

Planning 11333

Oracle's Hyperion® Strategic Finance 1493 and 1495

Oracle's Hyperion® Performance Suite™ Legacy 1494 - 1498

Hyperion Performance Suite GSM 1800

Oracle's Hyperion® Performance Suite™ Services 1801-1803

OpenLDAP 58081

Default Port Numbers for Remote Method Invocation (RMI) Servers 11

12 Planning the Installation

3Installing and Uninstalling Data

Integration Management

In This Chapter

Running the Installer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13

Installing Data Integration Management in Silent Mode ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22

Installing Data Integration Management in Console Mode ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23

Uninstalling Data Integration Management.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23

Stopping Repository Server (UNIX) .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25

Stopping Server (UNIX) .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25

About Hyperion Home ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26

Running the Installer

Caution!

If you install Data Integration Management using Terminal Services, open the Windows ControlPanel and select Add or Remove Programs and then Add New Programs to install DataIntegration Management. If you use the Data Integration Management installer instead, theinstallation might fail, and an error message might be displayed.

➤ To install Data Integration Management:

1 Take one action to start the Data Integration Management installer from the directory where you downloadedthe installation files or from the installation DVD (DVDs are provided on request only):

Windows

Double-click setupWin32Platform.exe

UNIX

Run a program:

● AIX—setupAixPlatform.bin

● Solaris—setupSolarisPlatform.bin

● Linux—setupLinuxPlatform.bin

● HP-UX—setupHpPlatform.bin

2 On the Welcome page, ensure that all requirements are met, and click Next.

Running the Installer 13

Note:

Data Integration Management does not use Oracle's Hyperion® License Server™. It usesInformatica licensing keys, which are included in the Data Integration Management softwarepackage.

3 Select a country, and click Next.

14 Installing and Uninstalling Data Integration Management

4 Select I AGREE, and click Next.

Note:

You must select I AGREE to continue with the installation.


Note:

If any Data Integration Management component is already installed, the screen to select adirectory to install Data Integration Management is not displayed. For example, if you installonly PowerCenter Server and then run the installer again to add the PowerCenter Clientcomponent, you do not see this screen when you run the installer for the second time. If all DataIntegration Management components are already installed, an error message is displayed, andthe installation must be cancelled.

5 Specify the installation directory (if the screen to select a directory to install Data Integration Managementis displayed), and click Next.


6 Specify the Hyperion Home directory, and click Next.

See “About Hyperion Home” on page 26.

7 Select a setup option, and click Next.


If you select Custom, a page with the different components that you can choose to install isdisplayed:

If the installer finds that a component is already installed on the computer, that componentlisting is followed by the word “installed” in parentheses.

See “Data Integration Management Components” on page 6.

If you select Typical, the page to provide license keys is displayed:


8 If you selected the Custom setup option in step 7, select components to install, and click Next.

The page to provide license keys is displayed.

9 If you selected the Typical option in step 7, or if you selected PowerCenter Server or PowerCenterRepository Server in step 8, enter a product key, and click Next.

Note:

The product key is included with your Data Integration Management software package.


Note:

Any components installed earlier are not listed. If all components were installed earlier and notremoved before this installation attempt, a message tells you that the installation cannotcontinue.

10 Verify the installation summary, and click Next.

Tip:

You can click Back to change installation choices.

While the installer is running, a progress page is displayed.


If you installed the Repository Server component, you are prompted to restart your computernow or later.

Note:

You must use Hyperion Configuration Utility to configure Data Integration Management beforestarting it. See Chapter 4, “Configuring and Setting Up Data Integration Management.” If youinstalled the Repository Server component on a Windows platform, you must restart yourcomputer before configuring Data Integration Management.


Installing Data Integration Management in Silent ModeWhen you install Data Integration Management in silent mode, the installer retrieves theinstallation properties that are saved in a response file instead of displaying screens where youenter these properties. Silent mode is often used for performing installations remotely. You cancreate the response file from a template before you perform an installation, or you can createthe file during an installation for use in subsequent silent-mode installations. See “Creating aResponse File Using a Template” on page 22 and “Creating a Response File During anInstallation” on page 22.

➤ To install Data Integration Management in silent mode, run this command:

InstallerFile -silent -options ResponseFile

where InstallerFile is a platform-specific installation program (such assetupWin32Platform.exe for an installation on a Windows platform orsetupSolarisPlatform.bin for a Solaris platform) and ResponseFile is the property filecontaining the parameters required for the installation.

Creating a Response File Using a Template

➤ To create a response file from a template:

1 Run this command:

InstallerFile -options-template ResponseFile

where InstallerFile is a platform-specific installation program (such assetupWin32Platform.exe for an installation on a Windows platform orsetupSolarisPlatform.bin for a Solaris platform) and ResponseFile is the name that yougive to the response file (for example, response.txt).

The installer produces the specified response file.

2 Edit the response file to specify properties for silent installations. For example, edit response.txt tospecify that only the PowerCenter Client component is installed.

Creating a Response File During an InstallationIf you run the installer using the -record option, the installer displays screens where you enterinformation. The installer records your entries in a response file that you can then use insubsequent silent-mode installations.

➤ To create a response file during a silent-mode installation, run this command:

InstallerFile -options-record ResponseFile

where InstallerFile is a platform-specific installation program (such assetupWin32Platform.exe for an installation on a Windows platform or


setupSolarisPlatform.bin for a Solaris platform) and ResponseFile is the name that yougive to the response file (for example, response.txt).

The installer produces the specified response file.

Installing Data Integration Management in Console ModeYou can run the Data Integration Management installer in console mode. When you run theinstaller in console mode, you select input from a series of menus that are displayed. Thefollowing figure shows a language menu that is displayed in console mode:

➤ To install Data Integration Management in console mode, run this command:

InstallerFile -console

where InstallerFile is a platform-specific installation program (such assetupSolarisPlatform.bin for a Solaris platform).

Uninstalling Data Integration ManagementYou can uninstall some or all Data Integration Management components.

Before you uninstall Data Integration Management from a UNIX platform, Repository Serverand Server must be stopped. See “Stopping Repository Server (UNIX)” on page 25 and“Stopping Server (UNIX)” on page 25.

➤ To uninstall Data Integration Management:

1 Navigate to the Uninstall subdirectory of the directory where you installed Data Integration Management,and start uninstall.exe (Windows) or uninstall.bin (UNIX).

Installing Data Integration Management in Console Mode 23

Tip:

You can also start the Data Integration Management uninstaller from the Windows ControlPanel by selecting Add/Remove Programs, and then Change or Remove Programs, and thenHyperion System 9 Data Integration Management 9.2.

2 On the uninstaller Welcome screen, click Next.

3 Select to uninstall all components or specific components, and click Next.

4 If you are uninstalling specific components, select the components, and click Next.

5 Verify the information in the uninstallation summary, and click Next to complete the uninstallation.

Uninstalling Data Integration Management in Silent ModeWhen you uninstall Data Integration Management in silent mode, the installer retrieves theuninstallation options that are saved in a response file instead of displaying screens where youenter these properties. Silent mode is often used for performing uninstallations remotely. Youcan create the response file from a template before you perform an uninstallation, or you cancreate the file during an uninstallation for use in subsequent silent-mode uninstallations. See“Creating a Response File Using a Template” on page 22 and “Creating a Response File Duringan Installation” on page 22.


➤ To uninstall Data Integration Management in silent mode, run this command:

UninstallerFile -silent -options ResponseFile


where uninstallerFile is uninstall.exe (Windows) or uninstall.bin (UNIX), andResponseFile is the property file containing the parameters required for the uninstallation.

The uninstaller file is in the Uninstall subdirectory of the Data Integration Managementinstallation directory.

Uninstalling Data Integration Management in Console ModeYou can run the Data Integration Management uninstaller in console mode. When you run theuninstaller in console mode, you select input from a series of menus that are displayed.


➤ To uninstall Data Integration Management in console mode, run this command:

UninstallerFile -console

where UninstallerFile is uninstall.exe (Windows) or Uninstall.bin (UNIX).

The uninstaller file is in the Uninstall subdirectory of the Data Integration Managementinstallation directory.

Stopping Repository Server (UNIX)Repository Server must be stopped before you uninstall Data Integration Management from aUNIX platform.

➤ To stop Repository Server on a UNIX platform, run this command:

$DIM_HOME/Resources/bin/stop_pmrepserver.sh RepServerAdminPwd

RepServerHost RepServerPort

where RepServerAdminPwd is the Repository Server administrator's password, RepServerHost isthe name of the Repository Server host computer, and RepServerPort is the port that RepositoryServer uses.

Stopping Server (UNIX)Server must be stopped before you uninstall Data Integration Management from a UNIXplatform.

➤ To stop Server on a UNIX platform, run this command:

$DIM_HOME/Resources/bin/stop_pmserver.sh RepositoryAdminUser

RepositoryAdminPwd ServerHost ServerPort

Stopping Repository Server (UNIX) 25

where RepositoryAdminUser is the Hyperion repository administrator's user name,RepositoryAdminPwd is the Hyperion repository administrator's password, ServerHost is thename of the Server host computer, and ServerPort is the port that Server uses.

About Hyperion HomeWhen multiple Hyperion products are installed on one computer, common internal and third-party components are installed to a central location, called Hyperion Home. On a Windowsplatform, the Hyperion Home location is defined in the system environment variable calledHYPERION_HOME. On a UNIX platform, the Hyperion Home value is storedin .hyperion.<hostname> in the home directory.

Note:

On a UNIX platform, to ensure that all installers have the permissions required to modify theHYPERION_HOME location, Hyperion recommends that all Hyperion applications be installedunder one HYPERION user account.

Hyperion Home LocationThe default location for Hyperion Home is C:\Hyperion on a Windows platform or $HOME/Hyperion on a UNIX platform. The Data Integration Management installer searches for theHYPERION_HOME environment variable on the computer to which you are installing.

If the Hyperion Home location was previously defined for another Hyperion product, theinstallation uses the previously defined location. The location cannot be changed through theinstaller.

If the current installation is the first Hyperion installation on the computer, you can specify thelocation during installation.

Note:

On a UNIX platform, if the HYPERION_HOME directory is mounted on an NFS so that oneHYPERION_HOME location is visible across multiple computers, Shared Services can beinstalled to only one computer. If you try to install Shared Services to an additional computer,the previous installation is detected.

Files Installed in the HYPERION_HOME DirectoryVarious files are installed in the HYPERION_HOME\common directory by a default installation ofShared Services. Some common components, and thus some files and directories, are optionaland may not be installed.


Table 2 Common-Component Directories Created in the HYPERION_HOME\common Directory

Directory Contents

appServers Application server files

config Hyperion Configuration Utility files

CSS Files to support Hyperion external authentication

DBMS Relational database management system (DBMS) files

Docs Product documentation files

HyperionLookAndFeel Installer user interface files

JCE JCE files for encryption, key generation and agreement, and MAC

JDBC JDBC files

lib Shared Services library files

loggers Files for external authentication logging

SAP SAP files

utilities Utilities to change the location of Hyperion Home and export, import, or validateprovisioning data

XML Common XML components

Changing the Hyperion Home LocationAfter Hyperion Home is defined through the product installation, you can run a migration utilityto change the Hyperion Home location.

On a Windows platform, the migration utility moves the files installed in Hyperion Home tothe new location and updates the value of the HYPERION_HOME environment variable.

On a UNIX platform, the migration utility updates the .hyperion.<HOSTNAME> file, whichresides in the directory that contains the environment variable. Login initialization files, suchas .profile and .login are not updated.

Hyperion Home Migration Utility is provided with the Shared Services installation.

Note:

For an Apache Tomcat 5.0.28 Windows installation, you can install the Shared Services serveras a Windows service. If you select this option, the Shared Services server is launchedautomatically by the service and runs in the background. However, if you change theHYPERION_HOME location, the Windows service does not automatically start. This problemoccurs because the registry entries for the Windows service retain the old path information. Tosolve this problem, you must manually update the location of the Windows service.

About Hyperion Home 27

➤ To change the Hyperion Home location:

1 Choose a method to launch the migration utility on your platform:

Windows

● Double-click the run.exe file from %HYPERION_HOME%\common\utilities\HyperionHomeTool\9.2.1\bin.

● From a Windows console, change to %HYPERION_HOME%\common\utilities\HyperionHomeTool\9.2.1\bin. Then type run.exe -console.

UNIX

● In XWindows, change to $HYPERION_HOME/common/utilities/HyperionHomeTool/9.2.1/bin. Then type migrationtool.sh.

● In a UNIX console, change to $HYPERION_HOME/common/utilities/HyperionHomeTool/9.2.1/bin. Then type migrationtool.sh -console.

2 Step through the screens, and when prompted, enter the Hyperion Home location or click Browse to navigateto the preferred location.

Do not choose a HYPERION_HOME location that contains a space character. For example, C:\Program Files is not acceptable.


4Configuring and Setting Up

Data Integration Management

In This Chapter

Hyperion Configuration Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29

Launching Hyperion Configuration Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30

Configuring Data Integration Management .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34

Synchronizing Users .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .43

Batch Synchronizing ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .44

Starting and Stopping Shared Services... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .45

Note:

Before configuring Data Integration Management, review the Informatica PowerCenterInstallation and Configuration Guide for important setup details. See “Accessing InformaticaDocumentation” on page 42.

Hyperion Configuration UtilityHyperion Configuration Utility is a common tool used to configure installed Hyperion products.This utility is installed with the first product installed on a computer, and you can use it toconfigure all products that are installed on that computer. You must run HyperionConfiguration Utility on each computer where a product is installed.

Hyperion Configuration Utility provides the appropriate set of configuration tasks for theproducts installed on the computer:

● Product Activation—Required for all products, except for product components that areoptionally included with Base Solutions products (for example, Hyperion AnalyticIntegration Services™, which is optionally included with Oracle's Hyperion® Essbase® –System 9 ).

Note:

Data Integration Management configuration does not include product activation.

● Shared Services registration—Required if you are using Shared Services authenticationrather than native Informatica authentication. See “Registering Products with SharedServices” on page 31.

Hyperion Configuration Utility 29

● Relational storage configuration—Required for products that use a database to store andretrieve data.

Note:

Data Integration Management configuration does not include relational storageconfiguration.

● Application server deployment—Required for products that deploy on an applicationserver. See “Deploying Products to Application Servers” on page 10.

Data Integration Management configuration does not include application serverdeployment.

● Shared Services deregistration—Required before Data Integration Management isuninstalled if Data Integration Management is registered with Shared Services. See “Product-Specific Configuration” on page 33.

Product-specific configuration tasks may also be provided.

You can use the Configuration Utility to perform configuration tasks sequentially for multipleproducts in one session. The sequence of Configuration Utility pages depends on your productand task selections. As a troubleshooting measure, perform configuration tasks individually forone product at a time.

You can reconfigure products after the initial configuration, following the same procedures.

Launching Hyperion Configuration UtilityYou must run Hyperion Configuration Utility on each computer to which a product is installed.

➤ To launch Hyperion Configuration Utility:

1 Choose one of the methods for your operating system:

● Windows:

❍ From the Start menu, select Programs > Hyperion System 9 Foundation >Configuration Utility.

❍ Double-click the configtool.bat file from HYPERION_HOME\common\config.

❍ Select Start > Run, switch to HYPERION_HOME\common\config, and typestartconfigtool.bat -console and press Enter.

● UNIX:

❍ In XWindows, change to the directory $HYPERION_HOME/common/config, and thenrun configtool.sh.

❍ In a UNIX console, change to the directory $HYPERION_HOME/common/config, andthen run configtool.sh -console.

30 Configuring and Setting Up Data Integration Management

Note:

If you are running Hyperion Configuration Utility in console mode, follow the command-lineprompts.

2 On the Welcome page, click Next.

3 From the list of installed products, select those to configure and click Next.

A list of configuration tasks is displayed.

Note:

Data Integration Management configuration tasks are available only on the computer where theRepository Server component is installed.

4 Follow the instructions for configuration tasks:

● “Registering Products with Shared Services” on page 31

● “Deregistering Products from Shared Services” on page 32

● “Product-Specific Configuration” on page 33

Registering Products with Shared ServicesShared Services functionality is programmed into Hyperion products to enable userprovisioning, single sign-on, and metadata management. Products that implement SharedServices functionality require access to the Shared Services server. When a product is registeredwith Shared Services, a registration file is created under its corresponding product directory inShared Services.

➤ To register products with Shared Services:

1 Ensure that Shared Services is running.

2 Launch Hyperion Configuration Utility.

See “Launching Hyperion Configuration Utility” on page 30.

3 From the list of installed products, select products to configure.

4 If you have not activated the products, activate them.

Note:

Data Integration Management is activated with the Informatica keys that you enter during DataIntegration Management installation. There is no additional activation step for Data IntegrationManagement.

5 From the list of configuration tasks, select Shared Services Registration, and click Next.

Launching Hyperion Configuration Utility 31

6 Specify Shared Services server information:

Table 3 Shared Services Server Fields

Field Instruction

Server Enter the computer name (host name) where the Shared Services server is installed. Do not specify anIP address, especially in DHCP environments. Only English alphanumeric characters and the followingspecial characters can be entered: dash ( - ), underscore ( _ ), dot (.).

Port Enter the Shared Services server port number, or accept the default (58080).

User Enter the user name of the Shared Services administrator.

Password Enter the password of the Shared Services administrator.

SSL Select if SSL is enabled on the Shared Services server and is configured to use https. See the HyperionSystem 9 Shared Services Installation Guide.

Deregistering Products from Shared ServicesIf you need to uninstall a Hyperion product after installation and configuration, and if theproduct is registered with Shared Services, deregister the product before uninstalling it.

➤ To deregister products withShared Services:

1 Make sure that the Shared Services server is running.

2 Launch Hyperion Configuration Utility.



3 From the list of installed products, select products to deregister, and click Next.

4 On the task selection page, select Shared Services Deregistration, and click Next.

On the Shared Services location page, the Server, Port, and User fields display the informationthat was specified when the product was registered with Shared Services.

5 For Password, enter the password for the specified Shared Services user.

6 Click Next to go to the next configuration task or to finish.

Product-Specific ConfigurationAny configuration tasks that are product-specific are displayed on the configuration taskselection page. For example, DCOM is a configuration task specific to and required for FinancialManagement.

For configuration and setup procedures specific to Data Integration Management, see thesetopics:

● “Configuring Data Integration Management” on page 34

● “Synchronizing Users” on page 43

Note:

Configuration tasks specific to Data Integration Management are available only if you select theRepository Server component when you install Data Integration Management.

ReconfigurationHyperion Configuration Utility enables you to reconfigure Hyperion products multiple times.Reconfiguration procedures are identical to the initial configuration procedures. LaunchHyperion Configuration Utility, select the products to configure, and perform the configurationprocedures, selecting the options that you want to change and following the prompts to enterthe required information.

Configuration TroubleshootingBecause Hyperion Configuration Utility separates configuration from product installation, thetask of tracking and correcting configuration errors is simplified. Hyperion Configuration Utilitylogs configuration errors and warning messages to a log file, configtool.log, in a centrallocation:

● Windows: %HYPERION_HOME%\common\logs\config

● UNIX: $HYPERION_HOME/common/logs/config

The dim.log file, in the logs subdirectory of the Data Integration Management installationdirectory, can also be helpful in troubleshooting.

Launching Hyperion Configuration Utility 33

Note:

If you experience problems with configuration, as a troubleshooting measure, performconfiguration tasks individually for one product at a time.

Configuring Data Integration ManagementYou can configure Data Integration Management for Shared Services authentication or forInformatica native authentication. For Shared Services authentication, Shared Services must berunning when you configure Data Integration Management. See the Informatica PowerCenterdocumentation for information about Informatica native authentication.

Note:

The following procedure includes steps for setting up a repository and configuring a repositorydatabase. If you are using Oracle, ORACLE_HOME must be set before you can configure therepository. See the Informatica PowerCenter Installation and Configuration Guide for details.

➤ To configure Data Integration Management:

1 Launch Hyperion Configuration Utility, and select Hyperion System 9 Data Integration Management fromthe list of installed products.


2 Select Data Integration Management Configuration, and click Next:


Note:

You can also select Register with Shared Services if you are configuring Data IntegrationManagement for Shared Services authentication. See “Registering Products with SharedServices” on page 31. The remainder of this procedure assumes that you selected only DataIntegration Management Configuration.

3 Enter your Informatica product and connectivity keys; enter an options key, if you have one; and click Next.

Note:

The connectivity key controls PowerCenter connectivity to data sources. The options keycontrols activation of PowerCenter add-on components. The keys are included in the DataIntegration Management software package. They are platform-specific.

Configuring Data Integration Management 35

Note:

If the Repository Server component has already been configured on the default port and isrunning, this dialog box includes an Old Password box where you enter the password for thatconfiguration. The default port is 5001. If you specify another port number, ensure that the portthat you specify is not in use.

4 Set up Repository Server and configure the repository database:

Note:

To set up a repository, you must have access to the database.

a. Enter the requested information, and click Next:

● Host—Name of the computer that is hosting the Repository Server component

● Port—Port number for the Repository Server host computer

● Password—Any password that you want to assign to the Repository Serveradministrator

This password is for accessing the Repository Server Admin Console, which does notrequire an ID.

● Confirm Password—The same password that you entered in the Password box


Note:

Use Hyperion Shared Services Authentication is displayed only if Data IntegrationManagement is registered with Shared Services or if you selected the Register with SharedServices task in step 2.

b. With Configure Repository selected (by default), enter the requested information:

● Repository name—Name of the repository to be created during installation

You can change the default name (Hyperion).

● Code page—ID of a code page

A code page contains the encoding to specify characters in one or more languages.Code pages are used to identify data in different languages. See the InformaticaPowerCenter Installation and Configuration Guide, Appendix B: Code Pages.

● Database type—The RDBMS that you are using for the database; selected from a list

● Database user ID—Your user name for the database

● Database user Password—Your password for the database

● Connect string—The address for connecting to the database, which depends on yourRDBMS:

❍ DB2—database name@servername[:port]


Note:

If you are using DB2, you must verify the environment variable settings establishedby DB2. See the Informatica PowerCenter Installation and Configuration Guidefor details. The default port for DB2 is 50000. You can specify a different port.

❍ MS SQL—server name[:port]@database name

Note:

The default port for MS SQL is 1433. You can specify a different port.

❍ Oracle—TNS server name

Note:

If you are using Oracle, ORACLE_HOME must be set before you configure therepository. See the Informatica PowerCenter Installation and ConfigurationGuide for details.

5 If you selected Use Hyperion Shared Services Authentication on the screen where you entered repositoryconfiguration information, enter the requested information, and click Next:

Note:

The Use Hyperion Shared Services Authentication option is available only if Data IntegrationManagement is registered with Shared Services. If you use Shared Services authentication, JavaRuntime Environment (JRE) must be in your system path. For Shared Services authenticationon an HP-UX platform, the path cannot include JVM 1.4.


● Repository Admin Name—User name of the repository administrator, which isAdministrator by default

● Repository Password—Repository administrator's password

The initial repository password is Administrator. To use a different repository password,you must change it using Informatica PowerCenter before you configure Data IntegrationManagement. See the Informatica PowerCenter Installation and Configuration Guide. Alsosee “Accessing Informatica Documentation” on page 42.

Note:

The repository administrator name and password are required for accessing the repository.They are not related the Repository Server administrator password discussed in step 4 ofthis procedure.

● Shared Services User Name—Your Shared Services user name

● Shared Services Password—Your Shared Services password

Data Integration Management attempts to register the authentication plug-in within thespecified repository. Groups that correspond to Shared Services roles are created.

Configuring Sample with PowerCenter Repository Server andPowerCenter Server on Different ComputersWhen the PowerCenter Repository Server and PowerCenter Server are installed on differentcomputers, you must perform these configuration tasks:


● Use Hyperion Configuration Utility to configure the Repository Server component on thecomputer where it is installed. See “Configuring Data Integration Management” on page34.

● Use the Informatica Server Setup utility to configure the repository connectivity informationand other parameters on the computer where PowerCenter Server is installed, using one ofthe following procedures.

● Register the PowerCenter Server installation with the repository that is created andconfigured on the computer where PowerCenter Repository Server is installed. For moreinformation on registering a server, see “Registering the PowerCenter Server” in theInformatica PowerCenter Installation and Configuration Guide.

➤ To run Informatica Server Setup utility on the computer where PowerCenter Server is installed:

1 Take one of these actions:

● Windows–Select Start > Programs > Hyperion System 9 > Data Integration Management> Informatica PowerCenter 7.1.4–Server > Informatica Server Setup.

● UNIX–Run the pmconfig utility, which is in the $DIM_HOME/Server/bin directory.

Note:

$DIM_HOME/Server/bin must be added to your library path so that the pmconfig utilitycan find the required libraries to start.

2 Accept the default selection (Configure Informatica Service), and click Continue.


3 Click the Licenses tab.


4 Enter the product key (included with your Data Integration Management software package) in the withKey box, and click Update.

5 Click Apply, and click OK.

Tip:

You can also configure the PowerCenter Server on a UNIX platform by editing thepmserver.cfg file.

For information about configuring the connection, see the Informatica PowerCenter Installationand Configuration Guide. Also see the next topic, “Accessing Informatica Documentation” onpage 42.

Accessing Informatica DocumentationDocumentation for each component of Informatica PowerCenter is installed in the Manualssubdirectory of component installation directory. Example: Repository Server component


documentation is in the Manuals subdirectory of the Repository Server component installationdirectory.

➤ To access Repository Server documentation in a Windows installation, select Start > Programs> Hyperion System 9 > Data Integration Management > Informatica PowerCenter 7.1.4 —Component > Documentation, where Component is Client, RepServer (for Repository Server)or Server.

Synchronizing UsersIf Data Integration Management is registered with Shared Services and configured to use SharedServices authentication, you can synchronize users. When you use Shared Services to provisionusers, you must select the User Synchronization task for Data Integration Management inHyperion Configuration Utility so that the users are pushed to Informatica.

➤ To synchronize Data Integration Management users:

1 Ensure that Shared Services is running. See “Starting and Stopping Shared Services” on page 45.

2 Start Hyperion Configuration Utility and click Next on the Welcome page.

3 Select Hyperion System 9 Data Integration Management, and select User Synchronization.

4 Enter your Shared Services password.

5 Select Is SSL if SSL is enabled on the Shared Services server and is configured to use https.

6 Optional: Select Generate Batch File .

Note:

Generating a batch file provides a convenient way of running the user-synchronization task ona regular basis, which is recommended. See “Batch Synchronizing” on page 44.

7 Click Next.

On the synchronization status screen, the Next button becomes available when thesynchronization is complete.

Synchronizing Users 43

8 Click Next.

Batch SynchronizingSelecting the Generate Batch File option when you synchronize users with HyperionConfiguration Utility can save you time when you perform this routine task in the future. Thebatch file that is generated when you select the option (dim_synch.bat in a Windowsenvironment or dim_synch.sh in UNIX) saves the settings that you entered for synchronizingusers with Hyperion Configuration Utility, such as the Repository Server host and port. You canthen run the batch file, which is in the DIM_HOME directory, to synchronize users from anylocation at any time, instead of runningHyperion Configuration Utility and entering the settingsagain.

Tip:

You can schedule regular automatic runs of the batch file using the scheduling features of youroperating system.

Because the batch files cannot store passwords, you must edit the generated batch file to add oneof these parameters:

● -rp RepositoryAdministratorPassword

● -rP EnvironmentVariable, where EnvironmentVariable is the name of the environmentvariable that contains the repository administrator password


A comment in the generated file indicates where to add the parameter.

Note:

If you edit the batch file and then run Hyperion Configuration Utility again with Generate BatchFile selected, your edits are overwritten.

Starting and Stopping Shared Services

Starting Shared Services

➤ On a Windows platform, if you deployed the Shared Services application server as a Windowsservice, to start Shared Services manually, from the Windows control panel, selectAdministrative Tools > Services.

➤ On a Windows platform, if you did not deploy the Shared Services application server as aWindows service, to start the Shared Services server:

1 Select Start > Programs > Hyperion System 9 Foundation> Start Shared Services.

2 If the menu item does not indicate the application server to which the Shared Services server is deployed,you must start Shared Services server manually.

If you did not deploy the Shared Services application server as a Windows service, you can startit manually.

➤ To start Shared Services server manually, execute the startup script:

Application Server Path to Script

IBM WebSphere Windows

<HSS_HOME>\AppServer\InstalledApps\<AppServName>\<version>\SharedServices9\bin\startSharedServices9.bat

UNIX

<HSS_HOME>/AppServer/InstalledApps/<AppServName>/<version>/SharedServices9/bin/startSharedServices9.sh

BEA WebLogic Windows

<HSS_HOME>\AppServer\InstalledApps\<AppServName>\<version>\SharedServices9\startSharedServices.bat

UNIX

<HSS_HOME>/AppServer/InstalledApps/<AppServName>/<version>/SharedServices9/startSharedServices.sh

Oracle Windows

Starting and Stopping Shared Services 45


<OracleInstallDir>\bin\emctl start iasconsole

<OracleInstallDir>\opmn\bin\opmnctl startall

UNIX

<OracleInstallDir>/bin/emctl start iasconsole

<OracleInstallDir>/opmn/bin/opmnctl startall

Apache Tomcat Windows

<HSS_HOME>\AppServer\InstalledApps\<AppServName>\<version>\SharedServices9\bin\startSharedServices9.bat

UNIX

<HSS_HOME>/AppServer/InstalledApps/<AppServName>/<version>/SharedServices9/bin/startSharedServices9.sh

Note:

<HSS_HOME> is the directory where Shared Services is installed; for example, c:\hyperion\SharedServices\9.2 (Windows) or /home/username/Hyperion/SharedServices/9.2 (UNIX).

Verifying Successful Startup of Shared Services

➤ To verify successful startup and configuration of Shared Services:

1 During startup, look for the following confirmation messages in the Shared Services console window:

● Database Configuration Test Passed

● Security System Initialized Successfully

Note:

This message is not displayed for Tomcat.

● Shared Services Initialized Successfully

When Shared Services is deployed to the Tomcat application server on a UNIX platform,confirmation messages are logged to <HSS_HOME>/AppServer/InstalledApps/<AppServName>/<version>/SharedServices9/logs/Catalina.out.

When Shared Services is deployed to WebSphere, the confirmation message is logged to<WebSphereInstallDir>\AppServer\logs\SharedServices9\SystemOut.log

(Windows) or <WebSphereInstallDir>/AppServer/logs/SharedServices9/SystemOut.log (UNIX).

When Shared Services is deployed to WebLogic, if the log level is not set to WARN, theconfirmation message is logged to<HSS_HOME>\AppServer\InstalledApps\WebLogic\8.1\SharedServices9\ logs\SharedServices_Metadata.log (Windows) or


<HSS_HOME>/AppServer/InstalledApps/WebLogic/8.1/SharedServices9/

logs/SharedServices_Metadata.log (UNIX)

2 On the Shared Services server computer, perform an action to launch the User Management Console loginpage by opening a browser and entering this URL:

http://SharedServicesServerName:port#/interop

where SharedServicesServerName is the name of the computer where the Shared Servicesserver is installed and port# is the port number of the Shared Services server. The default portnumber is 58080; if Shared Services server is installed to a non-default port, specify that value.For example, using the default port:

http://jdoe:58080/interop/

Note:

As a best practice, the URL should use an IP address or a fully qualified machine name thatincludes the domain name. If the IP address is dynamic, use the fully qualified machine name.

Note:

On a Windows platform, select Start > Programs > Hyperion System 9 Foundation > UserManagement Console.

Display of the Oracle's Hyperion® Shared Services User Management Console login pageindicates that the Shared Services server started successfully.

Stopping Shared ServicesOn a Windows platform, if you installed the Shared Services application server as a Windowsservice, to stop Shared Services server, use the Windows control panel.

➤ To stop Shared Services server manually:

1 Choose a method:

● For Windows systems, select Start > Programs > Hyperion System 9 Foundation > StopShared Services.

● For all systems, execute the stop script:


IBM WebSphere Windows

<HSS_HOME>\AppServer\InstalledApps\AppServName\<version>\SharedServices9\bin\stopSharedServices9.bat

UNIX

Starting and Stopping Shared Services 47


<HSS_HOME>/AppServer/InstalledApps/AppServName/<version>/SharedServices9/bin/stopSharedServices9.sh

BEA WebLogic Windows

<HSS_HOME>\AppServer\InstalledApps\<AppServName>\<version>\SharedServices9\stopSharedServices.bat

UNIX

<HSS_HOME>/AppServer/InstalledApps/<AppServName>/<version>/SharedServices9/stopSharedServices.sh

Oracle Windows

<OracleInstallDir>\bin\emctl stop iasconsole

<OracleInstallDir>\opmn\bin\opmnctl stopall

UNIX

<OracleInstallDir>/bin/emctl stop iasconsole

<OracleInstallDir>/opmn/bin/opmnctl stopall

Apache Tomcat Windows

<HSS_HOME>\AppServer\InstalledApps\<AppServName>\<version>\SharedServices9\bin\stopSharedServices9.bat

UNIX

<HSS_HOME>/AppServer/InstalledApps/<AppServName>/<version>/SharedServices9/bin/stopSharedServices9.sh

Note: <HSS_HOME> is the directory where Shared Services is installed; for example, c:\hyperion\SharedServices\9.2(Windows) or /home/username/Hyperion/SharedServices/9.2 (UNIX).

2 On WebLogic, if a message that suggests using the FORCE SHUTDOWN command is displayed, use the FORCESHUTDOWN command to stop Shared Services server:

a. In a text editor, open the stop script.

See the table under Step 1 for the stop script location.

b. In the file, find SHUTDOWN, and replace it with FORCE SHUTDOWN.

c. Save and execute the file.


5Installing, Configuring, and

Uninstalling Data IntegrationManagement Adapters

In This Chapter

Data Integration Management Adapters .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .49

Installing Data Integration Management Adapters.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .49

Configuring Adapters .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .51

Uninstalling Adapters .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .57

Data Integration Management AdaptersData Integration Management adapters enable you to retrieve and write data for FinancialManagement and Planning.

To use Oracle's Hyperion® Data Integration Management Adapter for Financial Management,you must first install and configure Financial Management. You can install Oracle's Hyperion®Data Integration Management Adapter for Planning without installing Planning. To use thePlanning adapter, you must be able to connect to a Oracle's Hyperion® Planning – System 9server from the computer where the adapter is installed.

A Hyperion product and the Data Integration Management adapter for that product can be ondifferent computers. For example, you can install Financial Management on one computer andDIM Adapter for Financial Management on another.

Each adapter includes online help that provides instructions for using the adapter.

Note:

The adapters that you require for this installation must be taken from the 9.2.0.3 release.

Installing Data Integration Management AdaptersYou must have administrative privileges on any computer where you install a Data IntegrationManagement adapter. A Data Integration Management adapter installer provides two options:

● Typical—Install all adapter components

● Custom—Install the components that you select:

❍ Client Plug-in—Enables you to configure source and target definitions for the Hyperionapplication in Designer.

Data Integration Management Adapters 49

Client Plug-in should be installed on the same computer as PowerCenter Client.

❍ Repository Server Plug-in—Enables you to register the adapter in a repository.

❍ Server Plug-in—Enables you to execute workflows.

Note:

When you install the client and server components of any Data Integration Management adapteron one computer, you must install both components in the same location.

➤ To install a Data Integration Management adapter:

1 Take one action from the installation CD or the directory where you downloaded the adapter installer:

● Windows—Click setupWin32Platform.exe.

● UNIX—Run a program:

❍ AIX—setupAixPlatform.bin

❍ Solaris—setupSolarisPlatform.bin

❍ Linux—setupLinuxPlatform.bin

❍ HP-UX—setupHpPlatform.bin

2 On the adapter installer Welcome screen, click Next.

3 Select a country for the installation, and click Next.

4 On the license agreement screen, select I AGREE, and click Next.

Note:

You must select I AGREE to continue with the installation.

5 Click Next to accept the Hyperion Home directory.

6 Select a setup type, and click Next.

7 If you selected the Custom setup option in the preceding step, select components to install, and clickNext.

8 Verify the installation summary, and click Next.

Tip:

You can click Back to change installation choices.

Installing Adapters in Silent ModeWhen you install a Data Integration Management adapter in silent mode, the installer retrievesthe installation properties that are saved in a response file instead of displaying screens whereyou enter these properties. Silent mode is often used for performing installations remotely. Youcan create the response file from a template before you perform an installation, or you can createthe file during an installation for use in subsequent silent-mode installations. See “Creating a

50 Installing, Configuring, and Uninstalling Data Integration Management Adapters

Response File Using a Template” on page 22 and “Creating a Response File During anInstallation” on page 22.

➤ To install an adapter in silent mode, run this command:

InstallerFile -silent -options ResponseFile

where InstallerFile is a platform-specific installation program (such assetupwin32.exe for an installation on a Windows platform or setupSolaris.bin for aSolaris platform) and ResponseFile is the property file containing the parameters requiredfor the installation.

Installing Adapters in Console ModeWhen you run the installer for an adapter in console mode, you select input from a series ofmenus that are displayed.

➤ To install an adapter in console mode, run this command:

InstallerFile -console

where InstallerFile is a platform-specific installation program (such assetupSolaris.bin for a Solaris platform).

Configuring AdaptersAfter installing Data Integration Management adapters, you must configure them on thecomputers hosting the PowerCenter Server, Client, and Repository Server components of DataIntegration Management.

Adapter configuration tasks are described in these topics:

● “Registering Adapters with a Repository” on page 51

● “Configuring Hyperion Application Connections” on page 53

● “Configuring JVM Options” on page 55.

You can perform these tasks on Windows computers where PowerCenter Client is installed.

Note:

Adapter configuration is not done with Oracle's Hyperion® Configuration Utility™.

Registering Adapters with a RepositoryIf you install the Repository Server Plug-in or Server Plug-in component of a Data IntegrationManagement adapter, you must register the adapter with the repository. This registration is notrequired if you install only the Client Plug-in.

Configuring Adapters 51

➤ To register a Data Integration Management adapter with a repository:

1 Ensure that Data Integration Management Repository Server is running:

a. From the Windows Control Panel, select Administrative Tools.

b. Select Services.

c. In the Services window, check the status of Hyperion S9 data Integration ManagementRepository Server.

d. Unless the status is “Started,” click Start (in the upper left of the window).

Note:

Keep the Services window open for the next step.

2 Stop Data Integration Management Server, if it is running:

a. In the Services window, check the status of Hyperion S9 Data Integration ManagementServer.

b. If the status is “Started,” click Stop (in the upper left of the window).

3 Connect to the Repository Server host computer:

a. Select Start > Programs > Hyperion System 9 > Data Integration Management >Informatica PowerCenter 7.1.4 - Client > Repository Server Administration Console.

b. In Repository Server Administration Console, right-click the name of the RepositoryServer host computer, and select Connect.

c. Enter your password for the host computer, and click OK.

4 Under the Repository Server host computer name, click Available packages.

5 Right-click HFM.xml (for DIM Adapter for Financial Management) or Planning.xml (for DIM Adapterfor Planning), and select Register.


6 Enter the repository administrator user name and password, and click OK.

Note:

By default, both the user name and the password are Administrator if you are using Informaticanative authentication. If you are using Oracle's Hyperion® Shared Services authentication, thedefault user name and password are admin and password, respectively.

7 When a message that the registration succeeded is displayed, click OK.

8 Repeat step 5 through step 7 for each adapter to be registered

Note:

For more information, see “Registering and Unregistering Repository Plug-ins” in theInformatica PowerCenter Repository Guide.

Configuring Hyperion Application ConnectionsAfter you configure an adapter, you must configure an application connection in WorkflowManager before you can extract data from sources or write data into targets. When configuringapplication connections, you specify attributes that Data Integration Management Server usesto connect to a database during a Data Integration Management session. The applicationconnections that you define in Workflow Manager are saved in Data Integration ManagementRepository.

➤ To configure application connections:

1 Ensure that Data Integration Management Repository Server is running:

a. From the Control Panel, select Administrative Tools.

b. Select Servers.

c. In the Services window, check the status of Hyperion S9 data Integration ManagementRepository Server.


d. Unless the status is “Started,” click Start (in the upper left of the window).

2 Start the repository:

a. Select Start > Programs > Hyperion System 9 > Data Integration Management >Informatica PowerCenter 7.1.4 - Client > Repository Server Administration Console.

b. In Repository Server Administration Console, right-click the name of the RepositoryServer host computer and select Connect.

c. Enter your password for the host computer, and click OK.

d. In the Repositories directory, double-click the repository name.

e. Click Start (on the left).

3 Select Start > Programs > Hyperion System 9 > Data Integration Management > InformaticaPowerCenter 7.1.4 - Client > Workflow Manager.

4 In Workflow Manager, connect to the repository:

a. In the Repository Navigator panel, double-click the repository name.

b. Enter the repository administrator's user name and password, and then click Connect.


5 Select Connections > Application.

6 Click New.

7 Select the connection for the adapter that you are configuring, and click OK.

8 Enter the requested information, and click OK:

The information requested depends on the Hyperion application. It can include these items:

● Name—A name for the connection

● User Name—Your user name for the Hyperion application; for example, if you areconfiguring Hyperion Financial Management Connection, your user name for FinancialManagement.

● Password—Your password for the repository; for example, if you are configuring HyperionFinancial Management Connection, your password for Financial Management.

● URL—The Hyperion product application URL that you want to use

● Host or ServerHost—The name of the Hyperion product server host computer; for example,if you are configuring Hyperion Financial Management Connection, the name of theOracle's Hyperion® Financial Management – System 9 server host computer

● Port—The port number used by the application

● Cluster —The name of the registered cluster where the application runs

Application Connection Browser lists the new application connection.

Tip:

You can edit or delete an application connection by selecting it in the list in ApplicationConnection Browser and clicking Edit or Delete.

Configuring JVM Options

➤ To configure JVM options:

1 Start Informatica Server Setup:

● Windows—Select Start > Programs > Hyperion System 9 > Data Integration Management> Informatica PowerCenter 7.1.4 - Server > Informatica Server Setup.

● UNIX—Run pmconfig from the $DIM_HOME/Server/bin directory.

Note:

On Solaris, run ./pmconfig to avoid running the Solaris system command by the samename. The PM_HOME environment variable must point to the PowerCenter Serverinstallation directory, or the PowerCenter Server cannot start.


2 With Configure Informatica Service selected, click Continue.

3 Select the JVM Options tab.


4 In VM Location, enter the fully qualified path to the jvm.dll file in your JAVA_HOME directory, and thenclick OK.

Uninstalling AdaptersUninstallers for the adapters can be found in the uninstall folder.

➤ To uninstall a Data Integration Management adapter:

1 Start the adapter uninstaller:

● Windows—uninstall.exe

● UNIX—uninstall.bin

2 On the uninstaller Welcome screen, click Next.

3 Ensure that all PowerCenter Client applications are selected, and click Next.

4 On the uninstallation summary screen, click Next.

5 When the summary screen says that the uninstallation has succeeded, click Finish.

Uninstalling Adapters 57

6 Optional: Remove the adapter from a repository:

a. Open Data Integration Management Repository Server Administration Console byselecting Start > Programs > Hyperion System 9 > Data Integration Management >Informatica PowerCenter 7.1.4–Client > Repository Server Administration Console.

b. Select the repository in which the adapter is registered.

c. Stop the repository if it is running.

d. Click Repository > Registered packages and select HFM.xml for Oracle's Hyperion® DataIntegration Management Adapter for Financial Management or Planning.xml forOracle's Hyperion® Data Integration Management Adapter for Planning.

e. Click Unregister.

f. In Remove Repository plug-in, enter the repository user name and password, and clickOK.

The Output window displays the status of the plug-in uninstallation.

Note:

Repeat step 6 to remove the adapter from additional repositories.

Uninstalling Adapters in Silent ModeWhen you uninstall a Oracle's Hyperion® Data Integration Management adapter in silent mode,the installer retrieves the uninstallation options that are saved in a response file instead ofdisplaying screens where you enter these properties. Silent mode is often used for performinguninstallations remotely. You can create the response file from a template before you performan uninstallation, or you can create the file during an uninstallation for use in subsequent silent-mode uninstallations. See “Creating a Response File Using a Template” on page 22 and “Creatinga Response File During an Installation” on page 22.

➤ To uninstall an adapter in silent mode, run this command:

UninstallerFile -silent -options ResponseFile

The uninstaller file is in the Uninstall subdirectory of the adapter installation directory. Foruninstaller file names, see step 1 in “Uninstalling Adapters” on page 57.

Uninstalling Adapters in Console ModeWhen you run the uninstaller for an adapter in console mode, you select input from a series ofmenus that are displayed.

➤ To uninstall an adapter in console mode, run this command:

UninstallerFile -console


The uninstaller file is in the Uninstall subdirectory of the adapter installation directory. Foruninstaller file names, see step 1 in “Uninstalling Adapters” on page 57.

Uninstalling Adapters 59


ATroubleshooting

Problem

The Hyperion S9 Data Integration Management Server service stops immediately after starting,and the Workflow Monitor displays this error message:

Cannot connect to the server HyperionIntegrationServer.

Solution

1. Start the service:

● Windows

Select Start > Settings > Control Panel > Administrative Tools > Services, and try startingthe services manually.

● UNIX

Run start_pmserver.sh from the DIM_HOME/Resources/bin directory.

2. If the server process starts and stops immediately:

a. Open Workflow Manager.

b. Connect to the repository.

c. Double-click HyperionIntegrationServer.

d. Select a compliant code page from the Code Page list. See the InformaticaPowerCenter Installation and Configuration Guide, Appendix B: Code Pages.

See “Accessing Informatica Documentation” on page 42.

3. Restart the service.

61

62 Troubleshooting

Index

Aadapters

installingconsole mode, 51silent mode, 51

installing (overview), 49installing (procedure), 50overview, 49registering with a repository, 51uninstalling, 57

console mode, 58silent mode, 58

application connectionsconfiguring for adapters, 53

Bbatch file

generating for user synchronization, 43synchronizing users with, 44

Ccomponents of Data Integration Management, 6console mode

for adapter installation, 51for installing Data Integration Management, 23

Ddirectories installed

HYPERION_HOME directory, 26

HHyperion Home, 26HYPERION_HOME environment variable, 26

Iinstallation modes

console, 23silent, 22

installation modes for adaptersconsole, 51silent, 50

installation stepsData Integration Management, 13

Ooperating systems, 7

Pport

Shared Services, 32procedures

adapter installation, 50configuring application connections for adapters,

53Data Integration Management installation, 13uninstalling adapters, 57uninstalling Data Integration Management, 23

Rrepository

registering adapters with, 51Repository Server

stopping (UNIX), 25response file

creating during installation of Data IntegrationManagement, 22

creating from a template, 22

SServer

A B C D H I O P R S U V W

Index 63

stopping (UNIX), 25setup options, 7Shared Services

starting, 45stopping, 47

shutdowncommands

for Shared Services server, 47shutting down Shared Services, 47silent mode

for adapter installation, 50for uninstalling Data Integration Management, 24installation of Data Integration Management, 22

starting Shared Services, 45startup

commandsfor Shared Services server, 45

verifying, 46stopping Shared Services, 47synchronizing users

with batch files, 44with Hyperion Configuration Utility, 43

Uuninstallation

console mode, 25uninstallation modes

console, 25silent, 24

uninstallation stepsadapters, 57Data Integration Management, 23

User Management Consolelaunching

URL, 47user synchronization. See synchronizing users

Vverifying startup, 46

WWeb Hub component, 7Windows services

starting, 45

A B C D H I O P R S U V W

64 Index

Documents

HYPERION® DATA INTEGRATION MANAGEMENTData Integration Management Components Data Integration Management is integrated with Informatica PowerCenter and with adapters for Financial