Installing IBM Rational Publishing Engine clients for design use silently

You can install the IBM® Rational® Publishing Engine clients unattended for users in your organization by using the silent installation capabilities of IBM Installation Manager. You can create a response file with the commands and inputs that are needed during the installation process or you can enter commands and inputs individually from a command-line utility.

Before you begin

If you have another version of Rational Publishing Engine already installed, close all open Rational Publishing Engine applications.

About this task

You can enter the following optional properties in your response file or from a command-line installation:
Table 1. Optional Rational Publishing Engine installation properties
Property Description
user.RCL_PortAtHost You can specify a license key for the client applications.

Example: user.RCL_PortAtHost=license_key_value

user.rpe_hideDesktopShortcuts You can choose prevent the creation of desktop shortcuts for the client applications.

Example: user.rpe_hideDesktopShortcuts=true

user.rpe_remoteWebServicesLocation You can specify a URL to the Remote services application. If the property and URL are specified during installation, the URL cannot be edited from the Remote services preferences in the client applications.

Example: user.rpe_remoteWebServicesLocation=http://server:port/rpews/

For more information about installing by using Installation Manager, see the IBM Installation Manager 1.6.3.1 Information Center.

Installing by using a response file

By creating a response file, you can save a list of features to install with the preferences that are to be applied to each one. Then, you can run a command to install using the information stored in the response file on as many computers as you need to install the software on.

Before you begin

Create a response file, which is an XML document where you define your preferences in the following format:
<preference
	name="the key of the preference"
	value="the value of the preference to be set">
</preference>
Depending on the features that you want to install and other parameters, you can create different response files for different installations.
Example response file:
<?xml version="1.0" encoding="UTF-8"?>
<agent-input>
	<server>
		<repository location='path\to\repository\cic-metadata'/> 
		<!-- during the record stage this would get populated with the actual repository folder -->
	</server>

	<profile id='IBM Rational Publishing Engine' installLocation='C:\Program Files (x86)\IBM\Rational\Publishing Engine'>
		<data key='eclipseLocation' value='C:\Program Files (x86)\IBM\Rational\Publishing Engine'/>
		<data key='user.import.profile' value='false'/>
		<data key='cic.selector.os' value='win32'/>
		<data key='cic.selector.ws' value='win32'/>
		<data key='cic.selector.arch' value='x86'/>
		<data key='user.server_type' value='MANUAL'/>
		<data key='user.server_version' value='0'/>
		<data key='user.help.option' value='remote'/>
		<data key='user.help.url' value=''/>
		<data key='user.RCL_PortAtHost' value='port@server'/> 
		<!-- optional, can be provided later to the TELELOGIC_LICENSE_FILE env var -->
		<data key='user.rpe_remoteWebServicesLocation' value='http://server:port/rpews'/> 
		<!-- optional -->
		<data key='user.rpe_hideDesktopShortcuts' value='false'/> 
		<!-- optional, can be set to true if needed -->
		<data key='cic.selector.nl' value='en'/>
	</profile>

	<install modify='false'>
		<!-- the version attribute gets populated during the record stage with the actual version/build number -->
		<offering id='com.ibm.rational.rpe.offering' version='1.2.1.RPEvvv-buildNumber' profile='IBM Rational Publishing Engine' features='com.ibm.rational.rpe.launcher,com.ibm.rational.rpe.core,com.ibm.rational.rpe.studio' installFixes='none'/>
	</install>

	<preference name='com.ibm.cic.common.core.preferences.eclipseCache' value='C:\Program Files (x86)\IBM\IMShared'/>
	<preference name='com.ibm.cic.common.core.preferences.connectTimeout' value='30'/>
	<preference name='com.ibm.cic.common.core.preferences.readTimeout' value='45'/>
	<preference name='com.ibm.cic.common.core.preferences.downloadAutoRetryCount' value='0'/>
	<preference name='offering.service.repositories.areUsed' value='true'/>
	<preference name='com.ibm.cic.common.core.preferences.ssl.nonsecureMode' value='false'/>
	<preference name='com.ibm.cic.common.core.preferences.http.disablePreemptiveAuthentication' value='false'/>
	<preference name='http.ntlm.auth.kind' value='NTLM'/>
	<preference name='http.ntlm.auth.enableIntegrated.win32' value='true'/>
	<preference name='com.ibm.cic.common.core.preferences.preserveDownloadedArtifacts' value='true'/>
	<preference name='com.ibm.cic.common.core.preferences.keepFetchedFiles' value='false'/>
	<preference name='PassportAdvantageIsEnabled' value='false'/>
	<preference name='com.ibm.cic.common.core.preferences.searchForUpdates' value='false'/>
	<preference name='com.ibm.cic.agent.ui.displayInternalVersion' value='false'/>
	<preference name='com.ibm.cic.common.sharedUI.showErrorLog' value='true'/>
	<preference name='com.ibm.cic.common.sharedUI.showWarningLog' value='true'/>
	<preference name='com.ibm.cic.common.sharedUI.showNoteLog' value='true'/>
</agent-input>

See Recording a response file with Installation Manager.

Procedure

To run the command to install by using a response file:

  1. Open command-line utility.
  2. Navigate to the tools of the Installation Manager application files.
  3. Run the installation command:
    imcl input response_file_path_and_name 
    	[ encryptString stringToEncrypt ]
    	[ -keyring keyring_file -password password ]
    	[ -log log_file_path_and_name ] 
    	[ -acceptLicense ]

Installing from the command line

You can install a package from the command line without creating a response file to do so.

Procedure

To install from the command line:

  1. Open command-line utility.
  2. Navigate to the tools of the Installation Manager application files.
  3. Run the installation command:
    imcl install packageID[_version][,featureID] 
    	-repositories source_repository 
    	-acceptLicense 
    	-installationDirectory installation_directory 
    	[ encryptString stringToEncrypt ]
    	[ -eclipselocation eclipse_directory ]
    	[ -installFixes none|recommended|all ] 
    	[ -keyring keyring_file -password password ]
    	[ -sharedResourcesDirectory shared_directory ] 
    	[ -preferences preference_key=value ] 
    	[ -properties user.RCL_PortAtHost=license_key_value,user.rpe_hideDesktopShortcuts=true,
    		user.rpe_remoteWebServicesLocation=http://server:port/rpews/,
    		key_3=value_3a,,value_3b,key_4=value_4 ] 
    Note: If a Remote services application URL is entered during installation, the URL cannot be edited from the Remote services preferences.

Feedback