BEA Logo BEA WebLogic Portal Release 4.0

  BEA Home  |  Events  |  Solutions  |  Partners  |  Products  |  Services  |  Download  |  Developer Center  |  WebSUPPORT

   http://www.oracle.com/technology/documentation/index.html   |   Search   |   PDF Files   |   Contact   |   Glossary

 

   WebLogic Portal Documentation   |   Installation Guide   |   Previous Topic   |   Next Topic   |   Contents   |   Index

Installing Service Pack 2

 

Note: Installation of WebLogic Portal 4.0 with Service Pack 2 with Rolling Patch 1 is required to run WebLogic Server 6.1 with Service Pack 3. WebLogic Portal 3.5 Service Pack 2 with Rolling Patch 1 is supported for Win32, Solaris or HP-UX. 6.1 SP3 only.

This chapter explains how to install WebLogic Portal 4.0 Service Pack 2 on supported systems.

Warning: Before you install any part of Service Pack 2, see ALERT: Migrating Your Enterprise and Web Applications from WebLogic Portal 4.0 GA and Service Pack 1 to Service Pack 2.

Service Pack 2 consists of two installers:

The installation instructions tell where to download these installers.

This section includes the following information:

 

ALERT: Migrating Your Enterprise and Web Applications from WebLogic Portal 4.0 GA and Service Pack 1 to Service Pack 2

Before you install WebLogic Portal 4.0 with Service Pack 2, note that several resource files (.jar, .jsp, .class files) have been added or modified for Enterprise and Web applications from previous versions of WebLogic Portal 4.0 to WebLogic Portal with Service Pack 2. Failure to complete the migration steps listed in this section will prevent your Enterprise or Web applications from running with Service Pack 2. It is imperative that you complete the following migration steps:

  1. Back up all Enterprise and Web applications that you have created or customized.

    For example, if you needed to back up the enterprise application called portal, you would need to back up all resource files, directories, and Web applications under the following path:

    PORTAL_HOME/applications/portal

    All Web applications like stockportal, reside under the Enterprise application, along with all their resource files, as shown in the following path:

    PORTAL_HOME/applications/portal/stockportal

  2. Install WebLogic Portal 4.0 with Service Pack 2 as described elsewhere in this section.

  3. Update the files in your Enterprise and Web applications in the following ways depending on your particular customization strategies:

 

Installing Service Pack 2 of the WebLogic Portal 4.0 Server

To install Service Pack 2 of the WebLogic Portal 4.0 server, follow the instructions for your platform in the following sections.

Warning: Before you install any part of Service Pack 2, see ALERT: Migrating Your Enterprise and Web Applications from WebLogic Portal 4.0 GA and Service Pack 1 to Service Pack 2.

The following installation instructions tell you which Service Pack 2 installers to download and where to get them.

Windows - Installing Service Pack 2 of the WebLogic Portal 4.0 Server

Warning: Before you install any part of Service Pack 2, see ALERT: Migrating Your Enterprise and Web Applications from WebLogic Portal 4.0 GA and Service Pack 1 to Service Pack 2.

For installation of Service Pack 2 of the WebLogic Portal 4.0 server on supported Windows systems, you can choose between running a full installation or an upgrade installation of Service Pack 2:

Full Installation of the Server on Windows

  1. On the BEA WebLogic Portal Download site, download the following Service Pack 2 installer: wlportal400_with_sp2_win.exe.

  2. Install WebLogic Portal 4.0 server with Service Pack 2 of the WebLogic Portal 4.0 server by running wlportal400_with_sp2_win.exe. Follow the instructions in the installation wizard.

    For more information on the server installation process, see The Installation Procedure on Windows.

  3. Make sure that all preexisting E-Business Control Center installations are updated to Service Pack 2. For new E-Business Control Center installations, use the full E-Business Control Center with Service Pack 2 installation. See Installing Service Pack 2 of the E-Business Control Center.

Upgrade Installation of the Server on Windows

WebLogic Portal 4.0 Service Pack 2 includes modifications to default Webflow namespace files. Because the upgrade installer does not replace these modified Webflow namespaces in the server database, you must re-synchronize your E-Business Control Center data to put the modified Webflow namespaces in the server database after you install Service Pack 2 of the server and the E-Business Control Center.

