Installation Guide Sun Java™ Studio Enterprise 8 Sun Microsystems, Inc. www.sun.com Part No. 819-2807-10 October 2005, Revision A Submit comments about this document at: http://www.sun.com/hwdocs/feedback Copyright © 2005 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 © 2005 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 Preface 5 Typographic Conventions 7 Related Documentation 7 Contacting Sun Technical Support 8 Sun Welcomes Your Comments 9 1. Before You Install the Java Studio Enterprise Software 11 System Requirements 11 Installation Restrictions 12 Migrating From Java Studio Enterprise 7 to Java Studio Enterprise 8 12 Upgrading From an Earlier Java Studio Enterprise 8 Release 13 Running Different Versions of Java Studio Enterprise on the Same System 13 2. Microsoft Windows: Installing and Starting the Java Studio Enterprise Software 15 Before You Start 15 Installing the Java Studio Enterprise Software 16 Starting the IDE 18 3. Solaris OS: Installing and Starting the Java Studio Enterprise Software 21 Before You Start 21 3 Installing the Java Studio Enterprise Software 22 Starting the IDE 25 4. Linux: Installing and Starting the Java Studio Enterprise Software 27 Before You Start 27 Installing the Java Studio Enterprise Software 28 Starting the IDE 31 5. About the Java Studio Enterprise IDE User Directory 33 6. Using Startup Command-Line Options 35 7. Uninstalling the Java Studio Enterprise Software 37 Uninstalling on the Microsoft Windows Platform 37 Uninstalling on Solaris OS and Linux Platforms 38 8. Installing the Java Studio Enterprise Software Using Silent Mode 39 Guidelines for Using Silent Mode 39 Preparing a State File 40 Running the Installer in Silent Mode 43 9. Using the Collaboration Runtime 45 Starting the Collaboration Runtime 45 Configuring the Collaboration Runtime (Microsoft Windows) 46 Changing the Collaboration Logging Options 47 Stopping the Collaboration Runtime 47 Finding and Changing the Collaboration Runtime Port 48 Index 49 4 Sun Java Studio Enterprise 8 Installation Guide • October 2005 Preface The Sun Java ™ Studio Enterprise 8 software includes the following: ■ Sun Java Studio Enterprise 8 integrated development environment (the IDE) ■ Sun Java™ System Application Server 8.1 Platform Edition ■ Sun Java Studio Enterprise 8 Collaboration Runtime This installation guide for the 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 must be familiar with installing and uninstalling software products on the platforms you choose to use with this software. Before using the Java Studio Enterprise IDE, you also need to be familiar with the following subjects: ■ Java™ programming language ■ Enterprise JavaBeans™ (EJB™) technology concepts ■ Java™ Servlet API syntax ■ Syntax for drivers that support the JDBC™ API ■ JavaServer Pages™ technology syntax ■ HTML syntax ■ How to use JDBC databases ■ Java™ 2 Platform, Enterprise Edition (J2EE™ platform) application assembly and deployment concepts ■ Web Services ■ Using J2EE application servers Using the Java Studio Enterprise IDE successfully requires a knowledge of J2EE concepts, as described in the following resources: 5 ■ Java 2 Platform, Enterprise Edition Blueprints http://java.sun.com/j2ee/blueprints ■ Java 2 Platform, Enterprise Edition Specification http://java.sun.com/j2ee/download.html#platformspec ■ The J2EE Tutorial http://java.sun.com/j2ee/tutorial ■ Java Servlet Specification Version 2.3 http://java.sun.com/products/servlet/download.html#specs ■ JavaServer Pages Specification Version 1.2 http://java.sun.com/products/jsp/download.html#specs Familiarity with the Java API for XML-Based RPC (JAX-RPC) is helpful. For more information, see this web page: http://java.sun.com/xml/jaxrpc Note – Sun is not responsible for the availability of third-party Web sites mentioned in this document. Sun does not endorse and is not responsible or liable for any content, advertising, products, or other materials that are available on or through such sites or resources. Sun will not be responsible or liable for any actual or alleged damage or loss caused by or in connection with the use of or reliance on any such content, goods, or services that are available on or through such sites or resources. 6 Sun Java Studio Enterprise 8 Installation Guide • October 2005 Typographic Conventions Typeface Meaning Examples AaBbCc123 The names of commands, files, Edit your .cvspass file. and directories; on-screen Use DIR to list all files. computer output Search is complete. AaBbCc123 What you type, when contrasted > login with on-screen computer output : AaBbCc123 Book titles, new words or terms, Read Chapter 6 in the User’s Guide. words to be emphasized These are called class options. You must save your changes. AaBbCc123 Command-line variable; replace To delete a file, type DEL filename. with a real name or value Related Documentation The Java Studio Enterprise documentation includes books delivered in Acrobat Reader (PDF) format, release notes, online help, and tutorials delivered in HTML format. Documentation Available Online The documents described in this section are available from the docs.sun.comSM web site (http://docs.sun.com) and from the Documentation link from the Sun Java Studio Enterprise Developers Source portal (http://developers.sun.com/jsenterprise). ■ Sun Java Studio Enterprise 8 Release Notes Describes last-minute release changes and technical notes. ■ Sun Java Studio Enterprise 8 Installation Guide This book. Preface 7 Tutorials Sun Java Studio Enterprise 8 tutorials help you understand the features of the IDE. Each tutorial provides techniques and code samples that you can use or modify in developing more substantial applications.