784 WebSphere Studio Application Developer Version 5 Programming Guide © Copyright IBM Corp. 2003. All rights reserved. 785 Appendix A. Product installation In this appendix we describe how to install Application Developer and WebSphere Application Server. The installation instructions specifically apply to Version 5.0, but also should be very similar for more recent versions of the product. The following topics are covered: Installing DB2 UDB Installing WebSphere Application Server Installing Application Developer Update Application Developer A 786 WebSphere Studio Application Developer Version 5 Programming Guide Installing DB2 UDB To run our samples, you require a relational database system. All our testing was done with DB2 UDB Version 7.2 Fix Pack 7. Although it may be possible to run most of the examples with another relational database system, we only tested the examples with DB2 UDB. Installing DB2 UDB Version 7.2 is straight forward. Just follow the installation panels. You do not have to install all of the components, such as data warehousing and performance tools. The suggested installation directory is C:\SQLLIB. After the base installation, you have to install Fix Pack 7 or later. Also, it is required that you run the command file java12\usejdbc2.bat which is located in the installation directory of DB2 (usually SQLLIB) to enable the JDBC Version 2 support for data sources. This is not required if you use DB2 Version 8.1. Installing WebSphere Application Server This section describes how to install WebSphere Application Server. Hardware prerequisites Hardware requirements include: Any Intel®-based PC running Windows NT® Server V4.0, SP 6a or later, Windows 2000 Server, or Advanced Server SP 2 Intel Pentium® processor at 500 MHz, or faster Minimum 180 MB free disk space for installation (includes SDK) Minimum 384 MB memory; 512 MB recommended Software prerequisites The installation requires the following software to be installed: Windows NT Server or Windows 2000 Server Netscape Communicator 4.7.9 or Microsoft Internet Explorer 5.5 SP 2 and 6.0 Web browser that supports HTML 4 and CSS Appendix A. Product installation 787 For updated information about the hardware and software requirements please refer to WebSphere Version 5 InfoCenter. For the WebSphere installation, the database does not have to be configured. Cloudscape can be used in test environment, however, other databases are required for the production environment. The following databases are supported with WebSphere Application Server V5 and WebSphere Network Deployment V5 on Windows platforms: Cloudscape 5.06 DB2 UDB V7.2 Fixpack 7 Informix Dynamic Server Versions 7.31 and 9.3 Oracle Enterprise Edition 8i Release 3 (8.1.7) Oracle Enterprise Edition 9i Release 2 (9.2) SQL Server Enterprise 7.0 SP 4 and 2000 SP 2 IBM HTTP Server is bundled with base WebSphere Application Server V5. However, the following HTTP servers can also be installed and configured to work with WAS V5: Apache Server 1.3.26 HTTP Server 1.3.26 AIX, Linux/390, Linux/Intel, NT Internet Information Server 4.0 Sun ONE Web Server, Enterprise Edition (formerly iPlanet) 6.0 SP 4 Lotus Domino™ Enterprise Server (as HTTP Server) 5.0.9a Before we start the installation we also have to create the user with administrative rights on the local machine. Installation Application Server 5.0 The Install Shield Multi Platform (ISMP) is a new installer that is used to install the product on Intel, AIX, Linux, Linux/390, and Solaris. It checks the installation prerequisites. It also generates the uninstall program after the product has been completely installed. The administrative database of WebSphere Version 4 does not exist any longer. All of the configuration information for the WebSphere Application Server Version 5 is now contained in XML files in the ${WAS_ROOT}\config directory. There are many files that contain all the configuration information. 788 WebSphere Studio Application Developer Version 5 Programming Guide Installation process First we start the LaunchPad (launchpad.bat) to access the product overview, the ReadMe file, and installation guides. Select Install the product to launch the installation wizard (Figure A-1). Figure A-1 WebSphere Application Server LaunchPad In the first dialog panel, select the language and click OK . Click Next in the Welcome panel. After confirming that we agree with the licence agreement, we have to choose between two installation choices: Ty pi ca l and Custom . Choosing Typical installs the entire product, whereas the Custom installation option allows you to deselect components you do not want to install. We chose the Typical installation. The installation directories for the selected components are entered in the next panel. We chose: C:\WebSphere\AppServer C:\IBMHttpServer C:\WebSphere MQ Appendix A. Product installation 789 In the following panel we enter a node name and host name or IP address. In addition, we can select to install both WebSphere Application Server and IBM HTTP Server as a service on NT or Windows 2000. After the Summary window, the installation starts. The FirstSteps dialog is started automatically at the end of the installation. Verifying the installation Installation verification can be started from the menu. In Windows 2000, select Start -> IBM WebSphere -> Application Server v5.0 -> First Steps . Then select Verify Installation . We can also start the command ivc localhost . If the install was successful, you should see messages similar to the following: OS: Windows 2000 locale: en_US hostname: NODENAME cmd.exe /c "C:\WebSphere\AppServer\bin\ivt" NODENAME 9080 C:\WebSphere\AppServer IVT0006I: Connecting to the WebSphere Server NODENAME on Port:9080 IVT0007I:WebSphere Server NODENAME is running on Port:9080 IVT0060I: Servlet Engine Verification: Passed IVT0065I: JSP Verification: Passed IVT0066I: EJB Verification: Passed IVT00100I: IVT Verification Succeeded IVT0015I: Scanning the file C:\WebSphere\AppServer\logs\server1\SystemOut.log for errors and warnings IVT0020I: 0 Errors/Warnings were detected in the file C:\WebSphere\AppServer\logs\server1\SystemOut.log IVT0110I: Installation Verification is complete. 790 WebSphere Studio Application Developer Version 5 Programming Guide Installing Application Developer Before you proceed with installation, please verify that your hardware and software configurations meet the following prerequisites. Hardware prerequisites Intel Pentium II processor minimum (Pentium III 500 MHz or higher is recommended) 512 MB RAM minimum (768 MB RAM is recommended) Disk space: You will require 940 MB minimum disk space for installing Application Developer and additional disk space for your development resources. Minimum disk space can be reduced if optional features and run-time environments are not installed In addition to the space required to install the product, you must have at least 50 MB free on your Windows system drive, and your environment variable TEMP or TMP must point to a valid temporary directory with at least 10 MB free Note that you also require additional disk space if you download the electronic image to install Application Developer Display resolution: 800 x 600 pixels minimum (1024 x 768 recommended) Software prerequisites The following software must be installed before you install WebSphere Studio Application Developer: One of the following operating systems: – Windows 2000 Professional with Service Pack 2 or higher – Windows XP Professional – Windows NT Workstation or Server Version 4.0 with Service Pack 6a – Red Hat, Version 7.2 – SuSE, Version 7.2 A Web browser to view the license agreements and the online help for the WebSphere Studio Installation Launcher Note: Refer to the Migration Guide (these are the migrate.html and migrate.pdf files in Application Developers installation directory) for information on how to migrate from VisualAge for Java, WebSphere Studio, and previous versions of Application Developer. Appendix A. Product installation 791 For information about supported database servers, Web application servers, and other software products, see the readme and the install files located in the root of the installation CD directory. Installing Application Developer Application Developer’s installation routine can be started from CD-ROM or the folder where the setup.exe file is located. To install the product, log in as an administrator and perform the following steps: Double-click setup.exe and the Installation Launcher dialog appears (Figure A-2). Figure A-2 Application Developer Installation dialog Select Install IBM WebSphere Studio Application Developer. Note: If you had Application Developer Version 4.0 installed and you downloaded and installed any third-party plug-ins, you need to get the corresponding plug-ins for Version 5 and reinstall them. Note: If you have VisualAge for Java or any version of WebSphere Studio already installed, there is no need to un-install it before installing Application Developer. You can install Application Developer 5 in a separate directory, but do not install this version of Application Developer over an earlier version. 1. Install Application Developer 2. Install IBM Agent Controller 3. Embedded messaging not required for the samples 792 WebSphere Studio Application Developer Version 5 Programming Guide In the Welcome page, click Next . In the Licence Agreement page, accept the agreement and click Next . In the Destination Folder page, select a folder of your choice and then click Next . We installed the product into C:\WSAD5. In the Custom Setup page, select the ClearCase Adapter if you want to use ClearCase LT, otherwise accept the defaults, and click Next . In the Ready to Install the Program page, click Install . When the wizard completes, click Finish . Start Application Developer. When prompted, specify the location of the workspace (we used c:\WSAD5sg246957). You might want to install the IBM Agent Controller; it is required for profiling and publishing to a remote server. Installing the Agent Controller You have to install the IBM Agent Controller on every machine where you want to define remote WebSphere servers or perform profiling. Select Install IBM Agent Controller from the WebSphere Studio Installation Launcher (Figure A-2). For Windows you can also run the setup.exe from the IBM_Agent_Controller\windows directory on the CD. In the installation dialog (for Windows): Accept the license. Enter user name and organization. Select the installation directory. The default is: C:\Program Files\IBM\IBM Agent Controller Select the Java runtime library, for example: <wsadhome>\eclipse\jre\bin Select to enable or disable security. If you enable security, you have to prove the user IDs of authorized users Select which host computers can access the Agent Controller: – This computer only – Any computer – Specific computers: you provide a list of host names Start the installation. The Agent Controller service is started automatically after installation. Appendix A. Product installation 793 Update Application Developer This section demonstrates how to search for updates and how to install updates for Eclipse and Application Developer. Using the Update Manager Application Developer contains an Update Manager. The update manager can be used to discover, download, and install updated features and plug-ins from special web-based update sites. The basic underlying mechanism of the update manager is simple: The files for a feature or plug-in are always stored in a subdirectory whose name includes a version identifier (for example, 2.0.0). Different versions of a feature or plug-in are always given different version identifiers, thereby ensuring that the multiple versions of the same feature or plug-in can co-exist on disk. This means that installing or updating features and plug-ins requires adding more files, but never requires deleting or overwriting existing files. Once the files are installed on the local computer, the new feature and plug-in versions are available to be configured. The same installed base of files is therefore capable of supporting many different configurations simultaneously. Installing and upgrading an existing product are reduced to formulating a configuration incrementally newer than the current one. Important configurations can be saved and restored to active service in the event of an unsuccessful upgrade. You can launch the update manager by selecting Help -> Software Updates -> Update Manager from the menu bar. This opens the Install/Update perspective. Note, that you can also open the perspective Install/Update directly. The initial Install/Update perspective is shown in Figure A-3. Note: A detailed description about the Install/Update perspective and its views is provided in the section “Install/Update perspective” on page 75. . UDB Installing WebSphere Application Server Installing Application Developer Update Application Developer A 786 WebSphere Studio Application Developer Version 5 Programming Guide Installing. file C: WebSphere AppServerlogsserver1SystemOut.log IVT0110I: Installation Verification is complete. 790 WebSphere Studio Application Developer Version 5 Programming Guide Installing Application Developer Before. installing Application Developer. You can install Application Developer 5 in a separate directory, but do not install this version of Application Developer over an earlier version. 1. Install Application