Taking Notez

Notes from My Work with WebSphere Portal, Domino, and Other IBM Technology

Step-by-Step Building IBM WebSphere Portal Enable V 8.0 From Install to Cluster Part I

with 7 comments

Note: This is only the first part of my document. I have seen a fair amount of interest in sorting out the install. I should have clustering ready for later this week. Also, there are a lot of formatting issues today and I don’t have time to make it all pretty… yet.
Step-by-Step Building WebSphere Portal Enable V 8.0 From Install to Cluster
My first assumption is that if you are reading this you are doing so with regard to using this guide in a lab and not in a production environment. There are many factors that influence choices made in a portal implementation. These factors are far beyond the scope of a guide such as this. We do not consider OS, bitness, or even whether to use the Hypervisor edition. The purpose of mentioning these is not to suggest that they are more important than other considerations but to point out a few that come to mind at the moment.

You could use this guide as a template for creating your own procedure. Frankly the screenshots annoy me but some people find them very useful. I assume that when you find errors or have suggestions you will be so kind as to visit my blog and point them out kindly. … and thanks, in advance for doing that.

In a perfect world I will get around to a more refined guide that includes Linux and more use of the command interface / response files. MAYBE even Hypervisor. Frankly, there are other Portal 8 features to explore and document so don’t get too feisty if I never get around to these.

Finally, the first most assumption: no warranty explicit or implicit is offered. This is “as is and at your own risk” content. I am not responsible if you end up divorced, childless, or deranged, or worse.
Software Parts List

IBM WebSphere Portal and Web Content Manager Install V8.0 (1 of 5) (CI7N3ML)
IBM WebSphere Portal and Web Content Manager Install V8.0 (2 of 5) (CI7N4ML)
IBM WebSphere Portal and Web Content Manager Install V8.0 (3 of 5) (CI7N5ML)
IBM WebSphere Portal and Web Content Manager Install V8.0 (4 of 5) (CI7N6ML)
IBM WebSphere Portal and Web Content Manager Install V8.0 (5 of 5) (CI7N7ML)
IBM WebSphere Application Server Network Deployment V8.0.0.3 (1 of 3) (CI7N8ML)
IBM WebSphere Application Server Network Deployment V8.0.0.3 (2 of 3) (CI7N9ML)
IBM WebSphere Application Server Network Deployment V8.0.0.3 (3 of 3) (CI7NAML)

Prepare Windows

User Account

  1. The account used for install must be created prior to commencement of install. That is, if you create a new account, log off as the creator, log on as the created user, and proceed.
  2. The user must belong to the Windows local administrators group. Membership must be configured prior to the currently logged on session.

File System
There are two concerns.

  1. The first is use of virtualized volumes such as Program Files(x86). This concern is addressed in this installation guide.
  2. The second is IBM GPFS file sharing. Consult the product documentation: http://www-10.lotus.com/ldd/portalwiki.nsf/dx/Preparing_your_Windows_operating_system_in_a_clustered_environment_wp8

Install Path
In general avoid long file paths. My preference would be C:\IBM\….
I rarely use the Program Files directory structure for enterprise systems such as DB2 or WebSphere.
Also, while on the subject of file paths, be careful with file names. A WAR file name should consist of 25 or fewer characters.
Node names should be 5 or fewer characters. Keep in mind that the configuration repository node and cell names default to a concatenation with the host name.
Naming Conventions
In keeping with the previous item, remember that on Windows there is a 259 character length maximum length for file paths. Likewise, on occasion, there are issues with spaces in file paths. This should not happen but it can. Avoid spaces in file and folder names.
Project Flow
This guide will consist of several phases.

  1. Install the IBM Installation Manager
  2. Install WebSphere Portal V 8.0
  3. Configure a “remote” database (we will use a local instance as if it were remote for illustration purposes. DO NOT USE THIS FOR A PRODUCTION ARCHITECTURE.)
  4. Create an augmented Deployment Manager Profile
  5. Federate the primary node into the cell
  6. Create the cluster (static)
  7. Configure the external HTTP server
  8. Configure an LDAP repository

Configure the Source Binary Files
Extraction Options
You can extract all of the WAS and PORTAL parts identified in the table at the beginning of this guide into a single merged folder. If you do, there will be three subfolders of the parent. Portal, Setup, and WAS. You could extract the source binaries into three distinct folders. Either choice is fine.
What you DO NOT have to do is figure out the arcane folder names such as W-1, W-2, and W-4, etc.

The “Setup” folder contains the IBM Installation Manager install components. The content of the other two should be self evident.

Install WebSphere Portal on Primary Node
Using IBM Installation Manager
I really like this idea and am hopeful that the implementation will live up to the promise it represents. You can point to a local downloaded repository, as is the case in this guide. Or, you could point to a live repository hosted by IBM. In addition to the simplified install process you gain better control over the WAS and Portal update procedures.

If you do not want to use the GUI the Installation Manager supports use of a response file. There is not, however, a console mode.
Install the IBM Installation Manager
If you have an existing installation of the manager you should confirm that it is version 1.5.2 by launching the manager and selecting

Help -> About IBM Installation Manager.
If the version is not correct you may upgrade or uninstall and install from the source binaries.(Figure 1)

Figure 1
Installing IBM Installation Manager consists of seven steps.

