Portals

This article provides instructions for installing IBM WebSphere Portal Server v5.0.2 on the SuSE LINUX 8 (SLES 8) operating system on IBM zSeries hardware.

Fix pack 2 of WebSphere Portal Server v5.0, also known as WebSphere Portal Server v5.0.2, introduces support for WebSphere Portal on the SuSE SLES for S/390 8.2.4 kernel (SuSE Linux 8) and RedHat for S/390 7.2 platforms. WebSphere Portal Server v5.0.2 runs on WebSphere Application Server v5.0.2. The previous version of WebSphere Application Server v5.0 on Linux on zSeries has been superseded by v5.0.2, which is an entirely new installation. There is no fix pack to update a v5.0 installation to v5.0.2 on Linux on zSeries.

The following IBM Middleware products will be installed:

• WebSphere Application Server v5.0.2
• WebSphere Application Server Enterprise v5.0.2
• WebSphere Portal Server v5.0
• WebSphere Portal Fix Pack 2 (also called WebSphere Portal Server v5.0.2)

Note: This article does not cover the installation process of any databases, Web servers, or LDAP servers. To install these products, refer to the manufacturer's documentation. Also, to perform the configuration of WebSphere Portal Server v5.0.2 with databases, Web servers, or LDAP servers, refer to the WebSphere Portal Info Center.

Prerequisites
Tables 1-3 contain the information you need before beginning the installation of WebSphere Portal Server v5.0.2. Here you will find the operating system requirements for SLES 8, IBM hardware requirements, IBM Middleware component space requirements, and WebSphere installation file requirements.

Hardware Requirements
Table 1 displays the system requirements for SLES 8. Table 2 describes the space requirements for the IBM Middleware components.

Table 3 specifies the files and WebSphere Portal Server CDs that are required for the installation of WebSphere Portal Server v5.0.2.

Install WebSphere Application Server Base v5.0.2
The installation program for WebSphere Application Server Base v5.0.2 is located in the "was/zlinux/linuxs390/WAS50" directory on the WebSphere Application Server Enterprise for zLinux disc, which is included with WebSphere Portal v5.0.2.

1. Start the installation

   cd /mnt/cd1-14/was/zlinux/linuxs390/WAS50./install.sh

2. Select a language for the wizard GUI and click Next.
3. The installation wizard opens and a Welcome page appears. Click Next to continue.
4. The license agreement will appear. Click the radio button beside the I accept the terms in the license agreement message if you agree to the license agreement and click Next.
5. Choose Custom install to select installation features. Click Next.
6. Select all features to install except the following and click Next to continue.
   - Embedded Messaging
   - IBM HTTP Server (Optional)
   - Web server plugins (If you choose to install the IBM HTTP Server, then select the appropriate plugin.)
7. Accept the default destination directory. Click Next to continue.
8. If you choose to install the Web server plugin, specify the target directory for selected Web server plugins. Click Next to continue.
9. Accept the default values for the Node Name field and Host Name or IP Address fields. Click Next.
10. Review the summary information and click Next to install the product code or Back to change your specifications.
11. The installation process begins. Depending on your system, this may take up to 10 minutes.
12. When the installation is complete, click Next to register the product, or deselect the check box and click Next to register at a later time.
13. Click Finish to close the installation wizard.
14. The installation is complete.

Verification: WebSphere Application Server Base v5.0.2
Follow these steps to verify the proper installation of the WebSphere Application Server v5.0.2 software.

1. Display the WebSphere Application Server version level by typing the following commands:

   cd /opt/WebSphere/AppServer/bin./versionInfo.sh

   Review the Version field for the IBM WebSphere Application Server installed product. A value of 5.0.2 indicates a proper installation.

2. Verify the installation of WebSphere Application Server by typing the following commands:

   cd /opt/WebSphere/AppServer/bin./ivt.sh

   Verify that WebSphere Application Server is running and all verification status values are Passed.

3. The verification is complete.

Install WebSphere Application Server Enterprise v5.0.2
The installation program for WebSphere Application Server Enterprise v5.0.2 is located in the "was/zlinux/linuxs390" directory on the WebSphere Application Server Enterprise for zLinux disc, which is included with WebSphere Portal 5.0.2.

