infacmd commands reference guide

infacmd is a command line program that allows you to administer domains, users, and services. Use infacmd
to administer the following objects and services:

  • Application services and processes. Create, enable, disable, remove, and get the status of application
    services and the associated service processes. Ping services. List services and the nodes that run them.
    Update service processes and service process options. You cannot use infacmd to create services of a
    previous version.
  • Domain gateway. Update the gateway node connectivity information.
  • Domains. Link domains and remove domain links. Change the domain administrator password. Update
    domain options. Add and remove service levels.
  • Folders. Create, move, list, update, and remove folders. Move objects between folders.
  • Grids. Create and remove grids. List nodes in a grid.
  • Licenses. Add, remove, assign, unassign, and list licenses. Show license information.
  • Log events. Get and purge log events. Get session and workflow logs. Convert log files from binary to
    text format.
  • Nodes. Update, ping, shut down, and remove nodes. List node names and options. Update the node role.
    Add, enable, list, disable, and remove node resources. Change a node from a gateway node to a worker
    node or from a worker node to a gateway node. Calculate the CPU profile for a node.
  • Users. Create and remove users. Reset user passwords. Subscribe to and unsubscribe users from alerts.
    Assign users permission on objects. Enable user account lockout and unlock user accounts.

 

Running Commands

Invoke infacmd from the command line. You can issue commands directly or from a script, batch file, or other program.

To run infacmd commands:

  1. At the command prompt, switch to the directory where the infacmd executable is located. By default, infacmd installs in the following directory of the Informatica services installation:
    • [Informatica installation directory]/isp/bin
    • You can also install infacmd from the Informatica Installation DVD.
  2. Enter infacmd on Windows or infacmd.sh on UNIX followed by the plugin ID, the command name, and the required options and arguments. The command names are not case sensitive. For example:
    • infacmd(.sh) plugin_ID CommandName [-option1] argument_1 [-option2] argument_2…Command Options

When you run infacmd, you enter options for each command, followed by the required arguments. For example, most commands require that you enter the domain name, user name, and password using command options. Command options are preceded with a hyphen and are not case sensitive. Arguments follow the option.

To enter an argument that is preceded with a hyphen, enclose the argument in quotation marks using the backslash (\) as an escape character before each quotation mark. For example, the following command writes the log for the mapping run with the job ID “-qnLI7G_TEeW9olHBkc9hoA” to the file “MyLog.log” within the infacmd directory on Windows:

infacmd ms GetRequestLog -dn MyDomain -sn MyDIS -un AdminUser -pd password -id \”- qnLI7G_TEeW9olHBkc9hoA\” -f MyLog.log

If you omit or incorrectly enter one of the required options, the command fails and infacmd returns an error message.

You can use environment variables for some command options with infacmd. For example, you can store the default user name and password for a domain as environment variables so that you do not have to enter them using command options. Configure these variables before you use infacmd.

infacmd Return Codes

The infacmd program indicates the success or failure of a command with the following return codes:

  • 0 indicates that the command succeeded.
  • -1 indicates that the command failed.

infacmd options