目录

Sun GlassFish Web Stack 安装和配置指南

本文档介绍如何在 Solaris 和 Linux 平台上安装和配置 Sun GlassFish Web Stack 及其组件。

简介

Sun GlassFish Web Stack 是完全开源的 Web 应用平台，由 Apache、lighttpd、MySQL、PHP、Tomcat、Glassfish、Ruby 和 Python 组成。它支持内存高速缓存框架 (Memcached)、动态跟踪调试 (DTrace)、Xdebug 和高级 PHP 安全框架 (Suhosin)。

Sun GlassFish Web Stack 可在 Solaris、OpenSolaris 和 Red Hat Enterprise Linux 上使用。

Sun GlassFish Web Stack 组件

此表格列出了 Sun GlassFish Web Stack 中捆绑的主要组件。

Sun GlassFish Web Stack 分发

Sun GlassFish Web Stack 采用两种不同的版本进行分发。

• 本机软件包版本：这是 Sun GlassFish Web Stack 分发的非可重定位版本。此版本只能安装在“Sun GlassFish Web Stack 目录布局”部分中指定的系统目录下。默认情况下，本指南所介绍的是“本机软件包版本”。
• Unbundled IPS/pkg(5) 分发： 此分发基于映像包管理系统 (Image Packaging System, IPS)。您可以将其安装在自己选择的目录下。

Unbundled IPS/pkg(5) 分发具有以下显著益处：

• 非超级用户安装 ：支持在无超级用户权限或管理权限的情况下安装 Sun GlassFish Web Stack。
• 可重定位安装 ：允许在同一系统上安装 Sun GlassFish Web Stack 的多个副本。
• 简化的附加软件框架：简化的组件安装、更新和卸载机制。

安装 Sun GlassFish Web Stack

本部分讨论在 Solaris、OpenSolaris 和 Linux 平台上安装 Sun GlassFish Web Stack。

用户权限

本部分介绍安装 Sun GlassFish Web Stack 所需的用户权限。

本机软件包版本

执行本机软件包安装需要系统管理权限或超级用户权限。

Unbundled IPS/pkg(5) 分发

无论是否具有管理权限或超级用户权限，均可安装 Sun GlassFish Web Stack Unbundled IPS/pkg(5) 分发。如果以超级用户身份进行安装，文件和目录的所有权以及运行时标识将与本机软件包安装匹配（例如，对于 Apache 或 Lighttpd 为 webservd）。如果所需的守护进程用户 ID 尚不存在，安装将失败，同时系统会提示用户手动创建此 ID。如果以非超级用户身份进行安装，则所有文件和目录的所有权归运行安装的用户，且此用户将用作运行时标识。

Sun GlassFish Web Stack 操作系统依赖性

Solaris 和 Red Hat Enterprise Linux 平台上存在特定于平台的依赖性。请首先安装依赖软件包。下表对 Sun GlassFish Web Stack 各组件的依赖性进行了汇总。

注 此表不是完整的依赖性列表。其中仅列出了重要的软件包。

警告 Sun GlassFish Web Stack 安装程序的 Unbundled IPS/pkg(5) 分发无法检查操作系统依赖性。安装 Sun GlassFish Web Stack 各组件之前，您必须交叉检查以下依赖性表格并安装所有需要的依赖软件包。

注 在 Red Hat Enterprise Linux x86_64 版本上，Sun GlassFish Web Stack 也依赖于所列软件包的 32 位版本。

在 Solaris 和 Linux 平台上安装 Sun GlassFish Web Stack

执行以下步骤以安装 Sun GlassFish Web Stack

1. 从 Sun GlassFish Web Stack 下载页下载 Sun GlassFish Web Stack 软件包， http://www.sun.com/systems/solutions/amp/getit.jsp。下载页上提供了适用于 RedHat Enterprise Linux（x86 和 x86_64）和 Solaris（x86、x86_64 和 Sparc）的软件包。下载与您的平台相关的软件包。
2. 提取包含 Sun GlassFish Web Stack 安装程序的 tar.gz 文件。

   gunzip -c xxx.tar.gz | tar xf - 

   此命令会将 Web Stack 安装文件提取到当前目录下；可能需要在临时目录中执行此步骤。

3. 运行安装脚本以开始安装。下表显示了可用的安装程序命令列表。

安装 Sun GlassFish Enterprise Server

Sun GlassFish Enterprise Server 随其自己的安装程序提供，并可以使用 GlassFish Enterprise Server 安装向导进行安装。您可以通过在 GUI 模式下执行安装程序以安装 GlassFish Enterprise Server：

