ONEApplicationServer Version7,Update1 816-6866-102003年4月 版权所有©2003SunMicrosystems,Inc.,4150NetworkCircle,SantaClara,California95054,
U.S.A.。
保留所有权利。
本软件包含SunMicrosystems,Inc.的保密信息和商业机密。
未经SunMicrosystems,Inc.U.S事先明确书面许可，禁止使用、泄露或 复制本软件。
政府权利–商业软件。
政府用户必须遵守SunMicrosystems,Inc.标准许可证协议的条款以及FAR及其补充内容中的适 用条款。
使用本软件必须遵守许可证条款的规定。
本软件可能包括由第三方开发的产品。
Sun、SunMicrosystems、Sun徽标、Java和SunONE徽标是SunMicrosystems,Inc.在美国和其它国家/地区的商标或注册商标。
UNIX是在美国和其它国家/地区的注册商标，由X/OpenCompany,Ltd.独家授权。
本产品受美国出口控制法控制，并遵守其它国家/地区的进出口法律。
严禁将本软件直接或间接用于核武器、导弹、生化武器或核潜艇的研制或使用。
严禁出口或转口到美国禁运的国家/地区或美国禁止出口清单中的实体，包括但不限于被禁止的个人和特别指定的国家/地区清单。
目录 关于本指南.....................................................................7本指南的读者...........................................................................7本指南的组织方式.......................................................................8使用文档...............................................................................9文档惯例..............................................................................11 一般惯例..........................................................................11有关目录的惯例....................................................................12产品支持..............................................................................13更多信息..............................................................................13 第1章准备安装................................................................15关于SunONEApplicationServer安装...................................................16 安装组件..........................................................................16SunONEApplicationServer....................................................16管理客户机....................................................................18SunONEMessageQueue.......................................................18PointBase.....................................................................18样例应用程序..................................................................19SunONEStudio4.0,EnterpriseEditionforJava....................................19Java2SoftwareDevelopmentKit(J2SE)...........................................19 安装方法..........................................................................20图形界面方法..................................................................20命令行界面方法................................................................20静音模式......................................................................21 产品的安装版本....................................................................21评估版........................................................................21开发版（非评估版）............................................................22安装版本汇总..................................................................23
3 封装模型和目录结构................................................................23Solaris9上的捆绑安装..........................................................24UNIX上基于软件包的安装......................................................24MicrosoftWindows上的安装及评估版安装........................................25 系统要求..............................................................................25平台要求..........................................................................26所需的Solaris修补程序.............................................................27其它要求..........................................................................28对于所有平台..................................................................29对于UNIX....................................................................29对于Solaris捆绑版本...........................................................30对于MicrosoftWindows........................................................30 访问文档..............................................................................31 第2章评估安装...............................................................33安装内容..............................................................................34从Web站点下载.......................................................................35 针对UNIX进行下载................................................................35针对MicrosoftWindows进行下载...................................................35安装评估产品..........................................................................36在静音模式下安装（非交互式）..........................................................46 第3章用于开发的安装.........................................................47安装内容..............................................................................48从Web下载...........................................................................49 针对UNIX进行下载................................................................49针对MicrosoftWindows进行下载...................................................49安装开发版产品........................................................................50在静音模式下安装（非交互式）..........................................................62如何创建配置文件..................................................................62以静音模式安装....................................................................63 第4章完成Solaris9捆绑安装...................................................65关于Solaris9安装......................................................................66创建管理域............................................................................66启动管理服务器........................................................................67创建应用程序服务器实例................................................................68 第5章卸载SunONEApplicationServer软件......................................69卸载的内容............................................................................69卸载SunONEApplicationServer软件...................................................70 4SunONEApplicationServer安装指南•2003年4月 第6章升级SunONEApplicationServer软件......................................75准备升级..............................................................................75 升级组件..........................................................................76要求和限制........................................................................76升级程序如何工作......................................................................77升级输入文件......................................................................77升级进程..........................................................................78 备份阶段......................................................................78安装阶段......................................................................79重新配置阶段..................................................................79日志文件..........................................................................79升级日志文件..................................................................79审计文件......................................................................79升级SunONEApplicationServer........................................................80疑难解答..............................................................................81重新启动或中断升级................................................................81错误情况..........................................................................82 第7章安装后的任务............................................................83设置PATH环境变量...................................................................83 在UNIX上设置PATH变量.........................................................84设置MicrosoftWindows环境.......................................................84 设置MicrosoftWindowsPATH变量.............................................85设置命令..................................................................86查看手册页............................................................................86启动和停止服务器......................................................................87使用命令行界面....................................................................87使用start-domain和-domain................................................88使用start-instance和-instance...............................................89获得帮助信息..................................................................89使用管理界面......................................................................89使用MicrosoftWindows程序组.....................................................90使用MicrosoftWindows服务.......................................................91实现Web服务器插件...................................................................92实现Web服务客户机...................................................................92决定SunONEStudio插件的安装位置....................................................92访问样例应用程序......................................................................93 第8章疑难解答................................................................95关于日志..............................................................................95忘记了用户名或密码....................................................................96忘记了管理服务器的端口号..............................................................96管理界面连接被拒绝....................................................................96
5 服务器无法启动：出现CGI错误.........................................................97为文件说明设置限制................................................................97更改内核参数......................................................................97 卸载失败后的清除工作..................................................................98在UNIX上........................................................................98在MicrosoftWindows上...........................................................99 对于MicrosoftWindows—SNMP子代理安装失败........................................100对于MicrosoftWindows—具有启动消息的命令窗口不出现。
..............................100 附录A许可信息..............................................................101关于许可.............................................................................101许可证类型...........................................................................102 评估许可证.......................................................................102开发许可证.......................................................................102平台版许可证.....................................................................103标准版许可证.....................................................................103许可证汇总.......................................................................103显示许可证信息.......................................................................104转换许可证...........................................................................105对于基于软件包的UNIX安装......................................................105 对于非捆绑的基于软件包的Solaris安装..........................................105对于Solaris9捆绑安装........................................................106对于非基于软件包的UNIX安装.....................................................106对于MicrosoftWindows安装......................................................107 索引........................................................................109 6SunONEApplicationServer安装指南•2003年4月 关于本指南 本安装指南介绍了如何安装Sun™OpenNetEnvironment(SunONE)ApplicationServer7产品。
本文包括以下主题： •本指南的读者•本指南的组织方式•使用文档•文档惯例•产品支持•更多信息 注意 SunONEApplicationServer7平台版将自动随Solaris9一起安装。
使用Solaris9捆绑产品的用户应当阅读第11页上的“文档惯例”。
完成基本安装后，应继续阅读第65页上的“完成Solaris9捆绑安装”，然后再阅读《GettingStartedGuide》和《管理员指南》，以获取配置和使用SunONEApplicationServer产品的信息。
本指南的读者 本手册适用于要安装SunONEApplicationServer软件的系统管理员、网络管理员、评估者、应用程序服务器管理员、Web开发者和软件开发者。
本指南假设您已经熟悉以下内容：•软件产品的安装•UNIX或MicrosoftWindows（取决于您的操作系统）•客户机/服务器编程模型•和万维网(WWW)
7 本指南的组织方式 本指南的组织方式 本指南包含以下文档组件：•第15页上的“准备安装”—概述了最低要求以及安装SunONEApplication Server软件前要执行的步骤。
•第33页上的“评估安装”—提供了SunONEApplicationServer软件评估版 的快速安装指南。
•第47页上的“用于开发的安装”—提供了SunONEApplicationServer软件 的开发版（非评估版）的安装指南。
其中包括如何执行非交互式静音安装的说明。
•第65页上的“完成Solaris9捆绑安装”—提供了特定于Solaris9安装的附加说明。
还介绍了如何创建域。
•第69页上的“卸载SunONEApplicationServer软件”—介绍了如何卸载SunONEApplicationServer软件。
•第75页上的“升级SunONEApplicationServer软件”—介绍了如何升级Sun™OpenNetEnvironment(SunONE)ApplicationServer7软件的现有安装。
•第83页上的“安装后的任务”—介绍了安装SunONEApplicationServer软件期间或之后可能执行的某些附加任务。
•第95页上的“疑难解答”—提供了安装期间或之后可能遇到的问题的解决方案。
•第101页上的“许可信息”—提供了有关应用程序服务器许可、升级许可证以及许可命令的信息。
8SunONEApplicationServer安装指南•2003年4月 使用文档 使用文档 SunONEApplicationServer手册是可移植文档格式(PDF)和超文本标记语言(HTML)格式的联机文件，可以从以下位置获得： / 下表列出了SunONEApplicationServer手册中介绍的任务和概念。
SunONEApplicationServer文档说明 有关信息 软件和文档的最新信息 支持的平台和环境 应用程序服务器简介，包括新功能、评估安装信息和结构概述。
安装SunONEApplicationServer及其各种组件（样例应用程序、管理界面和SunONEMessageQueue）。
根据SunONEApplicationServer7中的开放式Java标准模式创建和执行J2EE应用程序。
包括有关应用程序设计、开发者工具、安全性、汇编、部署、调试和创建设生命周期模块的常规信息。
根据SunONEApplicationServer7中Web应用程序的开放式Java标准模式创建和执行J2EE应用程序。
介绍了Web应用程序编程概念和任务，并提供了样例代码、执行程序提示和参考资料。
根据SunONEApplicationServer7中企业Bean的开放式Java标准模式创建和执行J2EE应用程序。
介绍了EJB编程概念和任务，并提供了样例代码、执行程序提示和参考资料。
在SunONEApplicationServer7上创建Web服务、RMI-IIOP或访问J2EE应用程序的其它客户机。
J2EE功能，例如JDBC、JNDI、JTS、JMS、JavaMail、资源和连接器 创建自定义NSAPI插件 请参见以下手册 发行说明PlatformSummaryGettingStartedGuide 安装指南 Developer'sGuide Developer'sGuidetoWebApplications Developer'sGuidetoEnterpriseJavaBeans Developer'sGuidetoClients Developer'sGuidetoJ2EEFeaturesandServicesDeveloper'sGuidetoNSAPI 关于本指南
9 使用文档 SunONEApplicationServer文档说明（续） 有关信息 执行以下管理任务： 请参见以下手册 管理员指南 使用管理界面和命令行界面 配置服务器首选项 使用管理域 使用服务器实例 监视和记录服务器操作 配置Web服务器插件配置Java消息传送服务使用J2EE功能配置对基于CORBA的客户机的支持配置数据库连接 配置事务管理 配置Web容器部署应用程序 管理虚拟服务器 编辑服务器配置文件 Administrator'sConfigurationFileReference 为SunONEApplicationServer7操作环境配置和管理安全性。
包括有关常规安全性、证书和SSL/TLS加密的信息。
同时还介绍了基于Web核心的安全性。
为SunONEApplicationServer7配置和管理J2EECA连接器的服务提供者执行程序。
包括有关管理工具和DTD的信息，并提供了样例XML文件。
将应用程序从NetscapeApplicationServer2.1版移植到新的SunONEApplicationServer7编程模式（包括随SunONEApplicationServer提供的OnlineBank应用程序的样例移植）。
Administrator'sGuidetoSecurity J2EECAServiceProviderImplementationAdministrator'sGuide 迁移和重新部署服务器应用程序 使用SunONEMessageQueue SunONEMessageQueue文档位于： /?
p=/coll/S1_MessageQueue_30 10SunONEApplicationServer安装指南•2003年4月 文档惯例 文档惯例 本节介绍本指南使用的各种惯例：•一般惯例•有关目录的惯例 一般惯例 本指南使用了以下一般惯例：•文件和目录路径采用UNIX®格式（由正斜杠分隔目录名）。
对于Microsoft Windows版本，目录路径相同，但使用反斜杠分隔目录。
•URL的格式如下： 在这些URL中，server是应用程序运行所在的服务器的名称；domain是您的域名；path是服务器的目录结构；file是单个文件名。
URL中的斜体项为占位符。
•字体惯例包括：❍等宽字体用于样例代码和代码列表、API和语言元素（例如，函数名和类 名）、文件名、路径名、目录名以及HTML标记。
❍斜体用于代码变量。
❍斜体还用于书名、强调、变量、占位符以及斜体文字。
❍粗体用于段落标题或粗体文字。
•本文档中，多数平台的安装根目录都由install_dir表示。
第12页上的“有关目录的惯例”对例外情况进行了说明。
默认情况下，多数平台上的install_dir位置都位于：❍Solaris8非基于软件包的评估安装：user_home_directory/sun/appserver7 关于本指南11 文档惯例 ❍非捆绑的、基于软件包的Solaris安装： /opt/SUNWappserver7 ❍MicrosoftWindows的所有安装： C:\Sun\AppServer7 对于上面列出的平台，default_config_dir和install_config_dir与install_dir相同。
有关例外情况及其它信息，请参见第12页上的“有关目录的惯例”。
•本文档中，实例根目录由instance_dir表示，它是以下内容的缩写：default_config_dir/domains/domain/instance•除非特别说明，本手册中所有特定于UNIX的说明也适用于Linux操作系统。
有关目录的惯例 默认情况下，使用基于软件包的Solaris8和9安装以及Solaris9捆绑安装时，应用程序服务器文件将分布在多个根目录中。
本节介绍了这些目录。
•对于Solaris9捆绑安装，本指南使用了以下文档惯例，对应于所提供的各个不同的默认安装目录： ❍install_dir为/usr/appserver/，它包含安装映像的静态部分。
组成应用程序服务器的所有公用程序、可执行文件和库均驻留在此目录中。
❍default_config_dir为/var/appserver/domains，它是所创建的域的默认位置。
❍install_config_dir指的是/etc/appserver/，它包含与安装有关的配置信息，例如，为此安装配置的许可证和管理域主列表。
•对于基于软件包的非捆绑的Solaris8和9安装，本指南了使用以下文档惯例，对应于所提供的各个不同的默认安装目录： ❍install_dir为/opt/SUNWappserver7，它包含安装映像的静态部分。
组成应用程序服务器的所有公用程序、可执行文件和库均驻留在此目录中。
❍default_config_dir为/var/opt/SUNWappserver7/domains，它是所创建的域的默认位置。
❍install_config_dir指的是/etc/opt/SUNWappserver7/，它包含与安装有关的配置信息，例如，为此安装配置的许可证和管理域主列表。
12SunONEApplicationServer安装指南•2003年4月 产品支持 产品支持 如果您的系统出现问题，请使用以下方法与用户支持中心联系：•访问联机支持Web站点： /supportraining/•拨打随您的维修合同提供的电话号码联系之前，请准备好以下信息。
这可以帮助我们的支持中心人员更好地为您解决问题：•问题说明，包括出现问题时的情况及其对操作的影响•计算机类型、操作系统版本以及产品版本，包括可能影响该问题的任何修补程 序和其它软件•用于再现问题的方法的详细步骤•任何错误日志或信息转储 更多信息 从以下站点可以找到有关SunONE的更多有用信息：•SunONE产品和服务信息 •SunONE开发者信息 /software/product_categories/application_development.html•SunONE学习解决方案/software/training/•SunONE产品数据表/software/•SunMicrosystems产品文档/ 关于本指南13 更多信息 •SunONEApplicationServer产品下载：/software/download/app_servers.html •SunONEApplicationServer产品文档/db/prod/s1.asse#hic 14SunONEApplicationServer安装指南•2003年4月 第1章 准备安装 Sun™OpenNetEnvironment(SunONE)ApplicationServer7软件可以根据您的系统、角色和站点的需要以多种不同的方式进行发布和安装。
本模块介绍了该产品的软件组件、您的选择范围和限制以及SunONEApplicationServer环境的系统要求。
本文包括以下主题：•关于SunONEApplicationServer安装•系统要求•访问文档请阅读SunONEApplicationServer发行说明以获取最新的安装信息。
有关在安装后配置SunONEApplicationServer软件的详细信息，请参见《SunONEApplicationServer管理员指南》。
以下位置提供了相应的帮助信息，其中包括技术说明、论坛讨论、工具和公用程序以及产品下载信息： /software/products/appsrvr/home_appsrvr.html/software/download/app_servers.html 15 关于SunONEApplicationServer安装 关于SunONEApplicationServer安装 SunONEApplicationServer产品包含多个软件组件，它们组合在一起就构成了SunONEApplicationServer。
您在安装时可以有多种选择：•可以安装产品的平台版或标准版。
•可以从产品CD或下载站点进行安装。
•可以安装产品的评估版或开发版。
•可以通过命令行界面或图形界面进行安装。
•可以进行交互式安装或以静音模式安装。
本节包括以下主题。
•安装组件•安装方法•产品的安装版本•封装模型和目录结构 安装组件 以下各节简要介绍了SunONEApplicationServer的各个安装组件：•SunONEApplicationServer•管理客户机•SunONEMessageQueue•PointBase•样例应用程序•SunONEStudio4.0,EnterpriseEditionforJava•Java2SoftwareDevelopmentKit(J2SE) SunONEApplicationServer 包括本节所述的SunONEApplicationServer软件产品的核心组件。
有关SunONEApplicationServer功能的详细信息，请参见SunONEApplicationServerWhat'sNew文档。
16SunONEApplicationServer安装指南•2003年4月 关于SunONEApplicationServer安装 版本为满足UNIX和MicrosoftWindows环境的各种需要，提供了以下SunONEApplicationServer版本：•平台版•标准版平台版和标准版支持单机以及多机的分层部署。
平台版被限制为每个管理域只能有一个应用程序服务器实例（即一个JVM进程）；而标准版可以配置为每个管理域具有多个应用程序服务器实例。
标准版允许您将到达同一Web服务器实例的HTTP/S通信划分到中间层中的多台应用程序服务器上，从而提供了增强的Web层支持。
这两个版本都不支持来自插件的负载平衡。
本产品标准版的评估版试用期为六十天；试用期过后，可以将评估版转换为完全授权的开发版。
管理•管理服务器—提供了管理设备（每个域一台管理服务器）。
•管理界面—用于执行服务器管理任务的图形界面，也称为管理控制台。
•命令行界面—执行与管理界面相同的任务。
•多管理域—一种机制，使不同的管理员可以创建并管理各自的应用程序服务器 实例集。
管理界面和命令行界面将在您安装SunONEApplicationServer组件时自动安装。
管理界面（也称为管理控制台）启动后，将显示SunONEApplicationServer图形界面的初始页面。
使用图形管理（浏览器）客户机和命令行管理客户机都可以管理和配置服务器及驻留在这些服务器上的应用程序，并帮助您部署应用程序。
有关使用管理工具的详细说明，请参见《SunONEApplicationServer管理员指南》、管理界面联机帮助以及asadmin手册页。
第1章准备安装17 关于SunONEApplicationServer安装 管理客户机 管理客户机是SunONEApplicationServer的独立的命令行组件。
它是在安装SunONEApplicationServer组件时自动安装的。
可以选择在未安装SunONEApplicationServer的计算机上单独安装此客户机的命令行版本。
要完成此操作，请在安装过程中仅选择SunONEAdministrationClient组件而不选择SunONEApplicationServer组件。
SunONEMessageQueue SunONEMessageQueue3.0.1软件是JavaMessagingService(JMS)1.0.2规范的应用实现。
它是在安装SunONEApplicationServer软件时自动安装的。
SunONEMessageQueue包含三个主要组件： •代理 •客户机API •管理工具 对于非基于软件包的UNIX版本和所有MicrosoftWindows版本，SunONEMessageQueue软件将随SunONEApplicationServer软件一起自动安装在以下位置：install_dir/imq PointBase PointBase4.2是受SunONEApplicationServer平台支持的数据库。
PointBase是用于客户机-服务器联网应用程序的纯Java关系数据库管理系统(RDBMS)。
它为电子商务和应用程序服务器提供了一种可靠且可缩放的数据库。
PointBase4.2安装在以下位置：install_dir/pointbase 注意 PointBase在SunONEApplicationServer的Solaris9捆绑版本中不 可用。
18SunONEApplicationServer安装指南•2003年4月 关于SunONEApplicationServer安装 样例应用程序 SunONEApplicationServer包含六十多个样例应用程序，这些应用程序在您安装SunONEApplicationServer软件时提供。
所有样例都包含源文件、模式文件、Antbuild脚本文件和EAR文件。
数据库中提供了与数据库相关样例关联的任何现有数据。
这些样例应用程序可以分类为： •技术样例—介绍了Java™2Platform,EnterpriseEdition(J2EE™)规范的各个技术方面以及SunONEApplicationServer平台的增值功能。
•互操作性样例—详细介绍了如何在SunONEApplicationServer平台上集成这些技术。
样例应用程序安装在以下位置：install_dir/samples 有关样例的详细信息可以从以下位置获得： install_dir/samples/index.html SunONEStudio4.0,EnterpriseEditionforJava SunONEStudio（以前称为ForteforJavaEnterpriseEdition4.0）可用于创建和部署符合SOAP1.1规范的基于Java的Web服务。
SunONEApplicationServer平台支持SunONEStudio4.0。
也就是说，您可以将现有的SunONEStudio4安装用于SunONEApplicationServer软件。
安装SunONEApplicationServer时，系统将提示您输入现有SunONEStudio4.0安装的路径（如果适用）。
SunONEStudio4文件安装在以下位置：install_dir/studio4 Java2SoftwareDevelopmentKit(J2SE) SunONEApplicationServer产品需要J2SE1.4.1_01并利用1.4平台的性能和功能改进。
在开发版安装过程中，您可以选择再次使用系统中已安装的J2SE，只要此J2SE版本正确即可。
注意 SunONEApplicationServer7产品只能与SunMicrosystems的J2SE1.4.1_01一起使用。
第三方J2SE开发工具包（即使版本号正确）不受支持。
第1章准备安装19 关于SunONEApplicationServer安装 对于UNIX评估版和所有MicrosoftWindows版本，J2SE安装在以下位置：install_dir/jdk对于Solaris非捆绑的非评估版和Solaris9捆绑版本，J2SE安装在以下位置：/usr/j2se。
安装方法 您可以使用以下三种方法之一安装SunONEApplicationServer软件：•图形界面方法•命令行界面方法•静音模式 图形界面方法 如果选择使用图形界面进行安装，系统将为您提供一组交互式图形对话框。
这是当您调用安装程序而未选择选项时的默认模式： ./setup有关使用图形界面方法的详细说明，请参见第33页上的“评估安装”和第50页上的“安装开发版产品”。
命令行界面方法 如果选择使用命令行界面进行安装，则安装步骤与图形界面安装相同，但不提供图形显示。
要激活交互式命令行模式，请使用-console选项调用安装程序： ./setup-console如果使用访问远程服务器，可以使用命令行界面以交互方式安装本产品。
20SunONEApplicationServer安装指南•2003年4月 关于SunONEApplicationServer安装 静音模式 可以使用静音模式，基于一个参数文件（在使用图形界面或命令行界面进行的标准交互式安装过程中创建的）执行脚本安装。
在静音模式下，SunONEApplicationServer软件将自行安装而不与您进行交互。
通过引用参数文件，在交互模式下安装的组件将被自动安装。
有关使用静音模式的说明，请参见第62页上的“在静音模式下安装（非交互式）”。
产品的安装版本 SunONEApplicationServer根据您的特定用途（用于评估或开发）提供了两种安装版本。
注意 大多数安装任务都要求具有超级用户特权，即在UNIX上，必须具有超级用户特权；在MicrosoftWindows上，必须具有管理员特权。
本节包括以下主题： •评估版•开发版（非评估版）•安装版本汇总您可以从产品CD或从网站上下载来安装本产品。
在以下位置可以获得SunONEApplicationServer产品的各种可用下载文件： /software/download/app_servers.html 评估版 如果要评估SunONEApplicationServer软件，或者要先试用一下然后决定是否购买，可以安装SunONEApplicationServer软件的评估版。
产品的评估版不允许您选择可安装的组件。
默认情况下，如果选择评估版产品，以下组件将自动安装在安装根目录下： •SunONEApplicationServer，包括其图形管理工具和命令行管理工具•SunONEApplicationServerAdministrationClient（命令行工具）•SunONEMessageQueue 第1章准备安装21 关于SunONEApplicationServer安装 •Java2SoftwareDevelopmentKit(J2SE)•PointBase•样例应用程序评估许可证在60天后自动过期。
在MicrosoftWindows上，可以将此许可证升级为非评估开发许可证。
有关说明，请参见第101页上的“许可信息”。
开发版（非评估版） 开发者和管理员通常会使用“非评估”安装。
此安装程序可以通过下载获得，也可以在UNIX及MicrosoftWindows的产品CD中找到。
SunONEApplicationServer产品包括以下安装组件：•SunONEApplicationServer，包括其图形管理工具和命令行管理工具•SunONEApplicationServerAdministrationClient（仅命令行工具）•SunONEMessageQueue3.0.1•Java2SoftwareDevelopmentKit(J2SE),StandardEdition1.4.1_01•PointBaseDatabaseServer和Type4JDBC驱动程序（在SunONE ApplicationServer的Solaris9捆绑版本中不可用。
）•SampleApplications•SupportforSunONEStudio4.0,EnterpriseEditionforJava此许可证不会过期。
有关许可的详细信息，请参见第101页上的“许可信息”。
UNIX上的非评估版安装始终是基于软件包的。
有关SunONEApplicationServer软件各种安装版本的说明，请参见第23页上的“封装模型和目录结构”。
22SunONEApplicationServer安装指南•2003年4月 关于SunONEApplicationServer安装 安装版本汇总 下表总结了产品的评估版和开发版的功能。
安装版本汇总 要素/组件 SunONEApplicationServer管理客户机PointBase（在Solaris9捆绑版本中不可用）样例应用程序 J2SE SunONEMessageQueueSunONEStudio4插件可下载 评估版 是 是是 是是是否是 可通过CD-ROM安装 许可使用期限可以升级许可证 必须是超级用户才可以安装？ 是：Solaris否：所有其它版本 60天 是：MicrosoftWindows否：UNIX 是：MicrosoftWindows是：UNIX，基于软件包否：UNIX，非基于软件包 非评估版（开发版） 是 是可选 可选是是可选否：Windows是：UNIX是 无限制是 是 封装模型和目录结构 根据您系统上安装的产品版本，SunONEApplicationServer软件可能安装在单个根目录路径下，也可能安装在多个根目录路径下。
•Solaris9上的捆绑安装•UNIX上基于软件包的安装•MicrosoftWindows上的安装及评估版安装 第1章准备安装23 关于SunONEApplicationServer安装 Solaris9上的捆绑安装 在Solaris上，当使用产品的基于软件包的Solaris安装以及作为Solaris9安装的组成部分来安装SunONEApplicationServer软件时，SunONEApplicationServer软件会分布在以下几个根目录下： •/usr/appserver包含安装映像的静态部分。
组成应用程序服务器的所有公用程序、可执行文件和库均驻留在此目录中。
只有产品修补程序和升级程序会影响此区域。
此位置的子目录包括： ❍bin/包含可执行文件和公用程序，其中的某些文件和程序是象征性地从/usr/bin链接的。
❍include/包含旧的头文件。
❍lib/包含本地库和Java库。
•/etc/appserver/包含与安装有关的配置信息，例如，为此安装配置的许可证和管理域主列表。
•/var/appserver/domains是创建管理域的默认位置。
注意 由于将SunONEApplicationServer产品作为Solaris9安装的一部分 安装时不会创建初始域，因此在创建初始域之前不会存在域目录。
创建 管理域时，可以将管理域放在系统中的任意位置。
此区域仅作为域的默 认创建位置。
有关详细信息，请参见第66页上的“创建管理域”。
UNIX上基于软件包的安装 在UNIX上，基于软件包的安装模型将组件安装为软件包。
默认情况下，在进行基于软件包的SunONEApplicationServer产品安装时，安装位置以与捆绑安装类似的方式分布在三个根目录下。
•/opt/SUNWappserver7包含安装映像的静态部分。
SunONEApplicationServer软件的所有公用程序、可执行文件和库均驻留在此目录中。
注意 只有产品的修补程序和升级程序会影响/opt/SUNWappserver7。
•/etc/opt/SUNWappserver7/config包含与安装有关的配置信息，例如，为此安装配置的许可证和管理域主列表。
•/var/opt/SUNWappserver7/domains是创建管理域的默认位置。
24SunONEApplicationServer安装指南•2003年4月 系统要求 注意 由于将SunONEApplicationServer产品作为Solaris9安装的一部分安装时不会创建初始域，因此在创建初始域之前不会存在域目录。
创建 管理域时，可以将管理域放在系统中的任意位置。
此区域仅作为域的默 认创建位置。
有关详细信息，请参见第66页上的“创建管理域”。
MicrosoftWindows上的安装及评估版安装 在MicrosoftWindows上，以及对于任何评估版产品（无软件包）安装，SunONEApplicationServer都会安装在单个目录路径下。
默认目录如下所示：•对于MicrosoftWindows： c:\Sun\AppServer7 •对于不包含软件包的UNIX评估版：home_dir/sun/appserver7 在这些情况下，/config和/domains目录位于安装根目录下。
系统要求 本节列出了安装SunONEApplicationServer产品之前必须满足的要求。
•平台要求•所需的Solaris修补程序•其它要求 第1章准备安装25 系统要求 平台要求 下表总结了SunONEApplicationServer的要求。
操作系统 体系结构 UNIX •适用于SPARC的SunSolaris8或
9 32和64位 MicrosoftWindows •2000AdvancedServer，SP2 •2000Server，SP2 •2000Professional，SP2 •WindowsXPProfessional Intel32位 最小内存 建议的内存 最小磁盘空间 建议的磁盘空间 256MB（不含SunONEStudio） 512MB（含SunONEStudio） 512MB 250MB可用空间 500MB可用空间 256MB（不含SunONEStudio） 256MB（含SunONEStudio） 256MB（不含SunONEStudio） 512MB（含SunONEStudio） 250MB可用空间 500MB可用空间 在UNIX上，可以使用uname命令查看操作系统版本。
可以使用du命令查看磁盘空间。
有关支持的目录服务器、Web服务器和Web浏览器等的最新信息，请参见位于以下位置的《SunONEApplicationServerPlatformSummary》： /db/coll/s1_asse_en 26SunONEApplicationServer安装指南•2003年4月 系统要求 所需的Solaris修补程序 对于Solaris8系统，必须安装以下Solaris修补程序或它们的等效程序：•109326-06•108827-26•110934（仅适用于基于软件包的安装）Solaris8所需的修补程序可以从位于以下位置的修补程序查找器页面中检索：/pub-cgi/show.pl?
target=patches/ess建议Solaris8用户安装“推荐的修补程序集”，其中包含Solaris8需要的三个修补程序（109326-06、108827-26和110934）。
此修补程序集可以在以下位置的“PatchPortal”>“mendedandSecurityPatches”下找到： /安装SunONEApplicationServer7Update1软件之前，您的系统必须安装了以下软件包：•SUNWpr版本4.1.2•SUNWtls版本3.3.2以下命令将显示与SUNWpr软件包相关的信息（如果系统安装了此软件包）： pkginfo-lSUNWpr同样，以下命令将显示与SUNWtls软件包相关的信息： pkginfo-lSUNWtls如果系统同时安装了这两个软件包，您还必须验证系统是否安装了以下修补程序：•用于Solaris-114049-03•用于Solaris8-114045-02如果缺少SUNWpr软件包、SUNWtls软件包或相应的修补程序，则必须先安装缺少的项才能进行SunONEApplicationServer的安装。
为了方便您的使用，SUNWpr和SUNWtls软件包以及114049-03和114045-02修补程序都可以在以下位置进行下载： /software/download/app_servers.html要安装组件，请执行以下步骤：
1.将nss-nspr.tar归档文件下载到您的系统中，然后将其解压缩到任何临时位置。

