Sun Java logo     上一页      下一页     

Sun logo
Sun Java System Application Server Enterprise Edition 8.1 2005Q1 

快速入门指南

欢迎使用《Sun Java System Application Server Enterprise Edition 8.1 2005Q1 快速入门指南》。本指南适用于有兴趣了解有关 Sun Java™ System Application Server Enterprise Edition 8.1 2005Q1 软件的功能的开发者、系统管理员和 Application Server 管理员。

要获得此文档的最新版本,请参见 docs.sun.com 中的联机版本,网址为:

http://docs.sun.com/app/docs/prod/sjs.asse

本指南介绍了使用 Application Server 的基本步骤和高级步骤。这些步骤按照完成步骤的顺序来介绍。以下几部分将讲述基本步骤(完成这些步骤通常需要不到 45 分钟的时间):

以下几部分将讲述高级步骤(完成这些步骤通常需要约 45 分钟的时间):

本指南的最后几部分包含有关清除的说明和有关其他资源的信息。

下表介绍了本指南中所使用目录的变量名称和默认路径。变量名称位于第一列,默认路径位于第二列。

变量名称

描述和路径

install_dir

默认情况下,Application Server 安装目录位于此处:

  • Solaris Sun JavaEnterprise System 安装:
    /opt/SUNWappserver/appserver
  • Linux Java Enterprise System 安装:
    /opt/sun/appserver/
  • Solaris 和 Linux 上独立的 Application Server 安装(非超级用户):
    user_home_directory/SUNWappserver
  • Solaris 和 Linux 上独立的 Application Server 安装(超级用户):
    /opt/SUNWappserver

 

domain_root_dir

默认情况下,包含所有域的目录位于此处:

  • Solaris Java Enterprise System 安装:
    /var/opt/SUNWappserver/domains/
  • Linux Java Enterprise System 安装:
    /var/opt/sun/appserver/domains/
  • 所有其他安装:
    install_dir/domains/

domain_dir

默认情况下,域目录位于此处:
domain_root_dir/domain_dir


关于 Application Server 管理

为了使管理员能够管理在多个主机上运行的服务器实例和群集,Application Server 提供了以下工具:

这些工具都连接到称为域管理服务器的服务器,该服务器是特别指定的 Application Server 实例,用于协调所有管理任务。不管使用哪个接口,域管理服务器都为验证和执行管理命令提供了一个安全接口。

是具有同一个指定管理员的配置数据、已部署的应用程序和计算机的集合。域定义说明并可以控制可能分布在多台计算机上的多个应用程序、独立应用服务器实例和群集的运行。安装域管理服务器时,始终会安装名为 domain1 的默认域。本指南中使用默认域来进行说明。

要完成本指南中介绍的大多数步骤,需要使用管理控制台。


启动域管理服务器

此主题(三个基本主题中的第一个主题)介绍了以下步骤:

启动管理服务器

要启动管理服务器,请执行以下步骤。

  1. install_dir/bin/ 目录添加到 PATH 环境变量中:

         C Shell:
           setenv PATH install_dir/bin:$PATH

        
     Bourne Shell:
           PATH=install_dir/bin:$PATH
           export PATH
  2. 设置管理员用户环境变量,以使您无需为每个命令键入该环境变量:

         C Shell:
           setenv AS_ADMIN_USER admin_user

        
     Bourne Shell:
           AS_ADMIN_USER=admin_user
           export AS_ADMIN_USER
  3. 输入以下命令以便从 install_dir 启动服务器:
  4. asadmin start-domain domain1

    系统提示您输入管理员密码和主密码时,请输入在安装过程中提供的这些密码。

  5. 将显示一条消息,通知您正在启动域管理服务器:
    正在启动域 domain1,请稍侯。将日志重定向至 domain_dir/domain1/logs/server.log...
  6. 启动进程完成后,您将看到另一条消息:
    域 domain1 已启动

  7. 由于本指南指导您设置管理用户名的环境变量 AS_ADMIN_USER,因此在使用 asadmin 命令时将不会提供用户名参数。您可以在键入此命令时提供此参数。例如:

    asadmin command_verb --user username command_arguments


登录到管理控制台

管理控制台是一个浏览器界面,它可以简化各种管理和配置任务。通常用于执行以下任务:

有关使用管理控制台的详细信息,请参阅联机帮助或《Sun Java System Application Server Enterprise Edition 8.1 2005Q1 管理指南》。

