*************************************************************** (c) Copyright 1999, 2001 International Business Machines Corp. All rights reserved. *************************************************************** Welcome to IBM WebSphere Application Server, Single Server Edition, Version 4.0.1 PTF 2 for AIX, HP-UX, Linux, Solaris, Windows NT, and Windows 2000. This PTF is for upgrading the WebSphere Application Server, the J2EE Client, and the J2EE Thin Client. This README contains information about: * Prerequisites * Space requirements * Installing PTF 2 on AIX, HP-UX, Linux, and Solaris * Uninstalling PTF 2 on AIX, HP-UX, Linux, and Solaris * Installing PTF 2 on Windows NT and 2000 * Uninstalling PTF 2 on Windows NT and 2000 * Finding additional information PREREQUISITES ------------- Install this PTF on top of the IBM WebSphere Application Server Version 4.0.1 base. PTF 2 expands the list of supported product prerequisites. See the following Web site for details: http://www.ibm.com/software/webservers/appserv/doc/latest/prereq.html SPACE REQUIREMENTS ------------------ The PTF installation program requires some temporary space, approximately 110 MB. After it is installed, the PTF 2 code increases the IBM WebSphere Application Server installation and runtime footprints by a small amount. FINDING ADDITIONAL INFORMATION ------------------------------ In addition to this README file, see the Version 4.0 InfoCenter: http://www.ibm.com/software/webservers/appserv/infocenter.html See the InfoCenter for: * Release Notes for Version 4.0.1 PTF 2 * Release Notes for Version 4.0.1 * README for Version 4.0.1 base The above documents are also available from the InfoCenter site map. INSTALLING PTF 2 ON AIX, HP-UX, LINUX, AND SOLARIS ------------------------------------------------------- 1. Obtain the tar or zip was40_aes_ptf_2_(Platform) from the product Web site: http://www.ibm.com/software/webservers/appserv/efix.html Download the file into an empty directory on the machine on which you plan to install the PTF. For example, download the file to the /tmp directory. 2. At a system command prompt, change the directory to where you downloaded the file, for example: # cd /tmp 3. Untar or unzip the file. For untarring: # tar -xvf was40_aes_ptf_2_(Platform).tar For unzipping : # gunzip was40_aes_ptf_2_(Platform).zip 4. Stop the Web server that you have been using with IBM WebSphere Application Server. 5. Stop IBM WebSphere Application Server. Make sure all WebSphere processes have terminated before proceeding. Due to garbage collection all java processes may not terminate for some time. Use the command ps -ef | grep java to verify that there are no java processes running. 6. Determine the IBM WebSphere Application Server installation root for the respective operating system. By default, these locations are: AIX /usr/WebSphere/AppServer HP-UX /opt/WebSphere/AppServer Linux /opt/WebSphere/AppServer Solaris /opt/WebSphere/AppServer For the most updated information, consult: http://www.ibm.com/software/webservers/appserv/doc/v40/aes/infocenter/was/root.html 7. View the PTF install log (/logs/was40_aes_ptf_2.log) for warnings and errors in the logs directory. If the return code $? does not equal 0 this indicates an error has occured. USING THE INSTALLATION SCRIPT ----------------------------- 1. Install the PTF using the installation script or using the silent installation. a. If installing the PTF on Linux, before starting the install script you must update the Path environment variable: PATH=/opt/WebSphere/AppServer/java/bin:$PATH b. Run the PTF installation script: # ./install.sh c. Follow the instructions provided during the installation program. During installation, the following inputs need to be given: i. WebSphere Root Directory : (The default locations for different platforms are: Solaris/HP/ Linux : /opt/WebSphere/AppServer AIX : /usr/WebSphere/AppServer ) ii. IHS Root Directory : (The default locations for the different platforms are: Solaris: /opt/IBMHTTPD AIX: /usr/HTTPServer Linux: /opt/IBMHTTPServer HP: /opt/HTTPServer ) USING THE SILENT INSTALLATION ----------------------------- 1. Set the following environment variables prior to performing silent install: WAS_DIR Set WAS_DIR to the product installation root that you determined in a previous step ie: WAS_DIR=/opt/WebSphere/AppServer IHS_INSTALL Set IHS_INSTALL to true if you want to install IHS PTF, else false ie: IHS_INSTALL=true IHS_HOME Set IHS_HOME to the directory where IBM HTTP Server is installed ie: IHS_HOME=/opt/IBMHTTPServer On UNIX systems export the following environment variables: export WAS_DIR export IHS_INSTALL export IHS_HOME 2. Run the install silently by issuing the command: ./install.sh -silent * If the required environment variables are not set, the install process will list them out and exit. 3. View the PTF install log (/logs/was40_aes_ptf_2.log) for warnings and errors in the logs directory. If the return code $? does not equal 0 this indicates an error has occured. UNINSTALLING PTF 2 ON AIX, HP-UX, LINUX, AND SOLARIS --------------------------------------------------------- 1. Stop IBM WebSphere Application Server. Make sure all WebSphere processes have terminated before proceeding. Due to garbage collection all java processes may not terminate for some time. Use the command ps -ef | grep java to verify that there are no java processes running. 2. Stop the Web Server that you have been using with IBM WebSphere Application Server. 3. At a system command prompt, change directory to the product installation root. 4. Run the uninstall script. During the uninstall you will be asked for the directory where the IBM JDK 1.3 is installed uninstall_ptf_2.sh INSTALLING PTF 2 ON WINDOWS NT (AND 2000) ---------------------------------------------- 1. Obtain was40_aes_ptf_2.zip from the product Web site: http://www.ibm.com/software/webservers/appserv/efix.html Download the file into an empty directory on the machine on which you plan to install the PTF. 2. At a system command line, change directory (cd) to where you downloaded the file. 3. Unzip the file. 4. Stop the Web server that you have been using with IBM WebSphere Application Server. 5. Stop IBM WebSphere Application Server. Make sure all WebSphere processes have terminated before proceeding. Due to garbage collection all java processes may not terminate for some time. Use the Task Manager to verify that there are no java processes running. 6. Determine the product installation root for the operating system. By default, the value on Windows NT is: :\WebSphere\AppServer 7. View the PTF install log (\logs\was40_aes_ptf_2.log) for warnings and errors in the logs directory. If the environment variable %errorlevel% does not equal 0 this indicates an error has occured. 8. If this PTF installation was for a J2EE client or a ThinClient please do the following: After running the PTF installer the following files need to be copied from the WebSphere\AppClient\java\jre\bin directory: -The npwebscl.dll needs to replace the old file by the same name in the Plugins directory of any Netscape installed on the system. -The pluginw.cpl file needs to replace the old file by the same name in \winnt\system32 (or \windows\system32) directory. USING THE INSTALLATION SCRIPT ----------------------------- 1. Run the PTF installation batch file: install.bat 2. Follow the instructions provided by the installation program. During installation, the following will be asked for: i. WebSphere Root Directory : (Example : :\WebSphere\AppServer) ii. IHS Root Directory : (Example : :\IBM HTTP Server) USING THE SILENT INSTALLATION ---------------------------- 1. Set the following environment variables prior to performing silent install: WAS_HOME Set WAS_HOME to the product installation root that you determined in a previous step [Example : set WAS_HOME=:\WebSphere\AppServer] IHS_INSTALL Set IHS_INSTALL to true if you want to install IHS PTF, else false IHS_HOME Set IHS_HOME to the directory where IBM HTTP Server is installed. [Example : set IHS_HOME=:\IBM HTTP Server] 2. Run the install silently by issuing the command: install.bat -silent * If the required environment variables are not set, the install process will list them out and exit. 3. View the PTF install log (\logs\was40_aes_ptf_2.log) for warnings and errors in the logs directory. If the environment variable %errorlevel% does not equal 0 this indicates an error has occured. UNINSTALLING PTF 2 ON WINDOWS NT (AND 2000) ------------------------------------------------ 1. Stop IBM WebSphere Application Server. Make sure all WebSphere processes have terminated before proceeding. Due to garbage collection all java processes may not terminate for some time. Use the Task Manager to verify that there are no java processes running. 2. Stop the Web server that you have been using with IBM WebSphere Application Server. 3. At a system command prompt, change directory to the product installation root. 4. Run the uninstall script. During the uninstall you will be asked for the directory where the IBM JDK 1.3 is installed uninstall_ptf_2