2.转到your_temporary_location/nss_nspr。
第1章准备安装27 系统要求
3.要将SUNWpr和SUNtls软件包添加到系统中，请运行以下命令：pkgadd-d.SUNWprSUNWtls
4.要将相应的修补程序添加到您的系统中，请选择其中之一： 注意 修补程序114045和114049是针对特定版本的。
修补程序114049仅 适用于Solaris9系统，而修补程序114045仅适用于Solaris8系统。
❍对于Solaris8—转到your_temporary_location/nss_nspr/solaris8，并运行以下命令： patchadd-d114045-02 ❍对于Solaris9—转到your_temporary_location/nss_nspr/solaris9，并运行以下命令： patchadd-d114049-03 注意 在Solaris9上有一种特殊情况：系统安装了SUNWpr和SUNWtls软件包，但是应用此修补程序会导致以下错误： ERROR:Thispatchispatiblewithpatch114045-02whichhasalreadybeenappliedtothesystem... 您需要使用以下命令删除SUNWpr和SUNWtls软件包：pkgrmSUNWpr、SUNWtls 然后按照本节的说明重新安装软件包。
其它要求 安装SunONEApplicationServer软件前，必须满足以下附加要求：•对于所有平台•对于UNIX•对于MicrosoftWindows 28SunONEApplicationServer安装指南•2003年4月 系统要求 对于所有平台 •可用空间—临时目录中必须至少有100MB的可用空间。
在UNIX上，可以使用du命令查看磁盘空间。
•可用端口—在所有平台上，必须有四个未使用的端口。
❍在安装过程中，需要为管理服务器分配一个端口，为HTTP服务器默认实例分配另一个端口。
❍安装程序将检测已用端口并为您分配其它两个端口：SunONEMessageQueue（默认为7676）和IIOP（默认为3700）。
如果这两个默认端口中的任何一个处于使用状态，安装程序将分配下一个可用端口（例如7677或7678等）。
•使用uninstall程序—如果要从系统中删除SunONEApplicationServer，应当使用随SunONEApplicationServer软件一起安装的uninstall程序。
如果尝试其它方法，在试图重新安装同一版本或安装新版本时将出现问题。
对于UNIX •超级用户特权—对于基于软件包的UNIX安装，您必须对目标计算机具有超级用户特权。
（安装非基于软件包的评估版SunONEApplicationServer时不需要超级用户特权。
）以超级用户身份进行安装时，请注意以下问题：❍对于非基于软件包的产品版本—可以以超级用户身份安装多个SunONEApplicationServer，只要每次安装的安装目录不同即可。
❍对于基于软件包的产品版本—每个系统只能安装一次。
但是，同一系统上可以安装有一个非评估版以及任意数量的评估版，只要每个安装的安装目录不同即可。
❍对于评估版和非评估版—同一安装中可以运行有多个实例。
•增强型操作系统—是指为提高安全性而删除了某些功能的操作系统。
这种操作系统通常不允许在环境中运行基于GUI的应用程序。
在增强型操作环境中，安装和使用SunONEApplicationServer7需要以下两个库：❍libC.so.5❍libCrun.so.1这两个库可以通过安装SUNWlibC包获得。
第1章准备安装29 系统要求 •启动以前安装的服务器—如果目标计算机上具有以前安装的应用程序服务器或Web服务器，则在开始SunONEApplicationServer安装过程之前必须启动这些服务器。
这样，安装程序才能检测到已使用的端口，从而避免再分配它们用于其它用途。
对于Solaris捆绑版本 •共享的MessageQueue代理—如果计算机上安装了SunONEApplicationServer软件的Solaris9捆绑版本，然后要安装该服务器的非捆绑版本，则这些应用程序服务器安装的MessageQueue代理将被共享。
因此，如果未能对域和实例进行唯一命名，在启动具有相同域名或实例名的第二个实例时将发生以下错误： SEVERE:JMS5024:JMS服务启动失败 SEVERE:CORE5071:初始化过程中出现错误 为避免出现这些错误，请参见《SunONEApplicationServer管理员指南》中的“JMS支持”模块。
对于MicrosoftWindows •管理员特权—您必须具有管理员特权才能在MicrosoftWindows上安装SunONEApplicationServer软件。
这对评估版和非评估版安装均适用。
•SNMP—安装SunONEApplicationServer软件前，必须安装SNMP服务，否则SNMP子代理的安装将失败。
•关闭防火墙或防病毒程序—安装SunONEApplicationServer软件前，必须关闭防火墙或防病毒软件，因为某些这类软件会默认禁用所有端口。
SunONEApplicationServer安装程序必须能够准确确定哪些端口可用。
•在给定的MicrosoftWindows计算机上，只能安装一个SunONEApplicationServer。
30SunONEApplicationServer安装指南•2003年4月 访问文档 访问文档 SunONEApplicationServer文档具有多种提供方式：•手册—可以在以下位置查看HTML格式及可打印的PDF下载格式的SunONE ApplicationServer手册和发行说明：/db/coll/s1_asse_en •联机帮助—在图形界面上单击“Help”按钮将启动与上下文相关的帮助窗口。
•手册页—要在命令行查看手册页，必须先将install_dir/man添加到MANPATH 环境变量中（仅限于Solaris捆绑版本）。
设置该变量后，可以通过在命令行键入mand_name来访问SunONEApplicationServer命令的手册页。
例如： manasadmin 第1章准备安装31 访问文档32SunONEApplicationServer安装指南•2003年4月 第2章 评估安装 本模块介绍如何安装用于评估目的的Sun™OpenNetEnvironment(SunONE)ApplicationServer7软件。
这是一种快速安装，用户无需进行完整的操作安装即可试用本产品。
本文包括以下主题：•安装内容•从Web站点下载•安装评估产品•在静音模式下安装（非交互式）安装之前，应阅读第15页上的“准备安装”中的信息。
有关这些说明的最新更新，请参阅SunONEApplicationServer发行说明。
可以从以下位置获得产品下载和其它有用的信息： /software/download/app_servers.html/software/products/appsrvr/home_appsrvr.html 33 安装内容 安装内容 SunONEApplicationServer评估安装的目的是使用户和潜在用户可以试用SunONEApplicationServer软件，而不一定要购买该软件。
您可以以交互方式安装本产品的评估版本，也可以使用静音模式将一个安装方案复制到多台计算机上。
在UNIX上，评估版本使您可以同时在一个系统上安装多个SunONEApplicationServer。
允许存在SunONEMessageQueue和J2SE的原有版本，但不能使用。
评估安装期间，您无法从可安装组件中进行选择。
评估安装程序会自动安装以下组件：•SunONEApplicationServer，包括其管理工具和公用程序•SunONEApplicationServerAdministrationClient（命令行工具）•Java2SoftwareDevelopmentKit(J2SE),StandardEdition1.4.1_01•SunONEMessageQueue3.0.1•PointBaseDatabaseServer和Type4JDBC驱动程序（在SunONE ApplicationServer的Solaris9捆绑版本中不可用。
）•样例应用程序可以选择安装支持SunONEStudio（以前的ForteforJava4.0）的SunONEApplicationServer的评估版本。
如果安装此评估版本，同时还将安装以下组件：•SunONEStudio4插件有关组件的说明，请参见第16页上的“安装组件”。
34SunONEApplicationServer安装指南•2003年4月 从Web站点下载 从Web站点下载 本节介绍如何从Web站点下载SunONEApplicationServer安装文件。
针对UNIX进行下载
1.从以下SunONEApplicationServer下载站点选择要下载的文件，并将其保存到UNIX计算机上的一个临时目录中。
/software/download/app_servers.html
2.浏览至保存所下载文件的目录。
例如： cd/temp_dir/as7download/3.按照以下格式使用gunzip命令解压缩.gz文件： gunzip文件名.tar.gz4.按照以下格式使用tar-xvf命令将解压缩的文件解包： tar-xvf文件名.tar此过程可能需要一段时间。
将文件解压缩后，就可以看到sun-appserver7目录，其中包含setup文件和package目录。
针对MicrosoftWindows进行下载
1.从以下SunONEApplicationServer下载站点选择要下载的文件，并将其保存到MicrosoftWindows计算机上的一个临时目录中。
/software/download/app_servers.html 进度指示条将通知您下载何时完成。
注意 在MicrosoftWindows上—您会收到一封电子邮件通知，其中提供了一个不过期的许可证密钥（供开发人员免费使用），您可以使用它 升级评估许可证。
SunONEApplicationServer安装进程结束时，您可以升级许可证。
第2章评估安装35 安装评估产品
2.浏览至保存所下载的安装zip文件的目录。

