级别: 初级 IBM,
2003 年 1 月 01 日 IBM WebSphere SDK for Web Services Version 5.1 安装指导
这个版本的
安装指导适用于IBM
(R)WebSphere
(R)SDK for Web Services Version 5.1。
©IBM 版权所有,2003 年。保留所有权利。
本
安装指导提供了关于安装 IBM WebSphere SDK for Web Services(WSDK)Version 5.1 包的信息。
在完成了安装之后,您可以:
- 参考 README 文件以获得最新的信息。README文件在安装目录的根部并且位于安装目录的末尾。
- 参考
配置指导以获得为您的环境配置 WSDK的附加指导。
配置指导在安装目录的根部。
WSDK 已经在下列产品上进行了测试:
- Microsoft
(R)Windows
(R)2000 Professional withService Pack 2
- Microsoft Windows XP Professional with Service Pack 1
- SuSE 8.1
- Red Hat 8.0
已经在 Red Hat Advanced Server 2.1 和 SuSE Linux Enterprise Server 8.0(SLES)进行了有限的测试。
目录
在安装WSDK之前
在您安装 WSDK之前,请注意下面这些硬件、软件需求和关于 Eclipse环境的信息:
硬件需求
-
处理器:
- Intel 奔腾 III 或更高配置
- 500 MHz 或 更高(建议)
-
用于 Windows 的显示器:
- VGA(800 x 600)显示器或更高配置(建议使用1024 x 768)
-
用于 Linux 的显示器:
-
内存:
- 至少需要 256 MB RAM
- 512 MB RAM 或更高配置(建议)
-
磁盘空间:
软件需求
-
用于 Windows:
- Microsoft Windows 2000 Professional(带 Service Pack 2或更高版本)、或 Windows XP Professional(带 Service Pack 1)。
- Microsoft Internet Explorer 5.5 或更高版本。要使用基于Eclipse 的 Web 服务浏览器,您必须有 Internet Explorer 6.0或更高版本。
- 安装和配置 TCP/IP,其中最好带有代理设置(按照
配置指导中的说明进行配置,
配置指导在安装目录的根部)。
-
用于 Linux:
- Red Hat 8.0 或 SuSE 8.1,带或不带 Service Pack。
- Mozilla Web browser V1.0 或更高版本。要使用基于 Eclipse 的 Web服务浏览器,您必须有 Mozilla V1.2.1 或更高版本。
- 安装和配置 TCP/IP,其中最好带有代理设置(按照
配置指导中的说明进行配置,
配置指导在安装目录的根部)。
注意,WSDK 帮助文档不支持 Netscape。
在您开始安装之前,请确保 TEMP目录中有足够的空间供安装时使用。估计需要大约 140 MB临时空间。如果您没有足够的临时空间,那么安装程序将产生错误并且终止安装。
关于 Eclipse 环境的信息
Eclipse 提供了图形化交互开发环境,这种环境为构建和测试 Java应用程序提供了工具。WSDK V5.1 添加到标准 Eclipse 包中(带有与 Web 服务有关的工具),使得构建 Web 服务更简单。要将新的基于 WSDK Eclipse 的图形界面应用于 WSDK 5.1,您需要将 Eclipse 安装在您的工作站上。
所需的 Eclipse 的级别是 V2.1.1。对于 Linux,除了 Red Hat AdvancedServer 2.1 之外(Eclipse 的 GTK 版本不支持 Red Hat AdvancedServer 2.1),或者支持 GIMP Toolkit(GTK),或者支持 Motif 版本。您可以从
Eclipse Web 站点免费下载 Eclipse 包。
使用 Eclipse 环境是可选的。如果您愿意,您可以以 WSDK V5.0 和 V5.0.1 中提供的形式使用命令行版本的 WSDK 工具。您可以在安装时选择安装 WSDK 是供在 Eclipse 环境中使用 WSDK,还是供在命令行环境中使用 WSDK。如果在初始安装 WSDK V5.1 时,您选择命令行环境,那么以后您可以选择通过 WSDK 安装向导升级到 Eclipse 环境。
安装WSDK
WSDK 或者在 CDROM 上提供,或者可以从 IBMdeveloperWorks web 站点
www.ibm.com/developerworks/webservices/wsdk下载.
当从 web 站点下载 WSDK 时,您将得到一个用于 Windows 的 zip 文件或一个用于 Linux 的tar 文件。在 Windows 系统上,unzip 下载的文件。在 Linux 系统上,使用下面的命令 untar 下载的文件:
现在,您就有了一个名为 wsdksetup.exe(用于 Windows)、wsdksetup.bin(用于 Linux)的文件、以及 setup.jar。
CDROM 包含 wsdksetup.exe(用于 Windows)、wsdksetup.bin(用于 Linux)的文件、以及 setup.jar,它可以直接在您的计算机上进行安装。
在安装之前,请阅读以下注意事项,并且考虑移植项目(如果您安装了更早版本的 WSDK 的话)。
安装注意事项
- 在安装 WSDK V5.1 之前,建议您卸载以前的任何 WSDK 副本。您不能在以前的安装之上进行安装,并且建议您不要安装下一个 WSDK 到以前的 WSDK 安装中。
- 在 Linux 上从 CD-ROM 安装 WSDK 时,请确保您已经安装了 Mozilla 并且把它包括在您的路径。如果您没有这样做,注册过程将失败。
- 在 Linux 上,如果您已经选择简体中文作为安装语言,那么安装面板上的某些文本可能因为缺少字体而不能正确显示。您必须安装能够显示中文和英文的字体。
- 存在一个已知的安装程序问题,当安装到不同于 C: 的驱动器时,它可能在 Windows 上出现故障。如果您选择一个不同于 C: 的驱动器,并且输入还不存在的目录的名称,那么安装对话框可能不像期望的那样进行显示。如果您遇到这个问题,选择一个已经存在的目录就可以了。
- 在 Linux 上,如果您预先安装了 WSDK 和命令行工具,随后返回到安装 Eclipse 的 WSDK 插件(Plugin),那么在安装的末尾,您可能看到消息“Null Warning”。这是一个已知的问题,您可以忽略它。单击
Finish按钮,以完成和退出安装。
要安装 WSDK,请遵循下列步骤:
- 运行 wsdksetup 文件以启动安装程序。标题为
InstallShield Wizard的窗口出现,显示消息“Preparingthe Java Virtual(tm) Machine...”。当安装程序解压缩安装过程所需的文件时,这个窗口可能一直是可见的。现在,标题为
Installer的窗口出现了。
- 选择您想用来安装 WSDK 的语言。单击
OK按钮。
- 系统显示 InstallShield Welcome 面板。单击
Next按钮。
- 单击您想安装在您的计算机上的功能的复选框。如果您选择
WSDK Plugins for Eclipse,那么您还必须安装了
WSDK and command line tools。单击
Next按钮。
- 输入您想安装 WSDK 的目录的名称。在缺省情况下,在 Windows 上该目录为 C:\\wsdk_v51,而在 Linux 上该目录为$HOME/IBM/wsdk_v51(在整个文档中,该目录称为
<WSDK-install-dir>)。不要安装到路径名中带有空格或句号的目录中。如果您的机器没有 C: 驱动器,您可以选择一个有效的驱动器并在其中安装 WSDK。单击
Next按钮。
- 如果在步骤4中选中
WSDK Plugins for Eclipse,则输入安装了 Eclipse 程序的目录的名称。单击
Next按钮。
- 现在,安装程序把 WSDK 和 Eclipse 插件(如果要求的话)安装到您所选的目录中,同时显示进程栏。
- 如果您想查看 README(它包含关于产品的最新信息并且说明了某些限制),您可以在显示的面板上单击复选框。单击
Next按钮。单击
Finish按钮。如果您已经选择了 README,它将装载到您的浏览器中。
在安装完成时,<WSDK-install-dir> 包含下列子目录:
- apps
- 包含样本应用程序
- appserver
- 包含应用程序服务器运行时
- bin
- 包含 WSDK 工具
- docs
- 包含文档
- lib
- 包含一些用于 WSDK 工具的 jar 库(jar)文件
- prt
- 包含产品注册工具的信息(只限于 CD 安装)
- _uninst
- 包含卸载程序
可访问性选项
WSDK 也提供了命令行安装以满足可访问性的需要。要激活命令行安装,对于 Windows,请键入:
对于 Linux,请键入:
此命令打开控制台窗口,允许您交互式地安装 WSDK。
使用 WSDK V1.3.1 JVML 启动 Eclipse
WSDK 插件已经通过此产品附带的 IBMJava Software Developer Kit V1.3.1 Service Refresh 5 进行了测试。
要使用此 JVM 启动 Eclipse IDE,可以使用下面的命令:
Windows:
<path to Eclipse>\\eclipse.exe -vm <WSDK-install-dir>\\appserver\\java\\jre\\bin\\javaw.exe
您还可以通过选择
Start-> All Programs -> IBM WebSphere SDK for Web Service v5.1
来从开始菜单(Start Menu)启动 Eclipse IDE。
Linux:
<path to Eclipse>/eclipse -vm <WSDK-install-dir>/appserver/java/jre/bin/javaw
|
文档
在安装的末尾或通过使用 <WSDK-install-dir>\\bin 目录中的
wsdkHelp命令,可以访问 WSDK 的文档。该文档包括关于 WSDK 组件的信息、常见任务的指导、样本应用程序和关于支持 Web服务的技术的信息。对于 Windows,也可以从 Windows 开始菜单(Start Menu)访问该文档。
卸载 WSDK
在卸载 WSDK,请使用
<WSDK-install-dir>\\bin\\appserver stop 命令以确保应用程序服务器不在运行。
要卸载 WSDK,请遵循下列步骤:
Windows:
- 定位到窗口
Control Panel中的
Add/Remove Programs工具。
- 单击列表中的
IBM WebSphere SDK for Web Services, v5.1。
- 单击
Change/Remove。
Linux:
运行命令
<WSDK-install-dir>/_uninst/uninstall 。
这将删除安装程序安装的整个包。
卸载注意事项:
- 在卸载时,您可能看到一个消息,告诉您应用程序仍在运行。如果是这样的话,卸载将不能完成。运行命令
<WSDK-install-dir>\\bin\\appserver stop 以确保应用程序不在运行。接下来,在尝试另一次卸载之前,请确保<WSDK-install-dir>\\appserver\\logs中名为“server<n>.pid”的文件被删除。在停止 WSDK应用程序时, server<n>.pid文件会自动正常删除。然而,如果
appserver stop 命令没有完全成功,那么该文件有可能保留在系统中。
- 在卸载时,系统可能会显示一个警告信息,告诉您安装以后某些文件可能已经更改,并且询问您是否想让卸载删除它们。您可以安全地删除所有这些文件。
- 系统可能会显示警告信息,通知您并非所有的文件都已删除。之所以会出现这些消息,是因为操作系统错误地检测到某些文件仍在使用;这些文件将载下一次重新启动时删除。在下一次重新启动之后,您可以手工删除所有剩余的文件(如果不再需要它们的话)。
可访问性选项
WSDK也提供了命令行卸载以满足可访问性的需要。要激活命令行卸载,对于 Windows,请键入:
<WSDK-install-dir>\\_uninst\\uninstall.exe -console
|
对于 Linux,请键入:
<WSDK-install-dir>/_uninst/uninstall -console
|
此命令打开控制台窗口,允许您交互式地卸载 WSDK。
语言支持
在这个版本的 WSDK 中,只支持英语。
Trademarks
IBM and WebSphere are trademarks of International Business MachinesCorporation in the U.S.A., or other countries, or both.
Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States, or other countries, or both. The Java technology is owned and exclusively licensed by Sun Microsystems, Inc.
Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, or other countries, or both.
Other company, product, and service names may be trademarks or service marks of others.
Other acknowledgements
This product includes software developed by the Apache Software Foundation (
http://www.apache.org/).
The program includes ?nZipSFX stub?software which is Copyright (c) 1999-2002, Info-ZIP. All rights reserved. IBM did not modify the UnZipSFX software. IBM obtained the UnZipSFX software under the terms and conditions of the license from Info-ZIP, which is available at
ftp://ftp.info-zip.org/pub/infozip/license.html.
关于作者  | |  | IBM has authored this article |
对本文的评价
|