Install with the console interface

Portal Express, Version 6.0
Operating systems: i5/OS, Linux, Windows

Install with the console interface

+
Search Tips | Advanced Search

Overview
Local install
Remote install

Overview

The console interface is available for both local and remote installation with the Install and Configure and Install Only options.
An edition of WebSphere Application Server must be installed prior to beginning a WebSphere Portal Express install. The portal installation program automatically creates a WAS profile based on the WAS edition installed, for use with WebSphere Portal Express.
If more than one edition is installed, you will be asked to choose one. The installation program assigns a default profile name of wp_profile. If this profile already exists, then the profile name becomes wp_profilex, where x is 1 or the next available number. There is no maximum number of profiles set. Pre-existing profiles will not work; they may not have the right level of additional function required to run WebSphere Portal Express for System i5.
Upon completion of a local installation, the QHST message queue will contain a completion message. You can display the message details to obtain the fully qualified job name associated with the WebSphere Portal Express install job. To retain the i5/OS job log from a remote installation, change the Job Description for the remote command server job prior to installing WebSphere Portal Express by executing...
CHGJOBD JOBD(QSYS/QZBSJOBD) LOG(4 00 *SECLVL)

After changing JOBD, also restart the remote command server...

ENDHOSTSVR SERVER(*RMTCMD)
STRHOSTSVR SERVER(*RMTCMD)

Upon successful completion of these commands, any subsequent remote installations will retain a job log on the i5/OS server.

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.

Install WebSphere Portal Express locally with the console interface

To install WebSphere Portal Express locally on your System i5 system, follow the instructions below:

Insert the WebSphere Portal Express Setup CD into the optical drive of your System i5 system.
Open an i5/OS command prompt and start the Qshell Interpreter...
STRQSH

Change to the system root directory by entering the following:
cd /

Start the installation.

Default installation with no options...
/QOPT/cd_root/PortalExpress/install.sh

...where cd_root is the root directory of the first WebSphere Portal Express Setup CD.
You can also copy the contents of the setup CDs to the server and run the install.sh command from the file system. If you do this, you will not be prompted to replace CDs.
Specify the WAS profile name and starting port for WebSphere Portal Express.
install.sh -W iSeriesStartingPort.startingPort=starting_port -W iSeriesdetectProfileAction.profileName=profile_root

...where starting_port is the starting port for the WAS profile creation and profile_root is the name of your WAS profile where WebSphere Portal Express is installed.
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.
Install an empty portal, where a normal WebSphere Portal Express is installed without portlets or pages.
Useful for transferring an entire portal configuration from one portal to another, for example transferring a test portal environment to a production portal environment.
install.sh -W emptyPortal.active="True"

Type in the number representing the language desired for the install and press Enter.
Accept the license agreement.
Review the information on the installation summary screen and press Enter.
Throughout installation, the program displays progress messages related to the various components.
When prompted for the location of the next CD, insert the appropriate WebSphere Portal Express CD into the optical drive and enter the following on the Qshell command line to continue installation:
/QOPT/cd_root
where cd_root is the root directory of the second WebSphere Portal Express Setup CD.
When WebSphere Portal Express finishes installing, the installation program will display a confirmation panel. Press Enter to exit the installation program.
Configure document rendering on i5/OS.
Set the JVM max heap size

Install WebSphere Portal Express remotely with the console interface

To install WebSphere Portal Express remotely from a Microsoft Windows workstation connected to your System i5 system, follow the instructions below:

Disable any active firewalls
Insert the WebSphere Portal Express Setup CD.
Open a DOS command prompt and go to...
cd \install_root\PortalExpress

Where cd_root is the root directory of the WebSphere Portal Express Setup CD or where the install files were copied.
Start installation...
install400.bat ISERIES_SYSTEM USER_ID PASSWORD -console

You can specify the WAS profile name and starting...
install400.bat -W iSeriesStartingPort.startingPort=startingPort -W iSeriesdetectProfileAction.profileName=profile_root

