Installing WebSphere Portal Enabled Offering 4.2 On AIX

Full Install
 

This method presumes you are connected to a network drive which has a WebSphere Everyplace Access (WEA) build available. This process describes the use of Setup Manager, which installs WPO. It includes the installation of components "WebSphere Portal", "Portal Server", "WebSphere Application Server, Advanced Edition", "WebSphere Application Server Fixpack 4", "WebSphere Application Server", "IBM HTTP Server","IBM Directory Server", "IBM Directory Server", "IBM Directory Client", "DB2 Universal Database, "DB2 Universal Database Server", and the "DB2 Universal Database Fixpack 7". Note that this was a snapshot of the WPO 4.2 GM build.

When using Setup Manager without the use of the keyboard (for accessibility), choosing a radio button involves using the "Tab" key to go to the appropriate field, and pressing the space bar to select that field.  For selecting check boxes, use the tab and arrow keys to move to the appropriate  position, then press the space bar to "check" the box. Also, in the following sections, when instructed to "select" or "click", use the tab key to go to the appropriate field, then press the "Enter" key.

Before you begin installation of the full complement of services, you must increase your file sizes. This can be done automatically using a utility provided in the "tools" directory.

1)  Logon to your AIX machine (i.e. "(yourmachinename).raleigh.ibm.com") as "root", but before you attempt to install WPO, you must increase your file sizes. (i.e. change directories to "/WEA/tools/shayden", and execute the script "./qpb.ksh"). See Increasing File Sizes for details of this script.

2)  Mount a network drive to your machine that has the appropriate build on it (i.e. execute the command "/WEA/tools/shayden/mountscripts/mwpo42", shell scripts which mount the network disk with builds on it). See Example Mount Script for details of this script.

3)  Change directories to the newly mounted drive (i.e. "cd  /wpo42/WPO42/Setup"), and at the AIX command prompt type "./install.sh". In a few minutes the "WebSphere Portal - (yourmachinename)" GUI window should appear for performing the installation.
 

During installation, progress will be displayed on the window you started the install on.
 
 
 
 

WebSphere Portal Offering Install

1)  After invoking the install script, the first screen you will see is the "View Information" window in the "View Prerequisites" panel. If you wish, view the prerequisites (this will be done via a web browser), then click "Next"

2)  In the "Reading Software License" panel, select "Accept" in the "Program License Agreement" section and click "Next".

3)  In the "Validate the Installation Key" panel, enter the key values for the "Enable" version of WPO, then click "Next".

4)  In the "Install Selection" panel, select "Standard Install" and click "Next".

5)  You then have the option to enter a response file of a previously recorded install if desired, do not enter a value (and if one is there by default, delete it from this input field), and click "Next".

6)  In the "Select Components" panel, select ONLY the components "WebSphere Portal", "Portal Server", "WebSphere Application Server, Advanced Edition", "WebSphere Application Server Fixpack 4", "WebSphere Application Server", "IBM HTTP Server","IBM Directory Server", "IBM Directory Server", "IBM Directory Client", "DB2 Universal Database, "DB2 Universal Database Server", "DB2 Universal Database Fixpack 7", (and if this is a "distributed" install, also select "DB2 Universal Database Client"), then click "Next".

7)  In the "Checking Previous Installation" panel, you will (probably) be told you have a "Previous installation(s) of component(s) selected for install have been detected on this server. The following components' installation options cannot be modified. License Use Management Runtime - " and either "Take no action" or "Upgrade the installation", click "Next".

(Might need to install fileset "bos.adt.prof", "bos.rte", or whatever it tells you to).
 

IBM HTTP Server

1)  In the "Collecting Admin Username for IBM HTTP Server" panel, enter "ihsadmin" for the User Name, Password, and Confirm password fields. For the Group enter "ihsgrp", then click "Next".
 
 

SecureWay Directory Installation

1)  In the "SecureWay Directory Server" "Collect LDAP Suffix Information" panel, in the Suffix field enter "dc=rushmore".  In the Administrative User enter "cn=wpsadmin",  for the Password and Confirm Password fields enter "wpsadmin", then click "Next".  (LDAP port is "389").
 
 

WebSphere Application Server

1)  In the "WebSphere Application Server directory" panel, click "Next" to accept the defaults (WebSphere Application Server Directory is "/usr/WebSphere/AppServer").

2)  In the "Choose Database Location" panel, "Is this a remote database" field, select "No", then click "Next".

3)  In the "Choose DB Location" panel "Is this a remote database" field, select "No", and then click "Next".

4)  In the "Choose Database Type" panel, choose "DB2", and click "Next".

(DB2 Selected)

