Moving a Node to Another Informatica Domain

© 2014 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. All other
company and product names may be trade names or trademarks of their respective owners and/or copyrighted
materials of such owners.
Abstract
If you have multiple Informatica domains that each contain multiple nodes, you can move a node from one domain to
another domain. This article describes how to remove a node from one domain and add it to another domain.

Supported Versions
• Data Services 9.0.1 - 9.6.1
• Data Quality 9.0.1 - 9.6.1
• PowerCenter 9.0.1 - 9.6.1

Table of Contents
Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Step 1. Reassign Application Services that Run on the Node. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Step 2. Shut Down the Node. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Step 3. Back Up Files on the Node. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Step 4. Remove the Node from the Old Domain. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Step 5. Copy the Encryption Key File from the New Domain. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Step 6. Define a Node in the New Domain. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Step 7. Add the Node to the New Domain. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Step 8. Start the Node. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Step 9. Assign Application Services to Run on the Node. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Overview
If you have multiple Informatica domains that each contain multiple nodes, you can move a node from one domain to
another domain. For example, you might decide that the production domain requires an additional node. You can move
a node from the development domain to the production domain.

Note: If you have a domain with a single node, you can move the node to another domain. However, no application
service can run in the old domain until you add a node to it.

To move a node from one domain to another domain, perform the following steps:

1. Reassign application services that run on the node.

2. Shut down the node.
3. Back up files on the node.
4. Remove the node from the old domain.
5. For Informatica versions 9.6.0 or later, copy the encryption key file from the new domain.
6. Define a node in the new domain.
7. Add the node to the new domain.
8. Start the node.
9. Assign application services to run on the node.

2
Step 1. Reassign Application Services that Run on the Node
Before you remove the node from the old domain, reassign any application services that run on the node to another
node in the old domain.

Tip: When you view the Processes view for the node in the Administrator tool, you can view all application services
that are assigned to run on the node.

1. In the Administrator tool, click the Domain tab.

2. In the Navigator, select an application service that you must reassign to another node.
3. Click Actions > Disable Service.
4. In the Properties view for the application service, click Edit in the General Properties section.
5. Select another node for the application service to run on, and then click OK.
6. Click Actions > Enable Service.
7. Repeat steps 1 to 6 for each application service that runs on the node that you are moving to a new domain.

Step 2. Shut Down the Node

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

Shutting Down the Node from the Administrator Tool

1. In the Administrator tool, click the Domain tab.
2. Select the node in the Navigator.
3. Click Actions > Shutdown Node.
The Administrator tool displays the list of service processes running on that node.
4. Click OK to stop all processes and shut down the node.

Stopping the Node on Windows

1. Open the Windows Control Panel.
2. Select Administrative Tools.
3. Right-click Services and select Run as Administrator.
4. Right-click the Informatica service and click Stop.

Stopping the Node on UNIX

1. At the command prompt, go to the directory where infaservice.sh is located.
By default, infaservice.sh is installed in the following directory:
<Informatica installation directory>/tomcat/bin
2. Enter the following command to stop the Informatica daemon:
infaservice.sh shutdown

Step 3. Back Up Files on the Node

Before you remove the node from the old domain, back up files that are overwritten when you move the node to a new
domain. The files that you must back up depend on the Informatica version that you are using.

Back up the following files:

3
nodemeta.xml

For all Informatica versions, create a back up of the nodemeta.xml file by copying it to another location
outside the Informatica services installation directory.

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 repository database. A worker node uses the
information in nodemeta.xml to connect to the domain. The metadata file is stored in the following directory:

<Informatica installation directory>/isp/config

Encryption key file named siteKey

For Informatica versions 9.6.0 or later, create a back up of the encryption key file named siteKey by copying
it to another location outside the Informatica services installation directory.

Note: Informatica versions earlier than 9.6.0 do not use an encryption key file.

The encryption key file stores the encryption key for the domain. Informatica uses the encryption key to
encrypt sensitive data, such as passwords and secure connection parameters, before it stores the data in
Informatica repositories. All nodes in a domain must have access to the same encryption key file.

By default, the encryption key file is located in the following directory in version 9.6.0:

<Informatica installation directory>/isp/config/secret