要登录到管理控制台,请执行以下步骤:

  1. 在浏览器中键入以下 URL:
  2. https://localhost:4849/asadmin

    由于管理控制台是安全 Web 应用程序,因此您必须使用 https 而非 http。

    用运行域管理服务器的系统的名称替换 localhost 变量。

    4849 是管理控制台的默认端口号。如果在安装过程中更改了端口号,请使用更改后的端口号。


    如果出现一个弹出式窗口,显示诸如 Website Certified by an Unknown Authority 之类的消息,请单击“确定”。

    显示此消息的原因是浏览器未识别出自签名证书,域管理服务器通过安全传输协议为管理控制台提供服务时使用此自签名证书。


  3. 显示登录窗口时,请输入管理员用户名和密码。
  4. 单击“登录”。
  5. 显示“管理控制台”时,其外观如下所示:


    管理控制台的页面中有标题窗格,左侧窗格显示通用任务树,右侧窗格显示欢迎信息及通用任务和文档的链接。

在左侧窗格中,您可以从提供的树中选择要管理的任务。在右侧窗格中,“通用任务”标题下列出了各种管理任务。


提示

如果尚未注册软件,请单击“注册”选项卡以注册您的软件。


检查日志文件

Application Server 实例和域管理服务器会在文件系统中生成带注释的日志。默认情况下,将记录所有错误、警告或有用的信息类型消息。要查看管理服务器日志文件,请执行以下步骤:

  1. 在右侧窗格的“通用任务”列表中,单击“搜索日志文件”为日志查看器启动一个新的浏览器窗口。

  2. 日志查看器提供了查看、搜索和过滤选项。

  3. 在“日志查看器”窗口中,从“实例名称”下拉式列表中选择服务器,并单击“搜索”。将显示域管理服务器的最近的日志文件条目。
  4. 查看消息并查找所有 WARNINGSEVERE 消息(这些消息表明在服务器启动过程中遇到了问题)。
  5. 您随时可以关闭日志查看器。在创建群集和部署应用程序之后,应当检查日志文件(如果有任何操作失败)。日志查看器可用于查看域中运行的任何 Application Server 实例的日志文件。

有关日志文件的更多信息,请参见《Sun Java System Application Server Enterprise Edition 8.1 2005Q1 管理指南》。

在此部分中,您启动了域管理服务器并确认了该服务器正在运行。还登录到了管理控制台并使用了日志查看器。如果您不想继续进行操作,可以就此停止,不必查看快速入门的以下内容。


创建群集

此部分(三个基本主题中的第二个主题)说明了如何创建包含两个 Application Server 实例的群集。为了简单明了,群集完全在一台计算机内运行。此主题介绍了以下步骤:

启动节点代理

节点代理是在属于 Application Server 管理域的每台计算机上运行的轻量进程。节点代理负责启动和停止主机上的服务器实例。它还与域管理服务器协作来创建新的 Application Server 实例。

对于每个 Application Server 管理域,其中的每台计算机上都需要有一个节点代理。如果您在安装过程中选择了节点代理组件,将创建名为 hostname 的默认节点代理。

要启动默认节点代理,请执行以下步骤:

  1. 在终端窗口中,键入以下命令:
  2. asadmin start-node-agent hostname

    用运行 Application Server 的主机的名称替换变量 hostname

  3. 系统提示时,请输入主密码。
  4. 节点代理将启动并与域管理服务器连接。如果域管理服务器未运行,则节点代理可能无法启动。

定义群集

群集是共享相同配置、资源和应用程序的一组服务器实例(通常在多个主机上)。群集有助于服务器实例之间的负载平衡并通过故障转移提供高可用性。您可以在多台计算机之间创建群集,并利用每台计算机上的节点代理进程对其进行管理。在本指南中,为了简单明了,样例群集将位于运行域管理服务器的同一个主机上。

您必须已启动每台计算机上的节点代理进程(如前面部分所述)。在创建群集过程中,当指定实例时,您必须将实例与要运行实例的计算机上运行的节点代理关联起来。在同一域中创建的各个群集之间,节点代理和实例名称必须是唯一的。

