war 包的部署
SuperMap iServer Java 的 iserver.war 包部署成功后,访问的 URI 为:http://<server>:<port>/iserver/services。若 iserver.war 被重命名,比如被重命名为 renameiserver.war,则需要修改 URI 为 http://<server>:<port>/renameiserver/services。
在 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”保存配置。