5)  In the "Collect DB User Info" panel, accept the default for Database Username = "wasinst" and Local Database Group "wasgrp", and enter "wasinst" for the Database Password and Confirm Database Password fields, then click "Next". (Database Username was "wasinst" and Local Database Group was "wasgrp")

6)  In the "Collect Database Settings" panel, click "Next" to accept the defaults (Local Database Name = "wasdbl", Local Database Alias  name = "wasdb", Node Name = "LOOPBACK", and Database Server Port = "55555").

Go to step 7

(Oracle Selected)

5)  In the "Collect Database User Info" panel,  for the "Database Password" and "Confirm Database Password" fields enter "ejsadmin", then click "Next".

6)  In the "Collect Database Settings" panel, for the "Database SID" field, enter "ORA817", for the "Database Home" field, enter "/export/home/oracle/ORA817", for the "Database URL" field enter "jdbc:oracle:thin:@(yourmachinename).raleigh.ibm.com:1521:ORA817" (with no parenthesis and "yourmachinename" being your box, i.e. "weasun10"), for the "Database Hostname" field enter the fully qualified machine name (i.e. "weasun10.raleigh.ibm.com"), for the "Database Server Port" field enter "1521", then click "Next".

7) In the "Choose Web Server Location" panel, for the "Is your Web server on a remote machine", select "No", then click "Next".
 
 

WebSphere Application Server Web Server

1) In the "Select Web Server" panel, accept the default "IBM HTTP Server", and click "Next".

(with Oracle Selected)

2) In the "WebSphere Application Server Web Server" "Select Web server" panel, select "IBM HTTP Server" and click "Next".

3) In the "WebSphere Application Server Web Server" "Configure Plugin" panel, accept the defaults, then click "Next" ("IBM HTTP Server installation directory" was "/opt/IBMHTTPD", and "Location of httpd.conf" was "/opt/IBMHTTPD/conf/httpd.conf")

4) In the "Checking Previous Installation" panel, you will (probably) be told you have a "Previous installation(s) of component(s) selected for install have been detected on this server", click "Next".
 

Portal Server

1)  In the "Authentication Mode" panel, select "Database and LDAP Directory mode", and click "Next".

2)  In the "Security Configuration" panel, select "Now" and click "Next".

3)  In the "LTPA Password" panel, enter "wpsbind" for the LTPA Password and Confirm password, and click "Next".

4)  In the "Server Configuration" panel, click "Next" to accept the defaults. (the "Install Directory" is "/usr/WebSphere/PortalServer" ("/opt/WebSphere/AppServer" on Sun), the "Hostname" is "(yourmachinename).raleigh.ibm.com", the "Base URI" i.e. "/wps", and the "Home page" is. "/portal", and the "Customized page" is "/myportal". "Proxy Host" and "Proxy port" were blank. The Base URI and the Home page will be the URL to access the Portal portlet, i.e.. "http://(yourmachinename).raleigh.ibm.com/wps/portal".).

5)  In the "Authentication Settings" panel, accept the defaults, then click "Next" (Portal Admininstrator User ID was "wpsadmin", and the Administrator Password and Confirm Password fields were 8 "*").

6)  In the "Selection of LDAP Server" panel, for the "LDAP Server" field, change the value to your machine name (i.e. "6c4aix101.raleigh.ibm.com), and accept the remaining defaults, then click "Next". (IBM Directory Server was selected, User DN was "cn=wpsadmin", "User Password" and "Confirm Password" fields were 8 "*", Suffix was "dc=rushmore", LDAP Port Number was "389", and "Make sure LDAP server is properly configured" was checked).

7)  In the "LDAP Configuration" panel, accept the defaults and click "Next". (User Object Class was "inetOrgPerson", User DN Prefix was "uid", User DN Suffix was "cn=users,dc=rushmore", Group Object Class was "groupOfUniqueNames", Group Member was "uniqueMember", Group DN Prefix was "cn", Group DN Suffix was ""cn=groups,dc=rushmore", Administrator DN was "uid=wpsadmin,cn=users,dc=rushmore", Administrative group DN was "cn=wpsadmins,cn=groups,dc=rushmore", BIND DN was "uid=wpsbind,cn=users,dc=rushmore", and Bind Password and Confirm Bind Password were 7 "*". Leave the two remaining fields "objectAttribute name" and "pluginAttribute name" blank).

8)  In the "Portal Server Database Selection" panel, for the "Database Backend" select "DB2 Universal Database Server", for the "Is this a remote database" field select "No", for the Portal Server database configuration options "Create and initialize a new database (DB2 Only)", and for the "Do you want to share the database with Member Services", select "Share this database" and click "Next".