3.解压缩安装zip文件：打开zip文件并将其内容提取到指定的文件夹。
提取完成 时，您会在sun-appserver7文件夹目录中看到以下内容：\package文件夹3RD-PARTY-LICENSE.txt文件appserv.class文件LICENSE.txt文件README.txt文件setup.exe脚本 安装评估产品 验证系统满足第25页上的“系统要求”中指定的要求后，请执行本节中的步骤，安装评估版SunONEApplicationServer。
如果选择使用命令行界面，那么安装步骤不变，但不显示基于图形的安装屏幕，而是显示基于文本的屏幕。
注意 在MicrosoftWindows上—必须具有管理员特权，才能安装Sun ONEApplicationServer7软件。
一台MicrosoftWindows计算机上 只能安装一个SunONEApplicationServer。

1.如果不在安装目录中，请浏览至解压缩安装文件所在的目录，将看到setup.exe文件。
注意 在MicrosoftWindows上—可以使用MicrosoftWindows资源管理器浏览至解压缩文件所在的目录，然后双击setup文件，调用安装程 序的图形界面。
36SunONEApplicationServer安装指南•2003年4月 安装评估产品
2.按照如下所述选择安装方法：❍要使用图形界面运行安装，请在命令提示符下键入以下内容：./setup 注意 在UNIX上—如果要使用图形界面远程安装SunONEApplicationServer软件，您必须启用要安装本产品的计算机上的显示器配置。
可以通过设置DISPLAY环境变量来完成此操作。
DISPLAY包含服务器名称，并以以下格式显示：host_name.domain_:0.0 ❍要使用命令行界面运行安装，请在命令提示符下键入以下内容：./setup-console 将显示安装程序的“e”页面，如下所示。
第2章评估安装37 安装评估产品 注意 单击“Help”按钮，可以显示某个页面的上下文相关信息。

3.阅读“e”页面，然后单击“Next”。
将显示以下“LicenseAgreement”页面。

