Portal Express, Version 6.0
Operating systems: i5/OS, Linux, Windows
Install with a response file
Using a response file, you can install IBM® WebSphere® Portal Express without entering any information during the installation itself.
Information you would normally enter as the installation progresses is instead gathered from the response file, which you can edit in advance to suit your needs.
Installing with a response file is well suited to situations where the use of a graphical installation program is impractical or undesirable, or where you want to install WebSphere Portal Express on multiple machines with a similar setup.
A sample response file, installresponse.txt, is located in the root directory of the Setup CD. Using a text editor, you can modify the values in this response file and use the Save as function to save the new response file to your local file system.
- Notes on installing WebSphere Portal Express with a response file
- Response file parameters
- Local install
- Remote install
Notes on installing WebSphere Portal Express with a response file
- Hardware and software prerequisites should already be installed. Ensure that you have met the hardware and software prerequisites on the machine where you are installing WebSphere Portal Express, specifically for the memory and hard disk requirements.
- You can override values in the response file by entering them on the command line itself. See the list of parameters below.
- All values MUST BE ENCLOSED in double quotes ( "" ).
- The response file you want to use must be on the same system as the Setup CD. In other words, if you are installing locally, the response file you want to use for the installation must be saved on your IBM System i5 server. If you are installing remotely, the file must be saved on your Microsoft Windows PC.
- Only use the response file parameters documented here. The example response file may include parameters that are not valid for this version of WebSphere Portal Express.
- You cannot install two profiles of the portal server at the same time, even in different directories. You must install each portal server completely before beginning the installation of the next one.
Response file parameters
The following parameters can be specified in the response file or directly on the command line when issuing the install command. All values MUST BE ENCLOSED in double quotes ( "" ).| Parameter default | Description |
|---|---|
| -silent |
SILENT INSTALL CHOICE Description: Specify this parameter if you want to install WebSphere Portal Express silently. When installing silently, the installation program will not display any graphical interface panels or solicit input from the user. If a required parameter is not specified in this response file, an error message will be logged. If you want to use this response file but do not want to install silently, comment the parameter out.
|
| -G licenseAccepted="false" |
LICENSE ACCEPTANCE Description: This parameter specifies that you accept the license agreement for WebSphere Portal Express. By default it is set to false. You must set it to true for the silent install to complete successfully: -G licenseAccepted="true" |
| -W cdSetup.cdPath="/cdimg/I-Setup" |
SETUP CD LOCATION
Required for: Traditional and Archive install
Description: Specify the directory path to the Setup CD. Although this can be to a CD-ROM drive, for unattended installation this location is more likely to be a directory where electronic product images are stored, such as on a network drive.
Be sure to follow the convention for specifying path information on your platform.
|
| -W archiveMediaPanel1.cdPath="/cdimg/I-3" |
ARCHIVE CD 1
Description: Specify the directory path to the first archive install image.
|
| -W archiveMediaPanel2.cdPath="/cdimg/I-4" |
ARCHIVE CD 2
Description: Specify the directory path to the second archive install image.
|
| -W userInputCDLocProfile.cdPath="/cdimg/I-5" |
ARCHIVE CD 3
Description: Specify the directory path to the third archive install image.
|
| -W basicConfig.choice="yes" |
BASIC CONFIGURATION OPTION (System i5 ONLY)
Description: Specify whether you want to perform basic configuration of WebSphere Portal Express automatically when WebSphere Portal Express is installed. Although typically you will perform basic configuration automatically, there might be some situations where you want to install WebSphere Portal Express without performing configuration.
Note that if you do not perform configuration during installation, rerun the installation program to perform the configuration steps and completely install WebSphere Portal Express.
Values:
|
| -W iSeriesdetectProfileAction.profileName="profile_root" |
USER SPECIFIED PROFILE NAME OPTION (System i5 ONLY) Description: Specify the name of WebSphere Application Server profile to be created, where profile_root is the name of your WebSphere Application Server profile where WebSphere Portal Express is installed. An example is -W iSeriesdetectProfileAction.profileName="wp_profile9" Enter option all on one line. |
| -W iSeriesStartingPort.startingPort="port_number" |
USER SPECIFIED STARTING PORT for WebSphere Application Server PROFILE CREATION (System i5 ONLY) Specify the starting port that will be used in creating the WebSphere Application Server profile. An example is -W iSeriesStartingPort.startingPort="12345" The value provided for the starting port must be resolved prior to running the installation. When the value is specified as an argument, the installation program accepts it as provided and does not verify that the specified port is resolved. Using a port that is not resolved may interfere with other applications using the same ports on the same system. For example, if there is an existing profile using the same port block range, you will not be able to stop or start that profile once the second profile is configured. |
| # -W emptyPortal.active="True" |
INSTALL AN EMPTY WebSphere Portal Express
Description: Specify that WebSphere Portal Express is to be installed without portlets or pages. This parameter is useful when you want to transfer an entire portal configuration from one portal to another, for example transferring a test portal environment to a production portal environment.
Values: The default value is "True" but the line is commented out. If you wish to use this parameter just remove the preceding pound sign '#' .
|
Install WebSphere Portal Express locally with a response file
To install WebSphere Portal Express locally on your System i5 system, follow the instructions below:
- Insert the WebSphere Portal Express Setup CD into your System i5 system.
- Open an OS/400 command prompt and start the Qshell Interpreter by entering the following:
STRQSH
- Change to the PortalExpress directory of the CD by entering the following:
cd /qopt/cd_root/PortalExpress
where cd_root is the root directory of the WebSphere Portal Express Setup CD.
- Enter the following to start installation:
install.sh -options "path_to_file/filename.txt"
where path_to_file is the full path to the response file containing the values you want to use for the installation, and filename.txt is the name of the file.
- For security reasons, remove all user IDs and passwords from the response file when installation has completed.
- Continue the installation process with Document Rendering on i5/OS.
- When performing certain tasks within Portal, you might need to increase your JVM heap size; see Setting the JVM max heap size for information about when and how to increase your heap size.
Install WebSphere Portal Express remotely with a response file
To install WebSphere Portal Express remotely from a Windows workstation connected to your System i5 system, follow the instructions below:
- If you are installing on a machine with a firewall enabled, it is recommended that you disable the firewall before beginning installation.
- Insert the WebSphere Portal Express Setup CD.
- Open a DOS command prompt and change to the PortalExpress directory of the CD. For example, to change from the C:\ drive to the CD PortalExpress directory on drive E:\, you would enter the following:
cd /D E:\cd_root\PortalExpress
where cd_root is the root directory of the WebSphere Portal Express Setup CD. Note that the /D command is only necessary when changing from one drive to another.
- Enter the following to start installation:
install400.bat ISERIES_SYSTEM USER_ID PASSWORD -options path_to_file/filename.txt
where ISERIES_SYSTEM is the name of the System i5 system on which you are installing WebSphere Portal Express, USER_ID and PASSWORD are the user ID and password you use to log on to that system, path_to_file is the full path to the response file containing the values you want to use for the installation, and filename.txt is the name of the file.
- For security reasons, remove all user IDs and passwords from the response file when installation has completed.
- Continue the installation process with Document Rendering on i5/OS.
You can install more than one copy of WebSphere Portal Express on the same machine and have each WebSphere Portal Express operate independently of the others. Each copy of WebSphere Portal Express will be installed on a separate WebSphere Application Server profile.
If a full installation has already been completed, re-invoke the installation program to add more than one portal on the same System i5 server where WebSphere Portal Express was installed.
- When performing certain tasks within WebSphere Portal Express, you might need to increase your JVM heap size; see Setting the JVM max heap size for information about when and how to increase your heap size.
- Disable WebSphere Application Server informational logging by running the following command:
CHGJOBD JOBD(QWAS6/QWASJOBD) LOG(4 00 *NOLIST)