要创建群集,请执行以下步骤:

  1. 登录到位于 https://localhost:4849 的管理控制台(如果尚未登录)。
  2. 用运行域管理服务器的系统的名称替换 localhost 变量。

    4849 是管理控制台的默认端口号。如果在安装过程中更改了端口号,请使用更改后的端口号。

  3. 在右侧窗格的“通用任务”下,单击“创建新的群集”以显示“创建群集”输入页面。
  4. 键入 FirstCluster 作为新群集的名称。
  5. 从可用配置模板的下拉列表中,选择 "default-config" 配置并选择“复制选定的配置”。
  6. 单击“添加”按钮两次,以创建两个条目,从而为群集指定两个实例。
  7. 键入 i1i2 作为实例名称。节点代理名称将自动填充为本地计算机的名称。
  8. 您将看到与以下所示屏幕类似的屏幕:


    显示群集的名称、配置和要创建的服务器实例的“创建群集”页面。

  9. 单击“确定”。创建过程可能需要几分钟。

  10. 此选项需要自动指定的 HTTP、HTTPS、IIOP 和 IIOPS 端口号。如果需要,可以在以后对其进行更改。


    创建过程完成时,将显示“已成功创建群集”页面,并且 FirstCluster 将显示在左侧窗格的树中。为此群集创建了配置模板 default-config 的副本,并为其指定了名称 FirstCluster-config

  11. 在左侧窗格中,展开“群集”并单击 "FirstCluster" 以显示群集的“常规信息”页面。
  12. 单击“实例”选项卡以显示已创建的实例 i1 和 i2。
    1. 单击 "i1" 以检查此实例。
    2. 在右侧窗格的“常规信息”标题上面的选项卡中,单击“属性”并查看 HTTP_LISTENER_PORT 的值。
    3. 对 i2 重复上述步骤。

    4. 默认情况下,i1 的 HTTP 端口为 38081,i2 的 HTTP 端口为 38080。如果在创建这些群集时计算机上的这些端口正忙,或者您已将这些端口指定给其他实例和群集,则将指定其他端口号。


在此部分中,您已经在一台计算机上创建了一个简单的群集。您还可以使用相同的基本步骤在多台计算机之间创建群集(只要您安装了软件并且在每台计算机上运行节点代理)。

如果您不想继续进行操作,可以就此停止,不必查看快速入门的以下内容。


部署应用程序

此部分(三个基本主题中的第三个主题)介绍了以下步骤:

部署样例应用程序

本指南使用 clusterjsp 样例应用程序来演示 Web 路径负载平衡功能。

  1. 如果尚未处于“通用任务”页面,请单击“主页”按钮以转至该页面。
  2. 在右侧窗格的“通用任务”下,单击“部署企业应用程序”。
  3. 在“要上载的文件”文本框中,单击“浏览”并浏览到 install_dir/samples/ee-samples/highavailability/apps/clusterjsp/clusterjsp.ear
  4. 单击“下一步”将显示“部署企业应用程序”页面。
  5. 向下滚动到该页面的“目标”部分。
  6. 从“可用”列表中选择 "FirstCluster",然后单击“添加”以将其移动到“已选择”列表中。
  7. 单击“确定”。
  8. clusterjsp 应用程序现在已部署到 FirstCluster。

    此屏幕确认 clusterjsp 应用程序现在已部署到 FirstCluster。


    包括 clusterjsp 在内的已部署的企业应用程序的列表

检验群集的应用程序

在此步骤中,您将启动群集并检查在两个实例上是否可以访问应用程序。

要启动群集,请执行以下步骤:

  1. 在左侧窗格的树中,单击“群集”下的 "FirstCluster" 节点。
  2. 在右侧窗格中,单击“常规”选项卡(如果该选项卡尚未激活)。
  3. 单击“启动实例”按钮以启动群集。
  4. 通过检查“状态”字段是否更改(表明哪些实例正在运行)来检验群集是否已启动。

要在每个实例上访问应用程序,请执行以下步骤:

  1. 在浏览器中键入以下 URL:
  2. http://localhost:port/clusterjsp

    用运行域管理服务器的系统的名称替换 localhost 变量。

    用 i1 的 HTTP-LISTENER-PORT 的值替换 port 变量。此示例使用 http://localhost:38081/clusterjsp

  3. 添加会话属性数据。
  4. 检查显示的会话和主机信息。例如:
    • Executed From Server: localhost
    • Server Port Number: 38081
    • Executed Server IP Address: 192.18.145.133
    • Session Created: Day Mon 05 14:55:34 PDT 2005
  5. 添加会话数据并单击“添加到会话”按钮。
  6. 在浏览器中键入以下 URL,对实例 i2 重复此过程:
  7. http://localhost:38080/clusterjsp

在此部分中,您将应用程序部署到了群集并测试了应用程序在群集中的所有实例上是否可用。

祝贺您!您已经完成了本快速入门指南中的基本步骤。如果您不想继续执行高级步骤,可以就此停止,不必查看快速入门的以下内容。


设置负载平衡

通常在部署群集之前部署负载平衡器。它可以:

Application Server 包含用于常用 Web 服务器(如 Apache 和 Sun Java™ System Web Server)的负载平衡插件。