6)  In the "Portal Server Database Configuration" panel , for the "Local Database Password" and "Confirm Local Database Password" fields enter "wasinst", and for the "JDBC Driver Library", enter "/home/wasinst/sqllib/java12/db2java.zip", then click "Next". (The Local Database Instance was "wasinst", the Local Database Alias Name was "wpsdb", the JDBC Database Driver was "COM.ibm.db2.jdbc.DB2ConnectionPoolDataSource", JDBC URL Prefix was "jdbc:db2", and JDBC Driver Library was "/home/db2inst1/sqllib/java12/db2java.zip").

7)  In the "License Use Managment" panel, select "Local License Server" and accept the default "LUM Server Hostname" "(yourmachinename).raleigh.ibm.com", and click "Next".
 
 

Summary

1)  In the "Save Response File" panel, you can optionally save your response file (be sure to click "Save Response File"), then click "Next".

2)  In the "Display Summary" panel, click "Next" to proceed with installation. The following is the Summary Results for the above installation. Go have a latte'.

Display Summary Results

The following components are selected for install. Components that appear that you have not selected are listed because a component that you have selected requires them in order to be installed. All components listed will be installed when you hit the next button

Global Security Toolkit
IBM Http Server
    Username:  ihsadmin
    Group: ihsgrp
DB2 Universal Database Server
DB2 Universal Database Fixpack 7
IBM Directory Server
    LDAP Root Suffix:  dc=rushmore
    ADministrative user:  cn=wpsadmin
    LDAP port number:  389
WebSphere Application Server
    WebSphere Application Server installation directory: /usr/WebSphere/AppServer
    Local Database User ID:  wasinst
WebSphere Application Server Fixpack4
    Included eFixes: PQ61935, PQ66355, PQ67566, Cumulative CM, Cumulative Security, PQ69078
Portal Server
    Authentication Mode: Database and LDAP Directory mode
    Install Directory:  /usr/WebSphere/PortalServer
    Hostname for the Web Server:  b80aix103.raleigh.ibm.com
    LDAP Server type: WPS Ldap SWD
    LDAP Server: b80aix103.raleigh.ibm.com
    Database backend: Db2 Universal Database Server
    Is this a remote database?  No
    Portal Server database configuration options: Create and initalize a new databse (DB2 Only)
    Do you want to share the database with Member Services?  Share the database
Transcoding Technology
License Use Management Runtime
Productivity Portlets
 
 
 
 
 
 

Installation Details

After several minths a popup "Configuring for Admin Role " will appear.  While you are in the process of performing these steps you should also change the WebSphere Portal Ping Initial Timeout value to 1800.  From the WebSphere Administrative Console, scope down to "WebSphere Administrative Domain", "Nodes", (yournodename), "Application Servers", and select "WebSphere Portal".  In the "Advanced" tab for the Portal Server, change "Ping initial timeout" to "1800", click "Apply".

Follow the Configuring for Admin Role instructions before you continue with the installation of the software. When you are through with the configuring for admin role, be sure to click OK in the Configuring for Admin Role popup. The installation will then continue.
 

Wait a month, and eventually an "Installation Complete" popup should be displayed stating the response file has been saved, click "OK".  In the Display Summary window, click "Finish".

Logs resulting from the installation include the "setup*" file, which is the overall install log. Within that file will be references to additional logs "RunCommand* that will be in the directory "/usr/IBMWPO/RunCommand". (note that in the "setup*", and the "RunCommand*", the "*" refers to a "randomly generated" numeric value created during the install process.)
 

Additional LDAP Steps for WEA Installation

If you install WEA on top of WPO, you must make some changes to the LDAP to get WEA to work properly.

1) From a web browser connect to your ldap using the URL "(yourmachinename).raleigh.ibm.com/ldap".

2) When/If queried for login ID and Password, use "cn=wpsadmin" for the ID, and "wpsadmin" for the Password (or whatever you used in your SecureWay Directory Installation Administrative User and password)

3) Select "Settings", "Suffixes", and in the "Suffix DN" field, enter "dc=ins,dc=ibm,dc=com", then click "Update".

4) Click the link to "restart the server". A message will be displayed reflecting the status, it should eventually state "The directory server is currently running. To stop the server, click the Stop button."
 
 
 
 

Testing The Installation

At this point WEA and associated software should be installed, and WAS and your applications should have been started. Start the Admin Console, and when queried for authentication, use the value "wpsadmin" for the ID and password. (Note: if you had left the Admin Console running after performing the steps in "Configuring for Admin Role", you still have a snapshot of the configuration of WES/WAS at that point. Refreshing the Admin Console will not show you the remaining applications that were installed after the configuration was performed. To see these applications you must exit the Admin Console and restart it. Logon using ID/Password of "wpsadmin").

