The ifcli command accepts a build definition XML file as input and invokes the IBM® WebSphere® 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) 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 WebSphere Installation Factory for details on supported platforms and other information.
./ifcli.sh -help
./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 -wasPath app_server_root -repositoryPath cim_repository_path -installationPackagePath installation_package_path -overwrite
ifcli.bat -help
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 -wasPath app_server_root -repositoryPath cim_repository_path -installationPackagePath installation_package_path -overwrite
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.
Option | Description |
---|---|
-? or -help | Specifies usage information. |
-buildDef build_definition_file | Specifies the build definition file that the Build Definition wizard creates. |
-logFile log_file | 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: |
-silent | Specifies that the processing engine runs in silent mode, without displaying results to the console. |
-traceFile fully_qualified_trace_file_path_name | Specifies 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: |
Option | Description |
---|---|
-wasPath app_server_root | Specifies the installation directory of the application server to configure with the CIM repository. |
-repositoryPath cim_repository_path | Specifies the directory of the CIM repository. If the repository will be shared with other installations, it is recommended that you create the repository outside the product installation directory. |
-installationPackagePath installation_package_path | Specifies the directory that contains the installation package to be added to the repository. |
-overwrite | Overwrites the existing installation package in the specified repository. |
Using the installation package to install the product
Use the IBM WebSphere Installation Factory 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.