1. Start the installation

   cd /mnt/cd1-14/was/zlinux/linuxs390./install.sh

2. Select a language for the wizard GUI and click Next.
3. The installation wizard opens and a welcome page appears. Click Next to continue.
4. The license agreement appears for you to read. Click the radio button beside the I accept the terms in the license agreement message if you agree to the license agreement and click Next to continue.
5. Note that the installation wizard detects a previous installation of WebSphere Application Server V5.0.2. This is an anticipated event in the process; accept the defaults on this panel. Click Next.
6. Choose Custom install to select installation features. Click Next.
7. A panel of selectable installation components displays. Accept the defaults on this panel. Click Next.
8. Review the summary information and click Next to install the product code or Back to change your specifications
9. The installation process begins. Depending on your system, this may take up to 10 minutes.
10. When the installation is complete, Click Next to register the product, or deselect the check box and click Next to register at a later time.
11. Click Finish to close the installation wizard.
12. The installation is complete.

Verification: WebSphere Application Server Enterprise v5.0.2
Follow these steps to verify the proper installation of WebSphere Application Server Enterprise v5.0.2.

1. Display the WebSphere Application Server version level by typing the following commands.

   cd /opt/WebSphere/AppServer/bin./versionInfo.sh

   Review the Version field for the IBM WebSphere Application Server Enterprise installed product. A value of 5.0.2 indicates a proper installation.

2. The verification is complete.

Apply WebSphere Application Server v5.0.2 Fixes
WebSphere Portal Server v5.0.2 requires 17 e-fixes to install on the WebSphere Application Server. These are available in the "fixes/<operating_system>/efixes" directory on the WebSphere Application Server Fix Pack disc for your operating system. Or you can download a compressed archive containing the fixes from the WebSphere Portal support site.

Follow these steps to install the WebSphere Application Server v5.0.2 Fixes.

1. Copy the fixes directory and the e-fix installation program to the /tmp/efixes directory.
2. Start the installation program by typing the following commands:

   cd /tmp/efixes/fixes/linux/./updateWizard.sh

3. Select your preferred language. Click Next.
4. The Welcome to IBM WebSphere Application Server products welcome panel appears. Click Next.
5. Note that the installation wizard detects previous installations of WebSphere Application Server v5.0.2 and WebSphere Application Server Enterprise v5.0.2. This is an anticipated event in the process; accept the defaults on this panel. Click Next.
6. Click the Install fixes radio button. Click Next.
7. Specify the path in the Fix directory field as the following directory and click Next.

   /tmp/efixes/fixes/zlinux/efixes

8. Click the checkboxes to select all fixes. Click Next.
9. Verify the fixes selected for installation. Click Next.
10. A panel displays indicating that the fixes were successfully installed. Click Finish.

Verification: WebSphere Application Server v5.0.2 Fixes
To verify the proper installation of the WebSphere Application Server v5.0.2 Fixes, display a list of the fixes you installed in the fix pack by typing the following commands:

cd /tmp/fixes/linux
./updateSilent.sh -fix -installDir
/opt/WebSphere/Application

Note: Although this command is shown on multiple lines for clarity, it should be entered on the same line.

The entries in this list confirm the individual fix packs that you selected for installation.

Install WebSphere Portal Server v5.0
The installation program for WebSphere Portal Server v5.0 is located in the root directory on the Setup CD disc, which is included with WebSphere Portal 5.0.2.

1. Start the installation

   ./installzLinux.sh

   Note: You must run the installzLinux.sh command from the directory where the command script is located. Attempting to run the command from another location (for example, /mnt/cdrom/installzLinux.sh) will fail.

2. Select a language for the wizard GUI and click Next.
3. The installation wizard opens and a Welcome page appears. Click Next to continue.
4. The license agreement appears for you to read. Click the radio button beside the I accept the terms in the license agreement message if you agree to the license agreement and click Next to continue.
5. WebSphere Portal Install checks for operating system and software requirements, and then displays a panel of setup options. Choose Custom setup.
6. Click the radio button for Use an existing instance of WebSphere Application Server. Click Next.
7. Assure that the following directory in the Existing WebSphere Application Server Instances field is highlighted. Click Next.

   /opt/WebSphere/AppServer

