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). The ifgui command can create the package in connected or unconnected mode.

The ifgui command is also referred to as the Build definition wizard for the Installation Factory.

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] ifgui.sh
  • [Windows] ifgui.bat

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:

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 refresh packs, fix packs, and interim fixes, or because of insufficient disk space.

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

Syntax for the ifgui.sh command

Displaying help for the command:
./ifgui.sh -help
Creating a build definition:
./ifgui.sh 
   -loglevel log_level
   -logfile fully_qualified_log_file_path_name 
   -tracelevel trace_level
   -tracefile fully_qualified_trace_file_path_name      
[Windows]

Syntax for the ifgui.bat command

Displaying help for the command:
ifgui.bat -help

ifgui.bat ?
Creating a build definition:
ifgui.bat 
   -loglevel log_level
   -logfile fully_qualified_log_file_path_name 
   -tracelevel trace level
   -tracefile fully_qualified_trace_file_path_name     

Parameters

Supported arguments include:
-? [Windows]
Specifies usage information.
-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)
-tracefile fully_qualified_trace_file_path_name
Specifies the trace file. The default value is IF_root/logs/trace.xml.
-tracelevel trace level
Specifies 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.




Reference topic    

Terms of Use | Feedback

Last updated: Aug 29, 2010 7:21:45 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=vela&product=was-nd-dist&topic=rxml_ifgui
File name: rxml_ifgui.html