4.阅读许可证协议并单击“Yes”接受许可证条款，然后单击“Next”（或在命令行键入Yes）。
注意 必须接受许可证协议才能继续安装。
接受许可证协议后，将显示以下“SelectInstallationDirectory”页面。
38SunONEApplicationServer安装指南•2003年4月 安装评估产品
5.指定SunONEApplicationServer安装目录的路径。
❍单击“Browse”浏览到一个目录（或在命令行按Enter键接受默认的安装目录）。
❍如果输入的目录名不存在，将显示“CreateNewDirectory?
”。
•单击“CreateDirectory”（或在命令行键入1），创建一个新目录。
•单击“ChooseNew”（或在命令行键入2）返回“SelectInstallationDirectory”页面。
将显示以下“ServerConfigurationInformation”页面。
第2章评估安装39 安装评估产品
6.在“ServerConfigurationInformation”页面上（或在命令行中）输入以下值：❍AdminUser—管理服务器的用户的名称（例如，admin）。
❍AdminUser'sPassword—用于访问管理服务器的密码。
最少字符数为
8。
例如，adminadmin。
重新输入密码，确认您的选择。
❍AdminServerPort—用于访问管理服务器的端口号。
将显示一个默认端口号（例如4848，如果您的计算机当前没有使用该端口）。
更改默认的端口号（如有必要）。
单击“Next”时，安装程序将检查端口号是否有效和可用。
❍HTTPServerPort—用于访问默认服务器实例的端口号。
40SunONEApplicationServer安装指南•2003年4月 安装评估产品 将显示一个默认端口号（例如1024，如果您的计算机当前没有使用该端口）。
更改默认的端口号（如有必要）。
单击“Next”时，安装程序将检查端口号是否有效和可用。
注意 安装程序自动检测正在使用的端口，并建议将当前未使用的端口用作默认设置。
默认情况下，如果在UNIX上作为根用户或在MicrosoftWindows上安装，则用于HTTP服务器的初始默认端口号为80，用于管理服务器的初始默认端口号为4848。
如果在UNIX上作为非根用户安装，则HTTP服务器端口默认为1024。
如果系统正在使用初始默认端口，安装程序将建议一个替代的端口号。

7.单击“Next”。
安装程序开始验证是否有足够的磁盘空间来安装本产品。
将显示“CheckingDiskSpace”进度指示条。
❍如果没有足够的磁盘空间，将显示一条错误消息。
此时，需要退出安装程序，然后在创建足够的空间后重新开始安装。
有关空间要求的信息，请参见第26页上的“平台要求”。
❍如果有足够的磁盘空间，将显示一个类似于以下所示的“ReadytoInstall”页面。
第2章评估安装41 安装评估产品
8.此时，可以选择以下操作：❍如果要返回“ServerConfigurationInformation”页面，请单击“Back”。
如果执行此操作，将重新检查磁盘空间。
❍单击“InstallNow”（或在命令行键入1），开始安装进程。
❍单击“Cancel”，退出安装程序。
将显示一个安装进度指示条。
安装完成时，将显示一个类似于如下所示的“InstallationComplete”页面。
42SunONEApplicationServer安装指南•2003年4月 安装评估产品
9.在MicrosoftWindows上，现在可以决定是否升级许可证。
a.单击“Next”，将显示以下“UpgradeLicense”页面。
第2章评估安装43 安装评估产品 如果不想升级许可证，请单击“Back”，返回到上一屏幕。
注意 您可以在以后按照第105页上的“转换许可证”中的说明升级许可证。
b.要升级许可证，请输入许可证号，然后单击“Apply”。
将显示“LicenseUpgradeessful”对话框。
c.单击“OK”。
10.单击（或键入）“Finish”完成安装。
将显示“AboutSunONEApplicationServer”页面。
11.设置PATH环境变量。
需要将环境配置为包括SunONEApplicationServer的install_dir/bin目录。
有关此操作的说明，请参见第83页上的“设置PATH环境变量”。
44SunONEApplicationServer安装指南•2003年4月 安装评估产品 12.SunONEApplicationServer环境不会自动启动，因此，您需要启动此环境来验证安装是否成功。
有关启动SunONEApplicationServer的各种方法的说明，请参见第87页上的“启动和停止服务器”。
在桌面“启动程序”区域的SunMicrosystems,SunOneApplicationServer程序组下，执行以下操作：a.启动ApplicationServer。
将显示一个类似于如下所示的屏幕，指示SunONEApplicationServer已启动： b.启动管理控制台。
管理界面（也称为管理控制台）启动后，将显示如下所示的SunONEApplicationServer图形界面的初始页面。
第2章评估安装45 在静音模式下安装（非交互式） 13.可以通过访问应用程序服务器实例的HTTP服务器监听程序来确定SunONEApplicationServer启动是否成功。
使用浏览器访问以下位置：http://host_name:port_number其中，port_number为安装期间指定的HTTP服务器端口号。
默认的HTTP服务器端口号为80，但是可能会因安装期间使用的端口而有所不同。
有关解决问题的详细信息，请参见第95页上的“疑难解答”。
在静音模式下安装（非交互式） 如果要在静音模式下进行评估安装，请按照第62页上的“在静音模式下安装（非交互式）”中的说明进行。
46SunONEApplicationServer安装指南•2003年4月 第3章 用于开发的安装 本模块介绍如何安装用于开发和操作目的的Sun™OpenNetEnvironment(SunONE)ApplicationServer7产品。
您可以以交互方式安装产品的非评估版，也可以以静音模式将一个安装方案安装到多台计算机上。
本文包括以下主题：•安装内容•从Web下载•安装开发版产品•在静音模式下安装（非交互式）在开始本模块中的任务之前，您应当已经了解第15页上的“准备安装”中的信息。
有关这些说明的最新更新信息，请参见SunONEApplicationServer发行说明。
有关在安装后配置应用程序服务器的详细信息，请参见《SunONEApplicationServer管理员指南》。
可以从以下位置获得产品下载和其它有用的信息： /software/download/app_servers.html/software/products/appsrvr/home_appsrvr.html 47 安装内容 安装内容 通常，您将安装提供SunONEApplicationServer产品功能的基本组件。
您可以选择不安装其中的某些组件（在下面的介绍中标明为可选）。
将来如果要添加最初未选择安装的某个组件，可以再进行增量式安装，以便向原来的安装中添加组件。
一台计算机上只能安装一个非评估版的SunONEApplicationServer。
如果系统中已存在一个SunONEApplicationServer安装，安装程序将不会覆盖它；但会检测到现有安装，并不允许继续进行安装。
有关从系统中删除产品的说明，请参见第69页上的“卸载SunONEApplicationServer软件”。
注意 如果要从系统中删除SunONEApplicationServer，必须使用卸载程 序。
如果尝试其它方法，在试图重新安装同一版本或安装新版本时将 出现问题。
SunONEApplicationServer产品包括以下安装组件： •SunONEApplicationServer，包括其图形管理工具和命令行管理工具 •SunONEApplicationServerAdministrationClient（仅命令行工具） 注意 可以选择在未安装SunONEApplicationServer的计算机上单独安装 管理客户机命令行版本。
要执行此操作，可以在安装过程中仅选择 AdministrationClient组件。
•SunONEMessageQueue3.0.1•Java2SoftwareDevelopmentKit(J2SE),StandardEdition1.4.1_01•PointBaseDatabaseServer和Type4JDBC驱动程序（在SunONE ApplicationServer的Solaris9捆绑版本中不可用。
）•SampleApplications•SupportforSunONEStudio4.0,EnterpriseEditionforJava有关SunONEApplicationServer组件的说明，请参见第16页上的“安装组件”。
48SunONEApplicationServer安装指南•2003年4月 从Web下载 从Web下载 本节介绍如何从Web站点下载SunONEApplicationServer安装文件。
针对UNIX进行下载
1.从以下SunONEApplicationServer下载站点选择要下载的文件，并将其保存到UNIX计算机上的一个临时目录中。
/software/download/app_servers.html
2.浏览至保存所下载文件的目录。
例如： cd/temp_dir/as7download/
3.按照以下格式使用gunzip命令解压缩.gz文件：gunzip文件名.tar.gz
4.按照以下格式使用tar-xvf命令将解压缩的文件解包：tar-xvf文件名.tar此过程可能需要一段时间。
将文件解压缩后，会看到sun-appserver7目录，其中包含setup文件和pkg目录。
针对MicrosoftWindows进行下载 用于MicrosoftWindows的SunONEApplicationServer开发版只能通过CD光盘获得。
但是，您可以在MicrosoftWindows评估版安装过程中升级评估许可证，也可以在安装之后按照第107页上的“重新启动SunONEApplicationServer软件。
”中的说明来升级评估许可证。
注意 在MicrosoftWindows上—在评估版下载过程中，您将收到一个电子邮件通知，其中包含一个不会过期的许可证密钥（供开发者免费使用）； 您可以使用此密钥升级自己的评估许可证。
SunONEApplicationServer安装进程结束时，您可以升级许可证。
第3章用于开发的安装49 安装开发版产品 安装开发版产品 本节介绍如何使用图形界面安装SunONEApplicationServer软件。
如果选择使用命令行界面，那么安装步骤不变，但不显示基于图形的安装屏幕，而是显示基于文本的屏幕。
注意 您必须具有超级用户特权，才能安装非评估版的SunONEApplication Server7软件。
以下步骤适用于所有平台：
1.验证您具有超级用户特权，并且满足系统要求。
有关系统要求的详细信息，请参见第25页上的“系统要求”。

2.启动系统中所有使用端口并将与SunONEApplicationServer软件同时运行的进程。
这样，安装程序可以检测到已使用的端口，从而避免再将它们分配给其它用途。

3.如果不在安装目录中，请浏览至解压缩安装文件所在的目录，将看到setup.exe文件。
注意 在UNIX上—如果要使用图形界面远程安装SunONEApplicationServer软件，您必须启用要安装本产品的计算机上的显示器配置。
可以通过设置DISPLAY环境变量来完成此操作。
DISPLAY包含服务器名称，并以以下格式显示：host_name.domain_:0.0
4.按照如下所述选择安装方法：❍要使用图形界面运行安装，请在命令提示符下键入以下内容（在MicrosoftWindows上，可以双击setup.exe文件）：./setup❍要使用命令行界面运行安装，请键入： ./setup-console将显示安装程序的“e”页面，如下所示。
50SunONEApplicationServer安装指南•2003年4月 安装开发版产品 注意 单击“Help”按钮，可以显示某个页面的上下文相关信息。

5.阅读“e”页面，然后单击“Next”。
将显示以下“LicenseAgreement”页面。
第3章用于开发的安装51 安装开发版产品
6.阅读许可证协议并单击“Yes”接受许可证条款，然后单击“Next”（或在命令行键入Yes）。
注意 必须接受许可证协议才能继续安装。
接受许可证协议后，将显示以下“SelectInstallationDirectory”页面。
52SunONEApplicationServer安装指南•2003年4月 安装开发版产品
7.指定SunONEApplicationServer安装目录的路径。
❍单击“Browse”浏览到一个目录（或在命令行按Enter键接受默认的安装目录）。
❍如果输入的目录名不存在，将显示“CreateNewDirectory?
”。
•单击“CreateDirectory”（或在命令行键入1），创建一个新目录。
•单击“ChooseNew”（或在命令行键入2）返回“SelectInstallationDirectory”页面。
组件选择对话框显示了可用的组件。