8. The installer validates the instance of WebSphere Application Server Enterprise install, then specifies an installation directory for WebSphere Portal Server. Accept the default directory. Click Next.
9. Type the Portal administrative username and password. Click Next.

   Portal administrative user:
   wpsadmin
   Portal administrative user
   password: wpsadmin
   Confirm password: wpsadmin

10. A panel displays the features to be installed. Click Next.
    - WebSphere Portal
    - WebSphere Portal Content Publishing
11. The installation process begins. Depending on your system, this may take up to 45 minutes.
12. When the installation is complete, click Finish.

Verification: WebSphere Portal Server v5.0
Follow these steps to verify the proper installation of the WebSphere Portal Server v5.0 software.

1. Start the WebSphere Portal Server if it is not already running

   cd /opt/WebSphere/AppServer/bin./startServer.sh WebSphere_Portal

2. Open a Web browser and type in the following URL:

   http://<hostname>:<port>/wps/portal

   where hostname is the fully qualified hostname and port is the port where WebSphere Portal is installed; normally it is 9081.

3. The IBM WebSphere Portal Server Welcome page displays. Click Login.
4. The WebSphere Portal Administrative page displays. Note that in the About WebSphere Portal portlet, the version of IBM WebSphere Portal has changed to 5.0.
5. The verification is complete. Click Logout.

Install Fix Pack 2 of WebSphere Portal Server v5.0
The installation program for fix pack 2 of WebSphere Portal Server v5.0 is available in the "fixpack/<operating_system>" directory on the WebSphere Application Server FixPack disc for your operating system. Or, you can download a compressed archive containing the fixes from the WebSphere Portal support site.

Follow these steps to install the WebSphere Application Server v5.0.2 Fixes.

1. Copy the fixes directory and the e-fix installation program to the /tmp/fixpack directory.
2. Set up the Java environment for the update installer by typing the following commands:

   cd /opt/WebSphere/AppServer/binsource setupCmdLine.sh

3. Ensure that all WebSphere Application Server servers are stopped.

   ./stopServer.sh server1
   ./stopServer.sh WebSphere_Portal

4. Run the WebSphere Portal update installer to apply the fix pack by running the following command:

   cd /tmp/fixpack./updatePortal.sh -fixpack
   -installDir "/opt/WebSphere/PortalServer"
   -fixpackDir "/tmp/fixpack/fixpacks"
   -install
   -fixpackID WP_PTF_502

   Note: Although the command above is shown on multiple lines for clarity, it should be entered on the same line.

   After you have installed the fix pack using one of the previous commands, you must complete the configuration steps in these instructions before proceeding with any other WebSphere Portal configuration. Failure to complete these steps will result in a partial installation of the fix pack, which can cause unexpected behavior and interfere with the proper functioning of your portal.

5. Perform the configuration steps by typing the following commands:

   cd /opt/WebSphere/PortalServer/config
   ./WPSconfig.sh WP-PTF-502 -DPortalAdminPwd=wpsadmin

6. The execution of this command will require about 85 minutes. The configuration has completed successfully when you see BUILD SUCCESSFUL at the end.

Verification: Fix-pack 2 of WebSphere Portal Server v5.0
Follow these steps to verify the proper installation of the WebSphere Portal Server v5.0 software.

1. Start the WebSphere Portal Server if it is not already running.

   cd /opt/WebSphere/AppServer/bin
   ./startServer.sh WebSphere_Portal

2. Open a Web browser and type in the following URL:

   http://<hostname>:<port>/wps/portal

   where hostname is the fully qualified hostname and port is the port where WebSphere Portal is installed; normally it is 9081

3. The IBM WebSphere Portal Server welcome page displays. Click Login.
4. The WebSphere Portal Administrative page is displayed. Note that in the About WebSphere Portal portlet, the version of IBM WebSphere Portal has changed to 5.0.2.
5. Click Logout.

Add Your Feedback

In order to post a comment you need to be registered and logged in.

Register | Log in

Please wait while we process your request...