ifcli command

The ifcli command-line tool runs on any supported operating system. The ifcli tool accepts a build definition XML file as input and invokes the Installation Factory processing engine. The processing engine interprets the XML file, locates the product source files and maintenance packages, and then creates a customized installation package (CIP).

The ifcli tool is also referred to as the command-line interface tool or the command-line invocation tool for the Installation Factory.

Location of the command file

The command file is located in the /bin directory of the directory where you unpack the Installation Factory. The command file is a script named:

  • [AIX] [HP-UX] [Linux] [Solaris] ifcli.sh
  • [Windows] ifcli.bat

Logging

The ifcli command creates a build log file that shows whether the customized installation image is produced successfully. When the CIP is not successfully built, examine the trace file to determine what is wrong.

The following files record CIP creation data:

  • trace.xml is a detailed trace log in XML format
  • log.txt is the log file

The tracing and logging output and level are configurable as described in the logLevel and traceLevel parameters.

[AIX] [HP-UX] [Linux] [Solaris]

Syntax for the ifcli.sh command

Displaying help for the command: 

./ifcli.sh -help

Creating a customized installation package: 

./ifcli.sh -buildDef build_definition_file 
   -silent
   -logLevel log_level
   -logFile log_file_path_name 
   -traceLevel trace level
   -traceFile trace_file_path_name
[Windows]

Syntax for the ifcli.bat command

Displaying help for the command: 

ifcli.bat -help

ifcli.bat ?

Creating a customized installation package: 

ifcli.bat -buildDef build_definition_file 
   -silent
   -logLevel log_level
   -logFile log_file_path_name 
   -traceLevel trace level
    -traceFile trace_file_path_name

Parameters

Supported arguments include:

-? [Windows]
Shows usage information.
-buildDef build_definition_file
Identifies the build definition file that the Build Definition wizard creates.
-help
Shows usage information.
-logFile log_file_path_name
Identifies the log file. The default value is current_working_directory/logs/log.txt.
-logLevel log_level
Sets the level of logging. The default value is INFO. Valid values are:
  • ALL
  • CONFIG
  • INFO
  • WARNING
  • SEVERE
  • OFF (Turns off logging)
-silent
Specifies that the processing engine runs in silent mode, without displaying results to the console.
-traceFile trace_file_path_name
Identifies the trace file. The default value is current_working_directory/logs/trace.xml.
-traceLevel trace level
Sets the level of tracing. The default value is OFF. Valid values are:
  • ALL
  • FINE
  • FINER
  • FINEST
  • OFF (Turns off logging)

Using the customized installation package to install the product

Use the Installation Factory installer program for WebSphere Application Server products to install a customized installation package for a WebSphere Application Server product. Each supported product has its own installer program. See the install command for more information.

Related concepts
Customized installation package preview
Related tasks
Developing and installing customized installation packages
Related information
Build definition file install command