8.从组件选择对话框中列出的组件中进行选择（或在命令行键入Yes或按Enter键以接受某个组件）。
❍应用程序服务器❍SampleApplications❍PointBase4.2 第3章用于开发的安装53 安装开发版产品 ❍ApplicationServerAdministrationClient ❍SupportforSunONEStudio4.0,EnterpriseEdition
9.选择安装SunONEMessageQueue3.0.1，或使用以前安装的版本。
在MicrosoftWindows上—系统始终安装了SunONEMessageQueue的所需版本，即使系统中已安装了其它版本的SunONEMessageQueue。
在Solaris上—此安装程序将检测您的系统是否预先安装了SunONEMessageQueue的正确版本，并提供以下操作之一：❍如果安装了基于软件包的SunONEMessageQueue的正确版本，将再次使用该版本。
安装程序将继续进行下一步。
❍如果未安装基于软件包的SunONEMessageQueue，可以选择让安装程序自动安装SunONEMessageQueue软件包。
❍如果安装程序发现基于软件包的SunONEMessageQueue的不正确版本，将显示一条消息，询问是否要升级当前版本或取消安装。
请选择以下选项之一： •要让安装程序更新当前的SunONEMessageQueue，请单击“Upgrade”（或在命令行键入1）。
•要退出安装程序，请单击“Cancel”（或在命令行键入2）。
10.选择安装J2SE1.4.1_01或使用以前安装的J2SE。
在Windows上—安装程序检测您的系统是否预先安装了J2SE的正确版本。
❍如果安装了正确版本的J2SE，将再次使用该版本，您也可以输入其它正确版 本的路径。
安装程序将继续进行下一步。
❍如果未安装J2SE，可以选择让安装程序自动安装J2SE软件包，或再次使用现有的J2SE安装。
在Solaris上—安装程序检测您的系统是否预先安装了J2SE的正确版本，并提供以下操作之一： ❍如果安装了基于软件包的J2SE的正确版本，将再次使用该版本，您也可以输入其它正确版本的路径。
安装程序将继续进行下一步。
❍如果未安装基于软件包的J2SE，可以选择让安装程序自动安装J2SE软件包，或再次使用现有的J2SE安装。
❍如果安装程序发现基于软件包的J2SE的不正确版本，将显示一条消息，询问是否要升级当前版本或取消。
请选择以下选项之一： •要让安装程序升级当前的J2SE版本，请单击“Upgrade”（或在命令行键入1）。
54SunONEApplicationServer安装指南•2003年4月 安装开发版产品 注意 由于其它应用程序可能正在运行和使用此J2SE安装，因此升级J2SE可能会造成某些破坏。
最好取消当前安装并检查所有相关程序（例如正常关闭各个进程）。
如果选择不亲自升级J2SE版本，可以让安装程序完成升级操作。
•要退出安装程序，请单击“Cancel”（或在命令行键入2）。
在继续安装之前，必须卸载当前位于/usr/j2se中的J2SE或将其升级到J2SE1.4.1_01。
然后重新启动SunONEApplicationServer安装。
有关卸载操作的说明，请参见第69页上的“卸载SunONEApplicationServer软件”。
注意 在UNIX上—如果J2SE需要升级，在完成SunONEApplicationServer的安装后，需要重新启动计算机。
注意 SunONEApplicationServer7软件已经过认证可以使用SunMicrosystems的J2SE1.4.1_01。
第三方J2SE开发工具包（即使版本号正确）不受支持。
11.仅在UNIX上—标识服务器配置目录。
输入SunONEApplicationServer配置安装目录的路径。
❍单击省略号(...)浏览到某个目录（或在命令行按Enter键接受默认的安装目录）。
❍如果此目录不存在，将显示“CreateNewDirectory?
”对话框。
❍单击“CreateDirectory”（或在命令行键入1）。
也可以单击“ChooseNew”（或在命令行键入2），选择一个现有目录。
12.仅在UNIX上—标识服务器域目录。
输入SunONEApplicationServer域安装目录的路径。
❍单击省略号(...)浏览到某个目录（或在命令行按Enter键接受默认的安装目录）。
❍如果此目录不存在，将显示“CreateNewDirectory?
”对话框。
第3章用于开发的安装55 安装开发版产品 ❍单击“CreateDirectory”（或在命令行键入1）。
也可以单击“ChooseNew”（或在命令行键入2），选择一个现有目录。
将显示以下“ServerConfigurationInformation”页面。
13.在“ServerConfigurationInformation”页面（或在命令行）上，输入以下内容：❍AdminUser—管理服务器的用户的名称（例如，admin）。
❍AdminUser'sPassword—用于访问管理服务器的密码。
最少字符数为
8。
例如，adminadmin。
重新输入密码，确认您的选择。
❍AdminServerPort—用于访问管理服务器的端口号。
将显示一个默认端口号（例如4848，如果您的计算机当前没有使用该端口）。
更改默认的端口号（如有必要）。
单击“Next”时，安装程序将检查端口号是否有效和可用。
❍HTTPServerPort—用于访问默认服务器实例的端口号。
56SunONEApplicationServer安装指南•2003年4月 安装开发版产品 将显示一个默认端口号（例如1024，如果您的计算机当前没有使用该端口）。
更改默认的端口号（如有必要）。
单击“Next”时，安装程序将检查端口号是否有效和可用。
注意 安装程序自动检测正在使用的端口，并建议将当前未使用的端口用作默认设置。
默认情况下，如果在UNIX上以超级用户身份安装或者在MicrosoftWindows上安装，则用于HTTP服务器的初始默认端口号为80，用于管理服务器的初始默认端口号为4848。
如果系统中的这些初始默认端口已被使用，安装程序将给出一个建议的替代端口号。
14.输入以前安装的SunONEStudio4.0的路径（如果适用）。
15.单击“Next”。
安装程序开始验证是否有足够的磁盘空间来安装本产品。
将显示“CheckingDiskSpace”进度指示条。
❍如果没有足够的磁盘空间，将显示一条错误消息。
此时，需要退出安装程序，然后在创建足够的空间后重新开始安装。
有关空间要求的信息，请参见第26页上的“平台要求”。
❍如果有足够的磁盘空间，将显示一个类似于以下所示的“ReadytoInstall”页面。
第3章用于开发的安装57 安装开发版产品 16.此时，可以选择以下操作：❍如果要返回“ServerConfigurationInformation”页面，请单击“Back”。
如果执行此操作，将重新检查磁盘空间。
❍单击“InstallNow”（或在命令行键入1），开始安装进程。
❍单击“Cancel”，退出安装程序。
将显示一个安装进度指示条。
安装完成时，将显示一个类似于如下所示的“InstallationComplete”页面。
58SunONEApplicationServer安装指南•2003年4月 安装开发版产品 现在，您可以决定是否转换（升级）自己的许可证。
注意 不能转换Solaris非基于软件包的SunONEApplicationServer软件的评估许可证。
17.单击“Next”，将显示以下“UpgradeLicense”页面。
第3章用于开发的安装59 安装开发版产品 如果您改变想法不打算现在升级许可证，可以单击“Back”返回到上一个屏幕。
注意 您可以在以后按照第105页上的“转换许可证”中的说明升级许可证。
18.要升级许可证，请输入许可证号，然后单击“Apply”。
将显示“LicenseUpgradeessful”对话框。
19.单击“OK”。
20.单击（或键入）“Finish”完成安装。
将显示“AboutSunONEApplicationServer”页面。
21.设置PATH环境变量。
您需要将环境配置为包括SunONEApplicationServer的bin目录。
有关此操作的说明，请参见第83页上的“设置PATH环境变量”。
60SunONEApplicationServer安装指南•2003年4月 安装开发版产品 22.仅适用于Solaris9捆绑版本—此类型安装还需要附加任务。
请参见第65页上的“完成Solaris9捆绑安装”。
23.SunONEApplicationServer环境不会自动启动，因此，您需要启动此环境来验证安装是否成功。
有关启动服务器的各种方法的说明，请参见第87页上的“启动和停止服务器”。
在桌面“启动程序”区域的SunMicrosystems,SunOneApplicationServer程序组下，执行以下操作：a.启动ApplicationServer。
将显示一个类似于如下所示的屏幕，指示SunONEApplicationServer已启动： b.启动管理控制台。
管理界面（也称为管理控制台）启动后，将显示SunONEApplicationServer图形界面的初始页面。
24.可以通过访问应用程序服务器实例的HTTP服务器监听程序来确定SunONEApplicationServer启动是否成功。
使用浏览器访问以下位置：http://host_name:port_number其中，port_number为安装期间指定的HTTP服务器端口号。
默认的HTTP服务器端口号为80，但是可能会因安装期间使用的端口而有所不同。
请参见有关解决问题的信息。
第3章用于开发的安装61 在静音模式下安装（非交互式） 在静音模式下安装（非交互式） 如果选择以静音模式安装SunONEApplicationServer软件，安装程序将运行而无需进行任何用户输入。
如果安装程序能够访问一个为其提供了所需配置信息的文本文件，便可以采用这种静音模式。
本节包括以下主题： •如何创建配置文件 •以静音模式安装 如何创建配置文件 配置文件是在标准交互式安装过程中在安装目录下自动创建的。
该文件收集了您的用户输入信息。
这构成了静音安装的模型，以后您可以使用该模型在一台或多台计算机上安装产品。
标准安装完成后，将生成一个类似下面所示的配置文件： #WizardStatefilecreated:TueSep0311:03:27PDT2002 # Wizard path:/temp_dir/sun-appserver7//temp_dir/sun-appserver7/appserv.class # #WizardStatefilesectionforSunONEApplicationServer # [STATE_BEGINSunONEApplicationServer808daad84da2817ce79da504cae4c78ffb57d50e] defaultInstallDirectory=/opt/SUNWappserver7 currentInstallDirectory=/opt/SUNWappserver7 SELECTED_COMPONENTS=Java2SDK,StandardEdition1.4.0_02#ApplicationServer#SunONEMessageQueue3.0.1#SampleApplications#PointBaseServer4.2#Uninstall#Startup USE_BUNDLED_JDK=TRUE JDK_LOCATION=/usr/j2se JDK_INSTALLTYPE=PREINSTALLED AS_INSTALL_DEFAULT_CONFIG_DIR=/etc/opt/SUNWappserver7 AS_INSTALL_CONFIG_DIR=/etc/opt/SUNWappserver7 AS_INSTALL_DEFAULT_VAR_DIR=/var/opt/SUNWappserver7 62SunONEApplicationServer安装指南•2003年4月 在静音模式下安装（非交互式） AS_INSTALL_VAR_DIR=/var/opt/SUNWappserver7DOMAINS_DIR=/var/opt/SUNWappserver7/domainsINST_ASADMIN_USERNAME=adminINST_ASADMIN_PASSWORD=passwordINST_ASADMIN_PORT=4848INST_ASWEB_PORT=80AS_INSTALL_DEFAULT_STUDIO_DIR=/AS_INSTALL_STUDIO_DIR=/INSTALL_STATUS=SUCCESS[STATE_DONESunONEApplicationServer808daad84da2817ce79da504cae4c78ffb57d50e] 以静音模式安装 要以静音模式安装SunONEApplicationServer软件，请执行以下步骤：
1.使用文本编辑器检查当前的安装配置文件（称为statefile），并验证此文件 是否包含要用于静音安装的信息。
您可以将此文件以任意名称保存。
例如：cpstatefilesilent_config2.将SunONEApplicationServer安装文件复制到要安装SunONEApplicationServer软件的每台计算机上。

3.将静音模式配置文件复制到要安装SunONEApplicationServer软件的每台计算机上。

4.如果您当前不是在复制了安装文件和静音模式配置文件的目录下，请浏览到该目录。

5.以超级用户身份，使用以下命令格式在命令行启动静音安装：./setup-silentconfig_file_name安装程序将读取指定的config_file_name，检查是否有足够的空间，然后基于config_file_name中的数据安装产品。
当屏幕返回到提示符时，表明静音安装已完成。
第3章用于开发的安装63 在静音模式下安装（非交互式）
6.设置PATH环境变量。
您需要将环境配置为包括SunONEApplicationServer的bin目录。
有关此操作的说明，请参见第83页上的“设置PATH环境变量”。

7.启动SunONEApplicationServer软件。
SunONEApplicationServer在安装过程中不会自动启动。
请按照第87页上的“启动和停止服务器”中的说明启动服务器。
管理控制台启动后，将显示SunONEApplicationServer图形界面的初始页面。
64SunONEApplicationServer安装指南•2003年4月 第4章 完成Solaris9捆绑安装 Sun™OpenNetEnvironment(SunONE)ApplicationServer7有两种Solaris9安装版本：捆绑版和非捆绑版。
如果您收到的SunONEApplicationServer是作为Solaris9安装的一部分，则您拥有的是Solaris捆绑版本。
如果您获得的是单独的SunONEApplicationServer，则它是非捆绑版。
注意 如果使用SunONEApplicationServer的非捆绑Solaris版本，或者使用MicrosoftWindows版本，则无需执行本模块中的任务，因为域、管理服务器和服务器实例将自动创建。
本模块介绍如何完成Solaris9捆绑安装。
本文包括以下主题：•关于Solaris9安装•创建管理域•启动管理服务器•创建应用程序服务器实例 65 关于Solaris9安装 关于Solaris9安装 作为Solaris9安装的一部分安装的SunONEApplicationServer软件只包含必需的库、可执行文件以及支持SunONEApplicationServer所需的其它文件。
安装过程中不会生成应用程序服务器配置。
要创建初始配置，必须使用asadmin命令行界面及create-domain子命令来创建SunONEApplicationServer管理域。
您需要创建管理服务器配置和应用程序服务器实例配置。
创建管理域 创建管理域也就是创建管理服务器。
管理服务器是SunONEApplicationServer的特殊实例，它提供了管理界面，并为命令行界面提供了管理工具。
创建新域时，要指定以下内容：•管理服务器的端口号—安装非捆绑版时的默认端口号为4848。
•管理用户名和密码—访问管理服务器（无论是访问管理界面还是运行命令行界 面）时需要提供密码。
•域位置—与域的管理服务器关联的端口号。
默认情况下，create-domain子命令在/var/appserver/domains/下创建新的管理域配置。
如果您登录时的用户身份不具有对此区域的写权限，则在创建管理域时必须指定一个适当位置。
请使用create-domain子命令的--path选项指定创建域配置的位置。
要创建管理域，请执行以下步骤：
1.验证路径中是否包括/usr/sbin目录。
如果尚未添加此目录，请参见第83页上 的“设置PATH环境变量”中的说明。
66SunONEApplicationServer安装指南•2003年4月 启动管理服务器
2.在命令行上，运行以下命令以创建名为domain1的新管理域： 注意 要创建域，非超级用户必须属于asadmin组。
asadmincreate-domain--path--adminport4848--adminuseradmin--adminpasswordpassworddomain1 其中domain_config_dir指定了创建管理域配置的位置。
--adminport、--adminuser和--adminpassword选项指定了为域定义的新管理服务器的初始设置。
如果名称domain1已被使用，请使用其它域名再次运行create-domain子命令。
域名中可以使用句号和其它字符。
可以使用登录用户名作为限定词，以确保使用的域名是唯一的。
例如：ckamps.domain1。
屏幕上应显示以下消息： 域domain1创建成功
3.运行list-domains子命令以查看为SunONEApplicationServer安装配置的所有域的列表： asadminlist-domainsdomain1[domain1] 其中domain_config_dir的值表示新创建的管理域的默认位置或由create-domain子命令的--path选项指定的值。
有关在Solaris9安装完成后如何准备SunONEApplicationServer环境的信息，请参见《SunONEApplicationServer管理员指南》中的“快速入门”模块。
启动管理服务器 要使用图形管理界面或在命令行界面中使用诸多命令，必须运行管理服务器。
请按照第87页上的“启动和停止服务器”中的说明启动SunONEApplicationServer。
第4章完成Solaris9捆绑安装67 创建应用程序服务器实例 创建应用程序服务器实例 创建域并启动管理服务器后，需要创建应用程序服务器实例。
每个应用程序服务器实例都具有自己的J2EE配置、J2EE资源、应用程序部属区和服务器配置设置，（在非捆绑版中，安装时自动创建的服务器实例名为server1。
您在文档的样例中会经常看到server1。
） 可以通过管理界面或通过命令行界面创建应用程序服务器实例。
服务器实例是在域的文件夹中创建的。
注意 如果您在自己的管理域下创建一个应用程序服务器实例，则您的用户 ID无需属于具有对域配置文件的写权限的UNIX组。
创建应用程序服务器实例的步骤：
1.验证管理服务器正在运行。

2.运行create-instance子命令： asadmincreate-instance--domaindomain1--instanceport80server1 其中domain1是创建域时指定的域名，80是应用程序服务器实例的HTTP服务器端口号，server1是实例名。
请根据您的特定环境为这些选项指定适当的值。
注意 由于非超级用户无法访问端口号小于1024的服务器，因此如果您以非 超级用户身份登录，则需要指定一个大于1024的端口号。
如果系统上只定义了一个管理域，则创建实例时无需指定目标域名。
有关在Solaris9安装完成后如何设置SunONEApplicationServer环境的详细信息，请参见《SunONEApplicationServer管理员指南》。
68SunONEApplicationServer安装指南•2003年4月 第5章 卸载SunONEApplicationServer软件 本模块介绍如何从系统中卸载Sun™OpenNetEnvironment(SunONE)ApplicationServer7软件。
本文包括以下主题： •卸载的内容•卸载SunONEApplicationServer软件 卸载的内容 当前SunONEApplicationServer安装目录中除Java™2SoftwareDevelopmentKit(J2SE)以外的所有组件将被自动选中并卸载。
您不能选择卸载单个组件。
注意 如果要从系统中删除SunONEApplicationServer，必须使用此处描述的卸载例行程序。
如果尝试其它方法，在试图重新安装同一版本或 安装新版本时将出现问题。
69 卸载SunONEApplicationServer软件 卸载SunONEApplicationServer软件 卸载程序检测任何正在运行的SunONEApplicationServer进程并停止这些进程，然后开始卸载。
注意 如果J2SE的安装目录不是/usr/j2se，则必须使用以下命令：./uninstall-javahomevalid_j2se_directory其中valid_j2se_directory是J2SE1.4.1_01的安装路径。
要卸载SunONEApplicationServer软件，请执行以下步骤：
1.浏览到计算机上的SunONEApplicationServer7安装目录。

