. 12
( 87 .)


Before you start, you need to perform some tasks on your Linux server to
make it ready for the install. Speci¬cally, perform the following tasks:
1. Identify your version of Linux.
2. Make sure you have a static IP address by going to Gnome Menu ➪
System Settings and clicking Network Con¬gurations. Highlight
wy009-03 WY009-BenNatan-v1.cls May 9, 2004 4:37

Installing WebSphere Portal on Linux 45

Figure 3-2 Network con¬guration utility.

Device and click Edit. Verify this is a static IP, as shown in
Figure 3-2.
3. Right-click on the desktop and click New Terminal, and ping your
server™s fully quali¬ed domain name and see if your IP comes up
and four successful replies are returned.
4. Make sure that the following ports are not being used by typing
netstat-an in a command prompt:
443 (standard HTTPS port)
523 (DB2 Administration Server)
8008 (IBM HTTP Server Administration port)
50000 (DB2 instance connection port)
50001 (DB2 instance interrupt port)
50002 (DB2 Control Server)
55555 (WAS database port)
9081 (Default Portal Port).
5. Make sure that user account has root or root authority.
wy009-03 WY009-BenNatan-v1.cls May 9, 2004 4:37

46 Chapter 3

6. Make sure no other Web server, such as Apache, is running.
Remember, Red Hat installs Apache 1.3 even if you choose not to
install the Web Server package.
7. Disable the Linux ¬rewall.

You are now ready to install WebSphere Portal on Red Hat Linux 8.0.

Installing on Your Linux Server
To install WebSphere Portal, you ¬rst need to install a more current version
of HTTP server than the one installed during a typical install:

1. Log in as root, go to the IBM Web site, and download the IBM
Developer Kit, Java Technology Edition Version 1.3 and IBM HTTP
Server 2.042.2.
2. Uncompress the IBM Developer kit and install it in /opt.
3. Edit your shell pro¬le, append /opt/IBMJava2-131/bin to your
PATH variable, export it, and reinitialize your environment (or log
out and log in).
4. Uncompress the IBM HTTP install image in /opt/ibmhttp.
5. Open a new terminal, change directory to /opt/ibmhttp, and
enter java“jar setup.jar.
6. Choose the language in which to run the installation. The Welcome
screen appears (see Figure 3-3). Click Next.
7. The license agreement appears. Choose to accept and click Next.
8. Specify the directory name (see Figure 3-4). Choose the default
/opt/IBMIHS. Click Next.
9. Select the type of installation (see Figure 3-5). Choose Typical, which
installs everything. Click Next.
10. A window will appear summarizing your choices (see Figure 3-6).
Click Next.
11. The installation then starts. A progress bar will appear with a
message that states Installing IBM HTTP Server. Wait. If the
progress bar has reached 100 percent and after ¬ve minutes the
message has not changed to Updating the RPM database, the
process has stalled. Hit Cancel, Reboot, Delete /opt/IBMIHS, and
go back to step 5.
12. After the RPM database has been updated, click Finish.
wy009-03 WY009-BenNatan-v1.cls May 9, 2004 4:37

Installing WebSphere Portal on Linux 47

Figure 3-3 IBM HTTP Server Welcome screen.

Figure 3-4 IBM HTTP Server directory.
wy009-03 WY009-BenNatan-v1.cls May 9, 2004 4:37

48 Chapter 3

Figure 3-5 Choosing the type of installation.

Figure 3-6 Summary of installation options.
wy009-03 WY009-BenNatan-v1.cls May 9, 2004 4:37

Installing WebSphere Portal on Linux 49

Figure 3-7 IBM HTTP Server 2.0 Welcome screen.

