Sun Java Studio Enterprise 7 Installation
Total Page:16
File Type:pdf, Size:1020Kb
Installation Guide Sun Java™ Studio Enterprise 7 2004Q4 Sun Microsystems, Inc. www.sun.com Part No. 817-7971-10 December 2004, Revision A Submit comments about this document at: http://www.sun.com/hwdocs/feedback Copyright © 2004 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054, U.S.A. All rights reserved. U.S. Government Rights - Commercial software. Government users are subject to the Sun Microsystems, Inc. standard license agreement and applicable provisions of the FAR and its supplements. This distribution may include materials developed by third parties.Sun, Sun Microsystems, the Sun logo and Java are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. in the U.S. and other countries. Products bearing SPARC trademarks are based upon architecture developed by Sun Microsystems, Inc. UNIX is a registered trademark in the U.S. and other countries, exclusively licensed through X/Open Company, Ltd. Products covered by and information contained in this service manual are controlled by U.S. Export Control laws and may be subject to the export or import laws in other countries. Nuclear, missile, chemical biological weapons or nuclear maritime end uses or end users, whether direct or indirect, are strictly prohibited. Export or reexport to countries subject to U.S. embargo or to entities identified on U.S. export exclusion lists, including, but not limited to, the denied persons and specially designated nationals lists is strictly prohibited. DOCUMENTATION IS PROVIDED “AS IS” AND ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID. Copyright © 2004 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054, Etats-Unis. Tous droits réservés. Cette distribution peut comprendre des composants développés par des tierces parties.Sun, Sun Microsystems, le logo Sun et Java sont des marques de fabrique ou des marques déposées de Sun Microsystems, Inc. aux Etats-Unis et dans d’autres pays. Toutes les marques SPARC sont utilisées sous licence et sont des marques de fabrique ou des marques déposées de SPARC International, Inc. aux Etats-Unis et dans d’autres pays. Les produits portant les marques SPARC sont basés sur une architecture développée par Sun Microsystems, Inc. UNIX est une marque déposée aux Etats-Unis et dans d’autres pays et licenciée exlusivement par X/Open Company, Ltd. Les produits qui font l’objet de ce manuel d’entretien et les informations qu’il contient sont regis par la legislation americaine en matiere de controle des exportations et peuvent etre soumis au droit d’autres pays dans le domaine des exportations et importations. Les utilisations finales, ou utilisateurs finaux, pour des armes nucleaires, des missiles, des armes biologiques et chimiques ou du nucleaire maritime, directement ou indirectement, sont strictement interdites. Les exportations ou reexportations vers des pays sous embargo des Etats-Unis, ou vers des entites figurant sur les listes d’exclusion d’exportation americaines, y compris, mais de maniere non exclusive, la liste de personnes qui font objet d’un ordre de ne pas participer, d’une facon directe ou indirecte, aux exportations des produits ou des services qui sont regi par la legislation americaine en matiere de controle des exportations et la liste de ressortissants specifiquement designes, sont rigoureusement interdites.LA DOCUMENTATION EST FOURNIE “EN L’ETAT” ET TOUTES AUTRES CONDITIONS, DECLARATIONS ET GARANTIES EXPRESSES OU TACITES SONT FORMELLEMENT EXCLUES, DANS LA MESURE AUTORISEE PAR LA LOI APPLICABLE, Y COMPRIS NOTAMMENT TOUTE GARANTIE IMPLICITE RELATIVE A LA QUALITE MARCHANDE, A L’APTITUDE A UNE UTILISATION PARTICULIERE OU A L’ABSENCE DE CONTREFACON. Contents Before You Begin 9 Before You Read This Book 9 Typographic Conventions 11 Related Documentation 11 Sun Welcomes Your Comments 14 1. Introduction to Sun Java Studio Enterprise 7 Software 15 2. Preparing for Installation 17 Overview of the Installation Process 18 Planning for Installation 18 Supported Platforms 19 Selecting What to Install 19 Verifying System Readiness 21 System Dependencies 22 Software Product Dependencies and Conflicts 24 Installed Component Product Detection 25 Handling Existing Installations of Component Products 25 Component Product Dependencies 27 Shared Component Dependencies (Solaris OS) 28 3 Upgrade Path for Component Product Servers (Solaris OS) 29 J2SE Handling 29 Checking Other Prerequisites 29 3. Installing Java Studio Enterprise (Microsoft Windows) 31 Using the GUI Installer 31 Installer Reference 34 Initial System Check Report 34 Product Serial Number 35 Product Selection 36 Container Selection 36 Where Are Your Remote Servers 37 Installation Directory 37 Configuration 38 Installing on Machines Without a Static IP Address 39 Using Silent Mode Installation 40 4. Uninstalling Java Studio Enterprise (Microsoft Windows) 41 Using the GUI Uninstaller 41 Uninstalling Software in Silent Mode 43 5. Installing Java Studio Enterprise (Solaris OS) 45 Verifying the Solaris OS Patch Requirements 45 Using the GUI Installer 46 Installer Reference 49 Common Component Upgrade 49 Installation Directory 50 System Requirements Check 50 Where Are Your Remote Servers 50 4 Sun Java Studio Enterprise 7 Installation Guide • December 2004 Configuration 50 Product Usage by Non-root User 51 Installing Using Silent Mode 53 Troubleshooting During Installation 54 6. Uninstalling Java Studio Enterprise (Solaris OS) 55 Using the GUI Uninstaller 55 Uninstalling Software in Silent Mode 57 7. Installing and Uninstalling In Silent Mode 59 Installing in Silent Mode 59 Overview of Installing in Silent Mode 60 Preparing for Installing in Silent Mode 60 Guidelines for Using Silent Mode 60 Preparing a State File 61 Editing the State File 63 Running the Installer in Silent Mode 65 Uninstalling Software in Silent Mode 67 8. Setting Up the Java Studio Enterprise IDE 71 Starting the IDE 71 Setting Up the IDE 73 Import Settings Wizard 73 Setup Wizard 73 Registration Wizard 73 Using the Collaboration Runtime 74 Using the Startup Options 77 Java Studio Enterprise IDE User Directory 79 Troubleshooting During Setup of the IDE 79 Contents 5 9. Using Sun Java System Application Server Instances in the IDE 83 Understanding Application Server Integration and Instances 83 Application Server Instances (Microsoft Windows) 84 Application Server Instances (Solaris OS) 85 Application Server and IDE Integration 86 Using the Default Administrative Domain 87 Understanding Administrative Domains 89 Creating Administrative Domains for Each User 90 Other Common Application Server Tasks 95 10. Using Sun Java System Web Server Instances in the IDE 97 Using the Correct Web Server Instance (Microsoft Windows) 97 Using the Correct Web Server Instance (Solaris OS) 101 Other Common Web Server Tasks 104 11. Using Databases 107 Setting Up PointBase Connectivity 107 Using Other JDBC Enabled Databases 111 12. Upgrading Your Installation 113 Updating Modules With the Update Center 113 Using the License Manager Tool 114 13. Using Java Studio Enterprise Servers (Microsoft Windows) 117 Overview of the Validation Process 117 Finding Configuration Data 118 Validating Server Installation 118 Finding Additional Documentation 127 Troubleshooting During Server Validation 128 Diagnosing Common Errors 131 6 Sun Java Studio Enterprise 7 Installation Guide • December 2004 14. Using Java Studio Enterprise Servers (Solaris OS) 135 Overview of the Validation Process 135 Finding Configuration Data 136 Validating Server Installation 136 Accessing Server Admin Consoles 138 Stopping Servers 143 Finding Additional Documentation 146 Troubleshooting During Server Validation 146 Diagnosing Common Errors 150 15. Troubleshooting Problems 153 Basic Installation Troubleshooting Techniques 153 Examine Installation Log Files 153 Check Resources and Settings 155 Run Verification Procedures 156 Check the Distribution Media 156 Verify Directory Server Connectivity 156 Verify Passwords 156 Verifying the DNS Suffix 157 Java Studio Enterprise Problems and Solutions 158 Installing Java Studio Enterprise Software 158 Starting Servers 159 Identifying and Fixing an Incomplete Uninstallation 160 A. Solaris OS Patch Numbers and Descriptions 179 B. Java Studio Enterprise Installation Structure 183 C. Java Studio Enterprise Server Reference (Microsoft Windows) 187 Assigning Port Numbers 187 Contents 7 Command-line Usage 187 Server Reference Details 188 Application Server as the Web Container 192 Web Server as Web Container 193 D. Java Studio Enterprise Server Reference (Solaris OS) 195 Assigning Port Numbers 195 Application Server as the Web Container 196 Web Server as the Web Container 196 E. Port Usage in Java Studio Enterprise IDE 201 F. Java Studio Enterprise Shared Components (Solaris OS) 205 Index 207 8 Sun Java Studio Enterprise 7 Installation Guide • December 2004 Before You Begin This installation guide for Sun™ Java ™ Studio Enterprise 7 2004Q4 (Java Studio Enterprise) software provides instructions for installing, setting up, and starting the software. This book is designed to aid both system administrators and developers who install this software. You should be experienced with basic installation procedures