2.如下所述调用卸载程序： ❍在UNIX上，在命令提示符下键入以下命令之一：•要使用图形界面：./uninstall•要使用命令行界面：./uninstall-console ❍在MicrosoftWindows上：
I.浏览到“控制面板”。
II.选择“添加/删除程序”。
III.从已安装程序列表中选择“SunONEApplicationServer”。
IV.单击“删除”。
将显示卸载程序的“e”页面，如下所示。
70SunONEApplicationServer安装指南•2003年4月 卸载SunONEApplicationServer软件
3.阅读“e”页面，然后单击“Next”（或在命令行上按Enter键）继续。
将显示“ReadytoUninstall”页面，其中显示了要卸载的SunONEApplicationServer组件列表。
第5章卸载SunONEApplicationServer软件71 卸载SunONEApplicationServer软件
4.单击“UninstallNow”（或在命令行上按Enter键）启动卸载进程。
将显示卸载进度指示条。
卸载完成后，将显示下面的“UninstallSummary”屏幕。
72SunONEApplicationServer安装指南•2003年4月 卸载SunONEApplicationServer软件
5.单击“Details”可以查看详细信息。
详细信息列表（类似下面所示）显示了日志文件的开头部分。
有关卸载的完整信息可以在详细信息列表末尾指定的日志文件中找到。
第5章卸载SunONEApplicationServer软件73 卸载SunONEApplicationServer软件
6.单击“Close”（或在命令行上按Enter键）退出卸载程序。

7.查看SunONEApplicationServer组件是否已从系统中删除，以验证卸载是否 成功。
74SunONEApplicationServer安装指南•2003年4月 第6章 升级SunONEApplicationServer软件 本模块介绍如何升级Sun™OpenNetEnvironment(SunONE)ApplicationServer7软件的现有安装。
本文包括以下主题：•准备升级•升级程序如何工作•升级SunONEApplicationServer•疑难解答 准备升级 SunONEApplicationServer升级程序使您可以升级SunONEApplicationServer7的现有安装，而无需重新安装全部产品。
升级功能适用于基于软件包的安装以及tar或zip安装，具体情况取决于操作系统的特定机制。
本节包括以下主题：•升级组件•要求和限制 75 准备升级 升级组件 SunONEApplicationServer7Update1升级组件是作为一个压缩的归档文件提供的，其中包含setup文件、README文件、供升级程序使用的配置文件、日志文件以及要升级的SunONEApplicationServer软件包。
要求和限制 •访问特权❍对于基于软件包的UNIX安装，您必须是超级用户。
❍对于非基于软件包的UNIX安装，您必须可以访问安装目录。
❍对于Windows，您必须具有管理员特权。
•管理服务器和实例—管理服务器和应用程序服务器实例在升级进行期间无法运行。
如果它们正在运行，将被升级程序停止。
•升级位置—在上一次安装中如果未安装默认位置，则需要编辑config_01文件以指定正确位置。
•配置文件—升级过程中不能修改SunONEApplicationServer配置文件。
否则，当配置文件复制回其安装位置时，这些修改将被覆盖。
•解压缩公用程序，并且pkgadd必须存在于PATH环境变量中。
•系统上必须安装有Perl（最低5.0.0）。
•JDK和SunONEMessageQueue—升级程序不会升级任何现有Java™开发者工 具(JDK)或SunONEMessageQueue软件。
这些软件被认为是共享资源，因此应由客户自己根据需要升级这些软件。
•NSS/NSPR软件包—要进行升级，现有的SunONEApplicationServer中必须存在NetscapeSecurityServices(NSS)和NetscapePortableRuntime(NSPR)软件包。
如果NSS/NSPR软件包不存在，则不应继续升级。
因为这表明SunONEApplicationServer要么未安装，要么已经毁坏。
无论是哪种情况，您都必须完整地安装SunONEApplicationServer软件。
•当升级进程运行时，请勿修改以下文件： ❍.audit_upgrade ❍package-list ❍conf_01 76SunONEApplicationServer安装指南•2003年4月 升级程序如何工作 •中断升级—如果需要中断升级，可以执行此操作，然后从中断位置重新启动升级。
但是，在完成升级之前，所升级的服务器实例将处于一种不一致的状态。
因此，您应当完成已启动的升级，这一点很重要。
•JDK和SunONEMessageQueue—升级程序不升级任何现有的JavaDevelopersKit(JDK)或SunONEMessageQueue软件。
这些软件被认为是共享资源，因此应由客户自己根据需要升级这些软件。
为方便起见，SunONEApplicationServer7Update1下载归档文件的/imq目录下提供了SunONEMessageQueue的最新支持版本。
有关说明包含在该目录下的README中。
升级程序如何工作 升级程序是一个Perl脚本，它使用一个输入文件和一个软件包列表文件来确定升级的参数。
对于基于软件包的安装，package-list文件中包含了一个需要升级的软件包列表。
本节包括以下主题：•升级输入文件•升级进程 升级输入文件 config_01文件包含升级程序升级SunONEApplicationServer软件所需的位置。
config_01文件中的条目指定了以下位置：•ASINSTDIR—SunONEApplicationServer安装目录。
这是SunONEApplication Server二进制文件所在的位置。
•ASCONFDIR—SunONEApplicationServer配置文件目录。
这是domains.bin、 ppserv.lic和asenv.conf文件所在的位置。
•ASDOMAINSDIR—SunONEApplicationServer域目录。
这是文件夹域所在的位置。
•ASLOCALE—SunONEApplicationServer语言环境。
如果不确定此位置，请检查 ASCONFDIR/asenv.conf文件中的AS_LOCALE。
•ASJAVADIR—SunONEApplicationServer使用的JDK目录的位置。
如果在初始安装过程中选择了默认安装位置，输入文件中的位置将是正确的，并且不需要编辑该文件。
如果未接受默认安装位置，则需要编辑输入文件。
第6章升级SunONEApplicationServer软件77 升级程序如何工作 默认输入文件示例 config_01BASEDIR=/optASINSTDIR=/opt/SUNWappserver7ASCONFDIR=/etc/opt/SUNWappserver7ASDOMAINSDIR=/var/opt/SUNWappserver7ASLOCALE=en_USASJAVADIR=/usr/j2sepackage-listSUNWasacmoSUNWasroSUNWasacoSUNWjaxpSUNWxrpcrtSUNWaso.version7.0.0_01 升级进程 升级进程分为三个阶段：备份、安装和重新配置。
系统提供了日志文件，用于在这三个阶段中监视升级进程并提供疑难解答。
本节包括以下主题：•备份阶段•安装阶段•重新配置阶段•日志文件 备份阶段 升级进程开始时，升级程序将SunONEApplicationServer配置文件复制到一个单独位置，以使其不会受到升级进程的影响。
在升级结束时的重新配置阶段，这些文件将被复制回它们原来的位置。
备份目录位于在其中解压缩和展开升级文件的目录下。
78SunONEApplicationServer安装指南•2003年4月 升级程序如何工作 安装阶段 在安装阶段，升级程序将验证具有足够的磁盘空间用于相关软件包的升级，然后在系统上安装升级组件。
如果安装阶段失败，则调用升级脚本时将在最后一个完全安装的软件包之后重新启动安装。
升级程序将查看审计文件以确定升级进程的中断位置，然后在适当位置处重新启动。
例如，如果五个软件包中有三个已经安装，但在安装第四个软件包时发生错误，则重新启动操作将重新开始安装第四个软件包。
重新配置阶段 在重新配置阶段，原来的SunONEApplicationServer配置文件将被复制回安装位置。
您可以决定是否在升级期间禁止他人修改SunONEApplicationServer配置文件；升级程序本身没有提供这种机制。
日志文件 升级程序的事件、错误和状态被记录到以下文件中：•升级日志文件•审计文件 升级日志文件 在活动的升级进程中，升级事件和错误被捕获到upgrade.log文件中。
对于常见错误，此文件包含了最可能需要执行的操作，以便于您参考。
审计文件 审计文件.audit_upgrade用于维护升级的状态。
如果发生故障并重新启动升级进程，则可能需要使用此文件。
使用审计文件，可以通过在最后一个完全安装的组件之后重新启动升级来恢复升级进程。
审计文件位于在其中解压缩和展开升级文件的目录下。
注意 不能编辑.audit_upgrade文件。
否则，任何重新启动都将失败。
第6章升级SunONEApplicationServer软件79 升级SunONEApplicationServer 升级SunONEApplicationServer SunONEApplicationServer升级文件可在以下位置获得：/software/download/app_servers.html 在下载站点，您将看到一些可用归档文件。
例如，SunONEApplicationServer7Update1归档文件的版本是7.0.0_01。
请执行以下步骤升级SunONEApplicationServer软件：
1.确保您已查看了第76页上的“要求和限制”中介绍的信息。

2.验证NetscapeSecurityServices(NSS)和NetscapePortableRuntime(NSPR) 软件包是否存在。
有关这些软件包的信息和说明，请参见第27页上的“所需的Solaris修补程序”。

3.将压缩的升级版本归档文件下载到目标计算机上（XX表示版本）。
❍对于Solaris—sun-appserver7-upgrade01-sol-sparc.tar.gz❍对于MicrosoftWindows—sun-appserver7-upgrade01-win.zip4.解压缩并展开升级版本归档文件。
您将看到以下升级组件：❍setup❍README.txt❍config_01❍package-list❍.version❍SUNWaso、SUNWascmno、SUNWasro、SUNWjaxp、SUNWasaco、SUNWxrpcrt5.如果在安装过程中未接受默认安装位置，请编辑config_01输入文件，使其包含以下条目。
如果接受了默认位置，可以跳过此步骤。
也就是说，此文件必须反映您的实际位置。
ASINSTDIR=/opt/SUNWappserver7ASCONFDIR=/etc/opt/SUNWappserver7ASDOMAINSDIR=/var/opt/SUNappserver7ASLOCALE=en_USASJAVADIR=/usr/j2se 80SunONEApplicationServer安装指南•2003年4月 疑难解答
6.如下所示调用升级脚本：./setupa.升级程序将验证当前安装的SunONEApplicationServer的配置文件（版本号、是否基于软件包）。
如果此配置文件对于所选升级不是正确的配置文件，将显示一条错误消息。
•请解决问题并重新启动升级。
b.升级程序将确定是否有足够的可用空间进行升级。
如果空间不足，将显示一条错误消息。
•请解决问题并重新启动升级。
c.升级程序将检测任何正在运行的SunONEApplicationServer进程，并在继续升级之前停止这些进程。

7.升级程序将针对您所选择的升级类型提出相应的问题。
请根据您的站点情况对提示进行响应。

8.升级组件将安装到您在升级输入文件中指定的位置。

9.升级完成后，启动管理服务器和应用程序服务器实例。
有关说明，请参见第87 页上的“启动和停止服务器”。
10.通过运行asadminversion命令，验证升级是否成功。
您应当看到新的Sun ONEApplicationServer升级版本。
疑难解答 本节介绍升级过程中可能遇到的问题，并提供了一些建议的解决方案。
•重新启动或中断升级•错误情况 重新启动或中断升级 •重新启动和升级—因为任何原因要重新启动升级进程时，先删除setup脚本所在目录下的.audit_upgrade文件，然后重新启动升级。
•中断升级—如果需要中断升级，可以执行此操作，然后从中断位置重新启动升级。
但是，在完成升级之前，所升级的服务器实例将处于一种不一致的状态。
因此，您应当完成已启动的升级，这一点很重要。
第6章升级SunONEApplicationServer软件81 疑难解答 错误情况 •如果是特定于系统的错误—例如，如果基于软件包的安装总是失败，请检查软件包安装日志。
•如果是特定于为备份指定的位置的错误—请检查您对指定目录的访问权限。
•如果是特定于用户ID的错误（在Tarball安装情况下）—请检查您对安装目录和备份目录的权限。
•如果在备份阶段发生错误—可以重新启动升级脚本。
此阶段最可能发生的错误与空间限制有关。
解决所有问题后，可以在中断的位置重新启动升级程序。
•如果在重新配置阶段发生错误，则问题通常是由系统崩溃或其它中断所致。
解决所有问题后，可以在中断的位置重新启动升级程序。
82SunONEApplicationServer安装指南•2003年4月 第7章 安装后的任务 本模块介绍Sun™OpenNetEnvironment(SunONE)ApplicationServer7软件安装过程中或安装后可能要执行的某些任务。
本文包括以下主题：•设置PATH环境变量•查看手册页•启动和停止服务器•实现Web服务器插件•实现Web服务客户机•决定SunONEStudio插件的安装位置•访问样例应用程序 设置PATH环境变量 安装SunONEApplicationServer软件后，如果打算执行以下任意操作，需要将环境配置为包括SunONEApplicationServer的bin目录：•运行asadmin命令•运行命令行公用程序•访问asant公用程序，以便使用样例应用程序。
83 设置PATH环境变量 本节介绍如何将install_dir/bin目录添加到PATH环境变量中。
如果您熟悉环境变量的设置过程，现在便可以在自己的环境中执行此操作。
否则，请参见以下小节之一： •在UNIX上设置PATH变量 •设置MicrosoftWindows环境 在UNIX上设置PATH变量 在UNIX系统上，建议您将SunONEApplicationServer的install_dir/bin目录添加到登录配置文件中，以便在登录时将其自动添加到环境的PATH设置中。

1.将PATH变量设置为包括install_dir/bin目录。

2.通过运行如下所示的asadmin命令，验证可以找到asadmin命令： asadmin屏幕上应显示以下内容：使用“exit”退出；使用“help”获得联机帮助 asadmin>_ 注意 asadmin命令将启动SunONEApplicationServer的命令行界面。
通过运行不带参数的asadmin命令，可以进入命令行界面的交互模式。
在asadmin命令提示符下键入help可以查看命令行界面支持的子命令的完整列表。
如果未找到该命令，请检查PATH设置、刷新环境设置并再次运行asadmin。
设置MicrosoftWindows环境 本节介绍设置MicrosoftWindows环境的步骤：•设置MicrosoftWindowsPATH变量•设置命令 84SunONEApplicationServer安装指南•2003年4月 设置PATH环境变量 设置MicrosoftWindowsPATH变量 在MicrosoftWindows上，建议使用MicrosoftWindows控制面板，按如下所述修改系统PATH环境变量：
1.单击MicrosoftWindows“开始”按钮，选择“设置”，然后选择“控制面板”。