1. Locate the install program. In this example it is found in the extracted binaries folder D:\Installs\WPS8\Setup\IIM\win32. (Note: At this time there is not a 64bit version of the IBM Installation Manager shipped with the product.)
Figure 2

  1. Launch Install by double clicking.
  2. The installer will post a splash screen and then an Install Packages screen will appear. Select the package and version needed as illustrated in Figure 2.3.Accept the license agreement after reading and if you wish to continue the install.wpid-installmanager2-2012-05-7-11-07.jpg
    Figure 3
    5.Choose a location for the program. Due to the nature of this application it is allowed to remain in the Program Files directory structure.

Figure 4
6.On the summary page confirm the package selected for installation and choose Install.wpid-installmanager4-2012-05-7-11-07.jpg

Figure 5
7.When the installer has completed the task, a summary will appear. If successful you may restart the IBM Installation Manager and configure it so that you can install the product packages for IBM WebSphere Portal V 8.0wpid-installmanager5-2012-05-7-11-07.jpg

Figure 6

Configure the IBM Installation Manager
Once the installation manager has restarted you must configure it to reference the source repositories for the portal and the application server. Keep in mind that even when all the downloaded compressed binaries were extracted and merged into a single folder there will be at least two repositories to configure.

1. Locate the interface to add repositories by selecting File -> Preferences

Figure 7
2.In the list of preferences you will see a reference to Repositories. Select this.
3.In the preferences window you will see an Add Repository button. Click this. You will perform this operation for both the portal and the application server repository.
4.In the Add Repository dialog box, click the browse button and navigate to one of the two repository locations. In this example the portal repository is located at D:\Installs\WPS8\Portal and in this location the repository.config file is found. Select this file and click the Open button. Steps 2 through 4 are illustrated in Figure 8

Figure 8
5.        After you have added both repositories, one for portal and one for the application server, you should ensure that the application server repository is listed above the portal repository. If, as illustrated in Figure 9, the order is reversed select a repository and click Move Up or Move Down.wpid-installmanager7-8moveup-2012-05-7-11-07.jpg

Figure 9
6.Once the repositories are configured click the OK button.

Install IBM WebSphere Portal V 8.0

1.On the launch page of the installer click Install.

Figure 10
2.Select the packages to install. Package selection is determined by the repositories configured for the installation manager.wpid-install2selectpackages-2012-05-7-11-07.jpg

Figure 11
3.Accept the license.

Figure 12
4.The default on some systems may be a virtualized directory. This should be changed for a number of reasons of which one is the preference for shorter, space free file paths.

Figure 13
Figure 14
5.You will need to set an install path for the AppServer and PortalServer directory structures at this time.

Figure 15
Figure 16
6.Select additional languages as dictated by your environment.

Figure 17
7.Select features for installation. In this example we have maintained the default features as illustrated in Figure 18

Figure 18
8.Portal configuration can be managed as “Basic” or “Advanced”

Figure 19

Figure 20
9.On the summary page confirm your choices and choose Install.

wpid-install8summary-2012-05-7-11-07.jpgFigure 21
10.The installation will consume significant CPU resources.

Figure 22
11.Observe the status of the install. If successful the portal will already be running.

Figure 23
12.Launch a browser and confirm access to the system.

wpid-install10completewithhomepage-2012-05-7-11-07.jpgFigure 24
Perform post-installation procedures for a clustered environment
Transfer portal database to a remote database
Addressing Search Issues
Create a Profile Template
Prepare for Cluster Creation
Choose a Cluster Type / Create a Static Cluster
Prepare a Remote Web Server
Configure a User Registry for WebSphere Portal
Add Additional Cluster Members


Written by David Wilkerson

May 7, 2012 at 3:07 pm

Posted in WebSphere Portal

7 Responses

Subscribe to comments with RSS.

  1. Very helpful. Thank you!!


    June 5, 2012 at 8:38 am

  2. hi have you by any chance transferred to a remote db2 database. we seem to run into problems when it reaches action-process-constraints. We have done a rebind on dbs and it still fails,


    September 14, 2012 at 12:57 am

    • Portal enable comes with derby, if you want you can install db2 separately and configure portal to connect to it


      February 4, 2013 at 12:58 pm

  3. I Made it withyour guidance. Thanks!!!!!!!!!!!!!!


    December 19, 2012 at 5:43 am

  4. “If you do not want to use the GUI the Installation Manager supports use of a response file. There is not, however, a console mode.” — In the tools directory is “imcl” command and it can be used to start Installation Manager in console mode with “./imcl -c”.

    Rich Durso

    November 20, 2013 at 4:44 pm

    • Typically, by console mode, IBM has meant that you can interact with the install rather than “simply” load a response file.

      I find that most deployments typically rely on a response file and, as you point out, this is the technique by which this is achieved. That said, there is no console mode by which the user can interact OR create a new response file.

      David Wilkerson

      November 20, 2013 at 5:13 pm

  5. I don’t see the PDF for this step by step on Portal 8.
    It was very helpfull on your earlier versions but it will be really appreciated if you can help me in finding that to download. I am badly in need of that to setup LDAP configurations for Portal 8.

    Labels: IBM WebSphere Portal Java Barcode V 8.0


    November 24, 2014 at 4:10 am

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google+ photo

You are commenting using your Google+ account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )


Connecting to %s

%d bloggers like this: