在 Apache Tomcat 上部署

在 Apache Tomcat (以下简称 Tomcat)上部署 SuperMap iServer Java 前，请检查软件环境是否满足需求，请参考 war 包部署前的环境配置。

启动 Tomcat，把 war 包放入如下目录：【Tomcat 根目录】\webapps，Tomcat 就可以将 war 包发布为 Web 服务。例如启动 Tomcat，把 iserver.war 放入 webapps 目录，就完成了 SuperMap iServer Java 核心功能的启动。访问 http://<server>:<port>/iserver/services，就能获取 SupeMap iServer Java 所有可用服务的列表。使用 iserver#help.war 将帮助文档发布为在线形式后，访问的 URI 为：http://<server>:<port>/iserver/help。使用 iserver#iClient.war 将 iClient 发布为在线服务后，访问的 URI 为：http://<server>:<port>/iserver/iClient。

启动 Tomcat 后，可以通过访问 Tomcat 的管理界面，即 http://<server>:<port>/manager/html 来查看 war 包的部署情况。也可以通过该管理界面进行 war 包的部署。

在 Apusic Application Server 上部署

在 Apusic Application Server 上部署 SuperMap iServer Java 前，请检查软件环境是否满足需求，请参考 war 包部署前的环境配置。

Windows 系统下，在 Apusic Application Server（以下简称 Apusic）上部署 SuperMap iServer Java 的过程如下：

启动 Apusic，把 war 包放入如下目录：【Apusic 根目录】\domains\【domainname】\applications，Apusic 就可以将 war 包发布为 Web 服务。其中【domainname】是正在运行的 Apusic 领域名。对于 iserver#help.war 和 iserver#iClient.war，需要将它们重命名使得名称中不包含特殊符号“#”后再部署，如将 iserver#help 改为 help.war。

启动 Apusic 后，可以通过访问 Apusic 的管理界面，即 http://<server>:<port>/admin 来查看 war 包的部署情况。也可以通过该管理界面进行 war 包的部署。

在 GlassFish 上部署

在 GlassFish 上部署 SuperMap iServer Java  前，请检查软件环境是否满足需求，请参考 war 包部署前的环境配置。

GlassFish 支持自动部署、命令行部署及通过管理界面部署应用程序，有关命令行部署及通过管理界面部署方式请参见 GlassFish 的帮助。下面介绍在 GlassFish 3.1 上自动部署 SuperMap iServer Java 的过程。

启动 GlassFish，将 war 包放入【GlassFish 根目录】\glassfish\domains\【domain-name】\autodeploy 目录下，GlassFish 就可以将 war 包发布为 Web 服务，其中【domain-name】指正在运行的 GlassFish 领域名。对于 iserver#help.war 和 iserver#iClient.war，需要将它们重命名使得名称中不包含特殊符号“#”，如将 iserver#help 改为 help.war。

启动 GlassFish 后，可以通过访问 GlassFish 的管理界面，即 http://<server>:<port>/common/index.jsf （GlassFish 默认的管理端口是 4848）来查看 war 包的部署情况。也可通过该管理界面进行 war 包的部署。

注意：

GlassFish 的运行需要完整的 JDK 而不是 JRE，且需要把 %JAVA_HOME%\Bin 加入 PATH 中。

在 JBoss Application Server 上部署

在 JBoss Application Server 上部署 SuperMap iServer Java 前，请检查软件环境是否满足需求，请参考 war 包部署前的环境配置。

Windows 系统下，在 JBoss 4、JBoss-5.1.0.GA 上部署 SuperMap iServer Java 的过程如下：

1.解压缩 war 包到如下目录：【JBoss 根目录】\server\default\deploy，并重命名，使得解压缩后的文件夹名称以.war 结尾，如将 war 包 iserver.war 解压缩后重命名为 iserver.war。对于 war 包 iserver#help 和 iserver#iClient，还须使解压缩后的文件夹名称中不包含特殊符号“#”，如分别重命名为 help.war 和 iClient.war。

2.将 help.war\html 目录下的 OnlineHelp.zip 解压到当前目录。

3.启动 JBoss，即可将 SuperMap iServer Java 的 war 包发布为 Web 服务。

启动 JBoss 后，可以通过访问 JBoss 的管理界面，即 http://<server>:<port>/admin-console 来查看 war 包的部署情况。也可以通过管理界面进行 war 包的部署。

若在 JBoss 6 中部署 SuperMap iServer Java 服务，需要先删除 %JBoss_HOME%\server\default\deployers 目录下的 resteasy.deployer 文件夹。

注意：

1.在 JBoss 上部署服务时，启动 JBoss 时需要添加-b 0.0.0.0参数，才能在所有的计算机上访问，否则只能在本机访问服务。如 Windows 操作系统上可通过命令行启动 JBoss：

run.bat -b 0.0.0.0

Linux、AIX 操作系统上启动 JBoss 的方法为：

./run.sh -b 0.0.0.0

2.在 JBoss 中部署 SuperMap iServer Java 服务时，建议目录里不要包含非英文字符。

在 Oracle WebLogic Application Server 上部署

在 WebLogic 上部署 SuperMap iServer Java 前，请检查软件环境是否满足需求，请参考 war 包部署前的环境配置。

Windows 系统下，在 WebLogic 上部署 SuperMap iServer Java，包含如下步骤：

