Configuring the Command Line Utilities
Configure the path and environment variables as required by the command line utilities. Grant execute permission on the utility files to user accounts that run the commands.
Configure the Informatica Utilities
Configure the environment variables required for the infacmd and infasetup command line programs.
To run infacmd, set the ICMD_JAVA_OPTS environment variable.
To run infasetup, set the INFA_JAVA_CMD_OPTS environment variable.
Configure the PowerCenter Utilities
Before you run the PowerCenter utilities, use the following guidelines to configure the program files and variables:
- •To run pmrep, pmcmd, and pmpasswd, copy the domains.infa file for the Informatica domain to the utilities directory.
- •To run pmrep, pmcmd, and pmpasswd on UNIX, set the INFA_HOME, PATH, and library path environment variables to the location of the utilities.
For example, if the command line utilities are installed in the /data/Informatica_cmd_utilities/ folder, then the PowerCenter utilities are located in the /data/Informatica_cmd_utilities/PowerCenter/server/bin folder. On Linux, you can set the environment variables at the command prompt as follows:
setenv INFA_HOME /data/Informatica_cmd_utilities/PowerCenter/
setenv PATH .:/data/Informatica_cmd_utilities/PowerCenter/server/bin:$PATH
setenv LD_LIBRARY_PATH .:/data/Informatica_cmd_utilities/PowerCenter/server/bin:$LD_LIBRARY_PATH
Note: Restart the machine after you configure the INFA_HOME or library path environment variable.
Configure the Metadata Manager Utilities
To configure the Metadata Manager utilities, configure environment variables that specify the location of the Java Virtual Machine and the Informatica root directory. You must also verify the shared library location for Solaris.
If the domain uses Kerberos authentication, create the domains.infa file. Metadata Manager command line programs use the domains.infa file to get gateway connectivity information for the domain.
Configure the following environment variables:
- JAVA_HOME
Specifies the location of the Java Virtual Machine. Set JAVA_HOME to the PowerCenter Java directory in the command line utilities installation. For example:
<Utilities installation directory>\PowerCenter\java
Set this environment variable in each Metadata Manager command line program as follows:
- 1. Open the batch file or shell script with a text editor.
- 2. Find the line that sets JAVA_HOME to @INFA_JDK_HOME@.
- 3. Replace the string @INFA_JDK_HOME@ with the PowerCenter Java directory. For example:
set JAVA_HOME=C:\InfaUtilities\PowerCenter\java
- 4. Save and close the batch file or shell script.
- INFA_HOME
Specifies the Informatica root directory so that any Informatica application or service can find the other Informatica components that it needs to run. Set INFA_HOME to the PowerCenter directory in the command line utilities installation. For example:
<Utilities installation directory>\PowerCenter
Set this environment variable on each machine where you installed the Informatica utilities.
- LD_LIBRARY_PATH
Required for Solaris. Specifies the shared library location. Verify that the LD_LIBRARY_PATH environment variable contains the following directories:
${JAVA_HOME}/jre/lib/sparcv9/server:${JAVA_HOME}/jre/lib/sparcv9/jli
Set this environment variable on each machine where you installed the Informatica utilities.
Note: Restart the machine after you configure the INFA_HOME or LD_LIBRARY_PATH environment variable.
Create the domains.infa File
The domains.infa file contains the gateway connectivity information for the domain. When the domain uses Kerberos authentication, create the domains.infa file so that the command line programs can get the gateway connectivity information for the domain.
If the domain uses Kerberos authentication, you must enter domain connectivity information when you run the command line program commands. You enter domain connectivity information through the --domainName option or the --gateway option. To use the --domainName option, the domains.infa file must contain the domain gateway connectivity information. If the domains.infa file does not exist or the information in the file is out of date, you must use the --gateway option when you run any command that connects to the domain.
When you install Informatica services, the domains.infa file is available in the INFA_HOME directory. For any other installation, create the file and verify that it is available on the machine from which you want to run the commands.
To create the domains.infa file, run the infacmd isp UpdateGatewayInfo command. The command creates or updates the domains.infa file in the PowerCenter directory in the command line utilities installation, for example, <Utilities installation directory>\PowerCenter.