Sun Java System Application Server Platform Edition 8.1 2005Q2
Contents
1. var opt SUNWappserver domains Sun Java Enterprise System installations on the Linux platform var opt sun appserver domains All other installations install dir Aomains domain dir Represents the directory for a domain root dir domain dir domain In configuration files you might see domain dir represented as follows com sun aas instanceRoot Typographic Conventions The following table describes the typographic changes that are used in this book 12 Sun Java System Application Server Platform Edition 8 1 200502 Update 2 Installation Guide TABLE P 4 Typographic Conventions Typeface Meaning Example AaBbCc123 The names of commands files and directories Edit your login file and onscreen computer output P P Use 1s a to list all files machine name you have mail AaBbCc123 What you type contrasted with onscreen machine name su computer output Password AaBbCc123 A placeholder to be replaced with a real name or The command to remove a file is rm value filename AaBbCc123 Book titles new terms and terms to be Read Chapter 6 in the User s Guide emphasized note that some emphasized items p k p A cache is a copy that is stored locally appear bold online Do not save the file Symbol Conventions The following table explains symbols that might be used in this book TABLE P 5 Symbol Conventions for a reguired command option Symb2. bundle_filename console savestate filename EXAMPLE 1 1 Example Installation Configuration Wizard Statefile created Mon Aug 25 19 26 08 PDT 2003 Wizard path j2ee app sol appserv class Wizard Statefile section for Sun Java System Application Server STATE BEGIN Sun Java System Application Server a2512d6e8bdfa24acaf5e6bb5d0d46a803690279 defaultInstallDirectory SUNWappserver currentInstallDirectory opt SUNWappserver JDK LOCATION share builds components jdk 1 4 2 Sun0s INST_ASADMIN USERNAME admin INST_ASADMIN PASSWORD adminadmin INST_ASADMIN PORT 4848 INST ASWEB PORT 8080 NST HTTPS PORT 1043 INST JMS PORT 7676 NST ORB PORT 3700 INST ORB SSL PORT 1060 NST ORB MUTUALAUTH PORT 1061 INST JMX PORT 8686 INST POINTBASE PORT 9092 ADMIN PASSWORD ENCRYPTED FALSE STORE ADMIN AUTH FALSE 20 Sun Java System Application Server Platform Edition 8 1 200502 Update 2 Installation Guide EXAMPLE 1 1 Example Installation Configuration Continued CREATE SAMPLES DOMAIN FALSE CREATE DESKTOP SHORTCUT FALSE UPDATE PATH FALSE STATE DONE Sun Java System Application Server a2512d6e8bdfa24acaf5e6bb5d0d46a803690279 Modifying the Installation Configuration File You can modify the installation configuration file by editing the variables and values described in Modifying the Installation Configuration File on page 21 This table provides four columns showing var
3. Sun acknowledges the pioneering efforts of Xerox in researching and developing the concept of visual or graphical user interfaces for the computer industry Sun holds a non exclusive license from Xerox to the Xerox Graphical User Interface which license also covers Sun s licensees who implement OPEN LOOK GUIs and otherwise comply with Sun s written license agreements 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 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 CA 95054 U S A Tous droits r serv s Ce produit ou document est prot g par un copyright et distribu avec des licences qui en restreignent l utilisation la copie la distribution et la d compilation Aucune partie de ce produit ou document ne peut tre reproduite sous aucune forme par quelque moyen que ce soit sans l autorisation pr alable et crite de Sun et de ses bailleurs de licence s il y en a Le logiciel d tenu par des tiers et qui comprend la technologie relative aux polices de caract res e
4. you downloaded the bundle file 2 Change the permission of the bundle file so that you have execute access chmod x bundle_filename 3 Run the installation program Torun the installation program that uses a graphical interface at the command prompt type the name of the bundle file bundle_filename Torun the installation program that uses the command line interface at the command prompt type the name of the bundle file followed by the console option bundle_filename console 4 In the Admin Configuration page or at the command line enter the following m Admin User Name Name of the user who administers the server Password Admin user s password to access the Admin Server 8 character minimum Admin Port Administration port number for initial server instance HTTP Port Port number to access the default server instance HTTPS Port Secure port number to access the default server instance 5 In the Installation Options page select the options that you want If you select the Upgrade from Previous Version checkbox the upgrade process begins after installation is completed For information about upgrading see the Sun Java System Application Server Platform Edition 8 1 2005Q2 Update 2 Upgrade and Migration Guide 6 Set the PATH environment variable to include the Application Server install_dir bin directory Sun Java System Application Server Platform Edition 8 1 2005Q2 Update 2 Instal
5. RANTIE EXPRESSE OU IMPLICITE N EST ACCORDEE Y COMPRIS DES GARANTIES CONCERNANT LA VALEUR MARCHANDE L APTITUDE DE LA PUBLICATION A REPONDRE A UNE UTILISATION PARTICULIERE OU LE FAIT QU ELLE NE SOIT PAS CONTREFAISANTE DE PRODUIT DE TIERS CE DENI DE GARANTIE NE S APPLIQUERAIT PAS DANS LA MESURE OU IL SERAIT TENU JURIDIQUEMENT NUL ET NON AVENU O da amp Adobe PostScript Q 050726 12762 Contents Preface 9 Installing Application Server Software 17 What You Are Installing 17 Installing the Application Server Software 18 V To Install on UNIX or Linux 18 V To Install on Windows 19 Installing in Silent Mode 19 Creating the Installation Configuration File 20 Running the Installer in Silent Mode 23 V To Install in Silent Mode 23 Uninstalling Application Server Software 25 Running the Uninstallation Program 25 V To Run the Uninstallation Program on UNIX or Linux 25 V To Run the Uninstallation Program on Windows 26 4 Sun Java System Application Server Platform Edition 8 1 200502 Update 2 Installation Guide Tables TABLE 1 1 Installation Configuration File Variables 21 6 Sun Java System Application Server Platform Edition 8 1 200502 Update 2 Installation Guide Examples EXAMPLE 1 1 Example Installation Configuration 20 8 Sun Java System Application Server Platform Edition 8 1 200502 Update 2 Installation Guide Preface This Installation Guide provides instructions for installing the Sun Java Sy
6. Server Platform Edition software The following topics are discussed m What You Are Installing on page 17 m Installing the Application Server Software on page 18 m Installing in Silent Mode on page 19 UNIX installations support both root and non root user installations Users of Windows installations should have Power User or Administrator access What You Are Installing There are two different distribution types The Application Server product distribution includes the following components m Application Server software including administrative tools and utilities m Sun Java System Message Queue m PointBase Database Server The Java 2 Platform Enterprise Edition J2EE 1 4 product distribution includes the following components m All components contained in the Application Server product distribution m Java 2 Platform Edition J2SE Software Development Kit SDK m J2EE SDK samples which includes BluePrints applications such as Petstore Adventure Builder and SmartTicket Use these instructions to install either distribution 18 Installing the Application Server Software After you have verified that your system meets the requirements specified in the Sun Java System Application Server Platform Edition 8 1 2005Q4 Release Notes use either of the following sets of steps to install the Application Server product v To Install on UNIX or Linux Steps 1 Navigate to the directory where
7. Sun Microsystems Inc 4150 Network Circle Santa Clara CA 95054 Part No 819 2648 icrosystems Sun Java System Application Server Platform Edition 8 1 2005Q2 Update 2 Installation Guide Copyright 2005 Sun Microsystems Inc 4150 Network Circle Santa Clara CA 95054 U S A All rights reserved This product or document is protected by copyright and distributed under licenses restricting its use copying distribution and decompilation No part of this product or document may be reproduced in any form by any means without prior written authorization of Sun and its licensors if any Third party software including font technology is copyrighted and licensed from Sun suppliers Parts of the product may be derived from Berkeley BSD systems licensed from the University of California UNIX is a registered trademark in the U S and other countries exclusively licensed through X Open Company Ltd Sun Sun Microsystems the Sun logo docs sun com AnswerBook AnswerBook2 and Solaris 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 an architecture developed by Sun Microsystems Inc The OPEN LOOK and Sun Graphical User Interface was developed by Sun Microsystems Inc for its users and licensees
8. des a comprehensive table based summary of the supported hardware operating system JDK and JOBC RDBMS Quick Start Guide How to get started with the Application Server product Installation Guide Installing the software and its components Developer s Guide Creating and implementing Java 2 Platform Enterprise Edition J2EE platform applications intended to run on the Application Server that follow the open Java standards model for J2EE components and APIs Includes general information about developer tools security assembly deployment debugging and creating lifecycle modules J2EE 1 4 Tutorial Using J2EE 1 4 platform technologies and APIs to develop J2EE applications Administration Guide Configuring managing and deploying Application Server subsystems and components from the Administration Console Administration Reference Editing the Application Server configuration file domain xml Upgrade and Migration Guide Migrating your applications to the new Application Server programming model specifically from Application Server 6 x and 7 This guide also describes differences between adjacent product releases and configuration options that can result in incompatibility with the product specifications Troubleshooting Guide Error Message Reference Solving Application Server problems Solving Application Server error messages 10 Sun Java System Application S
9. em Application Server Platform Edition 8 1 200502 Update 2 Installation Guide TABLE 1 1 Installation Configuration File Variables Continued Valid Values if Variable Name applicable Content Comments UPDATE PATH TRUE FALSE Whether to update PATH Valid only for Windows environment variable to platforms and is disregarded include Application Server bin otherwise directory AE If this entry is not present default value of FALSE is used Running the Installer in Silent Mode To install the Sun Java System Application Server software in silent mode Y To Install in Silent Mode Steps 1 Review configuration file and verify that it contains what you want to use for your silent installation 2 Copy your installation configuration file to each machine where you plan to install the Application Server software 3 Copy the Application Server distribution file to each machine where you plan to install the Application Server software 4 Navigate to the directory where you copied the distribution file and your installation configuration file 5 Start silent installation at the command line using the following command format bundle filename silent config file The installation program reads the specified config_file checks for adequate disk space then installs the product based on the data in config_file When the prompt is returned the silent installation is complete and the installation components are i
10. erver Platform Edition 8 1 200502 Update 2 Installation Guide TABLE P 2 Books in the Application Server Documentation Set Continued Book Title Description Reference Manual Utility commands available with the Application Server written in man page style Includes the asadmin command line interface Related Books For other Sun Java System server documentation go to the following m Message Queue documentation m Directory Server documentation m Web Server documentation The URL for all documentation about Java ES and its components is http docs sun com prod entsys 05q4 Default Paths and File Names The following table describes the default paths and file names that are used in this book 11 TABLE P 3 Default Paths and File Names Placeholder Description Default Value install dir Represents the base installation Sun Java Enterprise System installations directory for Application Server on the Solaris platform opt SUNWappserver appserver Sun Java Enterprise System installations on the Linux platform opt sun appserver Other Solaris and Linux installations non root user user s home directory SUNWappserver Other Solaris and Linux installations root user opt SUNWappserver Windows all installations SystemDrive Sun AppServer domain root dir Represents the directory containing Sun Java Enterprise System installations all domains on the Solaris platform
11. example Sun Developer Network Third Party Web Site References Third party URLs are referenced in this document and provide additional related information 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 or alleged to be caused by or in connection with use of or reliance on any such content goods or services that are available on or through such sites or resources 14 Sun Java System Application Server Platform Edition 8 1 200502 Update 2 Installation Guide Sun Welcomes Your Comments Sun is interested in improving its documentation and welcomes your comments and suggestions To share your comments go to http docs sun com and click Send Comments In the online form provide the full document title and part number The part number is a 7 digit or 9 digit number that can be found on the book s title page or in the document s URL For example the part number of this book is 819 2648 16 Sun Java System Application Server Platform Edition 8 1 2005Q2 Update 2 Installation Guide CHAPTER 1 Installing Application Server Software This guide provides instructions for installing the Sun Java System Application
12. iable names valid values if applicable contents and comments TABLE 1 1 Installation Configuration File Variables Valid Values if Variable Name applicable Content Comments defaultInstallDirectory Default installation directory path currentInstallDirectory Selected installation directory path JDK_LOCATION Selected J2SE installation This entry is needed only for directory path distributions that do not contain a bundled J2SE INST ASADMIN USERNAME Administrator user name for initial server instance INST ASADMIN PASSWORD Administrator password for This entry is obfuscated by initial server instance default See also description of ADMIN PASSWORD ENCRYPTED variable INST ASADMIN PORT 0 65535 Administration server port number for initial server instance INST ASWEB PORT 0 65535 HTTP port number for initial server instance INST HTTPS PORT 0 65535 HTTPS port number for initial server instance Chapter 1 Installing Application Server Software 21 TABLE 1 1 Installation Configuration File Variables Continued Valid Values if Variable Name applicable Content Comments INST_JMS_PORT 0 65535 JMS port number for initial If the configuration file does not server instance include this entry default value of 7676 is used INST_ORB_PORT 0 65535 ORB port number for initial If the configuration file does not server instance include
13. lation Guide 7 Verify the installation by following the instructions in the Sun Java System Application Server Platform Edition 8 1 200502 Update 2 Quick Start Guide located in install_dir docs QuickStart html or online at http docs sun com v To Install on Windows Steps 1 2 3 Navigate to the directory where you downloaded the exe file Double click the exe file to start the installation program Follow the instructions on the wizard screens of the installation program In the Admin Configuration page or at the command line enter the following Admin User Name Name of the user who administers the server Password Admin user s password to access the Admin Server 8 character minimum m Admin Port Administration port number for initial server instance HTTP Port Port number to access the default server instance HTTPS Port Secure port number to access the initial server instance In the Installation Options page select the options that you want If you select the Upgrade from Previous Version checkbox the upgrade process begins after installation is completed For information about upgrading see theSun Java System Application Server Platform Edition 8 1 2005Q2 Update 2 Upgrade and Migration Guide If you did not select the corresponding option on the Installation Options screen set the PATH environment variable to include the Application Server install_dir bin directory Verify
14. m Standard Edition J2SE platform files bundled with the product Steps 1 Navigate to your Application Server installation directory 25 Vv Before You Begin Step 2 Invoke the uninstall program as follows To use the uninstall that has a graphical interface at the command prompt type uninstall To use the uninstall that has a command line interface at the command prompt type uninstall console To Run the Uninstallation Program on Windows Make sure that you have stopped all domains and other related processes including deploytool command prompts using the installation directory or its subdirectories and any applications using Java 2 Platform Standard Edition J25E platform files bundled with the product Invoke the Uninstalltion program in one of the following ways Under the Sun Microsystems Application Server PE program group in the Start Programs area of your desktop click Uninstall m Invoke the uninstall program through the Control Panel a Navigate to the Control Panel b Choose Add Remove Programs c From the list of installed programs select Java 2 Platform Edition 1 4 SDK for SDK distribution or Sun Java System Application Server Platform Edition for Application Server distribution d Click Remove 26 Sun Java System Application Server Platform Edition 8 1 200502 Update 2 Installation Guide
15. nstalled on your systems 6 Start the Application Server software by using the instructions in the Sun Java System Application Server Platform Edition 8 1 2005Q2 Update 2 Administration Guide When the Admin Console is started the initial page of the Application Server graphical interface is displayed Chapter 1 Installing Application Server Software 23 24 Sun Java System Application Server Platform Edition 8 1 200502 Update 2 Installation Guide CHAPTER 2 Uninstalling Application Server Software AIl components in the current Application Server installation directory are automatically selected for uninstallation Note tis important to use the uninstall routine described here If you attempt another method problems arise when you try to reinstall the same version or when you install a new version If you do not stop all domains before the uninstallation orphaned processes might exist on your system after the uninstallation On UNIX identify the processes using the ps ef command and terminate them using the kill command Running the Uninstallation Program To uninstall the Application Server software perform the following steps v To Run the Uninstallation Program on UNIX or Linux Before You Make sure that you have stopped all domains and other related processes including Begin aeploytool command prompts using the installation directory or its subdirectories and any applications using Java 2 Platfor
16. ol Description Example Meaning Contains optional 1s 1 The 1 option is not required arguments and command options Contains a set of choices a y n The d option requires that you use either the y argument or the n argument keystrokes Indicates a variable com sun javaRoot References the value of the reference com sun javaRoot variable Joins simultaneous Control A Press the Control key while you multiple keystrokes press the A key Joins consecutive multiple Ctrl A N Press the Control key release it and then press the subsequent keys 13 TABLE P 5 Symbol Conventions Continued Symbol Description Example Meaning gt Indicates menu item selection in a graphical user interface File gt New Templates From the File menu choose New From the New submenu choose Templates Accessing Sun Resources Online The docs sun com web site enables you to access Sun technical documentation online You can browse the docs sun com archive or search for a specific book title or subject Books are available as online files in PDF and HTML formats Both formats are readable by assistive technologies for users with disabilities To access the following Sun resources go to http www sun com Downloads of Sun products Services and solutions Support including patches and updates Training Research Communities for
17. st prot g par un copyright et licenci par des fournisseurs de Sun Des parties de ce produit pourront tre d riv es du syst me Berkeley BSD licenci s par l Universit de Californie UNIX est une marque d pos e aux Etats Unis et dans d autres pays et licenci e exclusivement par X Open Company Ltd Sun Sun Microsystems le logo Sun docs sun com AnswerBook AnswerBook2 et Solaris 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 L interface d utilisation graphique OPEN LOOK et Sun a t d velopp e par Sun Microsystems Inc pour ses utilisateurs et licenci s Sun reconna t les efforts de pionniers de Xerox pour la recherche et le d veloppement du concept des interfaces d utilisation visuelle ou graphique pour l industrie de l informatique Sun d tient une licence non exclusive de Xerox sur l interface d utilisation graphique Xerox cette licence couvrant galement les licenci s de Sun qui mettent en place l interface d utilisation graphique OPEN LOOK et qui en outre se conforment aux licences crites de Sun CETTE PUBLICATION EST FOURNIE EN L ETAT ET AUCUNE GA
18. stem Application Server Platform Edition 8 1 200502 software Who Should Use This Book This guide is intended for system administrators network administrators evaluators application server administrators web developers and software developers who want to install the Application Server software This guide assumes you are familiar with the following topics Installation of software products UNIX Linux or Microsoft Windows depending on your operating system Client server programming model Internet and World Wide Web How This Book Is Organized TABLE P 1 How This Book Is Organized Chapter Description Chapter 1 Provides instructions for installing Application Server software on UNIX Linux and Windows TABLE P 1 How This Book Is Organized Continued Chapter Description Chapter 2 Provides instructions for uninstalling Application Server software Application Server Documentation Set The Application Server documentation set describes deployment planning and system installation The URL for Application Server documentation is http docs sun com app docs coll 1343 1 For an introduction to Application Server refer to the books in the order in which they are listed in the following table TABLE P 2 Books in the Application Server Documentation Set Book Title Description Release Notes Late breaking information about the software and the documentation Inclu
19. the installation by following the instructions of the Sun Java System Application Server Platform Edition 8 1 200502 Update 2 Quick Start Guide located in install dir docs OuickStart html or at http docs sun com Installing in Silent Mode Silent mode installation is non interactive You must first provide a configuration file for information that the installer needs The following topics are discussed Creating the Installation Configuration File on page 20 Chapter 1 Installing Application Server Software 19 m Running the Installer in Silent Mode on page 23 Creating the Installation Configuration File The installation configuration file is created when you use the savestate option with a setup command to start a interactive installation During the interactive installation your input is collected and stored in the configuration file you specified This forms the template for silent installation which you can use later to install the product on one or more machines If needed you can modify the installation configuration file The following topics are addressed m Syntax for Creating the Installation Configuration File on page 20 m Modifying the Installation Configuration File on page 21 Syntax for Creating the Installation Configuration File The syntax for creating an installation configuration file is as follows For graphical method bundle_filename savestate filename For command line method
20. this entry default value of 3700 is used INST ORB SSL PORT 0 65535 Secure ORB port number for If the configuration file does not initial server instance include this entry default value of 3820 is used INST_ORB MUTUALAUTH PORT 0 65535 Mutual authentication ORB If the configuration file does not port number for initial server include this entry default value instance of 3920 is used INST_JMX_PORT 0 65535 JMX port number for initial If the configuration file does not server instance include this entry default value of 8686 is used INST POINTBASE PORT 0 65535 PointBase server port number If the configuration file does not include this entry default value of 9092 is used ADMIN PASSWORD ENCRYPTED TRUE FALSE Obfuscated admin password In initial statefile created by flag product installer this flag is set to TRUE since the admin password value is obfuscated for security reasons To override the value for admin password enter INST ASADMIN PASSWORD value in clear text and set this flag to FALSE to enable silent installation to process it correctly STORE ADMIN AUTH TRUE FALSE Whether to create admin authentication user preference file CREATE SAMPLES DOMAIN TRUE FALSE Whether to create additional samples server domain CREATE DESKTOP SHORTCUT TRUE FALSE Whether to create autodeploy Valid for Windows platforms folder desktop shortcut only and is disregarded otherwise 22 Sun Java Syst
Download Pdf Manuals
Related Search