Moving a Node to Another PowerCenter Domain

2009-2013 Informatica Corporation. 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.

Abstract
A node is a logical representation of a physical machine in a PowerCenter domain. You can remove a node from one PowerCenter domain and add it to another PowerCenter domain.

Table of Contents
Overview ........................................................................................................................................................................... 2 Step 1. Shut Down the Node ............................................................................................................................................ 2 Step 2. Back Up the nodemeta.xml File ............................................................................................................................ 3 Step 3. Remove the Node from the Current PowerCenter Domain .................................................................................. 3 Step 4. Define the Node for the Other PowerCenter Domain ........................................................................................... 3 Using infasetup DefineGatewayNode ........................................................................................................................... 4 Using infasetup DefineWorkerNode ............................................................................................................................. 5 Step 5. Add the Node to the Other PowerCenter Domain ................................................................................................ 5 Step 6. Start the Node ...................................................................................................................................................... 6 Step 7. Assign Application Services to Run on the Node ................................................................................................. 6

Overview
A node is a logical representation of a physical machine in a PowerCenter domain. You can remove a node from one PowerCenter domain and add it to another PowerCenter domain. When you remove a node from a PowerCenter domain, all application services that were running on the node are also removed. If you have the high availability option and the services run on multiple nodes, then the services fail over to a backup node when you remove the node. If you do not have the high availability option, note the configuration of the services before you remove the node. After moving the node to another PowerCenter domain, you must assign existing services in the new domain to run on the node or create services to run on the node. To move a node from one PowerCenter domain to another PowerCenter domain, complete the following steps: 1. 2. 3. 4. 5. 6. 7. Shut down the node. Back up the nodemeta.xml file. Remove the node from the current PowerCenter domain. Define the node for the other PowerCenter domain. Add the node to the other PowerCenter domain. Start the node. Assign application services to run on the node.

Step 1. Shut Down the Node

Shut down the node that you want to move. You can shut down a node from the Administration Console or from the operating system. When you shut down a node, you stop Informatica Services and abort all processes running on the node.

Note: To avoid loss of data or metadata when you shut down a node, disable all running processes in complete mode. To shut down the node from the Administration Console: 1. 2. 3. Select the node in the Navigator. Click Shutdown in the right pane. The Administration Console displays the list of service processes running on that node. Click Yes to stop all processes.

To stop the node on Windows: 1. 2. 3. From the Start Menu, click Administrative Tools > Services. Double-click Informatica Services. Click Stop.

To stop the node on UNIX: 1. At the command prompt, switch to the directory where the infaservice executable is located. By default, infaservice installs in the following location:
<PowerCenter Installation Directory>\server\tomcat\bin

2.

At the command prompt, type the following command:

infaservice shutdown

Step 2. Back Up the nodemeta.xml File

The nodemeta.xml file stores the configuration metadata of the node. A gateway node uses information in nodemeta.xml to connect to the domain configuration database. A worker node uses the information in nodemeta.xml to connect to the domain. The metadata file is stored in the following location:
<PowerCenter Installation Directory>\server\config

Create a backup of this file by copying it to another location outside of the PowerCenter installation directory. If needed, you can use the backup copy to restore the node to the initial domain.

Step 3. Remove the Node from the Current PowerCenter Domain

Use the Administration Console to remove the node. To remove the node from the current PowerCenter domain: 1. 2. 3. In the Administration Console, select the node in the Navigator. Click the Remove button. In the warning message that appears, click OK.

Step 4. Define the Node for the Other PowerCenter Domain

You can define the node to function as a gateway node or a worker node in the new PowerCenter domain. When you define a node, you specify the host name and port number for the machine that hosts the node. You also specify the node name. The Administration Console uses the node name to identify the node. Use either of the following programs to define the node: The PowerCenter installation program. Run the installation program on the machine you want to define as the gateway or worker node. For more information, see the PowerCenter Installation Guide.

infasetup command line program. Run the infasetup DefineGatewayNode or DefineWorkerNode command on the machine you want to serve as the gateway or worker node.

Using infasetup DefineGatewayNode

The infasetup DefineGatewayNode command defines a gateway node on the current machine. This command overwrites the nodemeta.xml file that stores the configuration metadata for the node. To define the node as a gateway node: 1. At the command prompt, switch to the directory where the infasetup executable is located. By default, infasetup installs in the following location:
<PowerCenter Installation Directory>\server

2.

Enter infasetup on Windows or infasetup.sh on UNIX followed by the DefineGatewayNode command name and its required options and arguments. For example on Windows, enter the following command:
infasetup DefineGatewayNode DatabaseConnectionString <database_connection_string> -DatabaseUserName <database_user_name> -DatabasePassword <database_password> -DatabaseType <database_type> -DomainName <domain_name> -NodeName <node_name> -NodeAddress <node_host:port> -LogServiceDirectory <log_service_directory> -ResourceFile <resource_file>