2.在“控制面板”中，双击“系统”。

3.单击“高级”选项卡，然后选择“环境变量”。
“环境变量”对话框列出了适用于您当前用户帐户以及整个系统的环境变量。

4.选择现有PATH条目并单击“编辑”，或单击“新建”创建新的PATH环境 变量。

5.将install_dir/bin值添加到PATH值的开头。
例如，将C:\Sun\AppServer7\bin;添加到变量值的前面。

6.单击“确定”关闭“编辑用户变量”对话框。
PATH变量应反映出您刚刚输入的目录路径。

7.单击“确定”应用更改并关闭“环境变量”窗口。

8.单击“确定”关闭“系统特性”窗口。

9.按如下所述验证asadmin是否可用： a.单击MicrosoftWindows“开始”按钮，然后选择“运行”。
b.在“打开”字段中，输入cmd并单击“确定”。
c.当显示命令窗口时，在命令提示符下键入asadmin。
应显示以下内容： C:\>asadmin使用“exit”退出；使用“help”获得联机帮助asadmin> 注意 asadmin命令将启动SunONEApplicationServer的命令行界面。
通过运行不带参数的asadmin命令，可以进入命令行界面的交互模式。
在asadmin命令提示符下键入help可以查看命令行界面支持的子命令的完整列表。
第7章安装后的任务85 查看手册页 d.如果PATH变量设置有误，将显示以下内容： 未将'asadmin'识别为内部或外部命令、可操作程序或批处理文件。
在这种情况下，请返回到“控制面板”，修复PATH设置，然后从一个新命令窗口中再次运行asadmin命令。
只有新命令窗口才能使环境变量更改生效。
10.键入exit退出命令行界面。
设置命令 在某些Windows2000系统上，Microsoft命令不会通过系统PATH环境变量自动提供给环境。
此MicrosoftWindows公用程序用于启动和停止SunONEApplicationServer软件。
要确定是否可以在环境中使用命令，请执行以下步骤：
1.单击MicrosoftWindows“开始”按钮，然后选择“运行....”以启动命令控制台窗口。

2.在“打开”字段中，键入cmd并单击“确定”。

3.控制台启动后，在命令提示符下键入。

4.如果未找到命令，请修改系统PATH环境变量，使其包括Windows_install_root\system32目录。
例如： C:\WINNT\system32; 查看手册页 在使用SunONEApplicationServer产品的同时，在命令行查看手册页的步骤：
1.对于Solaris非捆绑的版本—将install_dir/man添加到MANPATH环境变量中。

2.通过在命令行键入mand_name，访问SunONEApplicationServer命令 的手册页。
例如： manasadmin 86SunONEApplicationServer安装指南•2003年4月 启动和停止服务器 启动和停止服务器 由于SunONEApplicationServer不会在安装过程中自动启动，因此在您部署和练习样例应用程序之前，需要启动应用程序服务器环境，并验证环境是否正常运行。
要在UNIX或MicrosoftWindows计算机上启动SunONEApplicationServer，可以使用以下任一方法：•使用命令行界面•使用管理界面此外，在MicrosoftWindows上，您还可以使用以下工具：•使用MicrosoftWindows程序组•使用MicrosoftWindows服务 使用命令行界面 您需要将环境配置为包括SunONEApplicationServer的bin目录，然后才能运行命令行公用程序。
有关此操作的说明，请参见第83页上的“设置PATH环境变量”。
您可以使用asadmin命令行界面启动和停止：•整个应用程序服务器•特定管理域•单个应用程序服务器实例 第7章安装后的任务87 启动和停止服务器 下表列出了与启动和停止操作相关的asadmin的子命令。
asadimin的启动/停止子命令 子命令 说明 start-appserv 启动整个SunONEApplicationServer。
-appserv 停止SunONEApplicationServer。
start-domain 启动指定管理域的管理服务器和应用程序服务器实例。
Solaris9捆绑版用户：使用此命令之前，必须创建一个域。
请参见第85页上的“设置MicrosoftWindowsPATH变量”。
-domain 停止指定管理域的管理服务器和应用程序服务器实例。
start-instance 启动指定的应用程序服务器实例。
可以在本地或远程模式下运行。
在本地模式下，运行此子命令不需要运行管理服务器。
-instance 停止指定的应用程序服务器实例。
与start-instance的操作类似。
使用start-domain和-domain 如果SunONEApplicationServer正在运行，可以使用以下命令停止管理服务器和最初配置的域的应用程序服务器实例： asadmin-domain--domaindomain1--local 其中，domain1是在SunONEApplicationServer安装过程中定义的管理域的默认名称。
命令完成时，您应当看到以下结果： asadmin-domain--domaindomain1--local实例domain1:server1已停止域domain1已停止。
同样，您可以通过运行以下命令启动最初配置的管理域： asadminstart-domain--domaindomain1 命令完成时，您应当看到以下结果： asadminstart-domain--domaindomain1实例domain1:admin-server已启动实例domain1:server1已启动Domaindomain1Started. 88SunONEApplicationServer安装指南•2003年4月 启动和停止服务器 使用start-instance和-instance 要在不运行管理服务器的情况下启动某个特定应用程序服务器实例，可以使用以下命令： asadmin-instance--localserver1其中，server1是应用程序服务器实例的默认名称。
如果您的环境包含多个管理域，需要在调用-instance命令时指定管理域名称。
例如： asadmin-instance--local--domaindomain1server1要在本地模式下启动某个特定应用程序服务器实例，可以使用以下命令： asadminstart-instance--localserver1如果要在远程系统上启动或停止一个实例，可以在start-instance和-instance命令中指定目标管理服务器以及管理用户名和密码。
获得帮助信息 如果不带有参数运行以下任一子命令，将显示用法信息。
例如：asadminstart-instance接收的操作数数量无效命令“start-instance”未成功执行用法:start-instance[--useradmin_user][--passwordadmin_password][--hostlocalhost][--port4848][--local=false][--domaindomain_name][--debug=false][--secure|-s]instancename 您也可以发出后跟--help选项的子命令以获得完整的用法信息。
使用管理界面 当管理服务器运行时，您可以使用基于Web的管理界面来启动和停止应用程序服务器实例。

1.启动管理界面（也称为管理控制台）。
❍在UNIX上—打开一个浏览器窗口，并指定管理服务器控制台应用程序的位置。
在安装过程中，管理服务器的默认端口号被设置为4848。
如果此端口已被使用，或者您选择了其它端口号，请指定该端口号。
例如：http://localhost:4848 第7章安装后的任务89 启动和停止服务器 ❍在MicrosoftWindows上—启动基于Web的管理界面的最简单方法是单击MicrosoftWindows“开始”按钮，然后依次选择“程序”>“SunMicrosystems”>“SunONEApplicationServer7”>“启动管理控制台”。
选择“启动管理控制台”后，将启动默认浏览器的窗口，并在适当位置处（在安装过程中为管理服务器控制台设置的）显示了该控制台。

2.使用在安装过程中指定的管理用户名和密码登录到管理界面。
成功进行验证后，将显示如下所示的管理界面初始屏幕：
3.选择server1节点以访问启动和停止功能。
应用程序服务器实例处于“Running”或“NotRunning”状态。

4.根据服务器实例的状态，单击“Start”或“”以启动或停止应用程序服务器实例。
使用MicrosoftWindows程序组 在MicrosoftWindows上，启动整个应用程序服务器的最简单方法是访问MicrosoftWindows程序组。

1.单击MicrosoftWindows“开始”按钮，然后依次选择“程序”>“Sun Microsystems”>“SunONEApplicationServer7”>“启动ApplicationServer”。

2.要完全停止应用程序服务器，请访问MicrosoftWindows程序组中的“SunONEApplicationServer”菜单项。
此操作将停止管理服务器和配置的应用程序服务器实例。
90SunONEApplicationServer安装指南•2003年4月 启动和停止服务器 使用MicrosoftWindows服务 安装SunONEApplicationServer后，将定义多个MicrosoftWindows服务，以控制管理服务器和最初定义的应用程序服务器实例(server1)的启动和关闭。
本节介绍如何使用这些服务来控制应用程序服务器进程。

1.单击MicrosoftWindows“开始”按钮，选择“设置”，然后选择“控制面板”。

2.显示“控制面板”后，双击“管理工具”。

3.显示“管理工具”后，双击“服务”以查看系统中安装的服务。

4.向下滚动以查看SunApplicationServer条目，如下面的屏幕捕获所示。
管理服务器和最初配置的应用程序服务器实例(server1)分别有各自的MicrosoftWindows服务。
管理服务器和应用程序服务器实例运行时，每个服务条目的“Status”列应显示“Started”。

5.如果管理服务器和应用程序服务器实例已停止，可以使用MicrosoftWindows服务重新启动它们。
也就是说，在某个服务上单击鼠标右键并使用“Start”命令，而不是“”命令。
第7章安装后的任务91 实现Web服务器插件 实现Web服务器插件 Web服务器插件是一个HTTP反向代理插件，可用来指示SunONEWebServer或SunONEApplicationServer将某些HTTP请求转发到另一台服务器。
必须手动安装和配置Web服务器插件。
有关说明，请参见《SunONEApplicationServer管理员指南》中的“配置Web服务器插件”模块。
实现Web服务客户机 要安装和配置Web服务客户机，请参见《SunONEApplicationServerDeveloper'sGuidetoClients》。
决定 SunONEStudio插件的安装位置 如果系统上已经安装了SunONEStudio，可以在SunONEApplicationServer安装过程中，在组件选择屏幕上选择“SupportforSunONEStudio”。
随后输入SunONEStudio4安装目录时，安装程序将检查该目录，以确保存在适当的SunONEStudio文件。
可以将SunONEStudio4插件安装在Studio用户目录或Studio安装目录下。
如果将插件安装在用户目录下，则删除用户目录将卸载插件模块。
要决定SunONEStudio4插件的安装位置，您需要了解以下安装方案。
•方案1—SunONEApplicationServer安装程序将插件安装在Studio安装目录下。
删除Studio用户目录不会影响插件模块。
注意 只能使用SunONEApplicationServer安装程序安装一次SunONE Studio4插件。
安装之后，此选项将被禁用。
•方案2—指导SunONEApplicationServer安装程序将插件安装在SunONEStudio4用户目录下。
删除Studio用户目录将删除插件模块。
•方案3—使用SunONEStudio4更新中心安装插件，这会将插件安装在Studio用户目录下。
删除Studio用户目录将删除插件模块。
有关安装后的配置信息，请参见位于以下位置的SunONEStudio4,EnterpriseEditionforJavawithApplicationServer7Tutorial： /db/prod/s1.studio4update1#hic 92SunONEApplicationServer安装指南•2003年4月 访问样例应用程序 访问样例应用程序 验证安装已成功完成后，可以通过运行样例应用程序来尝试SunONEApplicationServer的功能。
有关详细信息，请参见install_dir/samples/index.html。
第7章安装后的任务93 访问样例应用程序94SunONEApplicationServer安装指南•2003年4月 第8章 疑难解答 本模块介绍如何解决Sun™OpenNetEnvironment(SunONE)ApplicationServer7软件安装过程中可能遇到的常见问题。
本文包括以下主题：•关于日志•忘记了用户名或密码•忘记了管理服务器的端口号•管理界面连接被拒绝•服务器无法启动：出现CGI错误•卸载失败后的清除工作•对于MicrosoftWindows—SNMP子代理安装失败•对于MicrosoftWindows—具有启动消息的命令窗口不出现。
关于日志 以下SunONEApplicationServer日志可用于解决安装时遇到的问题：•SunONEApplicationServer日志文件—您将发现此文件的内容对于解决服务 器配置和部署的问题很有用。
•HTTP服务器访问日志—您将发现此文件的内容对于解决HTTP服务器的问题 和跟踪HTTP请求输入应用程序服务器实例的活动都很有用。
95 忘记了用户名或密码 忘记了用户名或密码 如果忘记了安装时提供的管理用户名，请按以下顺序尝试各个解决方案：
1.输入用户名admin。
这是安装过程中在服务器配置对话框中指定的默认用户名。

2.如果此方法不能解决问题，请查看以下文件： domain_config_dir/domain1/admin-server/config/admpw此文件包含管理员的用户名，后跟加密形式的管理用户的密码。
查看用户名可能会帮助您想起密码。

3.如果此方法不能解决问题，请删除管理域，然后使用新密码重新创建一个管理域。

4.最后一种方法：卸载并重新安装SunONEApplicationServer。
忘记了管理服务器的端口号 如果忘记了管理服务器的HTTP服务器端口号，可以查看管理服务器的配置文件以确定HTTP服务器端口号：
1.浏览到domain_config_dir/domain1/admin-server/config/，然后在文本编辑器 中打开server.xml文件。

2.找到以下元素： http-listenerid="http-listener-1"address="0.0.0.0"port="4848"...在本例中，端口4848是正在使用的HTTP端口号。
管理界面连接被拒绝 如果试图调用图形管理界面时连接被拒绝，可能是由于管理服务器没有运行。
使用管理服务器日志文件可以帮助确定管理服务器未运行的原因。
要启动管理服务器，请使用第87页上的“启动和停止服务器”中的命令行说明。
96SunONEApplicationServer安装指南•2003年4月 服务器无法启动：出现CGI错误 服务器无法启动：出现CGI错误 如果SunONEApplicationServer无法启动，可能会收到以下错误消息：[05/Aug/2002:01:12:12]SEVERE(21770):cgi_initreports:HTTP4047:无法初始化CGI子系统(Cgistubpath/export/home/sun/appserver7/appserv/lib/Cgistub),errfork()failure[没有足够的空间] 系统可能需要额外的资源。
以下各节介绍了可能的解决方案：•为文件说明设置限制•更改内核参数 为文件说明设置限制 可以使用ulimit命令确定可用文件描述符的数目，或者为系统的可用文件描述符设置限制。
ulimit命令显示当前shell及其后续shell的限制。
对于shshell，ulimit-a命令列出了所有当前资源限制。
ulimit-n命令列出了最大文件描述符数目加上1后的值。
更改内核参数 在Solaris上，可以通过修改/etc/system文件使其包含以下条目来增加系统资源：setrlim_fd_max=4086setrlim_fd_cur=1024 要使新内核参数生效，需要重新引导系统。
设置shell资源后，SunONEApplicationServer将启动。
第8章疑难解答97 卸载失败后的清除工作 卸载失败后的清除工作 如果卸载失败，可能需要清除某些残余文件或进程，然后才能尝试新的安装。
在UNIX上 如果卸载失败，可能需要清除某些残余文件或进程，然后才能尝试新的安装。

