SuperMap iobjects Java 7C tar 包 使 用 指 南 北 京 超 图 软 件 股 份 有 限 公 司 2014 年 5 月 北 京
法 律 声 明 本 资 料 的 版 权 为 北 京 超 图 软 件 股 份 有 限 公 司 所 有, 受 中 华 人 民 共 和 国 著 作 权 法 和 著 作 权 国 际 公 约 的 保 护 未 经 北 京 超 图 软 件 股 份 有 限 公 司 书 面 许 可, 不 得 以 任 何 方 式 或 理 由 对 该 资 料 的 任 何 部 分 进 行 使 用 复 制 修 改 抄 录 传 播 或 与 其 它 产 品 捆 绑 使 用 销 售, 侵 权 必 究 超 图 SuperMap 以 及 为 北 京 超 图 软 件 股 份 有 限 公 司 的 注 册 商 标, 受 法 律 保 护 未 经 北 京 超 图 软 件 股 份 有 限 公 司 书 面 许 可, 不 得 以 任 何 方 式 或 理 由 对 该 商 标 的 任 何 部 分 进 行 使 用 复 制 修 改 传 播 或 与 其 它 产 品 捆 绑 使 用 销 售, 侵 权 必 究 本 资 料 并 不 代 表 供 应 商 及 其 代 理 的 承 诺, 北 京 超 图 软 件 股 份 有 限 公 司 可 在 不 作 任 何 声 明 的 情 况 下 对 本 资 料 进 行 修 改 本 资 料 中 提 到 其 他 公 司 和 产 品 的 商 标 所 有 权 为 该 公 司 所 有 未 经 该 权 利 人 的 书 面 同 意, 不 得 以 任 何 方 式 或 理 由 进 行 使 用 复 制 修 改 抄 录 传 播 本 资 料 中 所 涉 及 的 软 件 产 品 及 其 后 续 升 级 产 品 均 由 北 京 超 图 软 件 股 份 有 限 公 司 研 发 销 售 特 此 声 明 北 京 超 图 软 件 股 份 有 限 公 司 地 址 : 北 京 市 朝 阳 区 酒 仙 桥 北 路 甲 10 号 院 电 子 城 IT 产 业 园 107 楼 6 层 邮 编 :100015 电 话 :+86-10-59896655 传 真 :+86-10-59896666 技 术 支 持 与 客 户 监 督 热 线 :400-8900-866 技 术 支 持 电 子 邮 箱 :support@supermap.com 客 户 监 督 电 子 邮 箱 :cs@supermap.com 网 址 :http://www.supermap.com.cn SuperMap 欢 迎 您 的 宝 贵 建 议 和 意 见
前 言 欢 迎 使 用 SuperMap iobjects Java 7C 本 文 档 包 含 : 系 统 配 置 要 求 产 品 部 署 许 可 配 置 说 明 产 品 本 地 目 录 说 明 常 见 问 题 解 答 本 文 档 主 要 介 绍 产 品 的 安 装 要 准 备 安 装, 用 户 应 查 看 系 统 配 置 要 求, 了 解 管 理 权 限 需 求, 获 取 到 本 产 品 的 合 法 许 可 要 安 装 产 品, 用 户 必 须 具 有 管 理 员 权 限 有 关 管 理 权 限 的 信 息, 请 向 系 统 管 理 员 咨 询 本 文 档 最 后 修 订 时 间 为 2014 年 4 月 I
目 录 1 系 统 配 置 要 求... 2 1.1 硬 件 要 求... 2 1.1.1 最 低 硬 件 要 求... 2 1.1.2 推 荐 硬 件 要 求... 2 1.2 软 件 要 求... 2 2 产 品 部 署... 5 2.1 获 取 产 品 包... 5 2.2 产 品 部 署... 5 2.3 卸 载 产 品... 6 3 许 可 配 置 说 明... 7 3.1 获 取 许 可... 7 3.1.1 试 用 许 可... 7 3.1.2 正 式 许 可... 7 3.2 安 装 许 可 驱 动... 8 3.3 配 置 许 可... 9 3.3.1 配 置 软 许 可... 9 3.3.2 配 置 硬 件 许 可... 9 4 产 品 本 地 目 录 说 明... 11 5 常 见 问 题 解 答... 13 I
1 1 系 统 配 置 要 求 1.1 硬 件 要 求 1.1.1 最 低 硬 件 要 求 处 理 器 :1.00 GHz 内 存 :512 MB 硬 盘 :40 GB 1.1.2 推 荐 硬 件 要 求 处 理 器 :2.00 GHz 以 上 主 频 内 存 :1 GB 硬 盘 容 量 :100 GB 1.2 软 件 要 求 操 作 系 统 要 求 : Red Hat(Red Hat Enterprise Linux 5.4 及 以 上 6.x) SUSE(SUSE Linux Enterprise Server 10 SP2 及 以 上 11.x) 红 旗 Asianux Server 3 麒 麟 操 作 系 统 服 务 器 版 5.0 6.0 CentOS 5.6 及 以 上 6.x Ubuntu 10.04 及 以 上
1 系 统 配 置 要 求 3 其 他 软 件 要 求 : 开 发 用 户 需 要 安 装 Eclipse 3.2 及 以 上 版 本 或 者 其 它 开 发 工 具 JDK 1.6 或 以 上 版 本 对 数 据 库 的 支 持 : Oracle 9i/10g/11g/12c PostgreSQL 8.3 及 以 上 版 本 DB2 9.7/DB2 10.5 北 京 超 图 软 件 股 份 有 限 公 司
2 2 产 品 部 署 SuperMap iobjects Java 7C for Linux 产 品 以 tar 包 的 形 式 提 供, 方 便 用 户 快 速 部 署 产 品 运 行 环 境 与 开 发 环 境, 无 需 用 户 进 行 传 统 的 安 装 过 程 下 面 介 绍 如 何 通 过 SuperMap iobjects Java 7C tar 包, 完 成 SuperMap iobjects Java 7C for Linux 产 品 的 部 署 2.1 获 取 产 品 包 SuperMap iobjects Java 7C for Linux 产 品 以 tar 包 的 形 式 提 供, 您 可 以 通 过 如 下 两 种 方 式 获 取 SuperMap iobjects Java 7C for Linux 产 品 包 : 购 买 SuperMap iobjects Java 7C for Linux 产 品 即 可 获 取 相 应 的 产 品 安 装 光 盘 进 入 超 图 软 件 官 网 平 台 软 件 下 载 专 区 ( http://support.supermap.com.cn/productcenter/downloadcenter/productplatform.aspx ) 进 行 下 载, 具 体 路 径 为 官 网 首 页 > 技 术 资 源 中 心 > 软 件 下 载 > 平 台 软 件, 即 可 找 到 SuperMap iobjects Java 7C for Linux 产 品 包 2.2 产 品 部 署 1. SuperMap iobjects Java 7C tar 包 的 提 供 形 式 是 一 个 压 缩 包, 首 先, 需 要 将 压 缩 包 解 压 到 计 算 机 的 某 个 路 径 下, 该 路 径 将 作 为 产 品 应 用 程 序 所 在 的 路 径 ; 2. 在 产 品 根 目 录 下 Tools 文 件 夹 中,SetEnv.sh 文 件 用 来 实 现 部 署 SuperMap iobjects Java 7C for Linux 运 行 和 开 发 环 境, 以 及 安 装 许 可 驱 动 和 为 期 90 天 的 试 用 许 可 在 终 端 中 运 行 SetEnv.sh 文 件, 命 令 行 如 下 所 示, 注 意 在 运 行 SetEnv.sh 文 件 前, 需 要 以 root 用 户 登 录, 并 切 换 当 前 路 径 为 产 品 的 Tools 目 录, 然 后 再 执 行 下 面 的 命 令 ;./SetEnv.sh 1. 执 行 source 命 令, 使 产 品 部 署 生 效, 命 令 行 如 下 所 示 : source /etc/profile
6 2 产 品 部 署 2. 如 果 用 户 需 要 使 用 产 品 提 供 的 示 范 程 序 源 代 码, 还 需 要 完 成 本 步 骤 的 操 作 在 产 品 根 目 录 下 的 Tools 文 件 夹 中,LibReplace 文 件 可 以 实 现 将 示 范 程 序 编 译 所 需 库 (jar 文 件 ) 的 引 用 指 到 产 品 应 用 程 序 的 Bin 目 录, 该 LibReplace 文 件 为 Shell 脚 本, 通 过 如 下 命 令 行 运 行 注 意 在 运 行 LibReplace 文 件 前, 需 要 以 root 用 户 登 录, 并 切 换 当 前 路 径 为 产 品 的 Tools 目 录, 还 需 要 给 予 LibReplace 文 件 权 限, 然 后 才 可 直 接 运 行 该 脚 本 文 件 赋 予 LibReplace 文 件 权 限 的 命 令 行 : chmod +x LibReplace 以 命 令 行 方 式 运 行 LibReplace 文 件 :./LibReplace 上 述 的 操 作 可 以 实 现 通 过 SuperMap iobjects Java 7C for Linux tar 包 进 行 SuperMap iobjects Java 7C for Linux 部 署, 可 以 说 是 完 全 部 署, 此 时, 用 户 可 以 开 始 使 用 SuperMap iobjects Java 7C for Linux 2.3 卸 载 产 品 如 果 用 户 想 清 除 对 SuperMap iobjects Java 7C for Linux 运 行 环 境 和 开 发 环 境 的 部 署, 即 卸 载 SuperMap iobjects Java 7C for Linux, 可 以 通 过 在 终 端 中 运 行 产 品 Tools 目 录 下 的 UnsetEnv.sh 文 件, 可 以 将 部 署 的 内 容 进 行 清 除 :./SetEnv.sh 同 时, 要 使 清 除 操 作 生 效, 需 要 执 行 source 命 令, 如 下 所 示 : source /etc/profile SuperMap iobjects Java 7C tar 包 使 用 指 南
3 3 许 可 配 置 说 明 3.1 获 取 许 可 使 用 SuperMap iobjects Java 7C for Linux 需 要 拥 有 该 产 品 许 可,SuperMap GIS 7C 产 品 许 可 分 为 试 用 许 可 和 正 式 许 可 3.1.1 试 用 许 可 试 用 许 可 不 需 要 用 户 单 独 获 取,SuperMap GIS 7C 系 列 产 品 默 认 提 供 了 90 天 的 试 用 许 可 用 户 只 要 完 成 SuperMap iobjects Java 7C for Linux 产 品 的 部 署, 或 者 安 装 许 可 驱 动, 即 可 获 得 试 用 许 可 3.1.2 正 式 许 可 正 式 许 可 的 提 供 形 式 有 两 种 : 软 许 可 和 硬 件 许 可 硬 件 许 可 又 分 为 单 机 加 密 锁 和 网 络 加 密 锁 用 户 通 过 配 置 许 可, 即 可 使 正 式 许 可 生 效 1. 软 许 可 软 许 可, 是 以 离 线 或 在 线 方 式 获 得 合 法 的 软 件 运 行 许 可, 激 活 到 本 机, 即 可 生 效 软 许 可 分 为 单 机 软 许 可 和 网 络 软 许 可 如 果 激 活 单 机 软 许 可, 则 只 能 为 本 机 提 供 许 可 服 务 ; 如 果 激 活 网 络 软 许 可, 则 可 以 为 当 前 网 络 中 的 计 算 机 提 供 许 可 服 务 2. 硬 件 许 可 硬 件 许 可 是 以 硬 件 加 密 锁 ( 简 称 硬 件 锁 ) 的 形 式 获 得 合 法 的 软 件 运 行 许 可 目 前 SuperMap 硬 件 锁 的 生 产 厂 家 为 SafeNet 硬 件 锁 分 为 以 下 两 种 : 单 机 锁 单 机 锁 只 提 供 一 个 授 权 许 可, 需 与 SuperMap GIS 产 品 安 装 在 同 一 台 计 算 机 上 单 机 锁 外 观 为 绿 色 磨 砂
8 3 许 可 配 置 说 明 网 络 锁 网 络 锁 可 安 装 在 网 络 中 任 意 一 台 计 算 机 上, 可 以 提 供 多 个 授 权 许 可 安 装 有 网 络 锁 的 计 算 机 称 为 许 可 服 务 器, 网 络 中 许 可 范 围 内 的 客 户 端 无 论 是 否 安 装 许 可 驱 动 都 能 使 用 该 网 络 锁 网 络 锁 的 外 观 为 红 色 磨 砂 获 得 正 式 许 可 的 途 径 : 购 买 SuperMap GIS 产 品 即 可 获 得 许 可 签 约 合 作 伙 伴 请 联 系 超 图 软 件 合 作 伙 伴 部, 电 话 :+86-10-59896655 转 6167 用 户 及 其 他 合 作 伙 伴 请 联 系 超 图 软 件 销 售 人 员, 电 话 :+86-10-59896655 转 6156 3.2 安 装 许 可 驱 动 在 Linux 操 作 系 统 下, 支 持 软 许 可 和 硬 件 许 可, 但 都 必 须 安 装 驱 动 程 序, 所 有 的 许 可 验 证 都 是 通 过 驱 动 的 方 式 进 行 通 信 除 了 安 装 驱 动 程 序 外, 不 再 需 要 配 置 许 可, 驱 动 程 序 启 动 之 后 将 会 自 动 查 找 本 机 或 者 网 内 的 所 有 可 用 硬 件 锁 或 软 许 可 注 意 许 可 配 置 过 程 需 要 以 root 身 份 进 行 Linux 平 台 下, 许 可 驱 动 程 序 分 别 在 SuperMap GIS 7C 系 列 产 品 的 产 品 包 中 以 tar 包 的 形 式 提 供 若 使 用 SuperMap iobjects Java 7C tar 包, 许 可 驱 动 程 序 位 于 SuperMap iobjects Java 7C tar 包 解 压 后 的 Support 目 录 下, 名 称 为 :aksusbd-2.2.1-i386.tar 进 入 产 品 包 中 许 可 驱 动 程 序 (aksusbd-2.2.1-i386.tar) 所 在 的 目 录 下, 请 按 以 下 步 骤 执 行 相 关 命 令, 完 成 许 可 驱 动 的 安 装 : 1. 解 压 缩 命 令 如 下 : tar -xvf aksusbd-2.2.1-i386.tar 2. 进 入 解 压 后 的 文 件, 执 行 如 下 命 令, 安 装 驱 动 程 序 :./dinst 或 者 sh dinst 3. 安 装 完 该 驱 动 程 序 后 就 可 获 得 90 天 的 试 用 许 可, 即 可 使 用 SuperMap GIS 7C 系 列 产 品 如 果 dinst 没 有 可 执 行 权 限, 请 授 予 执 行 权 限, 执 行 如 下 命 令 : chmod +x dinst SuperMap iobjects Java 7C tar 包 使 用 指 南
3 许 可 配 置 说 明 9 3.3 配 置 许 可 3.3.1 配 置 软 许 可 不 同 于 Windows 平 台 下 的 界 面 化 配 置, 在 Linux 平 台 下, 是 通 过 com.supermap.license.jar 以 命 令 行 方 式 来 完 成 软 许 可 配 置 的 com.supermap.license.jar 位 于 SuperMap iobjects Java 7C tar 包 解 压 后 的 Bin 目 录 下, 执 行 相 关 的 命 令 时, 请 先 进 入 该 目 录 下, 并 确 保 Bin 目 录 以 添 加 到 LD_LIBRARY_PATH 环 境 变 量 中 执 行 如 下 命 令, 可 以 查 看 配 置 软 许 可 的 相 关 命 令 : java -jar com.supermap.license.jar -help 在 Linux 平 台 下,SuperMap 目 前 提 供 的 软 许 可 配 置 方 式 为 软 件 激 活 使 用 软 件 激 活 方 式 配 置 许 可 的 步 骤 如 下 : 1. 获 取 本 机 信 息, 执 行 如 下 命 令 并 指 定 生 成 的 本 机 信 息 文 件 所 存 放 的 路 径, 在 指 定 的 路 径 下 生 成 *.c2v 文 件 java -jar com.supermap.license.jar -create / 路 径 名 /*.c2v 2. 将 本 机 信 息 提 交 给 超 图 软 件 将 上 面 步 骤 生 成 的 本 机 信 息 文 件 (*.c2v) 提 交 给 超 图 软 件, 超 图 软 件 将 根 据 您 的 申 请 生 成 *.v2c 正 式 许 可 文 件 并 返 回 给 您, 您 通 过 该 文 件 配 置 正 式 许 可 3. 许 可 生 效, 将 您 获 得 的 *.v2c 正 式 许 可 文 件 指 定 到 文 件 位 置, 执 行 如 下 命 令 : java -jar com.supermap.license.jar - update / 路 径 名 /*.v2c 注 意 在 许 可 服 务 器 上 激 活 网 络 软 许 可 后, 无 法 转 移 该 网 络 软 许 可 3.3.2 配 置 硬 件 许 可 在 您 进 行 许 可 配 置 之 前, 请 确 保 已 经 获 得 北 京 超 图 软 件 股 份 有 限 公 司 的 授 权 许 可 如 果 当 前 网 络 或 网 段 中 找 不 到 可 用 的 硬 件 锁 许 可, 请 按 照 以 下 步 骤 进 行 许 可 配 置 : 1. 打 开 浏 览 器, 访 问 http://localhost:1947 或 http:// 本 地 IP:1947 北 京 超 图 软 件 股 份 有 限 公 司
10 3 许 可 配 置 说 明 2. 在 左 侧 Options 中 选 择 Configuration 3. 在 右 侧 选 择 Access to Remote License Managers 选 项 卡 4. 在 Specify Search Parameters 填 入 其 他 网 段 的 许 可 服 务 器 IP, 点 击 Submit 5. 稍 等 几 分 钟 就 可 以 在 左 侧 Options 中 的 Sentinel Keys 选 项 下 看 到 该 服 务 器 的 加 密 锁 了 许 可 状 态 的 查 询 也 可 以 通 过 执 行 如 下 命 令 进 行 查 看 : java -jar com.supermap.license.jar -s 注 意 1. 硬 件 锁 插 入 计 算 机 后, 锁 上 的 信 号 指 示 灯 点 亮 说 明 硬 件 锁 有 效 2. 在 Linux 操 作 系 统 下, 需 要 安 装 加 密 锁 的 驱 动 程 序, 硬 件 加 密 锁 才 能 插 入 并 被 识 别 如 果 使 用 单 机 锁, 请 在 本 机 安 装 加 密 锁 的 驱 动 程 序 ; 如 果 使 用 网 络 锁, 则 必 须 在 许 可 服 务 器 上 安 装 加 密 锁 驱 动 程 序 3. 对 于 两 种 硬 件 锁, 在 同 一 台 计 算 机, 会 优 先 使 用 单 机 锁 4. 如 果 在 虚 拟 机 上 使 用 硬 件 锁, 需 要 通 过 虚 拟 机 软 件 的 相 关 设 置 将 硬 件 锁 设 备 连 接 到 虚 拟 机 上 SuperMap iobjects Java 7C tar 包 使 用 指 南
4 4 产 品 本 地 目 录 说 明 下 内 容 : SuperMap iobjects Java 7C for Linux 产 品 完 整 tar 包 在 正 常 解 压 完 成 后, 在 产 品 安 装 路 径 下, 将 有 以 Bin 文 件 夹 : 存 放 SuperMap iobjects Java 7C for Linux 系 统, 各 种 动 态 库 语 言 包 和 资 源 文 件 FrameData 文 件 夹 : 存 放 三 维 场 景 默 认 加 载 的 基 础 框 架 数 据, 包 括 : 全 球 影 像 数 据 全 球 地 形 数 据 以 及 全 球 矢 量 数 据 GettingStarted 文 件 夹 : 存 放 产 品 入 门 的 程 序 代 码 以 及 产 品 入 门 手 册 (Getting Started with SuperMap iobjects Java.pdf) Help 文 件 夹 : 存 放 联 机 帮 助 文 档 jre1.6 文 件 夹 : 存 放 jre 1.6 License 文 件 夹 : 存 放 依 赖 第 三 方 库 的 许 可 声 明 文 件 SampleCode 文 件 夹 : 存 放 SuperMap iobjects Java 7C 的 范 例 程 序 代 码
12 5 产 品 本 地 目 录 说 明 SampleData 文 件 夹 : 存 放 示 范 数 据, 作 为 范 例 程 序 和 产 品 入 门 的 操 作 数 据 Support 文 件 夹 : 存 放 许 可 驱 动 安 装 程 序 和 字 体 Tools 文 件 夹 : 存 放 辅 助 工 具 辅 助 工 具 的 详 细 说 明 请 参 见 该 文 件 夹 下 的 ToolsDescription.txt InstallationGuide.pdf 文 件 :SuperMap iobjects Java 7C for Linux 产 品 的 安 装 指 南, 包 括 安 装 应 用 程 序 的 系 统 配 置 要 求 产 品 部 署 许 可 配 置 安 装 产 品 后 本 地 目 录 说 明 等 License.txt 文 件 : 产 品 的 许 可 协 议 StartHere.txt 文 件 : 对 产 品 部 署 和 清 除 部 署 的 简 要 说 明 What_is_new.htm 文 件 : 当 前 版 本 产 品 新 特 性 的 介 绍 SuperMap iobjects Java 7C tar 包 使 用 指 南
5 5 常 见 问 题 解 答 问 : 使 用 Oracle 数 据 引 擎 有 哪 些 注 意 事 项? 答 : 置 : 如 果 使 用 过 程 中 用 到 Oracle 数 据 引 擎, 请 安 装 Oracle 数 据 库, 并 在 系 统 的 profile 文 件 中 做 如 下 设 LD_LIBRARY_PATH= $ORACLE_LIB:$LD_LIBRARY_PATH export LD_LIBRARY_PATH export PATH=$LD_LIBRARY_PATH:$PATH 然 后, 执 行 source 命 令, 使 该 设 置 生 效 source /etc/profile 设 置 完 成 后, 执 行 echo 命 令 检 查 一 下 是 否 设 置 成 功 echo $PATH echo $LD_LIBRARY_PATH echo $LIBPATH( 当 操 作 系 统 为 AIX 时 ) 问 : 为 什 么 中 文 字 体 无 法 正 确 显 示? 答 : 执 行 : 由 于 在 安 装 过 程 中 会 使 用 到 Java 虚 拟 机 (JVM), 它 在 显 示 中 文 时 可 能 会 出 现 乱 码, 按 照 以 下 步 骤 在 JDK 安 装 路 径 的 jre/lib/fonts 目 录 下 新 建 一 个 名 为 fallback 文 件 夹 例 如,JDK 的 安 装 路 径 为 /opt/jdk1.6.0_14/, 在 终 端 中 输 入 以 下 命 令 : cd /opt/jdk1.6.0_14/jre/lib/fonts mkdir fallback 注 意 文 件 夹 的 名 字 不 能 更 改, 只 能 为 fallback
14 5 常 见 问 题 解 答 将 产 品 包 中 提 供 的 微 软 雅 黑 字 体 (MSYH.TTF)( 字 体 文 件 位 于 产 品 根 目 录 下 Support 文 件 夹 中 ) 拷 贝 到 fallback 文 件 夹 内 即 可, 不 用 执 行 安 装 操 作 例 如 tar 包 解 压 后 的 路 径 为 :/home/map/, 在 终 端 上 继 续 输 入 以 下 命 令 : cp /home/map/support/fonts/msyh.ttf /opt/jdk1.6.0_14/jre/lib/fonts/fallback/ SuperMap iobjects Java 7C tar 包 使 用 指 南