[AIX HP-UX Linux Solaris Windows]This topic applies only on the i5/OS operating system.

ifcli command

The ifcli command accepts a build definition XML file as input and invokes the IBM Installation Factory for WebSphere Application Server 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) or integrated installation package (IIP). The command runs on any supported operating system.

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

See the Readme for IBM Installation Factory for WebSphere Application Server page for details on supported platforms and other information.

Location of the command file

The command file is located in the IF_root/bin, where IF_root is the directory where you unpacked the Installation Factory. The command file is the following:
  • [AIX] [HP-UX] [Linux] [Solaris] ifcli.sh
  • [Windows] ifcli.bat
  • [iSeries] ifcli
[AIX] [HP-UX] [Linux] [Solaris]

Syntax for the ifcli.sh command

Display help for the command:
./ifcli.sh -help
Create an installation package:
./ifcli.sh -buildDef build_definition_file 
   -silent
   -logLevel log_level
   -logFile fully_qualified_log_file_path_name 
   -traceLevel trace level
   -traceFile fully_qualified_trace_file_path_name                  
[Windows]

Syntax for the ifcli.bat command

Display help for the command:
ifcli.bat -help

Creating an installation package:
ifcli.bat -buildDef build_definition_file 
   -silent
   -logLevel log_level
   -logFile fully_qualified_log_file_path_name 
   -traceLevel trace level
    -traceFile fully_qualified_trace_file_path_name     

Logging

The ifcli command creates a build log file that shows whether the installation image is produced successfully. If it is not successfully built, then examine the trace file to determine the error.

The following files record installation package creation data:

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

Parameters

Supported arguments include:
-? [Windows]
Specifies usage information.
-buildDef build_definition_file
Specifies the build definition file that the Build Definition wizard creates.
-help
Specifies usage information.
-logFile fully_qualified_log_file_path_name
Specifies the log file. The default value is IF_root/logs/log.txt.
-logLevel log_level
Specifies 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 fully_qualified_trace_file_path_name
Identifies the trace file. The default value is IF_root/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 installation package to install the product

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




Reference topic Reference topic    

Terms and conditions for information centers | Feedback

Last updatedLast updated: Aug 31, 2013 1:23:07 AM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=pix&product=was-nd-dist&topic=rxml_ifcli
File name: rxml_ifcli.html