Академический Документы
Профессиональный Документы
Культура Документы
1 HotFix 1)
Informatica Upgrade Guide for PowerCenter 9.0 Version 9.0.1 HotFix 1 September 2010 Copyright (c) 1998-2010 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 227.7202-1(a) and 227.7702-3(a) (1995), DFARS 252.227-7013(1)(ii) (OCT 1988), FAR 12.212(a) (1995), FAR 52.227-19, or FAR 52.227-14 (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 (http://www.apache.org/), and other software which is licensed under the Apache License, Version 2.0 (the "License"). You may obtain a copy of the License at http://www.apache.org/licenses/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 (http://www.mozilla.org/), software copyright The JBoss Group, LLC, all rights reserved; software copyright 1999-2006 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 http:// www.gnu.org/licenses/lgpl.html. 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 () 1993-2006, 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 http://www.openssl.org. This product includes Curl software which is Copyright 1996-2007, Daniel Stenberg, <daniel@haxx.se>. All Rights Reserved. Permissions and limitations regarding this software are subject to terms available at http://curl.haxx.se/docs/copyright.html. 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 2001-2005 () MetaStuff, Ltd. All Rights Reserved. Permissions and limitations regarding this software are subject to terms available at http://www.dom4j.org/ license.html. The product includes software copyright 2004-2007, The Dojo Foundation. All Rights Reserved. Permissions and limitations regarding this software are subject to terms available at http:// 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 http://source.icu-project.org/repos/icu/icu/trunk/license.html. This product includes software copyright 1996-2006 Per Bothner. All rights reserved. Your right to use such materials is set forth in the license which may be found at http:// www.gnu.org/software/ 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 http://www.opensource.org/licenses/mit-license.php. This product includes software developed by Boost (http://www.boost.org/) or under the Boost software license. Permissions and limitations regarding this software are subject to terms available at http:/ /www.boost.org/LICENSE_1_0.txt. This product includes software copyright 1997-2007 University of Cambridge. Permissions and limitations regarding this software are subject to terms available at http:// www.pcre.org/license.txt. This product includes software copyright 2007 The Eclipse Foundation. All Rights Reserved. Permissions and limitations regarding this software are subject to terms available at http:// www.eclipse.org/org/documents/epl-v10.php. This product includes software licensed under the terms at http://www.tcl.tk/software/tcltk/license.html, http://www.bosrup.com/web/overlib/?License, http://www.stlport.org/doc/ license.html, http://www.asm.ow2.org/license.html, http://www.cryptix.org/LICENSE.TXT, http://hsqldb.org/web/hsqlLicense.html, http://httpunit.sourceforge.net/doc/ license.html, http://jung.sourceforge.net/license.txt , http://www.gzip.org/zlib/zlib_license.html, http://www.openldap.org/software/release/license.html, http://www.libssh2.org, http://slf4j.org/license.html, http://www.sente.ch/software/OpenSourceLicense.html, and http://fusesource.com/downloads/license-agreements/fuse-message-broker-v-5-3license-agreement. This product includes software licensed under the Academic Free License (http://www.opensource.org/licenses/afl-3.0.php), the Common Development and Distribution License (http://www.opensource.org/licenses/cddl1.php) the Common Public License (http://www.opensource.org/licenses/cpl1.0.php) and the BSD License (http:// www.opensource.org/licenses/bsd-license.php). This product includes software copyright 2003-2006 Joe WaInes, 2006-2007 XStream Committers. All rights reserved. Permissions and limitations regarding this software are subject to terms available at http://xstream.codehaus.org/license.html. This product includes software developed by the Indiana University Extreme! Lab. For further information please visit http://www.extreme.indiana.edu/. 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: PC-UPG-90100-HF1-0001
Table of Contents
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . iv
Informatica Resources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . iv Informatica Customer Portal. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . iv Informatica Documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . iv Informatica Web Site. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . iv Informatica How-To Library. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . iv Informatica Knowledge Base. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v Informatica Multimedia Knowledge Base. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v Informatica Global Customer Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v
Table of Contents
Assign Roles to Users and Groups. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Back Up the Repository. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 Verify Database User Account Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 Shut Down the Domain. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
ii
Table of Contents
Update the Plug-in. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 Metadata Manager Service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 Copy JDBC drivers for Netezza Resources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 Reload Metadata Manager Resources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 Update the Metadata Manager Properties File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 Update the Metadata Manager File Location. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 Configure Domain SMTP Configuration Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Index. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Table of Contents
iii
Preface
The Upgrade Guide for PowerCenter 9.0 is written for the system administrator who is responsible for upgrading the Informatica product. This guide assumes that you have knowledge of operating systems, relational database concepts, and the database engines, flat files, or mainframe systems in your environment. This guide also assumes that you are familiar with the interface requirements for your supporting applications.
Informatica Resources
Informatica Customer Portal
As an Informatica customer, you can access the Informatica Customer Portal site at http://mysupport.informatica.com. 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 Product Documentation, 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 email 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 Product Documentation from http://mysupport.informatica.com.
iv
Standard Rate Belgium: +31 30 6022 797 France: 0805 804632 Germany: 01805 702702 Netherlands: 030 6022 797
Preface
vi
CHAPTER 1
Upgrade Overview
This chapter includes the following topics:
Informatica Upgrade, 1 Upgrade Process, 2 Upgrade Tasks, 3
Informatica Upgrade
You can upgrade the following Informatica product versions to version 9.0.1 HotFix 1:
Informatica Product Version Informatica PowerCenter 8.1.x Comments If the PowerCenter 8.1.x domain includes Metadata Manager or Data Analyzer, you must upgrade to PowerCenter 8.6.1 before you upgrade. If the PowerCenter 8.5.x domain includes the Metadata Manager Service or Reporting Service, you must upgrade to PowerCenter 8.6.1 before you upgrade. If the PowerCenter 8.6 domain includes the Metadata Manager Service, Reporting Service, or Reference Table Manager Service, you must upgrade to PowerCenter 8.6.1 before you upgrade. Effective in version 9.0.1, the Reference Table Manager functionality is available through the 9.0.1 Analyst Service. See the PowerCenter 8.6.1 upgrade documentation for the steps to migrate the PowerCenter 8.6.1 reference table data to the Informatica 9.0.1 Analyst tool. You can migrate the contents of the Informatica Data Quality 8.6.2 repository to the Informatica 9.0.1 Model repository. See the 9.0.1 Data Quality migration documentation for details.
Informatica PowerCenter 9.0 Informatica Data Quality 9.0 Informatica Data Services 9.0
Comments See the Informatica Data Quality 9.0 upgrade documentation. Complete the steps to upgrade Informatica Data Quality 9.0 unless an exception is specified. See the Informatica 9.0.1 HotFix 1 Release Notes for details. See the Informatica 9.0.1 HotFix 1 Release Notes for details. See the Informatica 9.0.1 HotFix 1 Release Notes for details.
Informatica PowerCenter 9.0.1 Informatica Data Quality 9.0.1 Informatica Data Services 9.0.1
If the product version you use cannot be upgraded to Informatica 9.0.1 HotFix 1, you must first upgrade to a supported version.
Upgrade Process
The upgrade consists of the following phases:
Upgrading the domain and server files. To upgrade the domain and server files, run the Informatica server
installer and select the upgrade option. The domain upgrade wizard installs the server files and configures the domain. If the domain has multiple nodes, you must upgrade all nodes. The following table describes the actions that the installer performs when you upgrade Informatica:
Tasks Installs Informatica. Description Installs Informatica directories and files into the new directory. Copies the contents of the infa_shared directory from the existing installation directory into the new installation directory. Copies the contents of the mm_files directory from the default location in the existing installation directory into the new installation directory. Upgrades the domain to run version 9.0.1 application services. The upgrade retains the user and administrator accounts in the domain. Starts Informatica Services on the node.
*If you choose the installer option to update the node configuration, the installer does not copy directories. Upgrading the application services. After you upgrade the domain and server files, log in to the Administrator
tool and upgrade the application services. The service upgrade wizard provides a list of all application services that must be upgraded. It upgrades the services based on the order required by the dependent objects.
Upgrading the Informatica client. To upgrade the Informatica client, run the Informatica client installer and
select the upgrade option. If the client is installed on multiple machines, upgrade the client on all machines.
Upgrade Tasks
To upgrade PowerCenter, complete the following tasks: 1. 2. Complete the pre-upgrade tasks for the domain and server files to ensure that you can successfully run the installer. Upgrade Informatica domain and server files. Use the server installer to upgrade Informatica domain and upgrade the server files on each node. If the domain contains multiple nodes, upgrade a gateway node before you upgrade the worker nodes. After you upgrade the first gateway node, verify that the upgrade was successful before you upgrade the other nodes in the domain. Complete the pre-upgrade tasks for the application services. Upgrade the application services. After installation, log in to the Administrator tool and upgrade the application services. Upgrade the PowerCenter Client. Use the client installer to upgrade the PowerCenter client. Perform the post-upgrade tasks.
3. 4. 5. 6.
Upgrade Tasks
CHAPTER 2
Pre-Upgrade Tasks
Before you upgrade the domain and server files, complete the following tasks: 1. 2. 3. 4. 5. 6. Review the operating system specific requirements. Prepare the domain. Prepare the PowerCenter repository. Prepare Metadata Manager. Prepare the Data Analyzer repository. Shut down the domain.
2 CPU
4 GB
4 GB
1 CPU
2 GB
3 GB
3 GB 3 GB 3 GB 220 MB
Note: When you upgrade, the installer requires an additional 4 GB disk space plus the amount of disk space used by the existing infa_shared directory. The following table lists the minimum system requirements to run PowerCenter Client:
Client PowerCenter Client Processor 1 CPU RAM 512 MB Disk Space 1.2 GB
The following table lists the temporary disk space requirements during installation of Informatica clients:
Product Installer Informatica Clients Disk Space 1 GB 550 MB
PATH
Library path
INFA_HOME
INFA_DOMAINS_FILE
If the domain has more than 1,000 users, update the maximum heap size based on the number of users in the domain. 1. 2. 3. 4. 5. Extract the installation files. Go to the <installer>\source\tomcat\bin directory. Use a text editor to open the infaservice.bat file. Search for the following text: INFA_JAVA_OPTS=% INFA_JAVA_OPTS% -XX. Set the value for -Xmx to the maximum heap size required for the number of Informatica domain users. For example, to set the maximum heap size to 1024 MB, use the following configuration:
set INFA_JAVA_OPTS=% INFA_JAVA_OPTS% -XX:GCTimeRatio=9 -Xmx1024m
2 CPU
4 GB
4 GB
1 CPU
2 GB
3 GB
2 GB 512 MB 512 MB
3 GB 3 GB 3 GB
Note: When you upgrade, the installer requires an additional 4 GB disk space plus the amount of disk space used by the existing infa_shared directory. For more details, see the Product Availability Matrix at http://mysupport.informatica.com.
PATH
Library path
JRE_HOME
INFA_HOME
INFA_DOMAINS_FILE
If the domain has more than 1000 users, update the maximum heap size based on the number of users in the domain. 1. 2. 3. 4. 5. Extract the installation files. Go to the <installer>\source\tomcat\bin directory. Use a text editor to open the infaservice.sh file. Search for the following text: INFA_JAVA_OPTS="${INFA_JAVA_OPTS} -XX. Set the value for -Xmx to the maximum heap size required for the number of Informatica domain users. For example, to set the maximum heap size to 1024 MB, use the following configuration:
INFA_JAVA_OPTS="${INFA_JAVA_OPTS} -XX:GCTimeRatio=9 -Xmx1024m"
If you do not know the IP address of a UNIX machine where the X Window server is installed, ask your network administrator. For more information about redirecting the DISPLAY variable, see the documentation from the UNIX vendor. If the X Window server does not support the font that the Informatica installer uses, the installer can display incorrect labels on the buttons. For example, the button labeled Test Connection can appear as Test Connecti....
Informatica. The following table describes the metadata files and the locations where you can find them:
Metadata File nodemeta.xml Description Contains metadata for a node. Location Stored in the isp/config directory on each node in the domain. If you use the same backup directory name on all the nodes, rename nodemeta.xml before copying it to the backup location. For example, you back up nodemeta.xml to the /nodebak directory on nodeA and nodeB. Rename the configuration files so that on nodeA the file is backed up to /nodebak/nodemeta_A.xml, and on nodeB the file is backed up to /nodebak/nodemeta_B.xml. Stored in one of the following locations: - The Informatica installation directory on the client and server machines. - The location configured through the INFA_DOMAINS_FILE environment variable.
domains.infa
10
To grant the Create View privilege for a Microsoft SQL Server database, you can use the following syntax:
USE <DatabaseName>; GRANT CREATE VIEW TO <DatabaseUser>; GO
To grant the Create View privilege for an Oracle database, you can use the following syntax:
GRANT CREATE VIEW TO <DatabaseUser>
Run infasetup
Informatica infasetup includes command line programs to back up, restore, and update gateway nodes. infasetup is located in the following directory:
<Informatica Installation Directory>\server
11
To update the gateway node with infasetup, use the following syntax:
UpdateGatewayNode [<-DatabaseAddress|-da> database_hostname:database_port <-DatabaseConnectionString|-cs> database_connection_string] [<-DatabaseUserName|-du> database_user_name] [<-DatabasePassword|-dp> database_password] [<-DatabaseType|-dt> database_type] [<-DatabaseServiceName|-ds> database_service_name] [<-DomainName|-dn> domain_name] [<-NodeName|-nn> node_name] [<-NodeAddress|-na> node_host:port] [<-PreviousInfaHome|-ph> previous_infa_home] [<-HttpsPort|-hs> https_port] [<-KeystoreFile|-kf> keystore_file_location] [<-KeystorePass|-kp> keystore_password] [<-LogServiceDirectory|-ld> log_service_directory] [<-ServerPort|-sv> server_admin_port_number] [<-SchemaName|-sc> schema_name Microsoft SQL Server only]
12
To restore the Metadata Manager warehouse with the backupCmdLine command line program, use the following syntax:
backupCmdLine.(bat | sh) restore <DBTYPE> "<JDBCConnectionString>" <DBUSERNAME> <DBPASSWORD> <FILENAME.bkp>
13
Informatica Services.
To stop Informatica on UNIX, you use the infaservice command. By default, the infaservice executable file is
You can also stop the Informatica service from the Windows control panel or from the Administrator tool.
14
CHAPTER 3
1.
Log in to the machine with the same user account that you used to install the previous version.
15
2. 3.
Close all other applications. To begin the upgrade on Windows, run install.bat from the root directory. To begin the upgrade on UNIX, use a shell command line to run install.sh from the root directory, and then select the option for graphical mode installation.
4.
Select Install or upgrade to Informatica 9.0.1 with HotFix 1 and click Start.
If you are upgrading from Informatica 9.0.1, select Apply HotFix 1 to Informatica 9.0.1. See the
Informatica 9.0.1 HotFix 1 Release Notes for information about applying the hotfix. 5. In the Installation Type window, select Upgrade to Informatica 9.0.1 with HotFix 1 and click Next. The Upgrade Pre-Requisites window displays the upgrade system requirements. Verify that all requirements are met before you continue the upgrade. 6. 7. Click Next. In the Upgrade Directory window, enter the following directories:
Directory Directory of the Informatica product to upgrade Directory for Informatica 9.0.1 HotFix 1 Description Directory that contains the previous version of PowerCenter that you want to upgrade.
Directory in which to install Informatica 9.0.1 HotFix 1. Enter the absolute path for the installation directory. The directory cannot be the same as the directory that contains the previous version of PowerCenter.The directory names in the path must not contain spaces or the following special characters: @|* $ # ! % ( ) {}[],;' On Windows, the installation directory must be on the current machine.
8.
Verify that the Allow changes to the node host name and port numbers option is not selected. You cannot modify the node configuration when you upgrade from Informatica 9.0.
9.
Click Next. The upgrade wizard displays a warning to shut down the Informatica domain before you continue the upgrade.
10. 11.
Click OK. In the Pre-Installation Summary window, review the upgrade information, and click Install to continue. The upgrade wizard installs the Informatica server files to the Informatica 9.0.1 HotFix 1 installation directory.
12.
If you are upgrading a gateway node, the upgrade wizard displays the database and user account information for the domain configuration repository to be upgraded. If you are upgrading a worker node, the upgrade wizard does not display the domain configuration repository information. You cannot modify the database connection information. The following table describes the properties that the installer displays for the domain configuration repository:
Property Database type Database user ID User password Description Database for the domain configuration repository. Database user account for the domain configuration repository. Password for the database user account.
16
The upgrade wizard displays the database connection string for the domain configuration repository based on how the connection string of the previous version was created at installation:
If the previous version used a JDBC URL at installation, the upgrade wizard displays the JDBC connection
properties, including the database address and service name. Optionally, you can specify additional JDBC parameters to include in the JDBC URL. To provide additional JDBC parameters, select JDBC parameters and enter a valid JDBC parameter string.
If the previous version used a custom JDBC connection string at installation, the upgrade wizard displays
the custom connection string. You cannot specify additional JDBC parameters. 13. 14. Click Test Connection to verify that you can connect to the database, and then click OK to continue. Click Next. On Windows, the upgrade wizard creates a service to start Informatica. By default, the service runs under the same user account as the account used for installation. You can run the Windows service under a different user account. 15. Select whether to run the Windows service under a different user account. The following table describes the properties that you set:
Property Run Informatica under a different user account User name Description Indicates whether to run the Windows service under a different user account.
User account with which to run the Informatica Windows service. Use the following format:
DomainName\UserAccount
This user account must have the Act as operating system permission. Password Password for the user account with which to run the Informatica Windows service.
16.
Click Next. The Post-Upgrade Summary window indicates whether the upgrade completed successfully.
17.
Click Done.
You can view the upgrade log files to get more information about the tasks performed by the upgrade wizard and to view the configuration of installed components.
17
2. 3.
Stop all processes that access the directory and subdirectories of the Informatica product to upgrade, including command prompts and tail logs. On a shell command line, run the install.sh file located in the root directory. The installer displays the message to verify that the locale environment variables are set.
4.
If the environment variables are not set, enter N to exit the installer and set them as required. If the environment variables are set, enter Y to continue.
5.
Informatica 9.0.1 HotFix 1 Release Notes for information about applying the hotfix. 6. 7. Enter C for console mode installation. Enter 2 to upgrade to Informatica 9.0.1 Hotfix 1. Review the system requirements and pre-upgrade tasks. Verify that all upgrade requirements are met before you continue. 8. 9. Press Enter. At the prompt, enter the following directories:
Directory Directory of the Informatica product to upgrade Directory for Informatica 9.0.1 Hotfix 1 Description Directory that contains the previous version of PowerCenter that you want to upgrade.
Directory in which to install Informatica 9.0.1 Hotfix 1. The directory cannot be the same as the directory that contains the previous version of PowerCenter.
10.
Enter 1 use the same node configuration as the previous version. You cannot modify the node configuration when you upgrade from Informatica 9.0. The installer displays a warning to shut down the Informatica domain that you want to upgrade before you continue the upgrade.
11. 12.
Press Enter. Review the upgrade information and press Enter to continue. The installer copies the server files to the Informatica 9.0.1 Hotfix 1 installation directory. The installer displays the database and user account information for the domain configuration repository to upgrade. It displays the database connection string for the domain configuration repository based on how the connection string of the previous version was created at installation:
If the previous version used a JDBC URL at installation, the installer displays the JDBC connection
custom connection string. 13. 14. Press Enter. If you use a JDBC URL, you can specify additional parameters to include in the connection string. If you use a custom connection string, you cannot specify additional parameters. The Post-Installation Summary window indicates whether the upgrade completed successfully. It also shows the status of the installed components and their configuration. You can view the upgrade log files to get more information about the upgrade tasks performed by the installer and to view the configuration properties for the installed components.
18
UPG_DIFF_CONFIG
USER_INSTALL_DIR
UPG_BACKUP_DIR DB2_TABLESPACE
19
Description Optional parameters to include in the JDBC URL connection string. Verify that the parameter string is valid. The installer does not validate the parameter string before it adds the string to the JDBC URL. If this parameter is empty, the installer creates the JDBC URL without additional parameters. You can set this parameter if DB_CUSTOM_STRING_SELECTION=0. Indicates whether to display the list of port numbers for the domain and node components. If the value is 0, the installer assigns default port numbers to the domain and node components. If the value is 1, you can set the port numbers for the domain and node components. Port number used by the Service Manager on the node. The Service Manager listens for incoming connection requests on this port. Client applications use this port to communicate with the services in the domain. This is the port that the Informatica command line programs use to communicate to the domain. This is also the port for the SQL data service JDBC/ODBC driver. You can set this parameter if ADVANCE_PORT_CONFIG=1. Port number used by the Administrator tool. You can set this parameter if ADVANCE_PORT_CONFIG=1. Port number that controls server shutdown for the Administrator tool. The Administrator tool listens for shutdown commands on this port. You can set this parameter if ADVANCE_PORT_CONFIG=1. For upgrades from version 8.x. You can set this option when you run the installer again after a failed upgrade. The installer starts the domain upgrade process from the beginning and overrides all previous upgrades to the domain. It also overrides any upgrade contention if other administrators are upgrading nodes in the domain at the same time.
ADVANCE_PORT_CONFIG
TOMCAT_PORT
AC_PORT
AC_SHUTDWN_PORT
FORCE_UPGRADE
4.
On Windows, specify whether to run the Informatica service under the same user account as the account used for upgrade. Set the following parameters:
Property USE_LOGIN_DETAILS Description Indicates whether to run the Windows service under a different user account. If the value is 0, the installer configures the service to run under the current user account. If the value is 1, the installer configures the service to run under a different user account. User account with which to run the Informatica Windows service. Use the following format:
DomainName\UserAccount
WIN_USER_ID
This user account must have the Act as operating system permission. WIN_USER_PSSWD Password for the user account with which to run the Informatica Windows service.
5.
20
2. 3. 4.
Go to the root of the server installer directory. Verify that the directory contains the file SilentInput.properties with the upgrade options. To start the silent upgrade process, double click the file silentinstall.bat.
The silent upgrade runs in the background. The process can take a while. The silent upgrade process is complete when the Informatica_<Version>_Services_InstallLog.log is created in the installation directory. The silent upgrade fails if you incorrectly configure the properties file or if the installation directory is not accessible. If the upgrade fails, view the silent upgrade log file and correct the errors. Then run the silent installer again. The silent upgrade log file name is silentErrorLog.log. The installer creates it in the root directory on Windows and in the user home directory on UNIX.
the domain configuration repository database from backup and run the installer again.
21
CHAPTER 4
Pre-Upgrade Tasks
Before you upgrade the application services, complete the following tasks: 1. 2. 3. 4. 5. Configure POSIX Asynchronous I/O. Configure Informatica environment variables. Configure locale environment variables. Clear browser cache. Configure browser bookmarks.
22
The command returns the languages installed on the UNIX operating system and the existing locale settings. Locale on Linux All UNIX operating systems except Linux have a unique value for each locale. Linux allows different values to represent the same locale. For example, utf8, UTF-8, UTF8, and utf-8 represent the same locale on a Linux machine. Informatica requires that you use a specific value for each locale on a Linux machine. Make sure that you set the LANG environment variable appropriately for all Linux machines. Locale for Oracle Database Clients For Oracle database clients, set NLS_LANG to the locale you want the database client and server to use with the login. A locale setting consists of the language, territory, and character set. The value of NLS_LANG
23
depends on the configuration. For example, if the value is american_america.UTF8, set the variable in a C shell with the following command:
setenv NLS_LANG american_america.UTF8
24
CHAPTER 5
25
You can access the service upgrade wizard from the Manage menu in the header area.
Upgrade Report
The upgrade report contains the upgrade start time, upgrade end time, upgrade status, and upgrade processing details. To save the upgrade report, choose one of the following options: Save Report The Save Report option appears on step 4 of the service upgrade wizard. Save Previous Report The second time you run the service upgrade wizard, the Save Previous Report option appears on step 1 of the service upgrade wizard. If you did not save the upgrade report after upgrading services, you can select this option to view or save the previous upgrade report.
26
CHAPTER 6
By default, the when you upgrade PowerCenter Client, the following components are also upgraded:
DataDirect ODBC drivers Java Runtime Environment libraries
27
options.
1. 2. 3.
Close all applications. Run install.bat from the root directory. Select Install or upgrade to Informatica 9.0.1 with Hotfix 1 and click Start.
If you are upgrading from Informatica 9.0.1, select Apply HotFix 1 to Informatica 9.0.1. See the
Informatica 9.0.1 HotFix 1 Release Notes for information about applying the hotfix. The Installation Pre-Requisites window displays the system requirements. Verify that all installation requirements are met before you continue the installation. 4. Click Next. On the Select Component window, select the Informatica client you want to upgrade. You can upgrade the following Informatica client applications:
Informatica Developer PowerCenter Client
If both Informatica Developer and PowerCenter Client are installed on the machine, you can upgrade the tools in the same process. 5. On the Upgrade Directory window, enter the following directories:
Directory Directory of the Informatica client to upgrade Directory for Informatica 9.0.1 client tools Description Directory that contains the previous version of the Informatica client tool that you want to upgrade Directory in which to install the Informatica 9.0.1 client tools Enter the absolute path for the installation directory. The installation directory must be on the current machine. The directory names in the path must not contain spaces or the following special characters: @|* $ # ! % ( ) { } [ ] , ; '
6. 7.
Click Next. On the Pre-Installation Summary window, review the installation information, and click Install. The installer copies the Informatica client files to the installation directory. The Post-installation Summary window indicates whether the upgrade completed successfully.
8.
Click Done.
28
You can view the installation log files to get more information about the upgrade tasks performed by the installer.
UPG_BACKUP_DIR DXT_COMP
CLIENT_COMP
4.
29
The silent upgrade runs in the background. The process can take a while. The silent upgrade process is complete when the Informatica_9.0.1_Client_InstallLog.log is created in the installation directory. The silent upgrade fails if you incorrectly configure the properties file or if the installation directory is not accessible. If the upgrade fails, view the installation log files and correct the errors. Then run the silent installer again.
30
CHAPTER 7
Informatica Domain
After you upgrade, complete the post-upgrade tasks for the domain.
31
32
33
INDEX
D
disk space requirements installation requirements 8 DISPLAY environment variables 6
P
PATH environment variables 8
E
environment variables DISPLAY 9 installation 6, 8
S
Service Upgrade Wizard upgrading services 25 services Service Upgrade Wizard 25
G
graphical mode installation requirements 9
I
IATEMPDIR environment variables 6, 8 installation requirements disk space 8 environment variables 6, 8 X Window Server 9
U
upgrading Service Upgrade Wizard 25
X
X Window Server installation requirements 9
J
JRE_HOME environment variables 6, 8
L
LANG locale environment variables 6, 8
34