An integrated installation package (IIP) contains an application programming interface (API) which allows an application to launch the IIP installer and retrieve information pertaining to the running install. The API provides a standardized way to retrieve installation status and progress. The API requires that the application server installer be contained within an IIP and is unavailable for the standalone application server installer.
The following Java classes are available to interface with the IIP controller.
The IIPInstallerCLIInterface is the main interface into the IIP controller. From the IIPInstallerCLIInterface all objects that are used by the IIP are initialized where the IIP is launched.
The IIPResults object contains the result information for the IIP that was run. Installation status constants:
The InstallationProgressListener object contains the installation progress information for both the IIP as a whole as well as for each individual invocation.
The IIPArguments object contains all the arguments that are passed into an IIP for all contributions.
Use the following example to create and initialize an API interface object, launch the IIP, and retrieve the installation status.
import com.ibm.ws.install.factory.iip.engine.impl.IIPInstallerCLIInterfaceImpl; import com.ibm.ws.install.factory.iip.engine.IIPArguments; import com.ibm.ws.install.factory.iip.engine.IIPResults; import com.ibm.ws.install.factory.iip.engine.IIPInstallerCLIInterface; IIPInstallerCLIInterface wasIIP = new IIPInstallerCLIInterfaceImpl(“/IIPHome”); String[] options = {IIPArguments.IIP_NOGUI_ARG, “-OPT installLocation=/opt/IBM/WebSphere/AppServer”}; wasIIP.initialize(options); int wasInstallStatus = wasIIP.runIIP();
Read the "install command" topic for more information on installation codes.
Requirements