Informatica PowerChannel (Version 9.0) User Guide

Transcription

1 Informatica PowerChannel (Version 9.0) User Guide

2 Informatica PowerChannel User Guide Version 9.0 December 2009 Copyright (c) Informatica. All rights reserved. This software and documentation contain proprietary information of Informatica Corporation and are provided under a license agreement containing restrictions on use and disclosure and are also protected by copyright law. Reverse engineering of the software is prohibited. No part of this document may be reproduced or transmitted in any form, by any means (electronic, photocopying, recording or otherwise) without prior consent of Informatica Corporation. This Software may be protected by U.S. and/or international Patents and other Patents Pending. Use, duplication, or disclosure of the Software by the U.S. Government is subject to the restrictions set forth in the applicable software license agreement and as provided in DFARS (a) and (a) (1995), DFARS (1)(ii) (OCT 1988), FAR (a) (1995), FAR , or FAR (ALT III), as applicable. The information in this product or documentation is subject to change without notice. If you find any problems in this product or documentation, please report them to us in writing. Informatica, Informatica Platform, Informatica Data Services, PowerCenter, PowerCenterRT, PowerCenter Connect, PowerCenter Data Analyzer, PowerExchange, PowerMart, Metadata Manager, Informatica Data Quality, Informatica Data Explorer, Informatica B2B Data Transformation, Informatica B2B Data Exchange and Informatica On Demand are trademarks or registered trademarks of Informatica Corporation in the United States and in jurisdictions throughout the world. All other company and product names may be trade names or trademarks of their respective owners. Portions of this software and/or documentation are subject to copyright held by third parties, including without limitation: Copyright DataDirect Technologies. All rights reserved. Copyright Sun Microsystems. All rights reserved. Copyright RSA Security Inc. All Rights Reserved. Copyright Ordinal Technology Corp. All rights reserved.copyright Aandacht c.v. All rights reserved. Copyright Genivia, Inc. All rights reserved. Copyright 2007 Isomorphic Software. All rights reserved. Copyright Meta Integration Technology, Inc. All rights reserved. Copyright Intalio. All rights reserved. Copyright Oracle. All rights reserved. Copyright Adobe Systems Incorporated. All rights reserved. Copyright DataArt, Inc. All rights reserved. Copyright ComponentSource. All rights reserved. Copyright Microsoft Corporation. All rights reserved. Copyright Rouge Wave Software, Inc. All rights reserved. Copyright Teradata Corporation. All rights reserved. Copyright Yahoo! Inc. All rights reserved. Copyright Glyph & Cog, LLC. All rights reserved. This product includes software developed by the Apache Software Foundation ( and other software which is licensed under the Apache License, Version 2.0 (the "License"). You may obtain a copy of the License at LICENSE-2.0. Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. This product includes software which was developed by Mozilla ( software copyright The JBoss Group, LLC, all rights reserved; software copyright by Bruno Lowagie and Paulo Soares and other software which is licensed under the GNU Lesser General Public License Agreement, which may be found at The materials are provided free of charge by Informatica, "as-is", without warranty of any kind, either express or implied, including but not limited to the implied warranties of merchantability and fitness for a particular purpose. The product includes ACE(TM) and TAO(TM) software copyrighted by Douglas C. Schmidt and his research group at Washington University, University of California, Irvine, and Vanderbilt University, Copyright ( ) , all rights reserved. This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit (copyright The OpenSSL Project. All Rights Reserved) and redistribution of this software is subject to terms available at This product includes Curl software which is Copyright , Daniel Stenberg, <daniel@haxx.se>. All Rights Reserved. Permissions and limitations regarding this software are subject to terms available at Permission to use, copy, modify, and distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies. The product includes software copyright ( ) MetaStuff, Ltd. All Rights Reserved. Permissions and limitations regarding this software are subject to terms available at license.html. The product includes software copyright , The Dojo Foundation. All Rights Reserved. Permissions and limitations regarding this software are subject to terms available at svn.dojotoolkit.org/dojo/trunk/license. This product includes ICU software which is copyright International Business Machines Corporation and others. All rights reserved. Permissions and limitations regarding this software are subject to terms available at license.html. This product includes software copyright Per Bothner. All rights reserved. Your right to use such materials is set forth in the license which may be found at kawa/software-license.html. This product includes OSSP UUID software which is Copyright 2002 Ralf S. Engelschall, Copyright 2002 The OSSP Project Copyright 2002 Cable & Wireless Deutschland. Permissions and limitations regarding this software are subject to terms available at

3 This product includes software developed by Boost ( or under the Boost software license. Permissions and limitations regarding this software are subject to terms available at / This product includes software copyright University of Cambridge. Permissions and limitations regarding this software are subject to terms available at This product includes software copyright 2007 The Eclipse Foundation. All Rights Reserved. Permissions and limitations regarding this software are subject to terms available at This product includes software licensed under the terms at overlib/?license, license.html, and This product includes software licensed under the Academic Free License ( the Common Development and Distribution License ( the Common Public License ( and the BSD License ( This product includes software copyright Joe WaInes, XStream Committers. All rights reserved. Permissions and limitations regarding this software are subject to terms available at This product includes software developed by the Indiana University Extreme! Lab. For further information please visit This Software is protected by U.S. Patent Numbers 5,794,246; 6,014,670; 6,016,501; 6,029,178; 6,032,158; 6,035,307; 6,044,374; 6,092,086; 6,208,990; 6,339,775; 6,640,226; 6,789,096; 6,820,077; 6,823,373; 6,850,947; 6,895,471; 7,117,215; 7,162,643; 7,254,590; 7, 281,001; 7,421,458; and 7,584,422, international Patents and other Patents Pending.. DISCLAIMER: Informatica Corporation provides this documentation "as is" without warranty of any kind, either express or implied, including, but not limited to, the implied warranties of non-infringement, merchantability, or use for a particular purpose. Informatica Corporation does not warrant that this software or documentation is error free. The information provided in this software or documentation may include technical inaccuracies or typographical errors. The information in this software and documentation is subject to change at any time without notice. NOTICES This Informatica product (the Software ) includes certain drivers (the DataDirect Drivers ) from DataDirect Technologies, an operating company of Progress Software Corporation ( DataDirect ) which are subject to the following terms and conditions: 1. THE DATADIRECT DRIVERS ARE PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. 2. IN NO EVENT WILL DATADIRECT OR ITS THIRD PARTY SUPPLIERS BE LIABLE TO THE END-USER CUSTOMER FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL OR OTHER DAMAGES ARISING OUT OF THE USE OF THE ODBC DRIVERS, WHETHER OR NOT INFORMED OF THE POSSIBILITIES OF DAMAGES IN ADVANCE. THESE LIMITATIONS APPLY TO ALL CAUSES OF ACTION, INCLUDING, WITHOUT LIMITATION, BREACH OF CONTRACT, BREACH OF WARRANTY, NEGLIGENCE, STRICT LIABILITY, MISREPRESENTATION AND OTHER TORTS. Part Number: PCH-USG

4

5 Table of Contents Preface.... vi Informatica Resources.... vi Informatica Customer Portal.... vi Informatica Documentation.... vi Informatica Web Site.... vi Informatica How-To Library.... vi Informatica Knowledge Base.... vii Informatica Multimedia Knowledge Base.... vii Informatica Global Customer Support.... vii Chapter 1: Understanding PowerChannel Understanding PowerChannel Overview PowerChannel Concepts User and Server Authentication Data Compression and Decompression Data Encryption and Decryption File Integrity Recovery PowerChannel Architecture PowerChannel Clients PowerChannel Server PowerChannel Repository PowerChannel Properties Files Chapter 2: Installation and Configuration Installation and Configuration Overview Minimum System Requirements Before You Begin Installing PowerChannel with Encryption Algorithms Working with the Sample PowerChannel Repository Installing and Configuring PowerChannel for File Transfer... 8 Installing and Configuring PowerChannel for Database Data Transfer Upgrading PowerChannel from a Previous Version Installing PowerChannel Installing PowerChannel on Windows Installing PowerChannel on UNIX Configuring PowerChannel Components on PowerCenter Starting the PowerChannel Server Table of Contents i

6 Starting the PowerChannel Server as a Service Starting the PowerChannel Server as an Application Running PowerChannel Commands Running Web Client Commands Running PcCmd Commands Restoring the Repository Uninstalling PowerChannel Troubleshooting a PowerChannel Installation Chapter 3: Administering PowerChannel Accounts Administering PowerChannel Accounts Overview User Accounts Certificate Accounts Working with PowerChannel Accounts Creating a User Account with the Web Client Creating a Certificate Account with the Web Client Displaying Accounts with the Web Client Editing a User Account with the Web Client Editing a Certificate Account with the Web Client Removing an Account with the Web Client Chapter 4: Administering the PowerChannel Server Administering the PowerChannel Server Overview PowerChannel Connectivity PowerChannel Protocol Working with Channels Working with Data Transformers Working with PowerChannel Listeners Configuring Client Access Privileges Configuring the PowerChannel Server PowerChannel Server Properties Configuring the PowerChannel Properties File Working with PowerChannel Server Variables Controlling Source and Destination File Paths Controlling the Log File Path Controlling Export Directory Path Working with PowerChannel Server Commands Configuring the PowerChannel Properties File Importing a Certificate Account Reencrypting the PowerChannel Repository Unlocking the PowerChannel Repository Verifying the PowerChannel Repository Version Stopping the PowerChannel Server with the Web Client ii Table of Contents

7 Chapter 5: Configuring PcCmd Properties Configuring PcCmd Properties Overview Configuring PcCmd Properties SERVER_ADDRESS SERVER_PORT PCCMD_LOG USERNAME PASSWORD SESSION_NAME COMPRESSION_LEVEL ENCRYPTION_LEVEL CHECKSUM CODE_PAGE HOSTS STAGE CRYPTOGRAPHY Configuring the PcCmd Properties File Chapter 6: Flat File Data Transfer Flat File Data Transfer Overview Transferring Files Between PowerChannel Servers Requirements for File Transfer Working with Input and Output Folders During File Transfer Entering Filenames in PcCmd get and PcCmd send Commands Transferring Text Files from Windows to UNIX Receiving Files from a Remote PowerChannel Server Sending Files to Remote PowerChannel Servers Transferring Files Between FTP Clients and Servers Requirements for Transferring Files Between FTP Clients and Servers Transferring Files Transferring Source and Target Files in PowerCenter Transferring Files Between PowerCenter and an FTP Server Working with PcCmd Commands in PowerCenter Sessions for File Transfer Troubleshooting a Flat File Data Transfer Chapter 7: Working with Database Sources and Targets Working with Database Sources and Targets Overview Requirements for Transferring Database Data Transferring Data with Compression and Encryption Configuring PowerChannel for Data Transfer Configuring the Remote PowerChannel Server Properties Configuring the Local PowerChannel Server Properties Table of Contents iii

8 Configuring a Mapping and Workflow for PowerChannel Data Transfer Viewing the PowerCenter Session Log for Database Data Transfer Troubleshooting a PowerChannel Database Data Transfer Chapter 8: Managing PowerChannel Sessions Managing PowerChannel Sessions Overview Monitoring PowerChannel Sessions with the Web Client Stopping Sessions with the Web Client Chapter 9: Recovering PowerChannel Sessions Recovering PowerChannel Sessions Overview Automatic Recovery Manual Recovery Troubleshooting Chapter 10: Running PcCmd Commands Running PcCmd Commands Overview Path Names in PcCmd Commands Editing the Properties File with PcCmd Creating Accounts with PcCmd Creating a User Account with PcCmd Creating a Certificate Account with PcCmd Displaying Accounts with PcCmd Displaying User Accounts with PcCmd Displaying Certificate Accounts with PcCmd Editing Accounts with PcCmd Editing a User Account with PcCmd Editing a Certificate Account with PcCmd Removing Accounts with PcCmd Removing a User Account with PcCmd Removing a Certificate Account with PcCmd Monitoring PowerChannel Sessions with PcCmd Stopping PowerChannel Sessions with PcCmd Recovering PowerChannel Sessions with PcCmd Stopping the Server with PcCmd Chapter 11: Working with XML Command Files Working with XML Command Files Overview Creating an XML Command File Transferring Files with an XML Command File (FileTransfer) Executing Operating System Commands (ExternalExecute) Executing Commands on a Remote PowerChannel Server (RemoteExecute) Running an XML Command File iv Table of Contents

9 XML Command File Example Appendix A: PowerChannel Error Messages PowerChannel Messages General Messages Server Messages Session Messages Repository Messages Common Messages PcCmd Messages Client Common Messages Index Table of Contents v

10 Preface The Informatica PowerChannel User Guide provides information to install and configure PowerChannel, administer the PowerChannel repository, transfer data from sources to targets, and manage PowerChannel sessions. It is written for information services developers and software engineers who are responsible for extracting data from different sources to implement a data warehouse. Informatica Resources Informatica Customer Portal As an Informatica customer, you can access the Informatica Customer Portal site at The site contains product information, user group information, newsletters, access to the Informatica customer support case management system (ATLAS), the Informatica How-To Library, the Informatica Knowledge Base, the Informatica Multimedia Knowledge Base, Informatica Documentation Center, and access to the Informatica user community. Informatica Documentation The Informatica Documentation team takes every effort to create accurate, usable documentation. If you have questions, comments, or ideas about this documentation, contact the Informatica Documentation team through at infa_documentation@informatica.com. We will use your feedback to improve our documentation. Let us know if we can contact you regarding your comments. The Documentation team updates documentation as needed. To get the latest documentation for your product, navigate to the Informatica Documentation Center from Informatica Web Site You can access the Informatica corporate web site at The site contains information about Informatica, its background, upcoming events, and sales offices. You will also find product and partner information. The services area of the site includes important information about technical support, training and education, and implementation services. Informatica How-To Library As an Informatica customer, you can access the Informatica How-To Library at The How- To Library is a collection of resources to help you learn more about Informatica products and features. It includes articles and interactive demonstrations that provide solutions to common problems, compare features and behaviors, and guide you through performing specific real-world tasks. vi

11 Informatica Knowledge Base As an Informatica customer, you can access the Informatica Knowledge Base at Use the Knowledge Base to search for documented solutions to known technical issues about Informatica products. You can also find answers to frequently asked questions, technical white papers, and technical tips. If you have questions, comments, or ideas about the Knowledge Base, contact the Informatica Knowledge Base team through at Informatica Multimedia Knowledge Base As an Informatica customer, you can access the Informatica Multimedia Knowledge Base at The Multimedia Knowledge Base is a collection of instructional multimedia files that help you learn about common concepts and guide you through performing specific tasks. If you have questions, comments, or ideas about the Multimedia Knowledge Base, contact the Informatica Knowledge Base team through at KB_Feedback@informatica.com. Informatica Global Customer Support You can contact a Customer Support Center by telephone or through the WebSupport Service. WebSupport requires a user name and password. You can request a user name and password at Use the following telephone numbers to contact Informatica Global Customer Support: North America / South America Europe / Middle East / Africa Asia / Australia Toll Free Standard Rate Brazil: Mexico: United States: Toll Free Standard Rate Belgium: France: Germany: Netherlands: Spain and Portugal: United Kingdom: Toll Free Australia: Singapore: Standard Rate India: Preface vii

12 viii

13 C H A P T E R 1 Understanding PowerChannel This chapter includes the following topics: Understanding PowerChannel Overview, 1 PowerChannel Concepts, 1 PowerChannel Architecture, 3 Understanding PowerChannel Overview Informatica PowerChannel lets you transfer large amounts of data with encryption and compression across a wide area network (WAN) or across firewalls in an Internet environment. You can transfer files between PowerChannel Servers and between FTP clients and servers. PowerChannel also lets you read flat file and relational source data and write flat file and relational target data during a PowerCenter session. You can transfer relational data between PowerCenter and a database on a local area network (LAN) or WAN. You can also transfer the database data in compressed and encrypted format. Note: PowerChannel does not support database data transfer on Linux. PowerChannel Concepts PowerChannel uses the following concepts to ensure fast, secure, and reliable data transfer: User and server authentication Data compression and decompression Data encryption and decryption File integrity Recovery User and Server Authentication PowerChannel uses accounts to authenticate users and PowerChannel Servers. To ensure that only authorized users can use PowerChannel to transfer data, PowerChannel uses the following two stages of authentication: User authentication Server authentication 1

14 RELATED TOPICS: PowerChannel Protocol on page 25 User Authentication When you run a command to run a PowerChannel task, you enter a PowerChannel user account name and password as part of the command parameters. The PowerChannel Server uses the user account name and password to authenticate you as a valid PowerChannel user. When the authentication succeeds, the PowerChannel Server runs the user command. PowerChannel clients use a secure protocol to communicate with the server. It exchanges data with the server in encrypted format. Server Authentication When you transfer data from a local PowerChannel Server to a remote PowerChannel Server, the remote server must authenticate the local server as a trusted server. To send data to a remote server, the local server must have a certificate account in the remote PowerChannel repository. When you run a command to transfer data, you enter the remote PowerChannel certificate account name as part of the command parameters. The remote PowerChannel Server uses the certificate account name to authenticate the local server. When the authentication succeeds, data transfer can begin. The local server communicates with the remote server using a secure protocol. It exchanges data with the remote server in encrypted format. Data Compression and Decompression When you use PowerChannel to transfer data, you can compress the data before extracting or loading it. PowerChannel uses the zip compression algorithm to compress and decompress the data. Data Encryption and Decryption When you use PowerChannel to transfer data, you can encrypt the data before extracting or loading it. PowerChannel uses the RSA Crypto-J libraries with the RC2 and 3DES encryption algorithms for data encryption and decryption. With the RSA Crypto-J libraries, PowerChannel provides FIPS-certified encryption using the 3DES encryption algorithm. File Integrity PowerChannel ensures that when you transfer files, the file you transfer is intact and secure during file transfer. With integrity checking, you can make sure that no third party tampers with the file while it is in transit. This prevents the file from data corruption during file transfer. PowerChannel uses the CR32 checksum algorithm to perform integrity checking. Recovery PowerChannel lets you recover sessions that fail due to errors. When data transfer between PowerChannel Servers fails due to network failure, PowerChannel can recover the session. If the PowerChannel Server cannot recover the session, the PowerChannel session fails. When the PowerChannel Server cannot recover a failed file transfer PowerChannel session, use manual recovery. RELATED TOPICS: Recovering PowerChannel Sessions on page 79 2 Chapter 1: Understanding PowerChannel

15 PowerChannel Architecture Informatica PowerChannel architecture includes the following components: PowerChannel clients. PowerChannel uses a web client and the PcCmd command line program to run commands to the PowerChannel Server. PowerChannel Server. PowerChannel implementation requires a PowerChannel Server installation at the remote site. When you use PowerChannel to read or write flat file data, or when you want to compress or encrypt data using PowerChannel, you also need to install a PowerChannel Server at the local site. The PowerChannel Server listens to requests from PcCmd, the web client, the PowerCenter Client, and remote PowerChannel Servers to run PowerChannel sessions. PowerChannel repository. PowerChannel uses an encrypted repository that stores information about PowerChannel accounts and sessions. PowerChannel properties files. The PowerChannel Server and clients use a set of properties files. Use the default values set values in the properties files to run the PowerChannel Server and clients using a configuration utility. PowerChannel Clients PowerChannel uses the following client applications to run commands to the PowerChannel Server: Web client PcCmd Web Client Use the PowerChannel web client to manage PowerChannel accounts and sessions and stop the PowerChannel Server from a web browser. When you run a command from the web client, the web client translates the command into an XML request and passes the request to the PowerChannel Server. The server receives the request and runs the user command. PcCmd PcCmd is the command line program you use to run commands to the PowerChannel Server. Use PcCmd commands to run PowerChannel tasks. When you run a PcCmd command, PcCmd translates the command into an XML request and passes the request to the server. The server receives the request and runs the user command. You can run PcCmd from the machine hosting the PowerChannel Server or on a client machine. To use PcCmd, you must have a valid user account in the PowerChannel repository. PcCmd communicates with the server using a secure protocol. It exchanges data with the server in encrypted format for security. Use PcCmd to complete the following tasks: Transfer files. Use PcCmd to run commands to transfer files between PowerChannel Servers. You can also use PcCmd to create a PowerChannel connection to transfer files between the Integration Service and an FTP server or between FTP clients and servers. Administer PowerChannel accounts. Use PcCmd to administer PowerChannel accounts in the repository. Manage PowerChannel sessions. Use PcCmd to manage PowerChannel sessions in the PowerChannel repository. PowerChannel Architecture 3

16 Run an XML command file. Use PcCmd to run an XML command file. An XML command file lets you run file transfer commands from an XML file. When you use an XML command file, you have more flexibility in structuring commands. Stop the PowerChannel Server. Use PcCmd to stop the PowerChannel Server. PowerChannel Server The PowerChannel Server reads and writes flat file and database data. The server listens to user requests from PcCmd, the web client, the Integration Service, and remote PowerChannel Servers on a listener port and runs PowerChannel sessions to complete the tasks. When you read or write flat file data or use compression or encryption, install a PowerChannel Server in the same LAN as the Integration Service. You also need to install a PowerChannel Server in the same LAN as the remote source or target. Local and remote PowerChannel Servers communicate with the TCP/IP protocol. When you want to read flat file data in compressed and encrypted format, the remote PowerChannel Server reads, compresses and encrypts the data from the source. Then it sends the data to the local PowerChannel Server. The local PowerChannel Server decompresses and decrypts the flat file data and sends it to the Integration Service. Similarly, when you want to write flat file data in compressed and encrypted format, the local PowerChannel Server receives data from the Integration Service. It compresses and encrypts the data before sending it to the remote PowerChannel Server. The remote PowerChannel Server decrypts and decompresses the data. The remote PowerChannel Server then writes the data to the target. You can administer the PowerChannel Server from the PowerChannel command line. RELATED TOPICS: Administering the PowerChannel Server on page 24 PowerChannel Repository The PowerChannel Server creates an encrypted file-based repository during installation. It creates the PowerChannel repository in the repository folder under the PowerChannel root directory. The PowerChannel repository stores information that the PowerChannel Server, web client, and PcCmd use to run commands. The PowerChannel repository stores information about the following objects: PowerChannel accounts PowerChannel sessions Accounts PowerChannel uses accounts to authenticate users and PowerChannel Servers. PowerChannel uses user accounts to run PowerChannel commands and certificate accounts to authenticate remote PowerChannel Servers. To run PowerChannel commands, you must have a user account in the PowerChannel repository. User accounts require a password for authentication. When you run a command, you provide the PowerChannel user account name and password as part of the command parameters. Or, you provide the PowerChannel account name and password in the PowerChannel properties files. To communicate with remote PowerChannel Servers to transfer data, a PowerChannel Server uses a certificate account to authenticate itself as a valid server. To send data to a remote server, the local PowerChannel Server must have a certificate account in the remote PowerChannel repository. Certificate accounts use account profiles to define privileges for the PowerChannel accounts. A certificate account can have a profile of oneway or twoway. 4 Chapter 1: Understanding PowerChannel

17 User accounts also use account profiles to define the privileges for the PowerChannel accounts. A user account can have a profile of admin, user, transport, or disabled. RELATED TOPICS: Certificate Accounts on page 17 User Accounts on page 16 Sessions The PowerChannel repository also stores information about PowerChannel sessions. A PowerChannel session includes tasks that the PowerChannel Server completes when it receives a request from PcCmd, the web client, the PowerCenter Client, or a remote PowerChannel Server. For example, the Integration Service starts a session to write flat file data through PowerChannel. When the local PowerChannel Server receives the request, it initiates a session to write the flat file to a remote PowerChannel Server. The PowerChannel repository stores session information for PowerChannel session recovery purposes. RELATED TOPICS: Managing PowerChannel Sessions on page 74 Recovering PowerChannel Sessions on page 79 PowerChannel Properties Files The PowerChannel Server and clients use a set of properties files to run. For example, the server uses the PowerChannel.properties file to run. Similarly, PcCmd and the web client use their own properties files. Use the default values or set values in the properties files to run the server and clients using a configuration utility. The following table describes the properties files for the PowerChannel Server and clients: Properties Files PowerChannel.properties PcCmd.properties PcWeb.properties Description PowerChannel Server uses this properties file to run. PcCmd uses this properties file to run PcCmd commands. Web client uses this properties file to run web client commands. PowerChannel Architecture 5

18 C H A P T E R 2 Installation and Configuration This chapter includes the following topics: Installation and Configuration Overview, 6 Installing PowerChannel, 9 Configuring PowerChannel Components on PowerCenter, 11 Starting the PowerChannel Server, 11 Running PowerChannel Commands, 13 Restoring the Repository, 14 Uninstalling PowerChannel, 14 Troubleshooting a PowerChannel Installation, 14 Installation and Configuration Overview To run PowerChannel, you install the PowerChannel Server and PcCmd. You can also install the PowerChannel web client on Windows to communicate with the PowerChannel Server. The PowerChannel Server communicates with PcCmd, the web client, the Integration Service, and other PowerChannel Servers using the TCP/IP protocol. Install the PowerChannel Server, PcCmd, the web client, and the Integration Service on a network that can establish TCP/IP connections. You can configure PowerCenter to use PowerChannel to transfer data between the PowerCenter Integration Service and remote databases. Install the PowerChannel Server on a machine with a static IP address. Otherwise, you cannot use default server parameters for PowerChannel. To install PowerChannel, you must have knowledge of Java installation. You can install and run PowerChannel as a service or an application. To run PowerChannel as a service, you must install the PowerChannel Server on Windows. When you install PowerChannel as a service, the PowerChannel Server starts when you log in to Windows. It also stops when you shut down Windows. When you run PowerChannel as an application, you must start and stop the PowerChannel Server manually. 6

19 Minimum System Requirements The following table describes the system requirements to run the PowerChannel Server and clients: PowerChannel Component Operating System RAM Description PowerChannel Server PcCmd Windows, UNIX Windows, UNIX 128 MB Install the PowerChannel Server on Windows or UNIX (Solaris, HP-UX, AIX, Linux). 64 MB Install PcCmd on Windows or UNIX (Solaris, HP-UX, AIX, Linux). You can install PcCmd on the machine running the PowerChannel Server or on client machines that can access the local PowerChannel Server. Web Client Windows 64 MB Install the web client on Windows. You can install the web client on the machine running the PowerChannel Server or on a Windows client machine that can access the local PowerChannel Server. The web client requires BEA WebLogic Server. Make sure a web server is installed on the web client machine. PowerChannel uses Java Runtime Environment (JRE). The installation program installs JRE when you install PowerChannel. Before You Begin Complete the following tasks before you install the web client on Windows: Install and configure BEA WebLogic Server. Install and configure BEA WebLogic Server. Install a web browser. You must install a web browser on the machine from which you want to access the web client. Complete the following task if you want to read data from a remote source or write data to a remote target during a PowerCenter session: Install PowerCenter. When you want PowerChannel to read data from a remote source or write data to a remote source during a PowerChannel session, you need to install and configure PowerCenter. Installing PowerChannel with Encryption Algorithms When you install PowerChannel, the installation program provides two sample repositories with two different encryption algorithms. The installation program asks you to select an encryption algorithm for the default repository. The PowerChannel Server uses the algorithm you select to encrypt and decrypt data. You can install one of the following encryption algorithms: RC2. 3DES. Select 3DES when you want the PowerChannel Server to use FIPS-certified 3DES encryption. After you select the encryption algorithm, the following information applies: After you install the PowerChannel repository, you cannot change the encryption algorithm for that repository. To change the encryption algorithm, you must copy the sample repository provided for the encryption algorithm and replace the default repository. You must also change the encryption algorithm in the PowerChannel and PcCmd properties files using the configuration utility. PowerChannel Servers and their clients must use the same encryption algorithm to communicate with each other. PowerChannel Servers must use the same encryption algorithm to communicate with each other. Installation and Configuration Overview 7

20 Working with the Sample PowerChannel Repository When you install PowerChannel for the first time, the installation program installs two sample PowerChannel repositories that you can use with the PowerChannel Server: 3DES and RC2. Choose the repository that matches the encryption algorithm you selected when you installed the PowerChannel Server. The 3DES repository is in the following directory: <PowerChannel>/repository.3DES The RC2 repository is in the following directory: <PowerChannel>/repository.RC2 Note: Select the encryption algorithm you used in the previous version of PowerChannel. Select 3DES when you want the PowerChannel Server to use FIPS-certified 3DES encryption. The installation program includes a user name and password in the sample repository that you can use to administer the PowerChannel Server and transfer data. The sample repository uses the following user name and password: User name: admin Password: Administrator The PowerChannel installation also includes a default certificate account with a twoway profile in the sample repository. The default certificate account allows PowerChannel Servers that use the sample repository to transfer data with each other. After you install PowerChannel, you can start the PowerChannel Server, run PowerChannel commands, and transfer data. Warning: Using the admin user and default certificate account to run PowerChannel does not ensure a secure data transfer environment. If you do not require a secure data transfer environment, you can continue to use the admin user and default certificate account to run PowerChannel. If you want to ensure a secure data transfer environment, you must implement the following security measures into the PowerChannel sample repository: 1. Delete the default certificate account. 2. Create a certificate account. 3. Change the user password. 4. Reencrypt the repository. Installing and Configuring PowerChannel for File Transfer To install and configure PowerChannel to transfer files, complete the following steps: 1. Install PowerChannel. 2. Optionally, configure the web client on BEA WebLogic Server. 3. Start the PowerChannel Server. Installing and Configuring PowerChannel for Database Data Transfer To install and configure PowerChannel to transfer database data, complete the following steps: 1. Install the PowerChannel Server on the same network as the remote database from which you want to read data or write data. Install the PowerChannel Server on the same machine as the remote database. 2. Optionally, install a PowerChannel Server on the same network as the Integration Service when you want the Integration Service to read compressed and encrypted data from a remote database and write compressed and encrypted data to a remote database. Install the PowerChannel Server on the same machine as the Integration Service. 8 Chapter 2: Installation and Configuration

21 3. Configure PowerChannel components on PowerCenter. 4. Optionally, configure the web client on BEA WebLogic Server. 5. Start the PowerChannel Server. Upgrading PowerChannel from a Previous Version If you are upgrading from a previous version of PowerChannel, complete the following steps: 1. Stop the PowerChannel Server. 2. Back up the PowerChannel repository. You can back up the PowerChannel repository by copying the repository folder to a different location. 3. Back up the PcCmd.properties and the PowerChannel.properties files. To back up PcCmd.properties and PowerChannel.properties, copy the files to a different location. Use the values of the properties in the backup files as a reference for configuring the new properties files. 4. Back up any scripts you used to run PowerChannel and PcCmd commands and the PcPassword command. 5. Install the PowerChannel Server and clients. 6. Optionally, configure PowerCenter to transfer database data using PowerChannel. 7. Configure the web client on BEA WebLogic Server. 8. Start the PowerChannel Server. Installing PowerChannel To run PowerChannel, you install the PowerChannel Server and PcCmd on Windows or UNIX. You also install the web client on Windows. Note: You must have write permissions for the directory where you want to install PowerChannel. Other, the installation program might not be able to successfully install PowerChannel. Installing PowerChannel on Windows You can install PowerChannel on Windows connected to a network that can establish TCP/IP connections. When you install PowerChannel on Windows, you need a Windows user account with administrator rights. Note: The installation program lets you install the PowerChannel Server on Windows XP. However, Windows XP is not compatible with the PowerChannel Server. Do not install the PowerChannel Server on Windows XP. When you want to install the PowerChannel Server to run as a service on Windows, you also need a Windows user account that runs the PowerChannel Server service. Before you install PowerChannel, create a user account with the right to run services, known as the Service Start Account. To see if this account has the correct rights, run User Manager for Domains and select the user. Select User Rights from the Policies menu. The user must have the Logon as a service right. Create this account specifically to run the PowerChannel Server. Do not run the PowerChannel Server as the System account. When you install the PowerChannel Server on Windows, the installation program creates a pcservice.log file in the PowerChannel root directory. The pcservice.log file shows the status of the PowerChannel Server service installation. If you uninstall the PowerChannel Server service, check the pcservice.log file to verify if the service uninstalled successfully. Installing PowerChannel 9

22 Note: When you install PowerChannel, the installation program only copies the web client files into the directory you enter. You need to configure BEA WebLogic Server to run the web client. To install PowerChannel on Windows: 1. Log in to the Windows system as a member of the Administrators group in the local domain. 2. If the Informatica Welcome window does not start, run install.exe from the CD. The Informatica Welcome window appears. 3. Click Next. 4. Enter a valid license key. 5. Click Choose to select the destination folder where you want to install the PowerChannel Server, PcCmd, and the web client. Click Next. Or, click Next to accept the default installation location. 6. Select RC2 or 3DES for the encryption algorithm. 7. Click Next. 8. Verify the installation information and click Install. The installation program installs PowerChannel. If the installation is successful, a message appears asking if you want to configure PowerChannel. 9. Click Yes to open the PowerChannel configuration utility to configure the properties file. Or, click No if you want to configure the PowerChannel properties later, and go to If you clicked Yes, configure the following properties and click Next: Property Repository SERVER_LOG SERVER_ERR_LOG EXPORT_DIR LOG_LEVEL Description Absolute or relative path to the PowerChannel repository. Absolute or relative path to the PowerChannel Server log file. Absolute or relative path to the PowerChannel Server log file. Path to the export directory that PowerChannel to export all certificate files you create for certificate accounts. Enter a value from 0 to 3 for the level of detail in the PowerChannel log files. If you omit values for any of the properties, you can configure the PowerChannel.properties file. 11. Click Yes to restart the machine. Or, click no to restart the machine later. 12. Click Done to complete the setup. A message appears asking if you want to view the readme file. 13. Click Yes to view the PowerChannel release notes. Or, click No if you do not want to read the release notes. Installing PowerChannel on UNIX You can install PowerChannel on UNIX connected to a network that can establish TCP/IP connections. To install PowerChannel on UNIX: 1. Log in to the UNIX machine. 2. On the installation CD, locate the PowerChannel directory. 3. Locate the directory specific to the platform. 10 Chapter 2: Installation and Configuration

23 4. Enter./install.bin to run the installation program. 5. From the installation menu, enter 1 to install PowerChannel. To exit the installation process, enter quit. 6. At the prompt, enter a valid license key. 7. Enter the directory where you want to install PowerChannel and press ENTER. Or, press ENTER to accept the default directory. 8. Select RC2 or 3DES for the encryption algorithm. 9. Press ENTER to continue. A pre-installation summary appears. 10. Click Enter. After the installation completes, a message appears asking if you want to configure PowerChannel. 11. Enter 1 to open the PowerChannel configuration utility to configure the properties file. Or, enter 2 if you want to configure the PowerChannel properties later. If you entered 1, the PowerChannel configuration utility opens to guide you through configuring the properties file. The configuration utility closes when the configuration is complete. Configuring PowerChannel Components on PowerCenter Complete the following steps to configure PowerCenter to read and write remote database data with PowerChannel: 1. Create ODBC connections. Create ODBC connections on the PowerCenter Client machine to import definitions for remote database sources and targets. 2. Create relational database connections. Create connection objects in the Workflow Manager so the Integration Service can connect to remote databases. Note: You do not need to install PowerChannel on the PowerCenter Client or Integration Service machines to enable PowerCenter to read file data or write file data through PowerChannel. Starting the PowerChannel Server You can start the PowerChannel Server as a service on Windows. You can start the server as an application on Windows and UNIX. When you run the server on Windows, do not start the server as an application and as a service simultaneously. When you start the PowerChannel Server, it locks the repository to prevent multiple instances of the server accessing the same repository. The PowerChannel Server unlocks the repository when you stop the server. If you do not stop the server properly, you need to unlock the repository before you can restart it. Configuring PowerChannel Components on PowerCenter 11

24 Starting the PowerChannel Server as a Service On Windows, you can start the PowerChannel Server as a service from the Control Panel. You can configure the service to start when you start Windows. Use a Service Start Account for the PowerChannel Server service login. The user account you use for the service login must have access to the source or target directories you use during PowerChannel file transfer. When you start the PowerChannel Server as a service, the server starts with the following Java Virtual Machine (JVM) memory configuration: JVM Memory Configuration Default memory (-Xms) Maximum memory(-xmx) Memory Size 40 MB 300 MB You cannot change the memory configurations for the JVM if you start the PowerChannel Server as a service on Windows. On Windows, you can stop the PowerChannel service from the Control Panel. Starting the PowerChannel Server as an Application You can start the PowerChannel Server as an application on Windows or UNIX. You must have a PowerChannel user account with the admin profile to start the server. When you start the PowerChannel Server, you can configure the JVM memory. The PowerChannel Server uses JVM memory when it runs data transfer sessions. If you do not configure the JVM memory, PowerChannel data transfer sessions might fail when JVM runs out of memory. Configure JVM memory in the PowerChannel file on UNIX and the PowerChannel.bat file on Windows. You can find these files in the PowerChannel directory. Use the following guidelines to configure the JVM memory: If you run fewer than 20 PowerChannel sessions concurrently, set the -Xms value to 40 MB. Set the -Xmx value to 60 MB. If you run 20 to 60 PowerChannel sessions concurrently, set the -Xms value to 40 MB. Set the -Xmx value to 100 MB. If you run more than 60 PowerChannel sessions concurrently, set the -Xms value to 100 MB. Set the -Xmx value to 200 MB. If the session still fails, increase the maximum memory for Java. To start the PowerChannel Server as an application: 1. Go to the PowerChannel directory. 2. Enter the PowerChannel start command. Use the following command syntax to start the PowerChannel Server: PowerChannel start [-r=<properties_file>] [-u=<user_account_name>] [-p=<user_account_password>] The parameters enclosed in [ ] are optional. The input values for the parameters are enclosed in < >. Values in the format {x y} represent the options you can use for the command parameter. Parameters followed by an asterisk (*) can contain multiple values. 12 Chapter 2: Installation and Configuration