此部分提供了有关如何下载和设置 Sun Java System Web Server 软件以用作 Application Server 的群集的负载平衡器的说明。要完成此部分中的步骤,除了域管理服务器和按照本指南的指导目前您已创建的两个应用服务器实例之外,您的系统中还必须有足够的内存来运行 Web Server。为了完成此部分中的步骤,建议使用具有 512 MB 至 1024 MB 内存的系统。

此主题介绍了以下步骤:

安装 Web Server 软件

如果您已安装 Web Server 软件,并且可以识别出作为负载平衡器的 Web Server 实例,请记下此实例在文件系统中的位置并跳到安装负载平衡器插件

如果使用的是 Sun Java Enterprise System 软件,则在您选择安装负载平衡器插件时已自动选择安装 Web Server。但是,您也可以使用以下步骤安装 Web Server 软件:

  1. 启动 Java Enterprise System 安装程序。
  2. 在“组件选择”页面中,选择 Sun Java System Web Server 组件。
  3. 选择“立即配置”,系统将在安装过程中提示您进行 Web Server 配置。
  4. 系统提示时,定义一个默认的 Web Server 实例。

  5. 提示

    请记住您为此默认 Web Server 实例所选择的端口号。本指南假定选择端口 38000 作为默认实例的 HTTP 端口。


如果您使用的是独立的 Sun Java System Application Server,或者您无法使用 Sun Java Enterprise System 安装程序,请使用以下步骤安装 Web Server 软件:

  1. 转至 http://www.sun.com/downloads。向下滚动到 "Web & Proxy Servers" 标题并单击 "Web Servers"。
  2. 根据您选择的语言环境和平台,下载 Web Server 6.1 Service Pack 2 或更高版本。
  3. 要进行下载,您必须使用已在 MySunSM、Sun StoreSM、SunSolveSM 或联机支持中心注册的用户名和密码登录。如果您没有登录帐户,可以联机注册。

  4. 按照说明来安装 Web Server 软件。您必须:
    1. 从压缩的归档文件中解压缩软件。
    2. 运行安装程序。如果需要其他信息,请参见位于 http://docs.sun.com/doc/819-0131-10 的 Web Server 安装说明。
  5. Web Server 安装进程将配置 Web Server 管理服务器,还将提示您定义默认的 Web Server 实例。

  6. 提示

    请记住您为此默认 Web Server 实例所选择的端口号。本指南假定选择端口 38000 作为默认实例的 HTTP 端口。


安装负载平衡器插件

要安装负载平衡器插件,请执行以下步骤:

  1. 运行您正在使用的分发软件(Sun Java Enterprise System 软件或独立的 Sun Java System Application Server 软件)的安装程序。
  2. 当系统询问您要安装哪些组件时,选择“负载平衡插件”。
  3. 在 Sun Java Enterprise System 安装程序中,您必须展开 "Application Server" 项才能看到“负载平衡插件”。默认情况下,不会选择安装此插件。

创建负载平衡器配置

现在,继续与 Application Server 的域管理服务器进行交互。对于此部分,您需要 shell 执行环境。

  1. 创建名为 MyLbConfig、指向群集 FirstCluster 的负载平衡器配置:
  2. asadmin create-http-lb-config --target FirstCluster MyLbConfig

  3. 启用 FirstCluster 群集以及部署在该群集中的 clusterjsp 应用程序以进行 HTTP 负载平衡:
  4. asadmin enable-http-lb-server FirstCluster

    asadmin enable-http-lb-application --name clusterjsp FirstCluster

  5. 为负载平衡器创建运行状况检查器,当出现故障的实例进行恢复时,该检查器就会发出信号。
  6. asadmin create-http-health-checker --interval 10 --config MyLbConfig FirstCluster

    时间间隔是运行状况检查器在两次异常实例检查之间等待的时间(秒)。

  7. 将配置导出到 loadbalancer.xml 文件中
  8. asadmin export-http-lb-config --config MyLbConfig loadbalancer.xml

  9. loadbalancer.xml 复制到 web_server_install_dir/https-hostname/config/loadbalancer.xml

启动负载平衡器

如果用作负载平衡器的 Web Server 实例尚未运行,请执行以下命令启动 Web Server 软件:

如果用作负载平衡器的 Web Server 实例尚未运行,请执行以下命令重新启动 Web Server 软件:

