ifgui command

The ifgui command launches the IBM Installation Factory for WebSphere Application Server console and creates a build definition XML file that identifies configuration information about the products to include in the customized installation package (CIP) or integrated installation package (IIP). The ifgui tool can create the package in connected or unconnected mode.

The ifgui tool is also referred to as the Build definition wizard for the Installation Factory. Although the ifcli command-line version of the Installation Factory is supported for all V6.1 platforms with the exception of z/OS, the Installation Factory console (ifgui) is supported for the following operating systems:

• AIX

• Windows 2000

• Windows 2003

• Solaris SPARC 32-bit

• Linux RHEL

• Linux SLES

• HP-UX

The Installation Factory uses a version of IBM Eclipse Software Development Kit (SDK) that supports 64-bit operating systems in headless mode only without a user interface. As a result, the ifgui command is not available on 64-bit operating systems.

Location of the command file

• ifgui

Logging

The ifgui command creates a log file that shows whether the build definition file is produced successfully. In connected mode, the log also contains information about package creation. When the build definition file is not successfully built, examine the trace file to determine what is wrong.

The following files record build file definition data:

• IF_working_directory/logs/trace.xml is a detailed trace log in XML format

• IF_working_directory/logs/log.txt is the log file

The tracing and logging output and level are configurable as described in the loglevel and tracelevel parameters.

The success indicator is INSTCONFSUCCESS.

Common problems that can cause failure include mismatched fix packs and interim fixes, or because of insufficient disk space.

Parameters

-help

Shows usage information.

-logfile fully_qualified_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)

-tracefile fully_qualified_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 build definition file to create an installation package

Use the build definition file in connected mode to create a build definition file and generate the installation package from within the wizard or use disconnected mode to create the build definition file as input for the ifcli command on another machine. See the description of the ifcli command for more information.

Related tasks

Related Reference

Related information

Reference topic