Warning: Because the upgrade installation of Service Pack 2 involves re-synchronization of data from the E-Business Control Center to the server, it is important to fully test your applications prior to putting them back into production.

  1. Stop any running WebLogic Portal servers.

  2. Back up your WebLogic Portal 4.0 files.

    Note: When you run the upgrade installation, the installer automatically backs up files that it replaces in the following directory:

    PORTAL_HOME\servicepacks\sp2\backup

  3. Log in to the BEA Customer Support site. In the Support Downloads section, click the link to the WebLogic Portal service packs, and download the following Service Pack 2 upgrade installer: wlportal400sp2_win.exe.

  4. Install the WebLogic Portal 4.0 server with Service Pack 2 upgrade by running wlportal400sp2_win.exe. Follow the instructions in the installation wizard.

  5. Make sure that all preexisting E-Business Control Center installations are updated to Service Pack 2. For new E-Business Control Center installations, use the full E-Business Control Center with Service Pack 2 installation. See Installing Service Pack 2 of the E-Business Control Center.

Solaris - Installing Service Pack 2 of the WebLogic Portal 4.0 Server

Warning: Before you install any part of Service Pack 2, see ALERT: Migrating Your Enterprise and Web Applications from WebLogic Portal 4.0 GA and Service Pack 1 to Service Pack 2.

For installation of Service Pack 2 of the WebLogic Portal 4.0 server on supported Solaris systems, you can choose between running a full installation or an upgrade installation of Service Pack 2:

Full Installation of the Server on Solaris

  1. On the BEA WebLogic Portal Download site, download the following Service Pack 2 installer: wlportal400_with_sp2_sol.bin.

  2. Install WebLogic Portal 4.0 server with Service Pack 2 by running wlportal400_with_sp2_sol.bin. Follow the instructions in the installation wizard.

    You can also run Service Pack 2 installation on Solaris in console mode. For more information on the server installation process and installing in console mode, see The Installation Procedure on UNIX.

  3. Make sure that all preexisting E-Business Control Center installations are updated to Service Pack 2. For new E-Business Control Center installations, use the full E-Business Control Center with Service Pack 2 installation. See Installing Service Pack 2 of the E-Business Control Center.

Upgrade Installation of the Server on Solaris

WebLogic Portal 4.0 Service Pack 2 includes modifications to default Webflow namespace files. Because the upgrade installer does not replace these modified Webflow namespaces in the server database, you must re-synchronize your E-Business Control Center data to put the modified Webflow namespaces in the server database after you install Service Pack 2 of the server and the E-Business Control Center.

Warning: Because the upgrade installation of Service Pack 2 involves re-synchronization of data from the E-Business Control Center to the server, it is important to fully test your applications prior to putting them back into production.

  1. Stop any running WebLogic Portal servers.

  2. Back up your WebLogic Portal 4.0 files.

    Note: When you run the upgrade installation, the installer automatically backs up files that it replaces in the following directory:

    PORTAL_HOME/servicepacks/sp2/backup

  3. Log in to the BEA Customer Support site. In the Support Downloads section, click the link to the WebLogic Portal service packs, and download the following Service Pack 2 upgrade installer: wlportal400sp2_sol.bin.

  4. Install the WebLogic Portal 4.0 server with Service Pack 2 upgrade by running wlportal400sp2_sol.bin. Follow the instructions in the installation wizard.

    You can also run Service Pack 2 upgrade installation on Solaris in console mode. For more information on the server installation process, see Console Version of the Installer.

  5. Make sure that all preexisting E-Business Control Center installations are updated to Service Pack 2. For new E-Business Control Center installations, use the full E-Business Control Center with Service Pack 2 installation. See Installing Service Pack 2 of the E-Business Control Center.

UNIX - Installing Service Pack 2 of the WebLogic Portal 4.0 Server

Warning: Before you install any part of Service Pack 2, see ALERT: Migrating Your Enterprise and Web Applications from WebLogic Portal 4.0 GA and Service Pack 1 to Service Pack 2.