检验负载平衡

  1. 要显示 clusterjsp 应用程序的首页,请在浏览器中键入以下 URL:
  2. http://localhost:web_server_port/clusterjsp

    用运行 Web Server 的系统的名称替换 localhost 变量。

    web_server_install_dir/https-hostname/config/server.xml 中的 LS 元素的端口属性值替换 web_server_port 变量。对于此示例,使用端口 38000。

    所显示的页面与您在检验群集的应用程序部分中看到的页面类似。

  3. 检查显示的会话和主机信息。例如:
    • Executed From Server: localhost
    • Server Port Number: 38000
    • Executed Server IP Address: 192.18.145.133
    • Session Created: Day Mon 05 14:55:34 PDT 2005
  4. 服务器端口号为 38000(Web Server 的端口)。负载平衡器已转发了群集中两个实例上的请求。
  5. 使用其他浏览器软件或其他计算机上的浏览器新建会话。来自同一个浏览器的请求具有“粘性”并将转至同一个实例。
  6. 这些会话应分布到群集中的两个实例。您可以通过查看位于以下位置的服务器访问日志文件对此进行检验:

    • Solaris Java Enterprise System 安装:
      /var/opt/SUNWappserver/nodeagents/nodeagent_name/i1/logs/access/server_access_log
      /var/opt/SUNWappserver/nodeagents/nodeagent_name/i2/logs/access/server_access_log
    • Linux Java Enterprise System 安装:
      /var/opt/sun/appserver/nodeagents/nodeagent_name/i1/logs/access/server_access_log
      /var/opt/sun/appserver/nodeagents/nodeagent_name/i2/logs/access/server_access_log
    • 独立的 Application Server 安装:
      install_dir/nodeagents/nodeagent_name/i1/logs/access/server_access_log
      install_dir/nodeagents/nodeagent_name/i2/logs/access/server_access_log
  7. 添加名称和值对 (Name=Name Value=Duke),以存储到 HttpSession 中。
  8. 单击“添加到会话数据”按钮。
  9. 检验是否已添加会话数据。

在此部分中,您创建了用作负载平衡器的实例并设置了负载平衡配置。您还检验了负载平衡。

要配置并验证 HTTP 会话故障转移,请继续设置高可用性故障转移


清除

要进行清除,您可以通过完成选项 1:卸载安装中的步骤卸载 Application Server 安装,也可以通过完成选项 2:删除样例群集中的步骤只删除您刚创建的样例群集。


注意

如果要完成关于高可用性群集和 HADB部分,请不要现在清除安装。而应跳到关于高可用性群集和 HADB部分,并在完成后按照该部分说明中的步骤进行清除。


选项 1:卸载安装

要完全卸载,请执行以下步骤:

  1. 使用以下命令停止 Application Server 进程:
  2. asadmin stop-cluster FirstCluster

    asadmin stop-node-agent hostname

    asadmin stop-domain domain1

    此时,将停止与 Application Server 相关的所有进程。

  3. 卸载 Application Server。
  4. 在 Java Enterprise System 安装过程中,先运行 var/sadm/prod/entsys/uninstall,然后按照卸载向导中的步骤进行操作。

    在独立的 Application Server 安装过程中,先运行 install_dir/uninstall,然后按照卸载向导中的步骤进行操作。

  5. 对于此选项,如果您安装了 Web Server,则停止作为负载平衡器使用的 Web Server 实例并卸载 Web Server 产品。您可以按以下方式停止实例:
  6. web_server_install_dir/https-hostname/stop

  7. 如果要卸载 Web Server 产品,请从 web_server_install_dir 运行卸载程序。

选项 2:删除样例群集

要仅删除在此选项中使用的 FirstCluster(具有高可用性的样例群集)和样例应用程序,请执行以下步骤:

  1. 停止 Application Server 进程并清除配置:
  2. asadmin stop-cluster FirstCluster

    asadmin disable-http-lb-server FirstCluster

    asadmin delete-http-lb-ref --config MyLbConfig FirstCluster

    asadmin delete-http-lb-config MyLbConfig

    asadmin delete-instance i1

    asadmin delete-instance i2

    asadmin delete-cluster FirstCluster

    asadmin undeploy clusterjsp

  3. 停止用作负载平衡器的 Web Server 实例:
  4. web_server_install_dir/https-hostname/stop

  5. web_server_install_dir/https-hostname/config 中的 loadbalancer.xml 文件重命名为 loadbalancer.xml.sav

祝贺您!您现在已经完成了 Application Server 的快速入门。


其他资源

下面是一些用于了解和使用 Application Server 的其他资源:



上一页      下一页     


文件号码 819-1256.   版权所有 2004-2005 Sun Microsystems, Inc. 保留所有权利。