./sges-2_1-solaris-sparc.bin（Solaris SPARC 平台）

./sges-2_1-solaris-i586.bin（Solaris x86 平台）

./sges-2_1-linux.bin（Linux 平台）

有关详细信息，请参阅 《Sun GlassFish Enterprise Server 2.1 Installation Guide》。

在 OpenSolaris 平台上安装 Sun GlassFish Web Stack

有关在 OpenSolaris 平台上安装 Sun GlassFish Web Stack 的信息，请参阅 Web Stack Getting Started Guide for OpenSolaris

安装 Sun GlassFish Web Stack Unbundled IPS/pkg(5) 分发

Sun GlassFish Web Stack Unbundled IPS/pkg(5) 分发以最小化形式的分发提供。会预安装一个较小的基本 Web Stack 组件集。剩余组件可从基于网络的系统信息库中获得。为了安装附加组件或更新已安装的组件，Web Stack 分发提供了命令行界面 (pkg) 和图形用户界面 (updatetool) 以协助进行安装。

为 Sun GlassFish Web Stack 设置 Unbundled IPS/pkg(5) 分发

执行以下步骤，为 Sun GlassFish Web Stack 设置 Unbundled IPS/pkg(5) 分发

1. 从 Sun GlassFish Web Stack 下载页下载 Sun GlassFish Web Stack Unbundled IPS/pkg(5) 分发软件包， http://www.sun.com/systems/solutions/amp/getit.jsp。下载页上提供了适用于 RedHat Enterprise Linux（x86 和 x86_64）和 Solaris（x86、x86_64 和 Sparc）的软件包。下载与您的平台相关的软件包。
2. 将包含 Sun GlassFish Web Stack Unbundled IPS/pkg(5) 分发的 tar.gz 文件提取到任何想要的位置。 

   gunzip -c webstack-image-* | tar xf - 

3. 进入 webstack-1.5 目录（如果愿意，可以重命名此目录）。此目录将成为所有 Sun GlassFish Web Stack 组件的同一安装目录。您可以根据自己的选择移动或重命名此目录。此目录包含以下用于管理 Sun GlassFish Web Stack 组件的重要二进制文件
   • ./bin/pkg ：Unbundled IPS/pkg(5) 分发的命令行界面 (Command Line Interface, CLI)。
   • ./bin/updatetool ：Unbundled IPS/pkg(5) 分发的图形用户界面 (Graphical User Interface, GUI)。
   • ./bin/setup-webstack：Unbundled IPS/pkg(5) 分发的安装后实用程序。通过 CLI 安装软件包后必须运行该程序。

注 要使用 Unbundled IPS/pkg(5) 分发来安装和更新软件包，您需要可用的 Internet 连接。

使用 Unbundled IPS/pkg(5) 分发 CLI

您可以使用 ./bin/pkg 命令从命令行安装 Sun GlassFish Web Stack 软件包。下表列出了一些重要的命令。

注 运行命令 ./bin/pkg install 后，需要执行 ./bin/setup-webstack。

您可以查看 Sun GlassFish Web Stack 组件 部分或使用命令 list -a 以获得有效软件包名称的列表。

有关 pkg 命令的详细信息，请参阅 “pkg(5) 手册页” 和 Update Center Wiki。

使用 Unbundled IPS/pkg(5) 分发 GUI

Sun GlassFish Web Stack Unbundled IPS/pkg(5) 分发随附有称为 Update Tool（更新工具）的 GUI 工具。使用以下命令可以调用“更新工具”：

./bin/updatetool 

可使用更新工具执行以下任务：

• 安装新的附加软件包
• 管理软件包更新
• 查看关于已安装软件包的信息

要安装软件包，单击侧边栏上提供的“可用附加软件”项。选择要安装的软件包并单击绿色的“安装”箭头。

要更新软件包，单击侧边栏上提供的“可用更新”项。选择要更新的软件包并单击“更新”箭头。

有关 updatetool 的详细信息，请参阅联机帮助。可在主菜单栏上单击“帮助 > 目录”以访问联机帮助。

升级至 Sun GlassFish Web Stack 1.5

Sun GlassFish Web Stack 1.5 修复了大量重要的错误，并包含安全更新和更新的组件。有关详细信息，请参阅 Sun GlassFish Web Stack 1.5 发行说明 。

您可以使用带有 -u 开关参数的安装命令对所有已安装的 Sun GlassFish Web Stack 软件包执行自动升级。

./install -u 

警告 不支持使用系统软件包管理工具执行升级，如果使用则可能导致软件被破坏。