The encryption key file is located in the following directory in version 9.6.1:

<Informatica installation directory>/isp/config/keys

Step 4. Remove the Node from the Old Domain

Use the Administrator tool to remove the node from the old domain.

1. In the Administrator tool, click the Domain tab.

2. Select the node in the Navigator.
3. In the Navigator Actions menu, click Delete.
4. In the warning message that appears, click Yes.

Step 5. Copy the Encryption Key File from the New Domain
For Informatica versions 9.6.0 or later, copy the encryption key file from the new domain to the node that you are
moving. All nodes in a domain must have access to the same encryption key file.

Note: Informatica versions earlier than 9.6.0 do not use an encryption key file. For versions earlier than 9.6.0, skip to
“Step 6. Define a Node in the New Domain” on page 5.

1. Find the encryption key file on the master gateway node in the new domain.
By default, the encryption key file is located in the following directory in version 9.6.0:
<Informatica installation directory>/isp/config/secret
The encryption key file is located in the following directory in version 9.6.1:
<Informatica installation directory>/isp/config/keys
2. Copy the encryption key file from the master gateway node in the new domain to the encryption key directory
on the node that you are moving.
When you copy the file, overwrite the existing siteKey file that was used in the old domain.

4
Step 6. Define a Node in the New Domain
You can define the node to function as a gateway node or a worker node in the new domain.

Run the infasetup DefineGatewayNode command to define a gateway node in the new domain. Run the infasetup
DefineWorkerNode command to define a worker node in the new domain. Both commands overwrite the nodemeta.xml
file that stores the configuration metadata for the node.

By default, infasetup is installed in the following directory:

<Informatica installation directory>/isp/bin

For Informatica versions 9.6.0 or later, you must specify the encryption key directory when you run the command. The
command option depends on the following versions:

Version 9.6.0

For Informatica version 9.6.0, specify the following option when you run the infasetup DefineGatewayNode or
DefineWorkerNode command:

Option Argument Description

-SecretKeysDirectory Infa_secrets_directory_location Optional. Directory on the node that you are moving in
-skd which the encryption key file named siteKey is stored.
Default is <Informatica installation
directory>/isp/config/secret.

Version 9.6.1

For Informatica version 9.6.1, specify the following option when you run the infasetup DefineGatewayNode or
DefineWorkerNode command:

Option Argument Description

-KeysDirectory Infa_keys_directory_location Optional. Directory on the node that you are moving in which
-kd the encryption key file named siteKey is stored.
Default is <Informatica installation
directory>/isp/config/keys.

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

Step 7. Add the Node to the New Domain

After you define the node for the new domain, you must add the node to the new domain. Run the infacmd isp
AddDomainNode command to add the node to the domain. You can also add the node to the domain using the
Administrator tool.

By default, infacmd is installed in the following directory:

<Informatica installation directory>/isp/bin

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

5
Step 8. Start the Node
You must start the node before you can assign application services to run on the node.

Starting the Node on Windows

1. Open the Windows Control Panel.
2. Select Administrative Tools.
3. Right-click Services and select Run as Administrator.
4. Right-click the Informatica service and click Start.

Starting the Node on UNIX

1. At the command prompt, go to the directory where infaservice.sh is located.
By default, infaservice.sh is installed in the following directory:
<Informatica installation directory>/tomcat/bin
2. Enter the following command to start the Informatica daemon:
infaservice.sh startup

Step 9. Assign Application Services to Run on the Node

After moving the node to the new domain, assign existing application services in the new domain to run on the node or
create application services to run on the node.

Assign application services to run on the node in the following ways:

Assign existing services in the new domain to run on the node.

Use the Administrator tool to disable existing application services that you want to run on the node. Edit the
general properties of the application services so that you can assign the services to run on the node. Then,
enable the application services. For more information, see the Informatica Application Services Guide.

Create services to run on the node.

Use the Administrator tool or the infacmd command line program to create application services to run on the
node. For more information, see the Informatica Application Services Guide or the Informatica Command
Reference.

Author
Alison Taylor
Senior Technical Writer

Acknowledgements
The author would like to acknowledge Vijay Anand P and Girish Warrier for their contributions to this article.