Full Installation

  1. In your system PATH, add the location of your JDK. For example: 
    $ set PATH=<BEA_HOME>/jdk131/bin:$PATH
     
    $ export PATH

    where <BEA_HOME> is the home directory of your BEA installation.

  2. On the BEA WebLogic Portal Download site, download the following Service Pack 2 installer: wlportal400_with_sp2_unix.bin.

  3. Install Service Pack 2 of the WebLogic Portal 4.0 server by running wlportal400_with_sp2_unix.bin. Follow the instructions in the installation wizard. For more information on the server installation process and installing in console mode, see The Installation Procedure on UNIX.

  4. In the PORTAL_HOME/bin/unix/set-environment.bat file, specify the location of your JDK in the SET JDK HOME= line.

  5. Make sure that all preexisting E-Business Control Center installations are updated to Service Pack 2. For new E-Business Control Center installations, use the full E-Business Control Center with Service Pack 2 installation. See Installing Service Pack 2 of the E-Business Control Center.

Upgrade Installation of the Server on UNIX

WebLogic Portal 4.0 Service Pack 2 includes modifications to default Webflow namespace files. Because the upgrade installer does not replace these modified Webflow namespaces in the server database, you must re-synchronize your E-Business Control Center data to put the modified Webflow namespaces in the server database after you install Service Pack 2 of the server and the E-Business Control Center.

Warning: Because the upgrade installation of Service Pack 2 involves re-synchronization of data from the E-Business Control Center to the server, it is important to fully test your applications prior to putting them back into production.

  1. Stop any running WebLogic Portal servers.

  2. Back up your WebLogic Portal 4.0 files.

    Note: When you run the upgrade installation, the installer automatically backs up files that it replaces in the following directory:

    PORTAL_HOME/servicepacks/sp2/backup

  3. Log in to the BEA Customer Support site. In the Support Downloads section, click the link to the WebLogic Portal service packs, and download the following Service Pack 2 upgrade installer: wlportal400sp2_unix.bin.

  4. Install the WebLogic Portal 4.0 server with Service Pack 2 upgrade by running wlportal400sp2_unix.bin. Follow the instructions in the installation wizard.

    You can also run Service Pack 2 upgrade installation on Solaris in console mode. For more information on the server installation process, see Console Version of the Installer.

  5. Make sure that all preexisting E-Business Control Center installations are updated to Service Pack 2. For new E-Business Control Center installations, use the full E-Business Control Center with Service Pack 2 installation. See Installing Service Pack 2 of the E-Business Control Center.

 

Installing Service Pack 2 of the E-Business Control Center

The following installation instructions tell you which Service Pack 2 installers to download and where to get them.

Warning: Before you install any part of Service Pack 2, see ALERT: Migrating Your Enterprise and Web Applications from WebLogic Portal 4.0 GA and Service Pack 1 to Service Pack 2.

If you are migrating from an earlier version of the E-Business Control Center and WebLogic Portal 4.0, see one of the following sections before proceeding:

If you are not migrating from a previous version, see "Installing Service Pack 2" on page 4 - 14.

Migrating From WebLogic Portal 4.0 with Service Pack 1 to Service Pack 2

The installation for WebLogic Portal 4.0 with Service Pack 2 will replace your Service Pack 1 webflow files and delete any customizations that you've made to those files.

See Table 4-1 for a list of the webflow files replaced during Service Pack 2 installation.

To save your customizations to Service Pack 1:

  1. Back up any customized Service Pack 1 webflow files to a different location before you perform the installation of the Service Pack 2 E-Business Control Center.

  2. Install Service Pack 2 E-Business Control Center. See Installing Service Pack 2" on page 4 - 14.

  3. Replace the newly installed webflow files with your backed up webflow files.

Migrating From WebLogic Portal 4.0 GA to Service Pack 2

If you installed the upgrade version of Service Pack 2 of the WebLogic Portal server (as opposed to the full installer). The upgrade installers are described in Installing Service Pack 2 of the WebLogic Portal 4.0 Server.

  1. If you are upgrading directly from the original WebLogic Portal 4.0 GA to Service Pack 2 (instead of from Service Pack 1 to Service Pack 2), you must (after installation of Service Pack 2) re-synchronize your E-Business Control Center data for all applications to a test server that also has WebLogic Portal 4.0 with Service Pack 2 installed, making sure your synchronization settings (Tools > Synchronization Settings in the E-Business Control Center) are set to "Update all files in the application," as shown in Figure 4-2.

    Figure 4-2 Synchronization settings


     

    Warning: When you synchronize, make sure that all necessary application data files are loaded in the E-Business Control Center, especially if you have stored your data files in a content management or version control system. If any necessary files are not loaded in the E-Business Control Center, the synchronization process will treat them as deleted files and remove them from the server.

    To see which data files need to be loaded in the E-Business Control Center, look in the PORTAL_HOME\applications\<application_name>-project folder on the server to see the currently synchronized application files.

  2. Test and debug your applications on your test server, then synchronize to your live production server that is also running WebLogic Portal 4.0 with Service Pack 2.