The following table describes the required infasetup DefineGatewayNode options and arguments:
Option -DatabaseConnectionString Argument database_connection _string Description Connection string used to connect to the domain configuration database. Specify the database host, database port, and the database service name as part of the connection string. Enclose the connection string in quotes. Account for the database containing the domain configuration information. Domain configuration database password corresponding to the database user. Type of database that stores the domain configuration metadata. Database types include: db2 oracle sqlserver sybase -DomainName -NodeName domain_name node_name Name of the domain the gateway node links to. Name of the node. Node names must be between 1 and 79 characters and cannot contain spaces or the following characters: \ / * ? < > " | Host name and port number for the machine hosting the node. Choose an available port number. Shared directory path used by the Log Manager to store log event files. File that contains the list of available resources for the node. Use the file, nodeoptions.xml, located in the server\tomcat\bin directory.

-DatabaseUserName -DatabasePassword -DatabaseType

database_user_name database_password database_type

-NodeAddress -LogServiceDirectory -ResourceFile

node_host:port log_service_directory resource_file

For more information about using infasetup, see the PowerCenter Command Reference.

Using infasetup DefineWorkerNode

The infasetup DefineWorkerNode command defines a worker node on the current machine. This command overwrites the nodemeta.xml file that stores the configuration metadata for the node. To define the node as a worker node: 1. At the command prompt, switch to the directory where the infasetup executable is located. By default, infasetup installs in the following location:
<PowerCenter Installation Directory>\server

2.

Enter infasetup on Windows or infasetup.sh on UNIX followed by the DefineWorkerNode command name and its required options and arguments. For example on Windows, enter the following command:
infasetup DefineWorkerNode -DomainName <domain_name> -NodeName <node_name> -NodeAddress <node_host:port> -GatewayAddress <domain_gateway_host:port> -UserName <user_name> -Password <password> -ResourceFile <resource_file>

The following table describes the required infasetup DefineWorkerNode options and arguments:
Option -DomainName -NodeName -NodeAddress -GatewayAddress -UserName -Password -ResourceFile Argument domain_name node_name node_host:port domain_gateway_ host:port user_name password resource_file Description Name of the domain the worker node links to. Name of the node. Node names must be between 1 and 79 characters and cannot contain spaces or the following characters: \ / * ? < > " | Host name and port number for the machine hosting the node. Choose an available port number. Gateway host machine name and port number. User name used to connect to the domain. User password. File that contains the list of available resources for the node. Use the file, nodeoptions.xml, located in the server\tomcat\bin directory.

For more information about using infasetup, see the PowerCenter Command Reference.

Step 5. Add the Node to the Other PowerCenter Domain

After you define the node, add it to the PowerCenter domain using the infacmd AddDomainNode command. Note: You can also add the node to the PowerCenter domain from the Administration Console. To add the node to the other PowerCenter domain: 1. At the command prompt, switch to the directory where the infacmd executable is located. By default, infacmd installs in the following location:
<PowerCenter Installation Directory>\server\bin

2.

Enter infacmd on Windows or infacmd.sh on UNIX followed by the AddDomainNode command name and its required options and arguments. For example on Windows, enter the following command:
infacmd AddDomainNode -DomainName <domain_name> -UserName <user_name> -Password <password> -SecurityDomain <security_domain> -Gateway <gateway_host1:port gateway_host2:port...> -NodeName <node_name> -FolderPath <full_folder_path>

The following table describes the required infacmd AddDomainNode options and arguments:
Option -DomainName -UserName -Password -SecurityDomain -Gateway -NodeName -FolderPath Argument domain_name user_name password security_domain gateway_host1:port gateway_host2:port ... node_name full_folder_path Description Name of the domain. User name used to connect to the domain. User password. Required if you use LDAP authentication. Name of the security domain that the user belongs to. Default is Native. Host names and port numbers for the gateway nodes in the domain. Updates the gateway connectivity information in the domains.infa file. Name of the node you want to add to the domain. Full path, excluding the domain name, to the folder in which you want to add the node. Must be in the following format: /parent_folder/child_folder Default is /(the domain).

For more information about using infacmd, see the PowerCenter Command Reference.

Step 6. Start the Node

You must start the node before you can assign application services to run on the node. To start the node on Windows: 1. 2. 3. From the Start Menu, click Administrative Tools > Services. Double-click Informatica Services. Click Start.

To start the node on UNIX: 1. At the command prompt, switch to the directory where the infaservice executable is located. By default, infaservice installs in the following location:
<PowerCenter Installation Directory>/server/tomcat/bin

2.

At the command prompt, type the following command:

infaservice startup

Step 7. Assign Application Services to Run on the Node

When you remove a node from a PowerCenter domain, all application services that were running on the node are also removed. After moving the node to another PowerCenter domain, assign application services to run on the node in the following ways: Assign existing services in the new domain to run on the node. If you have the high availability option, you can assign existing services in the new domain to run on the node. You designate primary and backup nodes to run the service. By default, the service runs on the primary node. If the node becomes unavailable, the service fails over to a backup node. Create services to run on the node. Use the Administration Console or the infacmd command line program to create the services to run on the node. For more information, see the PowerCenter Administrator Guide or the PowerCenter Command Reference.

Author
Vijayaraghavan Amirisetty Software Engineer

Acknowledgements
Rupal Shah Senior Software Engineer QA Alison Taylor Technical Writer Girish Warrier Lead Technical Support Engineer