where startingPort is the starting port for the WAS profile creation and profile_root is the name of your WAS profile where WebSphere Portal Express is installed.
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.
Specify the installation of an empty portal, where a normal WebSphere Portal Express is installed without portlets or pages. This command 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.
Install an empty portal by typing:
install400.bat -W emptyPortal.active="True"

where ISERIES_SYSTEM is the name of the System i5 system on which you are installing WebSphere Portal Express, and USER_ID and PASSWORD are the user ID and password you use to log on to that system.
The ID you use to log on must be of the user type (user class) *SECOFR. To check the level of authority, type the command DSPUSRPRF userID.
Type in the number representing the language desired for the install and press Enter.
Accept the license agreement.
Select an install option by typing in the number representing: Install and Configure or Install only and press Next.
Selecting either option will copy WebSphere Portal Express files into the ProdData path for the portal_server_root_prod directory.
The Install and Configure option will continue to fully install a pre-configured WebSphere Portal Express on an existing WAS profile.
The Install only option stops after the copy of files.
The installation program will search for an installed WAS.
In the event that there is more than one application server, you will be given the option to select the application server profile on which to install WebSphere Portal Express. If none is detected, exit the installation program and first install an edition of WAS. Select from the list the WAS edition that you installed and on which you wish to install WebSphere Portal Express; selecting either WAS -
Base or WAS - Network Deployment. If you installed WAS -
Express, select -Base, because the file system is shared between these two editions.

For either option Install and Configure or Install only: The appropriate binary file will be copied from the install CDs or filesystem to the ProdData path for the portal_server_root_prod directory on the hard drive. If you selected Install only, skip to reviewing the summary screen step.
Install and Configure If you chose this option, the installation program continues, automatically creating a WAS profile on an existing edition of WAS, naming it wp_profile. If this profile already exists, then the profile name becomes wp_profilex, where x is 1 or the next available number.

For the Install and Configure option only: A port number is automatically chosen by the installation program when the profile is created.
The starting port is based on a range of 50 free ports within ports 10000 to 65000. If for some reason the installation program cannot detect ports for WAS or WebSphere Portal Express a warning message pops up stating that there was a problem detecting ports.
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.
Press Enter.

The screen for this step only appears if you chose the Install and Configure option: Enter an administrator user ID and password to be used for accessing both WebSphere Portal Express and WAS after installation. Do not use blanks in either the user ID or the password, and ensure that the password is at least five characters in length. This user ID is collected by the installation program in order to enable security. If you intend to use a Lightweight Directory Access Protocol (LDAP) directory to manage your users, ensure that the administrator user ID you specify here conforms to the recommendations specified in Special characters in user IDs and passwords. Press Enter.
The screen for this step appears whether you chose the Install and Configure or Install only option: Review the information on the installation summary screen and press Enter. Wrapper files from the install image are copied into the ProdData path for portal_server_root_prod.
This simplified and quick installation results in an updated, pre-configured, working portal with deployed portlets and security enabled.
A sequential summary of the automatic copy, install, and configuration steps follows:

Install and Configure or Install only option:
This is the point at which the appropriate binary file is copied from the install CDs or filesystem to the ProdData path for portal_server_root_prod on the hard drive. The i5/OS library is populated with Java Content Repository (JCR) files.
It is at this point that the Install only option completes. The Install and Configure option continues:

The installation program creates the WAS profile from the install image files.
The installation program extracts the WebSphere Portal Express install image files into the created WAS profile in UserData app_server_root.
The DB2 database library is created.
Database domain names are created.
Fix packs are automatically applied.
Portlets are pre-deployed, unless you specified an empty portal install.
Security is enabled.

When WebSphere Portal Express finishes installing, the installation program will display a confirmation panel. Press Finish to exit the installation program.
Continue the installation process with Document Rendering on i5/OS.
If you installed an empty portal, the portal is ready for importing the new configuration when the installation program is finished. Refer to details on transferring a portal configuration in Working with the XML configuration interface.
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 WAS 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 WAS informational logging by running the following command:
CHGJOBD JOBD(QWAS6/QWASJOBD) LOG(4 00 *NOLIST)

Parent topic: Installing methods (Choose one)