Table 4-1 shows the Webflow namespace files that are replaced by the Service Pack 2 installation directly from the original WebLogic Portal 4.0 GA. These files appear in the E-Business Control Center Explorer window for each given application.

Note: This table does not apply to migration from Service Pack 1 to Service Pack 2.

Table 4-1 Webflow namespace files replaced in conversion from original WLPortal 4.0 GA directly to Service Pack 2

Application

Webapp

Webflow Namespace

portal

stockportal

 
user_account.wf

tools

 
admin_main.wf

wlcsApp

tools

 
admin_main.wf

wlcs

 
sampleapp_main.wf
 
sampleapp_order.wf
 
sampleapp_search.wf
 
sampleapp_user.wf
 
tracking.wf

 

The Webflow namespace files that were replaced by the E-Business Control Center Service Pack 2 installer are moved into the following backup folders on the client systems:

 
EBCC_HOME\servicepacks\sp2\backup\applications\portal\
application-sync\webapps\stockportal
 
EBCC_HOME\servicepacks\sp2\backup\applications\wlcsApp\
application-sync\webapps\tools
 
EBCC_HOME\servicepacks\sp2\backup\applications\wlcsApp\
application-sync\webapps\wlcs

Reapplying Modifications to Webflow Namespace Files That Were Replaced

If you have made modifications to any of the default Webflow namespaces that were replaced by the upgrade installation, we recommend reapplying those modifications to the newly installed webflow namespace files using the following method:

  1. In the backup directory to which the older Webflow namespace files were moved, rename those files, maintaining the .wf extension.

  2. Copy the renamed files to the application folders from which they were moved. For example, if you renamed the admin_main.wf to admin_main_old.wf, copy it from the backup directory to EBCC_HOME\applications\wlcsApp\application-sync\webapps\tools, where the new version of admin_main.wf resides.

  3. In the E-Business Control Center, open the application containing the renamed namespace and the new Webflow namespace files.

  4. Open the renamed and the new Webflow namespace files in the E-Business Control Center, and switch back and forth between the two files, adding your previous modifications to the new Webflow namespace file.

  5. When you are finished modifying the new Webflow namespace files, delete the renamed .wf files from the application directory, and then synchronize your E-Business Control Center data to a test server to test the modifications. When testing is complete, synchronize to your live production server.

Installing Service Pack 2

Warning: Before you install any part of Service Pack 2, see ALERT: Migrating Your Enterprise and Web Applications from WebLogic Portal 4.0 GA and Service Pack 1 to Service Pack 2.

For installation of Service Pack 2 of the E-Business Control Center on supported systems, you can run a full installation or an upgrade installation of Service Pack 2:

To install the E-Business Control Center:

  1. Back up any existing E-Business Control Center files.

  2. On the BEA WebLogic Portal Download site, download one of the following Service Pack 2 installers:

    Solaris Full Installer - ebcc400_with_sp2_sol.bin

    Windows Full Installer - ebcc400_with_sp2_win.exe

    Solaris Upgrade Installer - ebcc400sp2_sol.bin

    Windows Upgrade Installer - ebcc400sp2_win.exe

  3. On each client system, run the appropriate installation program.

 

Updating the License File

You must update the product license file. See the following sections for information on updating your license:

 

Next Steps

After you complete the product's server installation and you update the license file:

If you need to uninstall the server software, see the following section.

 

Uninstalling Service Pack 2

The following sections tell you how to uninstall Service Pack 2 of the WebLogic Portal server and the E-Business Control Center.

Uninstalling Service Pack 2 of the WebLogic Portal Server

To uninstall your particular version of WebLogic Portal 4.0 server with Service Pack 2, follow the instructions in the appropriate section below.

