Install Liberty remotely on IBM i operating systems using the iRemoteInstall command

Install Liberty remotely on IBM i operating systems using the iRemoteInstall command

We can use the iRemoteInstall command to install IBM Installation Manager or WebSphere Application Server Liberty Core from a Windows workstation to a remote target IBM i system.

Prepare for the installation before using this procedure.
The product offering repository files or the IBM Installation Manager for IBM i installation kit compressed file must be available on the Windows system.
Important: You must set the JAVA_HOME environment variable to the IBM Installation Manager JRE home before running the command directly from the media.
Restrictions:

The iRemoteInstall command does not support credential-storage files used to pass confidential information You must use the physical media or download the installation files to your local system.

The iRemoteInstall command does not support the use of response files.

By running this script, you accept the terms of the product license. The relevant terms and conditions, notices, and other information are provided in the license-agreement files in the lafiles or offering_name/lafiles subdirectory of the installation image or repository for this offering.

Location of the iRemoteInstall command:

The iRemoteInstall command is located in the following directory when it has been installed as part of the WebSphere Customization Toolbox:
wct_root/Remote_Installation_Tool_for_IBM_i

A version of this utility that is current when the product is released is also available on the media or installation image. We can run the command directly from the media connected to a Windows system to install the offering on a remote target IBM i system. This version of the utility is located at the following location:
media_root\Remote_Installation_Tool_for_IBM_i\iRemoteInstall.bat
where media_root is the root directory of the media or installation image containing the product or supplements.

Syntax of the iRemoteInstall command:

iRemoteInstall.bat -hostname i5_hostname -username user_login_name -password user_login_password -iminstkit im_install_kit_file_path_and_name | -wasoid was_offering_id -wasrepoloc was_install_file_location -appdataloc im_agent_data_location -wasinstloc was_install_location -wassharedloc was_shared_location -features feature_ID_1,feature_ID_2, . . . -properties key=value,key=value, . . . -log log_file_path_and_name -trace -version -help

Parameters of the iRemoteInstall command:

-hostname i5_hostname

The host name of the target IBM i machine to which Installation Manager or WebSphere Application Server Liberty Core is going to be installed
Required.

-username user_login_name

Login name of the user who is performing the Installation Manager or WebSphere Application Server Liberty Core remote installation
This user must be a valid user for the target IBM i system with *ALLOBJ and *SECADM special authorization.

-password user_login_password

Login password of the user specified in -username

-iminstkit im_install_kit_file_name

Location of the Installation Manager for IBM i installation kit
We must include the path if it is not in the same directory as the command.
This parameter is required.

-wasoid was_offering_id

ID of the WebSphere Application Server Liberty offering being installed
Example values are base, nd, express, etc. This parameter is not case sensitive.
The value to use can be found in the product offering ID. If the offering ID is com.ibm.websphere.liberty.XXX.v85, for example, the -wasoid value should be liberty.XXX.

-wasrepoloc was_install_file_location

Location of the WebSphere Application Server Liberty Core installation repository
This option must be specified if the -wasoid parameter is specified.

-appdataloc im_agent_data_location

Location of the Installation Manager agent data
If no value is specified for this parameter, it is set to the default value of /QIBM/UserData/InstallationManager.

-wasinstloc was_install_location

Location of the WebSphere Application Server Liberty Core installation
If no value is specified for this parameter, it is set to the default value of /QIBM/WAS85/Liberty.

-wassharedloc was_shared_location

Location of the WebSphere Application Server Liberty Core shared location
If no value is specified for this parameter, it is set to the default value of /QIBM/WAS85/Liberty_Shared.

-features feature_ID_1,feature_ID_2, . . .

Features to be installed
The feature IDs must be separated by commas (,).
If no features are specified, the default feature (embeddablecontainer) is installed.

-properties key=value,key=value, . . .

Specifies package-group (profile) properties

-log log_file_path_and_name

Turns on the log, and sends all messages to the specified file and location
The path can be absolute (c:\temp\mylog.log for exampled) or relative (..\mylog.log for example).
Because we can append multiple installation actions into the same log, the actual name of a log file generated is log_file_path_and_name.x.log, where x is the number of the log file from 0 to 29. The maximum log file size is approximately 10 MB; and the maximum number of log files generated is 30.

-trace

Provides trace output of what the command checks and what the command discovers

-version

Display the version information for the command

-help

Displays usage information for the command

Log in to the IBM i machine using the IBM Personal Communications tool, or telnet with TN5250 to the IBM i machine.

If TCP/IP is not started or if we do not know if TCP/IP is started, enter the following command on the Control Language (CL) command line:
STRTCP

Verify that the host server jobs are started on the IBM i server.
The host server jobs allow the installation code to run on IBM i.
Enter the following command on the CL command line:
STRHOSTSVR SERVER(*ALL)

Verify that the user profile has *ALLOBJ and *SECADM special authorities.

Run the iRemoteInstall command in the temporary directory to install Installation Manager or Websphere Application Server Liberty Core.
To install Websphere Application Server Liberty Core, Installation Manager must already be installed on the target system.

Verify the installation.

Check for error messages in the output from the iRemoteInstall command.

Look for errors in the installation log.

Example

Here is an example of installing IBM Installation Manager with the iRemoteInstall command:
./iRemoteInstall -hostname iserver1.somedomain.com -username wasadmin -password mypwd -iminstkit E:\agent.installer.os400.motif.ppc_1.6.2000.20101206_0100.zip

Here is an example of installing WebSphere Application Server Liberty Core with the iRemoteInstall command:
./iRemoteInstall -hostname iserver1.somedomain.com -username wasadmin -password mypwd -wasoid liberty.CORE -wasrepoloc E:\repository

Parent topic:

Install Liberty on IBM i operating systems
Tasks:

Install Liberty on IBM i operating systems using the command line

Install Liberty on IBM i operating systems using response files

Add and remove features from Liberty on IBM i operating systems using response files

Verify the installation

Uninstall Liberty from IBM i operating systems using the command line

Uninstall Liberty from IBM i operating systems using response files

Install Liberty interim fixes on IBM i operating systems using the command line

Install Liberty fix packs on IBM i operating systems using the command line

Install Liberty fix packs on IBM i operating systems using response files

Uninstall Liberty interim fixes from IBM i operating systems using the command line

Uninstall Liberty fix packs from IBM i operating systems using the command line

Uninstall Liberty fix packs from IBM i operating systems using response files

Terms and conditions for information centers