注 版本 1.4 和版本 1.5 软件包不能混合在一起安装。您必须升级所有已安装的组件。

管理 Sun GlassFish Web Stack 服务

Sun GlassFish Web Stack 会在系统上安装大量的服务。下表列出了 Sun GlassFish Web Stack 服务及其启动/停止命令。

在 Linux 中自动启动服务

在 Linux 系统中，启动或停止某个服务只会启动或停止运行该命令的特定系统会话的服务。要在 Linux 中自动启动某个服务，必须将其放置在系统的默认运行级别中。

例如，要将 Apache Web Server 放在运行级别 3 和 5 中，可以使用以下命令：

chkconfig --level 35 sun-apache22 on 

Sun GlassFish Web Stack 目录布局

本部分讨论 Sun GlassFish Web Stack 组件的目录布局。Sun GlassFish Web Stack 文件安装在三个不同目录下：

OPT_ROOT：应用程序安装目录。

ETC_ROOT：应用程序配置目录。

VAR_ROOT：应用程序数据目录。

目录路径因平台而异。下表列出 Solaris、Linux 和 OpenSolaris 平台上的目录位置。

Apache HTTP Server 文件

下表介绍 Apache HTTP Server 和附加插件模块的目录布局：

模块 mod_fcgid、 mod_jk、mod_security}}和 {{mod_dtrace 已随 Apache HTTP Server 预先安装。有关这些模块的详细信息，请参阅 http://fastcgi.coremail.cn/doc.htm、 http://tomcat.apache.org/connectors-doc/generic_howto/quick.html、 http://www.modsecurity.org/documentation/index.html和 http://prefetch.net/projects/apache_modtrace/mod_dtrace.c

MySQL 数据库文件

下表说明 MySQL Database Server 的目录布局。

PHP 文件

下表介绍 PHP 的目录布局：

注 默认情况下会禁用 APC、 DTrace、 XDebug、 suhosin}}和 {{tcpwrap}}等 PHP 扩展。要启用这些扩展，需要取消注释{{conf.d}}文件中相应的行（ {{extensions=<模块名称>.so ）。

Ruby 文件

下表介绍 Ruby 的目录布局：

Squid Proxy Server 文件

下表介绍 Squid Proxy Server 的目录布局：

Sun GlassFish Web Stack 默认网络端口

Sun GlassFish Web Stack 使用数个默认端口用于常规组件操作。下表列出各组件使用的端口。

扩展 Sun GlassFish Web Stack

通过各种使用第三方扩展程序可以轻松扩展 Sun GlassFish Web Stack。从而使您可以将新的功能添加到现有软件中。要编译 Sun GlassFish Web Stack 扩展，需要在系统上安装强制开发软件包。

编译器要求：

Solaris 10：Sun Studio 12 或更新版本。

Red Hat Enterprise Linux：来自分发系统信息库，支持 RedHat 的 GCC 发行版本。

安装 PHP 扩展

PHP 扩展可采用两种形式提供：PECL（PHP Extension Community Library，PHP 扩展社区库）和 PEAR（PHP Extension and Application Repository，PHP 扩展和应用系统信息库）。PECL 扩展以 C 源代码发行。PECL 扩展是链接到 PHP 核心的已编译 C 语言扩展。作为 C 程序，PECL 扩展的运行效率高于 PEAR 软件包。PECL 包含 XML 解析、访问附加数据库、邮件解析、在 PHP 脚本中嵌入 Perl 或 Python 的模块。

PEAR 软件包作为 gzip 压缩的 tar 文件发行。每个归档文件均包含以 PHP 编写的源代码，一般采用面向对象的风格编写。通过在 PHP 中简单的 include 语句，开发者可以轻松地将许多 PEAR 软件包当作普通的第三方代码来使用。

安装 PECL 扩展

PECL 扩展需要先被编译成共享对象文件 (.so)，然后才能与 PHP 一起使用。

某些扩展需要附加软件才能成功构建和安装。如果在 PATH 中找不到附加软件，扩展安装将会失败，错误消息根据所需软件和正在安装的扩展而有所不同。附加软件通常需要包含 GNU Autoconf 和 re2c (http://re2c.org/)。&nbsp；

安装 Sun Studio 后，运行以下命令可下载、编辑和安装 PECL 扩展：

 # OPT_ROOT/bin/pecl install <扩展名称> 

如果您不确定扩展名称，可使用以下命令获得所有可用扩展的列表：

$ OPT_ROOT/bin/pecl list-all 

安装 PEAR 扩展

运行以下命令可下载和安装 PEAR 扩展：

# OPT_ROOT/bin/pear install <扩展名称> 

安装 Python 扩展

Python 扩展通过 Easy Install 提供支持。Easy Install 是与 setuptools 绑定的 python 模块 (easy_install)，可让您自动下载、构建、安装和管理 Python 软件包。easy_install 可以从 PyPI（Python Package Index，Python 软件包索引）系统信息库下载和安装 Python 扩展。

安装 setuptools (easy_install)

使用以下命令可下载和安装 setuptools。您需要在系统上安装 Sun Studio，以便编译 setuptools 软件包。此外，需要验证系统 PATH 变量中是否包含 Sun GlassFish Web Stack 的位置。这样可以避免与现有 python 安装产生任何冲突。

1. 从 http://pypi.python.org/pypi/setuptools#downloads下载和提取 python setuptools 源软件包。下载 tar.gz 文件（setuptools-0.6c9.tar.gz）。
2. 运行以下命令以编译和安装 setuptools 软件包。

# python setup.py install 

使用 easy_install

easy_install 非常易于使用。只需使用以下命令即可下载和安装 python 扩展。

# python easy_install.py <软件包名称> 

您可以访问 http://pypi.python.org/pypi 浏览 PyPI 系统信息库。 

安装 Ruby 扩展 (RubyGems)

Ruby 扩展由 RubyGems 提供支持。RubyGems 是 Ruby 编程语言的软件包管理器，可提供用于发布 Ruby 程序和库的标准格式（以一种称为 "gem" 的自包含格式）、专用于方便管理 gem 安装的工具，以及分发 gem 的服务器。

使用以下命令安装 Ruby 扩展 (gem)。确保 Sun GlassFish Web Stack 存在于 PATH 变量中。

# gem install <gem 名称> 

如果您不确定 gem 的名称，可使用以下命令获得所有可用 gem 的列表：

# gem list -r -d 

例如，安装 mysql gem 时，必须提供 MySQL 5.1 客户端库和头文件的路径，如下所示：

# gem install mysql --with-mysql-include=/usr/mysql/5.1/include --with-mysql-lib=/usr/mysql/5.1/lib 

注 要使用 gem，请确保您可以直接访问 Internet。如果您的系统受到防火墙的保护，或者其使用代理服务器，则需要设置 HTTP_PROXY 变量。

由 GEM_HOME 所引用的目录应为可写的。因此请务必执行以下命令：

$ chmod -R a+w <GEM_HOME_PATH> 

注意 - 如果 GEM_HOME 引用 $HOME/.gem，请勿执行之前提到的任务。

安装 Apache 扩展

通过由第三方提供插件模块，可以得到许多 Apache 附加功能。这些模块可能以单一源文件提供，用户运行 apxs 即可构建并安装此类文件；其构建也可能较为复杂，即将 apxs 的路径作为配置参数。

分别为 32 位或 64 位 Apache 构建模块。（未提供适用于 Red Hat Enterprise Linux 的 64 位 Apache 版本。）
apxs 使用的编译器必须与用于构建 Apache 的编译器匹配。在 OpenSolaris 和 Solaris 10 上，在 PATH 中找到的 cc 命令必须是 Sun Studio；如果已安装 gcc，您可能需要先将 PATH 指向 Sun Studio。在 Red Hat Enterprise Linux 上，将使用 gcc。
以下为创建 32 位和 64 位模块版本的构建示例：

$ pfexec /usr/apache2/2.2/bin/apxs -ci mod_example.c $ pfexec /usr/apache2/2.2/bin/64/apxs -ci mod_example.c 

这将在目录 /var/apache2/2.2/libexec/mod_example.so 和 /var/apache2/2.2/libexec/64/mod_example.so 中创建 mod_example.so。
推荐使用以下内容在 /etc/apache2/2.2/conf.d 中创建一个文件来装入和配置模块：

<IfDefine 64bit> LoadModule example_module /var/apache2/2.2/libexec/64/mod_example.so </IfDefine> <IfDefine !64bit> LoadModule example_module /var/apache2/2.2/libexec/mod_example.so </IfDefine> #module configuration directives 

使用配置脚本构建的模块通常会提供 --with-apxs 或 --with-apxs2 选项。根据所需模式，指定 32 位或 64 位 apxs 的路径。

高级配置

Sun GlassFish Web Stack 可利用 Solaris OS 的特定功能，如 Solaris Zones 和 DTrace。有关详细信息，请参阅：

• Using Memcached with Solaris Zones
• DTrace and Sun GlassFish Web Stack