Windows Upgrade Uninstall

  1. Stop the server if it is running.

  2. Create a backup copy of any files you modified in the PORTAL_HOME directory structure.

  3. Choose Start —> Programs —> BEA WebLogic E-Business Platform —> BEA WebLogic Portal 4.0 —> Uninstall BEA WebLogic Portal 4.0 sp2.

    You can also run the following uninstall program: PORTAL_HOME\uninstaller_servicepack\uninstall_wlportal40sp2.exe

    The Service Pack 2 files are removed and replaced with the original files.

  4. Uninstall E-Business Control Center with Service Pack 2 upgrade installations on all client systems.

  5. Re-synchronize your E-Business Control Center data for all applications to a test server that also has WebLogic Portal 4.0 with Service Pack 2 installed, making sure your synchronization settings (Tools > Synchronization Settings in the E-Business Control Center) are set to "Update all files in the application," as shown in Figure 4-2.

    If your E-Business Control Center installations are full installations of E-Business Control Center with Service Pack 2 (rather than upgrade installations), completely uninstall the E-Business Control Center and reinstall the general release version of the E-Business Control Center from the BEA Support download site. After reinstallation, re-synchronize your E-Business Control Center data to the server.

    Warning: When you synchronize, make sure that all necessary application data files are loaded in the E-Business Control Center, especially if you have stored your data files in a content management or version control system. If any necessary files are not loaded in the E-Business Control Center, the synchronization process will treat them as deleted files and remove them from the server.

    To see which data files need to be loaded in the E-Business Control Center, look in the PORTAL_HOME\applications\<application_name>-project folder on the server to see the currently synchronized application files.

Windows Full Installation Uninstall

  1. Stop the server if it is running.

  2. Create a backup copy of any files you modified in the PORTAL_HOME directory structure.

  3. Choose Start —> Programs —> BEA WebLogic E-Business Platform —> BEA WebLogic Portal 4.0 —> Uninstall BEA WebLogic Portal 4.0.

    You can also run the following uninstall program: PORTAL_HOME\uninstaller\uninstall.exe

    The entire WebLogic Portal 4.0 is uninstalled.

Solaris Upgrade Uninstall

  1. Stop the server if it is running.

  2. Create a backup copy of any files you modified in the PORTAL_HOME directory structure.

  3. Run the following uninstall program:
    PORTAL_HOME/uninstaller_servicepack/uninstall_wlportal40sp2.bin

    The Service Pack 2 files are removed and replaced with the original files.

  4. Uninstall E-Business Control Center with Service Pack 2 upgrade installations on all client systems.

  5. Re-synchronize your E-Business Control Center data for all applications to a test server that also has WebLogic Portal 4.0 with Service Pack 2 installed, making sure your synchronization settings (Tools > Synchronization Settings in the E-Business Control Center) are set to "Update all files in the application," as shown in Figure 4-2.

    If your E-Business Control Center installations are full installations of E-Business Control Center with Service Pack 2 (rather than upgrade installations), completely uninstall the E-Business Control Center and reinstall the general release version of the E-Business Control Center from the BEA Support download site. After reinstallation, re-synchronize your E-Business Control Center data to the server.

    Warning: When you synchronize, make sure that all necessary application data files are loaded in the E-Business Control Center, especially if you have stored your data files in a content management or version control system. If any necessary files are not loaded in the E-Business Control Center, the synchronization process will treat them as deleted files and remove them from the server.

    To see which data files need to be loaded in the E-Business Control Center, look in the PORTAL_HOME/applications/<application_name>-project folder on the server to see the currently synchronized application files.

Solaris Full Installation Uninstall

  1. Stop the server if it is running.

  2. Create a backup copy of any files you modified in the PORTAL_HOME directory structure.

  3. Run the following uninstall program:
    PORTAL_HOME/uninstaller/uninstall.bin

    The entire WebLogic Portal 4.0 server is uninstalled.

Uninstalling Service Pack 2 of the E-Business Control Center

  1. Exit the E-Business Control Center if it is running.

  2. Create a backup copy of any files you modified in the EBCC_HOME directory structure.

  3. Use the uninstall procedure from the following list that matches your installation of E-Business Control Center 4.0 server Service Pack 2.

 

back to top previous page next page

 

Copyright © 2001 BEA Systems, Inc. All rights reserved.
Required browser: Netscape 4.77 or higher, or Microsoft Internet Explorer 5.01 or higher.
Contact us (documentation feedback only)