Install IBM WDF 6.1 on Kubuntu 9.10 x64

These are instructions to install IBM WebSphere Dashboard Framework 6.1 on Kubuntu 9.10 x64.


Version Information

This installation guide was tested with the following software and versions. It may work for other versions as well.

Software	Version
Linux	Kubuntu 9.10 x64 Karmic Koala KDE 4
WebSphere Dashboard Framework	WebSphere Dashboard Framework 6.1
Eclipse	Eclipse Galileo 3.5 SR1
Portal Server	IBM WebSphere Portal Server 6.1.0.1
JDK (optional)	Sun Java x64 1.6.0_17 (build 1.6.0_17-b04)
Web Browser	Mozilla Firefox 3.5.5 x64

Steps

Follow these steps to install WebSphere Portal Server 6.1 on Kubuntu 9.10 x64

1. Download IBM WebSphere Dashboard Framework


2. Install Java


3. Make DNS Entry


4. Install Required Libraries


5. Set the Shell


6. Install WebSphere Portal Server


7. Complete Installer Steps


8. Update Permissions


9. Access the Portal Page


10. Reset the Shell (Optional)


11. Important Commands & URLs

1. Download IBM WebSphere Dashboard Framework

Download and extract the following IBM package.

IBM Package	Description
C1J1FML	IBM WebSphere Dashboard Framework 6.1 Linux Installer Multilingual

2. Install Java

These instructions will also install the latest JDK and the latest Java Plugin for Firefox.

1. Install Kbuntu Java Packages

First install the Kubuntu Java packages to setup JDK and JRE support within Kubuntu.

$ sudo apt-get install sun-java6-jdk sun-java6-plugin

2. Update to SUN's latest JDK/JRE.

DOWNLOAD:	jdk-6u17-linux-x64.bin
FROM URL:	http://java.sun.com/javase/downloads/index.jsp

