Troubleshooting Domains and Nodes
The installer can generate errors when creating and configuring domains and nodes during the Informatica installation.
You can encounter errors with the following installer tasks:
- •Adding the domain configuration database
- •Creating or joining a domain
- •Starting Informatica
- •Pinging the domain
- •Adding a license
Creating the Domain Configuration Repository
If you create a domain, the installer creates a domain configuration repository to store domain metadata. The installer uses the options you enter during installation to add configuration metadata to the domain configuration repository. The installer uses JDBC to communicate with the database. You do not need to configure ODBC or native connectivity on the machine where you install the Informatica services.
The installer creates and drops a table in the domain configuration repository database to verify the connection information. The user account for the database must have create privileges on the database. Each domain must have a separate domain configuration repository.
Creating or Joining a Domain
The installer completes different tasks depending on whether you create a domain or join a domain:
- •Creating a domain. The installer runs the infasetup DefineDomain command to create the domain and the gateway node for the domain on the current machine based on the information you enter in the Configure Domain window.
- •Joining a domain. The installer runs the infasetup DefineWorkerNode command to create a node on the current machine, and runs the infacmd AddDomainNode command to add the node to the domain. The installer uses the information you enter in the Configure Domain window to run the commands.
The infasetup and infacmd commands fail if the gateway node is unavailable. If the gateway node is unavailable, you cannot log in to Informatica Administrator.
For example, the DefineDomain command fails if you click Test Connection and the connection test passes but the database becomes unavailable before you click Next. The DefineDomain command can also fail if the host name or IP address does not belong to the current machine. Verify that the database for the domain configuration is available and that the host name is correct and try again.
If the AddDomainNode command fails, verify that the Informatica service is running on the gateway node and try again.
Starting Informatica
The installer runs infaservice to start the Informatica service. To troubleshoot issues when Informatica fails to start, use the information in the installation debug log and the node.log and catalina.out Service Manager log files to identify the cause of the error.
If you create a domain, log in to Informatica Administrator after the Informatica service starts to verify that the domain is available. If you join a domain, log in to Informatica Administrator after the Informatica service starts to verify that the node was successfully created and started.
Informatica can fail to start for the following reasons:
- •The Service Manager is out of system memory. The Java Runtime Environment (JRE) that starts Informatica and runs the Service Manager may not have enough system memory to start. Set the INFA_JAVA_OPTS environment variable to configure the amount of system memory used by Informatica. On UNIX, you can set the memory configuration when you start Informatica.
- •The domain configuration database is not available. Informatica fails to start on a node if the Service Manager on a gateway node cannot connect to the domain configuration database within 30 seconds. Verify that the domain configuration repository is available.
- •Some of the folders in the Informatica installation directory do not have the appropriate execute permissions. Grant execute permission on the Informatica installation directory.
Pinging the Domain
The installer runs the infacmd Ping command to verify that the domain is available before it continues the installation. The domain must be available so that license objects can be added to the domain. If the Ping command fails, start Informatica on the gateway node.
Adding a License
The installer runs the infacmd AddLicense command to read the Informatica license key file and create a license object in the domain. To run the application services in Informatica Administrator, a valid license object must exist in the domain.
If you use an incremental license and join a domain, the serial number of the incremental license must match the serial number for an existing license object in the domain. If the serial numbers do not match, the AddLicense command fails.
You can get more information about the contents of the license key file used for installation, including serial number, version, expiration date, operating systems, and connectivity options in the installation debug log. You can get more information about existing licenses for the domain in Informatica Administrator.