Steve:  Apparently during the installation process the Security Center password was changed from the value input ("wpsadmin") to "wpsbind". Dont know why!

To verify the installation and operation of WebSphere Application Server, scope down to "WebSphere Administrative Domain", "Nodes", (yournodename), "Application Servers", select "Default Server", right mouse click and select "Start". Once the Default Server has started you should be able to run the "snoop" servlet by using your favorite browser and browsing the url "http://localhost/servlet/snoop". The userid and password for accessing servlets is "wpsadmin".

To verify the installation of WEA, use the url "http://localhost/wps/portal" (or alternatively your machinename, i.e.. "http://rushtest55.raleigh.ibm.com/wps/portal") to run the "World Clock" portlet. If you are queried for an ID/Password, use "wpsadmin" for both.

To login to the WebSphere Everyplace Access using the "portal" portlet, click on the key icon on the upper right corner of the web page. For the User ID and Password, enter the value "wpsadmin", and click the "Log In".

If the snoop servlet and portal portlet both work your installation was (probably) successful.
 
 

Restarting WebSphere Everyplace Access

1)  From the Windows "Services" utility, if necessary, stop the "IBM SecureWay Directory V3.2.2" and the "IBM WS Admin Server".

2)  First start the SecureWay Directory server and then IBM WS Admin Server.
 
 
 
 
 

Example Mount Script

The following are the contents of a schell script which can be used as is or modified for mounting the build you wish.

#!/usr/bin/ksh
mkdir /wpo42
mount -o ro linwps1:/nfs  /wpo42
 
 
 
 

Increasing File Sizes

There are several scripts which contain the commands to increase your file sizes to accommodate the WEA installation. Note that it only adds to the
current size of your file system without knowing or caring what they currently are! Source listings of these scripts are listed later and are located in
directory "/WEA/tools/shayden".

For a WEA Core only, execute the script "qpc.ksh" (CORE).
For a WEA Full install, execute the script "qpe.ksh" (EVERYTHING).
For a WEA install where you have LOTS of file space, execute the script "qpb.ksh" (BIG)
For 4.21, execute the script "qp.ksh"
 

qpc.ksh

#!/bin/ksh
echo
echo "This script will increase your systems filespace. It uses values"
echo "as specified by the WEA 4.30 Setup Manager"
echo " "
echo "Increasing filesystem / size by 578134"
chfs  -a  size='+578134' /
echo "Increasing filesystem /home size by 229780 "
chfs  -a  size='+229780' /home
echo "Increasing filesystem /usr size by 4431323"
chfs  -a  size='+4431323' /usr

echo
echo "Filesystem /, /home, and /usr  modified."
echo
 

qpe.ksh

#!/bin/ksh
echo
echo "This script will increase your systems filespace. It uses values"
echo "as specified by the WEA 4.30 Setup Manager"
echo " "
echo "Increasing filesystem / size by 578134"
chfs  -a  size='+578134' /
echo "Increasing filesystem /home size by 4660024 "
chfs  -a  size='+4660024' /home
echo "Increasing filesystem /usr size by 5543958"
chfs  -a  size='+5543958' /usr

echo
echo "Filesystem /, /home, and /usr  modified."
echo
 

qpb.ksh

#!/bin/ksh
echo
echo "This script will increase your systems filespace. It uses values"
echo "beyond those specified by the WEA 4.30 Setup Manager"
echo " "
echo "Increasing filesystem / size by 1186950"
chfs  -a  size='+1186950' /
echo "Increasing filesystem /home size by 11815622 "
chfs  -a  size='+11815622' /home
echo "Increasing filesystem /usr size by 11087916"
chfs  -a  size='+11087916' /usr

echo
echo "Filesystem /, /home, and /usr  modified."
echo
 

qp.ksh

#!/bin/ksh

echo "Increasing Filesystem Sizes"

chfs -a size='+3000000' /
chfs -a size='+8000000' /home
chfs -a size='+800000' /tmp
chfs -a size='+800000' /var
chfs -a size='+5000000' /usr

echo
echo "Filesystem /, /home, /tmp, /var, and /usr modified."
echo
 
 
 
 
 
 
 
 
 
 
 

AIX Logon Problem

When you attempt to login to AIX and get the Action Required dialog box, it states:

The DT messaging system could not be started.

To correct the problem:

1.  Choose [OK] to return to the logon screen.
2.  Select Failsafe Session from the logon screen's optoin menu and log in.
3.  Check to see that the hostname is correct in "/etc/hosts".
     Other hostname problems can be corrected by usingthe command "smit mktcpip"
4.  Check to see that if a search list is specified in "/etc/resolv.conf" it includes the domain your machine is configured on.

For additional information, see the DT Users's Guide.

[OK]