$ cd [download location]
$ sudo cp jdk-6u17-linux-x64.bin /usr/lib/jvm
$ cd /usr/lib/jvm
$ sudo chmod +x /usr/lib/jvm/*.bin
$ sudo ./jdk-6u17-linux-x64.bin
$ sudo rm ./jdk-6u17-linux-x64.bin
$ sudo rm /usr/lib/jvm/java-6-sun
$ sudo ln -s /usr/lib/jvm/jdk1.6.0_17 /usr/lib/jvm/java-6-sun

3. Verify the Java Version

$ java -version
$ sudo update-alternatives --config java

The output will look like this.

$ java -version
java version "1.6.0_17"
Java(TM) SE Runtime Environment (build 1.6.0_17-b04)
Java HotSpot(TM) 64-Bit Server VM (build 14.3-b01, mixed mode)

$ sudo update-alternatives --config java
There is only one alternative in link group java: /usr/lib/jvm/java-6-sun/jre/bin/java
Nothing to configure.

4. Add JRE_HOME and JAVA_HOME environment variables.

$ kate ~/.profile

Add the following to the end of the file and save.

# Java
JAVA_HOME=/usr/lib/jvm/java-6-sun
export JAVA_HOME

JRE_HOME=/usr/lib/jvm/java-6-sun/jre
export JRE_HOME



3. Install Eclipse

SOFTWARE:	Eclipse IDE for Java EE Developers
DOWNLOAD:	eclipse-jee-galileo-SR1-linux-gtk-x86_64.tar.gz
FROM URL:	http://www.eclipse.org/downloads/

$ cd [download location]
$ sudo adduser `whoami` users
$ newgrp users
$ sudo tar -xvzf eclipse-jee-galileo-SR1-linux-gtk-x86_64.tar.gz -C /usr/local/
$ sudo chown -R root:users /usr/local/eclipse/
$ sudo chmod -R g=u /usr/local/eclipse/

$ sudo chown -R `whoami`:`whoami` ~/.config/
Add an item to K Menu
Name: Eclipse
Description: Java IDE
Icon: Select /usr/local/eclipse/icon.xpm
Command: export GDK_NATIVE_WINDOWS=1; /usr/local/eclipse/eclipse

Window | Preferences | General | Appearance | Colors and Fonts | Basic | Text Font | Change... | Family=Andale Mono, Size=8 | OK | OK

Window | Preferences | General | Web Browser | Use external Web Browser | New | Name = Firefox; Location=/usr/bin/firefox; Parameters=%URL%; Firefox | OK

4. Install WDF

$ cd [extract location]
$ sudo ./WDF.bin

-
English | OK
-
Next
-
Selected: I accept the terms in the license agreement | Next
-
Where would you like to Install?
Click Choose button and select /opt/IBM
Next
-
Please select the eclipse directory:
Click Choose button and select /usr/local/eclipse
Next
-
Install
-
Done

Note license and WPFDesigner folders will be created unser /opt/IBM

5. Update Permissions

Add your login id to the users group, and grant access to the portal server installation to members of the users group.

$ sudo adduser `whoami` users
$ newgrp users
$ sudo chown -R root:users /opt/IBM
$ sudo chmod -R g=u /opt/IBM


--- UNDER CONSTRUCTION!!!---
--- These instructions are not accurate beyond this point! ---

3. Make DNS Entry

A fully qualified DNS entry is required during installation.

1. To configure the DNS entry for your computer, edit the hosts file.

$ kdesudo kate /etc/hosts

2. Add an entry to your hosts file.

Add mycomputer.mydomain.com as shown in the third line below. Do not change any of the other lines.

(The value here is an example; you may use any fully qualified host name and domain name you wish.)

127.0.0.1 localhost
127.0.1.1 mycomputer
127.0.0.1 mycomputer.mydomain.com

# The following lines are desirable for IPv6 capable hosts
::1 ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
ff02::3 ip6-allhosts


4. Install Required Libraries

The installer requires 32 bit libraries (ia32-libs). Without the 32 bit libraries, the installer silently exists during launch without even giving an error message.
$ sudo apt-get install ia32-libs

Download and install the 32 bit version of libstdc++5. libstdc++5 is not available in the Kubuntu Karmic repositories. Without the libstdc++5 librarie, the graphical installer does not work.

DOWNLOAD: libstdc++5_3.3.6-17ubuntu1_i386.deb
FROM URL: http://packages.ubuntu.com/jaunty/i386/libstdc++5/download

$ cd [download location]
$ mkdir libstdc++5
$ dpkg-deb --extract libstdc++5_3.3.6-17ubuntu1_i386.deb ./libstdc++5

$ sudo cp ./libstdc++5/usr/lib/* /usr/lib32/

5. Set the Shell

Kubuntu uses dash as the default shell, but the installer requires bash. Change the shell using the following steps.

ls -la /bin/s*
sudo rm /bin/sh
ls -la /bin/s*
sudo ln -s /bin/bash /bin/sh
ls -la /bin/s*

(After installation you can optionally reset the shell to dash; see the Reset the Shell section below for instructions).


6. Install WebSphere Portal Server

Reboot your machine to activate the environment settings.

Navigate to the parent folder of the installation folders. (This is the directory where you placed IL-Setup, IL-1, IL-2, IL-3, IL-4, IL-5, and IL-5A).

$ cd [location of installation folders]

Change the installer file permissions.

$ sudo chmod a+x ./IL-Setup/install.sh
$ sudo chmod a+x ./IL-Setup/dist/linwpinstall

Start the installer.

$ sudo ./IL-Setup/install.sh

When launched from the parent folder, the installer will access all necessary installation files automatically.

Note that the command-line installer can be started using:
$ sudo ./IL-Setup/install.sh -console


7. Complete Installer Steps

Note that the following steps were created using the graphical installer. The command-line installer installer follows the same sequence of steps.

1. Begin the installation.

Click Next

2. Software License Agreement.

Select: I accept the terms in the license agreement

Click Next

3. Select the installation type you prefer.

Select: Full

Click Next

4. Warning Dialog

Ignore the following warning message.

EJPIC0007E: Operating System prerequisite check failed. Refer to the message log file /tmp/installmessages.txt for additional information.

Click OK

5. Enter the installation directory.

Enter the WebSphere Portal Installation directory.

/opt/IBM/WebSphere

Click Next

6. Enter Node and Host Information.

Enter the same host and domain information from your DNS entry above.

Node Name:	Node01
Host Name:	mycomputer.mydomain.com

(The node name here is an example; you may use any node name name you wish.)

Click Next

7. Warning Dialog

Ignore the following warning message.

EJPIC0071W: Host name mycomputer.mydomain.com does not match local host name. Enter the host name again if it is incorrect.

Click OK

8. Enter Administrator Information.

Administrative user ID:	admin
Administrative password:	admin
Confirm password:	admin

(The values here are examples).

Click OK

9. IBM WebSphere Portal is ready to install.

You will see the following message.

Products to install:	IBM WebSphere Portal 6.1.0.1
Installation type:	Full
Installation details:
WebSphere Portal installation location:	/opt/IBM/WebSphere/PortalServer
WebSphere Application Server installation location:	/opt/IBM/WebSphere/AppServer
WebSphere Portal profile location:	/opt/IBM/WebSphere/wp_profile
Host name:	mycomputer.mydomain.com
Node name:	Node01
Administrator user ID:	admin
Total size on disk:	4 GB

Verify the above information, then Click Next

Note: The installation process will take 40 minutes or more. The progress bar will remain unchanged for a long period of time, but the installation is under way, and you should not cancel.

10. Installation was successful.

Uncheck: Launch First Steps

Uncheck: Launch the configuration wizard

Click Finish.


8. Update Permissions

Add your login id to the users group, and grant access to the portal server installation to members of the users group.

$ sudo adduser `whoami` users
$ newgrp users
$ sudo chown -R root:users /opt/IBM
$ sudo chmod -R g=u /opt/IBM


9. Access the Portal Page

1. Launch Firefox and enter the following URL...

http://mycomputer.mydomain.com:10040/wps/portal

2. Enter the User ID and Password.

Enter the same user id and password you setup during installation.

User ID:	admin
Password:	admin

3. Click Login


10. Reset the Shell (Optional)

Since Kubuntu uses dash as the default shell, you can reset this shell using the following steps.

$ ls -la /bin/s*
$ sudo rm /bin/sh
$ sudo ln -s /bin/dash /bin/sh
$ ls -la /bin/s*

Now, you must update all of the installed IBM scripts to explicitly use dash. Be sure to complete step 8 before performing the following.

$ sed -i "s|/sh|/bash|g" /opt/IBM/WebSphere/AppServer/bin/*.sh
$ sed -i "s|/sh|/bash|g" /opt/IBM/WebSphere/PortalServer/bin/*.sh


11. Important Commands & URLs

Here is a list of important commands and URLs for the Portal Server and the WebSphere Application Server.

Start the Portal Server	$ /opt/IBM/WebSphere/wp_profile/bin/startServer.sh WebSphere_Portal
Stop the Portal Server	$ /opt/IBM/WebSphere/wp_profile/bin/stopServer.sh WebSphere_Portal
Portal Server Main Page ULRs	http://mycomputer.mydomain.com:10040/wps/portal
	http://localhost:10040/wps/portal
Portal Server Admin Console URL	$ https://localhost:10041/ibm/console
Start WebSphere Application Server	$ /opt/IBM/WebSphere/wp_profile/bin/startServer.sh server1
Stop WebSphere Application Server	$ /opt/IBM/WebSphere/wp_profile/bin/stopServer.sh server1
WebSphere Admin Console URL (Verify This!)	$ https://localhost:10001/ibm/console

Note: Starting the portal server results in the following errors. These errors do not seem to affect the functionality of the Portal Server.

/opt/IBM/WebSphere/AppServer/java/bin/java: Symbol `com_ibm_oti_vm_VM_getStackClassLoader' causes overflow in R_X86_64_PC32 relocation
/opt/IBM/WebSphere/AppServer/java/bin/java: Symbol `com_ibm_oti_vm_VM_getStackClass' causes overflow in R_X86_64_PC32 relocation
/opt/IBM/WebSphere/AppServer/java/bin/java: Symbol `com_ibm_oti_vm_VM_getStackClass' causes overflow in R_X86_64_PC32 relocation