SuperMap iDesktopX
    English11.0.1 GitHub
     /
     /
     /

    产品安装与启动

    Windows系统

    问1：为什么SuperMap iDesktopX 安装到C:\Program Files、C:\Program Files (x86)等系统目录后，虽然桌面可以正常启动，但有些功能（如：修改颜色方案、布局保存到模板库）无法正常使用？

    答： 执行修改颜色方案、保存布局到模板库等功能，会向安装路径写数据。直接双击SuperMap iDesktopX.exe启动桌面时，没有权限向系统目录写数据，因此功能会执行失败。此时，以管理员身份运行 SuperMap iDesktopX.exe 即可解决上述问题。

    问2：为什么使用 SuperMap iDesktopX 无法打开 C:\、C:\Program Files、C:\Program Files (x86) 等系统目录下的数据，也无法将图片、模板等文件保存到系统目录？

    答： 直接双击SuperMap iDesktopX.exe启动桌面时，没有权限读写系统目录下的数据，可以通过以下方式解决此问题：

    • 方案一：将要使用的数据放到非系统目录，更改输出文件的路径为非系统目录；（推荐）
    • 方案二：选中 SuperMap iDesktopX.exe，单击鼠标右键，选择”以管理员身份运行“；
    • 方案三：选中 SuperMap iDesktopX.exe，单击鼠标右键，选择”属性“，更改exe权限为管理员权限，重新运行exe；

    问3：在 Windows 系统中启动 SuperMap iDesktopX，启动失败并报如下错误，同时 error.log 提示“安装路径\SuperMap iDesktopX 10i\bin\WrapjGeo.dll: 找不到指定的程序。”，该怎么解决呢？

    SetupError

    答： 这种情况是由于缺少 Microsoft Visual C++ 运行环境，在产品包安装路径\SuperMap\SuperMap iDesktopX 10i\support文件夹中，双击 vcredist110_x64.exe，成功安装 Microsoft Visual C++ 2012 后，即可正常启动 SuperMap iDesktopX。

    问4：在 Windows Server 系统中，启动 SuperMap iDesktopX 提示下图错误，该怎么解决呢？

    WindowsServerError

    答： 这是由于dll文件加载失败导致的。可以通过以下方法解决：

    1. 再次启动 SuperMap iDesktopX；
    2. 若再次启动 SuperMap iDesktopX 依然报同样的错误，可在产品包\configuration文件夹中，打开 SuperMap.Desktop.Parameter.xml 文件，将“ < loadDll loadDll=“true”/>”中的 true 改为 False ；
    3. 修改之后，重新启动 SuperMap iDesktopX 即可。

    Linux系统

    问1：Linux 系统如何选择不同类型和格式的产品包？

    答：为适应不同Linux系统的计算机CPU架构，桌面Linux版本提供了x86、Arm、龙芯三类产品包，每种类型都有tar、deb、rpm三种格式。产品包的选择方式如下：

    LinuxPackageType

    1. 产品包类型选择：
    2. 若计算机的CPU架构为X86，则应选用x86版本的Linux产品包；
    3. 若计算机的CPU架构为ARM，则应选用arm版本的Linux产品包；
    4. 若计算机的CPU架构为龙芯，则应选用龙芯版本的Linux产品包；
    5. 如何选择产品包的格式：
    6. tar.gz绿色包：解压后即可使用，适用于各种Linux操作系统；
    7. deb安装包：安装后即可使用，适用于Ubuntu、统信等操作系统；
    8. rpm安装包：安装后即可使用，适用于centos等操作系统。

    问2：如何安装/卸载 rpm和deb包？

    答：

    1. rpm 包安装和卸载的命令如下：
    2. 安装命令：rpm -i 需要安装的包文件名
    3. 删除命令：rpm -e supermap-idesktopx
    4. deb 包安装和卸载的命令如下：
    5. 安装命令：dpkg -i 需要安装的包文件名
    6. 删除命令：dpkg -r supermap-idesktopx

    问3：Linux产品包解压/安装过程中失败应该怎么解决？

    答：

    1. 解压过程中若提示“压缩数据已损坏”，请对比产品包的MD5值，确认产品包是否有损坏，若有损坏建议使用完整产品包进行解压/安装；
    2. 若产品包完整无损坏，安装过程中提示安装失败，则需要使用root身份进行安装，默认安装路径为/opt/supermap_idesktopx，否则没有权限。

    问4：启动桌面的是否需要安装图形界面？

    答： 是的，启动桌面的机器必须有图形界面，才能保证桌面的正常启动和使用。通过终端工具（如xshell等）进行远程连接时，需确保被连接的机器中安装了图形界面，若已安装图形界面，通过终端工具去启动桌面，如果启动报如下错误，则需要在终端进行连接图形界面的配置。

    TerminalLackUI

    问5：启动SuperMap iDesktopX时，提示缺少依赖库“libpng12.so.0”或其他依赖库文件。怎么办？

    答： 缺少依赖库可从本机或其他机器拷贝，或在网上下载缺少的依赖库文件，将其放在SuperMap iDesktopX包的bin文件夹中，再启动桌面即可。具体解决步骤如下：

    1. 设置LDLIBRARYPATH环境变量，指向bin：export LDLIBRARYPATH=./bin:$LDLIBRARYPATH
    2. 输入以下命令，确认是否真的缺少指定的依赖库文件（libpng12.so.0）：ldd -d libWrapjGeo.so |grep libpng12.so.0
      若输出：libpng12.so.0 => not found，则表示缺少libpng12.so.0文件。
    3. 输入以下命令，查看操作系统中所有libpng12.so文件：find / -name libpng12.so.*
      若输出如下信息，表示在操作系统中的第三方软件中有这个库文件，可将该文件拷贝到产品包bin目录下，若未找到该文件，则需要通过其他方式获取。

    /snap/core/4917/lib/x86_64-linux-gnu/libpng12.so.0 /snap/core/4917/lib/x86_64-linux-gnu/libpng12.so.0.54.0 /snap/core/4917/usr/lib/x86_64-linux-gnu/libpng12.so.0 /snap/core/5548/lib/x86_64-linux-gnu/libpng12.so.0

    1. 执行以下命令，将libpng12.so.0文件拷贝文件到bin目录中：cp /snap/core/4917/lib/x86_64-linux-gnu/libpng12.so.0
    2. 执行以下命令查看是否还缺少依赖库文件：ldd libWrapj.so |grep no
    3. 未提示缺少依赖库，启动桌面即可。

    问6：在Linux系统中启动 SuperMap iDesktopX 失败，并提示”No X11 DISPLAY variable wasset,……”，如下图，怎么办？

    NoX11Display

    答： 失败原因是没有配置 X11 转发，解决方案为：在命令行窗口输入” export DISPLAY=%电脑ip%:0.0 “，再重新启动 SuperMap iDesktopX 即可。

    问7：在Linux系统中启动 SuperMap iDesktopX 失败，并提示下图所示的信息，怎么办？

    FontMissing

    答： 失败原因是缺少字体库相关的类库，解决方案如下：

    1. 安装 java-1.8.0-openjdk，在命令行窗口执行：yum install java-1.8.0-openjdk；
    2. 将当前使用 jre 环境切换为系统的 jre 环境，将 startup.sh 文件中的” export JRE_PATH=./jre/bin “行注释即可(加#号注释)，如下图： AnnotationJre
    3. 在命令行执行如下命令，安装字体相关的依赖库：yum -y install xorg-x11-xauth xorg-x11-utils xorg-x11-fonts-*
    4. 重新启动桌面即可。

    问8：在Linux系统中运行 SuperMap iDesktopX，界面中的字体显示为方块是什么原因呢？怎么解决？

    答： 这是Linux系统缺失中文字体导致的，将桌面产品包/resources/Fonts/WenQuanYiMicronBlack.ttf 文件，拷贝至当前使用 jre 环境中的jdk安装目录/jre/lib/fonts/fallback 文件夹中，例如：/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.242.b08-1.h5.oe1.x86_64/jre/lib/fonts/fallback文件夹，重新启动桌面，界面文字即可正常显示。

    问9：在Linux系统中运行SuperMap iDesktopX，界面中的字体显示为方块是怎么回事呢。

    答： 这是Linux系统缺失中文字体导致的，在产品包目录下的jre/jre/lib/fonts文件夹中下放置一个中文字体，程序界面文字即可正常显示。

    问10：若 centos5.7 系统配置的 jre 版本早于1.8，无法启动 SuperMap iDesktopX，并且会报错，如何解决该问题呢？

    答： SuperMap iDesktopX 桌面启动需要依赖于 jre 1.8及更新的环境，由于jre版本没有达到要求，所以Java会启动失败，解决方案有以下两种：

    • 方案一：卸载本地安装的旧版本 jre 环境，安装1.8或更新的 jre，然后重新启动 Java即可；
    • 方案二：Java 产品包中带有jre 1.8的环境，启动桌面时会优先考虑本地配置的环境，因此会导致启动失败，若用户不想卸载本地的 jre 环境，可以修改 startup.sh 的脚本，将“export PATH=$SUPERMAPROOT:$LDLIBRARYPATH:$JREPATH:$PATH”中的$JREPATH:放到最前面，即：export PATH=$JREPATH:$SUPERMAPROOT:$LDLIBRARY_PATH:$PATH。重新执行 startup.sh 文件即可启动Java。

    备注 ：该问题在9D版本中已解决，不会出现jre环境过低无法启动的问题。

    问11：为什么在 SUSE Linux Enterprise 11 SP2 操作系统上启动SuperMap iDesktopX 报“libSuGraphicsQT.uge:undefined symbol:_ZN40GDC170gdcUnicodeStringC1EPKw”的错误？

    答： 在 SUSE 上需要安装第三方数据库客户端才能正确加载sdx数据引擎。一个sdx加载失败会影响其他sdx数据引擎的加载，从而导致无法打开任何数据源或程序启动失败。需要依赖第三方数据库客户端的sdx数据引擎文件有：libSuEngineSRDB.sdx、libSuEngineOracle.sdx、libSuEngineDMCI.sdx、libSuEngineOsp.sdx、libSuEngineAltibase.sdx、libSuEngineDB2.sdx、libSuEngineKDB.sdx。例如：如果需要使用 Oracle 数据源，则首先安装 Oracle 客户端，然后删除 libSuEngineOracle.sdx之外的上述所有*.sdx，再启动SuperMap iDesktopX 桌面。以此类推，如果需要使用其他数据库引擎，也进行相应的处理。

    解决方法是：保留产品包内 bin 目录下 libSuEngineImagePlugin.sdx 和需要的数据库引擎文件，删除不需要的数据库引擎文件（上述列表中的*.sdx）。

    问12：若启动桌面报“java.lang.UnsatisfiedLinkError: /opt/SuperMapiDesktopX/bin/ libWrapjGeo.so: /usr/lib64/libstdc++.so.6: version `GLIBCXX3.4.9’ not found (required by ./bin/libSuToolkit.so)”错误，参加如下解决方法：

    答： 将桌面包的 support 文件夹中的 “libstdc++.so.6”文件拷贝到组件的Bin目录下即可解决该问题。

    许可问题

    问1：启动桌面时无法启动，并提示”许可检查失败，请确认许可是否安装成功。“。

    答：出现该情况的原因有三个，一是没有配置许可，二是许可未配置成功，三是许可到期。若是前两个原因，则解决方案为重新配置许可，Windows和Linux操作系统的配置方式不同，具体操作请分别参见Windows配置指南和Linux配置指南中的许可配置。

    问2：Linux系统如何选择许可？

    答： SuperMap提供了文件许可、硬件许可、公有云许可、私有云许可四种类型。龙芯和ARM格式的产品包，不支持硬件许可，计算机若可以连接网络，则可使用共有云许可；若计算机可无法连接网络，单可访问局域网，则可部署私有云许可。

    桌面启动

    问1：程序在运行过程中的信息会输出到日志吗？日志存放在哪里？

    答： 输出的日志有两种，一个是 SuperMap iDesktopX 的log，一个是 SuperMap iObjects 的log，分别记录了桌面和组件运行输出的信息，日志中的内容包括程序输出窗口的输出信息、异常信息等内容。日志存放在根目录下的“bin”目录下的“log”文件夹中。

    问2：在启动 iDesktopX 桌面后，输出窗口提示“xx 插件加载失败！” 是什么原因？

    答： iDesktopX 存在以下几种情况会提示加载插件失败，以 SuperMap.Desktop.Dashboard 插件为例:

    1. 当 SuperMap.Desktop.Dashboard.config 配置文件中 enabled 属性设置为“false”时，SuperMap.Desktop.Dashboard 插件加载失败！
      原因 ：enabled属性用于设置插件是否可见，设置为“false” 后，插件不可见。
      Plugin enable
    2. 当 SuperMap.Desktop.Dashboard.config 配置文件中 level 属性设置为 1时，SuperMap.Desktop.Dashboard 插件加载失败！
      原因 ：level 属性用于设置插件等级，除核心插件 Controls 等级为1外，其他插件等级为 2-10 的整数，一般设置为5。
      Plugin level
    3. 当 SuperMap.Desktop.Dashboard.config 配置文件正确且存在，但是 对应 jar 包不存在 ，会引起 SuperMap.Desktop.Dashboard 插件加载失败！
      原因 ：在安装路径\bundles\idesktop_bundles 目录下不存在 Dashboard.jar 包，因此该插件无法加载。
    4. 当 SuperMap.Desktop.Dashboard.config 配置文件中 pluginClassName 与 jar 包中的插件类名不一致 ，导致 SuperMap.Desktop.Dashboard 插件加载失败！
      原因 ：根据 pluginClassName 属性值“com.supermap.desktop.dashboard.DashboardPlugin”，未匹配到对应插件类。
      Plugin Name
    5. 插件类 DashboardPlugin 中构造函数构造失败 ，导致 SuperMap.Desktop.Dashboard 插件加载失败！
      原因 : 在插件类 com.supermap.desktop.dashboard.DashboardPlugin 的构造函数中出现异常，导致构造失败。
    6. 许可 中没有包含大屏插件的许可，导致 SuperMap.Desktop.Dashboard 插件加载失败！
      原因 : 插件 SuperMap.Desktop.Dashboard 在当前许可无法加载！
    7. 除以上原因外导致 SuperMap.Desktop.Dashboard 插件加载失败！
      原因 : SuperMap.Desktop.Dashboard插件在构建的过程中失败。