13. Start the HTTP server by going into /opt/IBMIHS/bin and
entering ./apachectl start. Verify that the Web server is working by
starting your Web browser and entering your fully quali¬ed host
name in the address bar (for example, sandbox1.
rigorconsultants.com). You should see a page with Welcome
to IBM HTTP server (see Figure 3-7).
14. Place the WebSphere Portal setup disc in the CD drive. Start a new
terminal session and change the directory to /mnt/cdrom. Enter
the command ./install.sh.
15. Select the language for the install and click OK. Also close the
terminal session so you will be able to eject the CD when the
installation process requests you.
16. The Welcome panel will then be displayed. You will then be given
the option to browse the infocenter if you choose Launch Infocenter.
Otherwise click Next.
17. The license agreement will appear. Select I accept the terms
in the license agreement and click Next.
18. The installation then checks the machine for operating system and
software prerequisites. Click Next.
wy009-03 WY009-BenNatan-v1.cls May 9, 2004 4:37

50 Chapter 3

Figure 3-8 WebSphere Portal installation type screen.

19. You will then be asked if you want a Full or Custom install (see
Figure 3-8). Choose Custom.
20. You will then be asked if you want to install a new WebSphere
Application or con¬gure to an existing install of WebSphere
Application. Click on New Install and select Next.
21. You will then be asked to specify the directory to install WebSphere
Application Server (see Figure 3-9). If the directory does not exist, it
will be created. By default, IBM suggests that you install in
/opt/WebSphere/AppServer. Enter the directory and click Next.
22. The next screen asks you if you want to install IBM HTTP Server or
con¬gure WAS to use an existing Web server (see Figure 3-10).
Choose Install the plug-in for an Existing Http
Server. Click Next.
23. You will then be asked to choose the type of HTTP server to use
with WAS (see Figure 3-11). Click IBM HTTP Server. Click Next.
24. The next screen will ask you to specify the location of the http
con¬guration ¬le (see Figure 3-12). Enter /opt/IBMIHS/conf/httpd
.conf and click Next.
wy009-03 WY009-BenNatan-v1.cls May 9, 2004 4:37

Figure 3-9 WebSphere installation directory screen.

Figure 3-10 Installing a new HTTP server or con¬guring an existing Web server.

wy009-03 WY009-BenNatan-v1.cls May 9, 2004 4:37

Figure 3-11 Choosing the HTTP server to install the plug-in.

Figure 3-12 Specifying the location of the HTTP server con¬guration ¬le.

wy009-03 WY009-BenNatan-v1.cls May 9, 2004 4:37

Installing WebSphere Portal on Linux 53

25. You will then be asked where you want to install WebSphere Portal.
Usually it is installed off the WebSphere Application Server
directory root or /opt/WebSphere/Portalserver. Click Next.
26. Enter the user ID and password for the WebSphere Portal
Administrator. (see Figure 2-9). The password and user ID must be
at least ¬ve letters long and contain no blanks. This user ID is
speci¬c to the WebSphere Portal and does not have to be an
Operating System User ID but it must conform to the rules of the
LDAP if you are using an LDAP to manage your users.
27. Verify the components to be installed and click Next.

Next, the program starts installing the selected components. You see the
progress indicator moving as the components are installed. When it asks
you for a CD, you will have to right-click on the CD icon and click Eject.
When the installation is ¬nished, a con¬rmation panel, such as the one
shown in Figure 3-13, is displayed with a listing of the components in-
stalled. The con¬rmation panel will also display the port number used
to access the portal. The port number is also stored in the WpsHostport

Figure 3-13 Screen after a successful install.
wy009-03 WY009-BenNatan-v1.cls May 9, 2004 4:37

54 Chapter 3

property in <wp_root>/config/wpconfig.properties ¬le. Record
the port number and click Finish.
In Linux, the installation program does not add menu items to the desk-
top. You will need to do this manually. You will also need to apply ¬xpack 2.
Use the instructions in Chapter 2 except for downloading the Linux ¬xpacks
and use forward slashes instead of backward slashes for the commands. Re-
member to replace .bat with .sh for the script commands.
The WebSphere Portal installation modi¬es the Web server con¬gura-
tion ¬le to support IBM HTTP Web server plug-ins. To correct
the entries to support IBM HTTP 2.042.2, go to the http.conf ¬le in
/opt/IBMIHS/conf and change:
LoadModule ibm_app_server_http_module


. 12
( 87 .)