1.重命名 iserver#help.war 和 iserver#iClient.war，使得名称中不包含特殊符号“#”，如分别将其重命名为 help.war 和 iClient.war。

2.启动 WebLogic，把 war 包放在创建的 WebLogic 域的 autodeploy 目录下，WebLogic 就可以将 war 包发布为 Web 服务。如 Windows 系统上创建的 WebLogic 域为 C:\wls1033_dev\user_projects\domains\SuperMapiServer，则将 war 包放在 C:\wls1033_dev\user_projects\domains\SuperMapiServer\autodeploy 下。

启动 WebLogic 后，可以通过访问 WebLogic 的管理界面，即 http://<server>:<port>/console 来查看 war 包的部署情况。也可以通过管理界面进行 war 包的部署。

若在部署时遇到 PermGen space 的错误，请将当前所使用 WebLogic 域的 PermSize 设为 256M，具体方法请参见在 WebLogic 上部署 iServer 失败。

在 TongWeb 上部署

在 TongWeb 上部署 Supermap iServer Java 前，请检查软件环境是否满足需求，请参考 war 包部署前的环境配置。

Windows 系统下，在 TongWeb 上部署 Supermap iServer Java，包含如下步骤：

1.为 TongWeb 指定 UGO 的路径，即在【TongWeb 根目录】\bin\startserver.bat 的 Djava.library.path 中加入 UGO 的 bin 路径，如 Djava.library.path=”C:\SMO_Java_602_7119_Bin\Bin”。

2.启动 TongWeb，把 war 包放入如下目录：【TongWeb 根目录】\autodeploy，TongWeb 就可以将 war 包发布为 Web 服务。对于 iserver#help.war 和 iserver#iClient.war，需要将它们重命名使得名称中不包含特殊符号“#”后再部署，如将 iserver#help.war 改为 help.war。

3.在【TongWeb 根目录】\config\twns.xml 中找到 help 和 iClient 对应的 web-app 节点，将 context-root 分别改为 iserver/help 和 iserver/iClient。

启动 TongWeb 后，可以通过访问 TongWeb 的管理界面，即 http://<server>:<port>/twns 来查看 war 包的部署情况。在第2步中也可通过该管理界面进行 war 包的部署。

在 WebSphere Application Server 上部署

在 WebSphere Application Server（WAS）7上部署 SuperMap iServer Java  前，请检查软件环境是否满足需求，请参考 war 包部署前的环境配置。

下面以 AIX 系统为例介绍在 WebSphere Application Server（WAS）7上部署 SuperMap iServer Java 的过程。

1.WAS 启动成功后，浏览器中输入 http://<server>:<port>/ibm/console 登录 WAS 的管理控制台，在 Applications→Application Types→WebSphere enterprise applications 选项卡中，单击 install 即可开始安装，如下图：

用户还可在此界面选择某个服务控制服务的启动/停止状态。

注意：对于 iserver#help.war 和 iserver#iClient.war，需要将它们重命名使得名称中不包含特殊符号“#”，如将 iserver#help.war 改为 help.war。

2. 在如下对话框中，用户可从本地或远程文件系统中选择 war 包进行安装。选择之后单击“Next”按钮；

3.在“Preparing for the application Installation”中可选择“Fast Path”和“Detailed”进行安装，前者是仅当需要其他信息时才提示，后者会显示所有的安装选项和参数。这里选择“Fast Path”，单击“Next”按钮；

4.在“Select Installation options”中指定可用于准备和安装应用程序的各种选项，这里保持默认，单击“Next”按钮；

5.在“Map modules to servers”中将模块映射至服务器，可将模块安装在同一服务器上或安装在几台服务器上，也可以安装在 Web 服务器上。若有多个服务器可以选择，则可选择欲安装的目标服务器，若只有一个服务器，则不用选择，默认安装在当前服务器。单击“Next”按钮；

6.在“Map virtual hosts for Web modules”一步中，若有多个 virtual host，选择欲映射的一个，若只有一个，则可以不选，默认使用当前 virtual host。如下图，单击“Next”按钮；

7.在“Map context root for Web modules”一步中为 Web 应用配置上下文根路径，如下图，SuperMap iServer Java 的核心服务的 Context Root 为 /iserver（如果 iserver.war 被重命名，比如被重命名为 renameiserver.war，则 Context Root 应为/renameiserver）：

OnlineHelp 的 Context Root 为 /iserver/help，客户端软件开发工具包 iClient 的 Context Root 为 /iserver/iClient。

8.在“Summary”一步选择“Finish”，然后在接下来的一步单击“Save”保存配置，如下图：

9. 配置参数 com.ibm.ws.classloader.strict，将其值定义为 true。即单击 Servers→Server Types→WebSphere application servers→“server_name”，然后进入 Java and process management→Process definition→Java virtual machine→Custom properties 界面，单击“New”按钮，如下图所示：

注意：该参数需要在 WebSphere 7.0.0.11 中进行配置，若所使用的版本不是7.0.0.11，请先升级到该版本。

10. 配置完成之后单击“Save”保存配置。

注：本文档完成日期为 2012 年 03 月 20 日 ，如果此前的文档（包括电子文档和印刷文档）与本文档不相符合，请以本文档为准。若本文档更新，则以更新后的文档为准。转自北京超图软件有限公司。