1.以超级用户身份登录。

2.浏览到安装目录，然后查看/var/sadm/install/productregistry文件（即 带有SUNW字符串的文件）的内容以检查已安装的软件包。
例如：cat/var/sadm/install/productregistry|grepSUNW3.为在产品注册表文件中找到的SUNW软件包运行pkgrm。
例如：pkgrmSUNWasaco4.删除以下文件（如果存在）：/tmp/setupSDKNative/tmp/SolarisNativeToolkit_3.0_15.删除软件包后，从产品注册表文件中手动删除SunONEApplicationServer的特定条目。
rm/var/sadm/install/productregistry6.在命令行上，键入以下命令，删除所有可能正在运行的appservd进程：ps-ef|grepappservd7.删除SunONEApplicationServer安装目录下的所有剩余文件。
98SunONEApplicationServer安装指南•2003年4月 卸载失败后的清除工作 在MicrosoftWindows上
1.在MicrosoftWindows任务管理器中，终止WindowsNativeToolkit进程并删除相应文件。

2.使用wincleanup公用程序删除appserv70-admin、server1以及任何其它相关服务。
注意 如果您的MicrosoftWindows计算机上未安装wincleanup公用程序，则需要下载它。
有关详细信息，请参见SunONE知识库： /pub-cgi/show.pl?
target=home 使用以下语法运行wincleanup： wincleanupservice_name 其中service_name是显示在MicrosoftWindows“控制面板”中的“服务”屏幕上的实例服务器的名称（显示在括号中）。
例如，“服务”屏幕可能会在“名称”下显示以下内容： SunONEApplicationServer7(server1) 在本例中，服务名是server1。
对于管理服务器，使用admin-server作为服务名。
如果未提供服务名，所有与SunONEApplicationServer产品关联的服务都将被删除。

3.单击MicrosoftWindows“开始”按钮并选择“运行”，在文本框中键入regedit以打开MicrosoftWindows注册表编辑器。

4.删除以下注册表文件夹及其内容： HKEY_LOCAL_MACHINE\SOFTWARE\SunMicrosystems\ApplicationServer
5.退出注册表编辑器。

6.在MicrosoftWindows资源管理器中，删除产品注册表文件(system_drive\WinNT\system32\productregistry)，或仅删除其中的appserver条目。

7.在MicrosoftWindows资源管理器中，从SunONEApplicationServer安装目录中删除产品文件。

8.重新引导系统。
第8章疑难解答99 对于MicrosoftWindows—SNMP子代理安装失败 对于MicrosoftWindows—SNMP子代理安装失败 在安装SunONEApplicationServer软件之前，必须先安装MicrosoftWindowsSNMP服务。
如果收到SNMP子代理失败的错误消息，则表明您的计算机上不存在MicrosoftWindowsSNMP服务，并且.dll关联文件注册失败。

1.卸载SunONEApplicationServer软件。

2.安装MicrosoftWindowsSNMP服务。

3.重新安装SunONEApplicationServer软件。
除非在安装日志中另有说明，否则余下的产品安装将不受SNMP子代理安装失败的影响。
对于MicrosoftWindows—具有启动消息的命令窗口不出现。
由于某些Windows2000环境未正确包含Microsoft命令，因此请确保您的系统环境可以访问此命令。
有关解决此问题的说明，请参见第86页上的“设置命令”。
100SunONEApplicationServer安装指南•2003年4月 附录
A 许可信息 Sun™OpenNetEnvironment(SunONE)ApplicationServer7针对您安装的产品版本使用了多种不同的许可证。
本文包括以下主题：•关于许可•许可证类型•显示许可证信息•转换许可证 关于许可 当您从SunONEApplicationServer软件的Web站点下载本产品或购买本产品的CD时，产品中将附带一个许可证文件。
您对本产品的权限将受到安装时所接受的许可证的限制，或者受到将许可证转换为其它类型许可证时所获得的许可证的限制。
安装SunONEApplicationServer产品后，您可以在以后将许可证转换为其它版本（此操作不适用于产品的UNIX评估版）。
例如，可以将平台版许可证转换为标准版的开发许可证。
如果系统正在使用产品的某个特定许可证运行，则无需管理任何密钥。
密钥机制是从一种产品转换为另一种产品的一种便捷方式。
您可以按照第104页上的“显示许可证信息”和第105页上的“转换许可证”中的说明管理许可证。
101 许可证类型 许可证类型 以下各节介绍了SunONEApplicationServer的各种可用许可证：•评估许可证•开发许可证•平台版许可证•标准版许可证•许可证汇总 评估许可证 此许可证的有效期为60天。
评估许可证在安装时启动。
到期日期将基于当前日期计算。
在许可证到期前的14天中，每次重新启动服务器时，都会显示一条警告消息。
许可证到期后，服务器将无法重新启动。
在MicrosoftWindows上，可以将评估许可证升级为平台版许可证、开发许可证或标准版许可证。
注意 Solaris评估许可证不能升级为任何其它类型的许可证。
开发许可证 此许可证不会过期。
开发许可证允许您执行与标准版许可证相同的功能，只有一点除外：开发许可证无法将应用程序部署到生产服务器上。
要部署用于生产的应用程序，必须将开发许可证升级为标准版或平台版许可证。
102SunONEApplicationServer安装指南•2003年4月 许可证类型 平台版许可证 此许可证不会过期。
SunONEApplicationServer的平台版具有以下限制：•只接受对管理服务器的本地请求。
•每台管理服务器只允许存在一个服务器实例。
•无法从同时向其它应用程序服务器发送请求的Web服务器插件发送请求。
•不能使用SNMP向远程系统发送警报。
如果尝试向管理服务器执行远程请求或创建其它服务器实例，将显示一条警告消息。
要执行这些任务，必须升级到开发许可证或标准版许可证。
标准版许可证 此许可证不会过期。
标准版许可证随SunONEApplicationServer软件的全功能版本一起安装，对产品的功能没有任何限制。
许可证汇总 下表总结了为SunONEApplicationServer产品提供的各种许可证。
SunONEApplicationServer许可证 类型 时间限制 MicrosoftWindows、Solaris（基于软件包）上的评估版 自安装之日起60天 Solaris上的评估版（非基于软件包） 开发 自安装之日起60天 无限制 是否允许多个实例？ 是 是是 是否允许远程管理？是否可以升级？ 是 在MicrosoftWindows 上可以升级到平台版、 开发版或标准版许可证 在Solaris上不可以 是 否 是 是，可以升级到标准版 许可证或可操作的平台 版许可证。
附录A许可信息103 显示许可证信息 SunONEApplicationServer许可证 类型 时间限制 平台版 无限制 标准版 无限制 是否允许多个实例？ 不可以。
每台管理服务器只能有一个实例。
是 是否允许远程管理？ 不，只有本地用户可以访问管理GUI和CLI。
是 是否可以升级？ 可以升级到开发许可证或标准版许可证。
N/A 显示许可证信息 使用display-license命令可以获取有关许可证的信息。
语法 asadmindisplay-license[--useradmin_user][--passwordadmin_password][--passwordfilepassword_file][--hostlocalhost][--portadmin_port][--local=true/false]此命令可以在本地运行，也可以远程运行，这取决于本地选项的值。
例如，以下命令将在本地计算机上运行，使用默认的主机和端口号： asadmindisplay-license--local 将返回以下信息： •当前安装的许可证类型（例如，评估）•到期日期（如果有）•许可证所允许的每台管理服务器的实例数•是否允许远程管理有关使用asadmin命令的详细信息，请参见《SunONEApplicationServer管理员指南》。
104SunONEApplicationServer安装指南•2003年4月 转换许可证 转换许可证 安装SunONEApplicationServer时，您接受一个自动安装的许可证。
安装后，可以将此许可证转换为其它类型的许可证。
要转换许可证，必须首先从以下位置下载新的许可证密钥： /as7upgrade可以使用asadmin和pkgadd命令在SunONEApplicationServer上转换许可证。
使用哪个命令取决于您的安装类型。
下面将讨论某些许可证使用情况：•对于基于软件包的UNIX安装•对于非基于软件包的UNIX安装•对于MicrosoftWindows安装 对于基于软件包的UNIX安装 基于软件包的UNIX安装可以是非捆绑的，也可以与操作系统捆绑在一起。
使用pkgadd命令在这些安装中安装许可证。
对于非捆绑的基于软件包的Solaris安装
1.从以下位置下载新的许可证密钥：/as7upgrade
2.停止任何正在运行的SunONEApplicationServer软件。

3.使用以下语法安装许可证： pkgadd-dfull_pathSUNWaslco例如： pkgadd-d/install_dir/pkgSUNWaslco4.出现提示时，接受许可证条款。

5.输入新的许可证密钥。

6.重新启动SunONEApplicationServer软件。
附录A许可信息105 转换许可证 对于Solaris9捆绑安装
1.从以下位置下载新的许可证密钥：/as7upgrade
2.停止任何正在运行的SunONEApplicationServer软件。

3.使用以下语法安装许可证： pkgadd-dfull_pathSUNWaslc4.出现提示时，接受许可证条款。

5.输入新的许可证密钥。

6.重新启动SunONEApplicationServer软件。
对于非基于软件包的UNIX安装 使用asadmin命令安装用于非基于软件包的UNIX安装的许可证。

1.从以下位置下载新的许可证密钥： /as7upgrade2.停止任何正在运行的SunONEApplicationServer软件。

3.运行以下命令： asadmininstall-license4.出现提示时，接受许可证条款。

5.输入新的许可证密钥。

6.重新启动SunONEApplicationServer软件。
106SunONEApplicationServer安装指南•2003年4月 对于MicrosoftWindows安装 使用asadmin命令安装用于MicrosoftWindows安装的许可证。

1.从以下位置下载新的许可证密钥： /as7upgrade2.停止任何正在运行的SunONEApplicationServer软件。

3.运行以下命令： asadmininstall-license4.出现提示时，接受许可证条款。

5.输入新的许可证密钥。

6.重新启动SunONEApplicationServer软件。
转换许可证 附录A许可信息107 转换许可证108SunONEApplicationServer安装指南•2003年4月 索引 符号 /etc/opt/SUNWappserver7/config24/opt/SUNWappserver724/var/opt/SUNWappserver7/domains24 英文 ess.log95asadmin命令84，89，104asant83audit_upgrade79bin目录44，60，64，83，84CGI错误97config_01.txt77console选项20create-domain67default_config_dir12DISPLAY环境变量37，50display-license命令104domain_config_dir67du命令26，29gunzip35，49HTTP服务器 port29，40，46，56，61监听器46，61install_config_dir12install_dir11，12 J2SE54第三方19，55 JavaMessagingService(JMS)概述18JMS服务启动失败30list-domains67MANPATH环境变量86MessageQueue代理问题30MicrosoftWindows程序组90MicrosoftWindows服务命令86NetscapePortableRuntime(NSPR)76，80NetscapeSecurityServices(NSS)80NSS/NSPR软件包76，80package-list.txt77patchadd28PATH环境变量84，86 在UNIX上设置84在Windows上设置85pkgadd28pkgrm28PointBase服务器18server.log95SNMP30SNMP子代理失败100Solaris97，12，30，66，88，106Solaris9捆绑安装配置65要求24start-appserv88 109 start-domain88start-instance89-appserv88-domain88-instance89SunONEApplicationServer的版本SunONEMessageQueue29 概述18在Solaris上30SunONEStudio57插件92概述19SunONEStudio插件安装方案92ulimit97uname命令26upgrade.log79URL格式11Web服务客户机92Web服务器插件92wincleanup99 17，103
A 安装22J2SE54SunONEStudio插件92安装后的任务83版本汇总23参数驱动62静音模式62开发版22，47至64目录结构23评估版21，25，33至46远程37组件16 安装方法20 安装根目录11 安装后的任务83至93 110SunONEApplicationServer安装指南•2003年4月
B 版本汇总23标准版许可证103
C 插件SunONEStudio92Web服务器92安装92 超级用户特权21，29重新启动升级79从Web下载35，49
D 第三方J2SE19，55端口29，30，50，57 HTTP服务器29，40，46，56，61管理服务器29，40，56，96默认41无法访问96端口号，忘记96端口要求29
F 封装23服务器，启动和停止 64，87
G 根目录instance12 管理服务器，未启动96管理服务器端口29，40，56管理工具概述17管理界面17，45，61 连接被拒绝96启动/停止89管理客户机18，48管理控制台。
参见管理界面。
管理特权30管理域，创建66
H 环境变量DISPLAY37，50MANPATH86PATH86疑难解答86
J 基于软件包的模型24技术要求28解包35，49静音安装21，62至64静音模式的配置文件62
K 开发版安装22，47至64开发许可证102空间要求26，29
L 路径格式11
M 密码，忘记96命令行界面，使用87命令行界面方法20默认端口号41，57目录12 bin44，60，64，83安装11实例根12
P 平台，支持的26平台版许可证103评估安装33至46评估版安装21，25评估许可证102
Q 启动/停止管理界面89启动服务器64，87启动实例89启动域88 索引111
R 日志安装95升级79
S 升级75至82重新启动79概述77日志文件79要求和限制76疑难解答81中断77，81组件76 升级许可证105实例 创建68根目录12启动和停止89适用于Solaris的软件包28手册页31，86
T 特定于UNIX的说明12特权21 root29管理30升级76停止服务器64，87停止实例89停止域88图形界面方法20 112SunONEApplicationServer安装指南•2003年4月
W 为升级进行备份78文档31 URL格式11路径格式11目录惯例12使用9说明9特定于UNIX的说明12一般惯例11字体惯例11
X 系统要求26系统资源，增加97卸载69至74卸载失败后的清除工作98修补程序24，27许可22，101至107 类型103
Y 样例应用程序19，83，93要求 端口29技术28空间26，29升级76系统26疑难解答95至100SunONEMessageQueue代理30环境设置86升级82应用程序，样例83用户名，忘记96 用户支持13用于升级的Perl脚本77域 创建66启动和停止88远程安装37
Z 增强型操作系统要求29支持的平台26中断和升级77，81中断升级77，81转换许可证44，59，105字体惯例11组件概述16 索引113 114SunONEApplicationServer安装指南•2003年4月