Product Installation, Configuration, and Startup

Windows System

   
Q1: Why can SuperMap iDesktopX be installed to system directories such as C:\Program Files, C:\Program Files (x86), etc.? Although the desktop starts normally, some features (e.g., modifying color, saving layout to template library) cannot be used properly?
A: Functions like modifying color or saving layout to template library write data to the installation path. When starting iDesktopX by double-clicking SuperMap iDesktopX.exe, there is no permission to write data to system directories, causing these functions to fail. Running SuperMap iDesktopX.exe as administrator resolves this issue.
Q2: Why can't SuperMap iDesktopX open data in system directories like C:\, C:\Program Files, C:\Program Files (x86), or save images and templates to these directories?
A:

When starting by double-clicking SuperMap iDesktopX.exe, there is no permission to read/write data in system directories. Solutions include:

  • Option 1: Move data to a non-system directory and change output paths to non-system directories (recommended);
  • Option 2: Right-click SuperMap iDesktopX.exe and select "Run as administrator";
  • Option 3: Right-click SuperMap iDesktopX.exe, select "Properties," change permissions to administrator, then rerun the executable.
Q3: When starting SuperMap iDesktopX on Windows, it fails with the error below. Additionally, error.log shows "Installation path\SuperMap iDesktopX\bin\WrapjGeo.dll: The specified program could not be found." How to resolve this?

A:

This occurs due to missing Microsoft Visual C++ runtime. In the product installation path\SuperMap\SuperMap iDesktopX\support folder, double-click vcredist110_x64.exe. After successfully installing Microsoft Visual C++ 2012, SuperMap iDesktopX will start normally.

Q4: On Windows Server systems, starting SuperMap iDesktopX shows the error below. How to resolve it?

A:

This is caused by failed DLL loading. Solutions:

  1. Restart SuperMap iDesktopX;
  2. If the error persists, open the SuperMap.Desktop.Parameter.xml file in the product package\configuration folder, change "<loadDll loadDll="true"/>" to False;
  3. After modification, restart SuperMap iDesktopX.

Linux System

   
Q1: How to select different types and formats of product packages for Linux systems?
A:

To accommodate different Linux system CPU architectures, the Linux desktop version provides x86, Arm, and Loongson product packages, each in tar, deb, and rpm formats. Selection criteria:

1. Package type selection:

  • For X86 CPU architectures, use x86 Linux packages;
  • For ARM CPU architectures, use arm Linux packages;
  • For Loongson CPU architectures, use Loongson Linux packages.

2. Package format selection:

  • tar.gz green package: Extract and use directly, compatible with all Linux OS;
  • deb installation package: Install and use, suitable for Ubuntu, Kylin, UOS, etc.;
  • rpm installation package: Install and use, suitable for NeoKylin, CentOS, etc.
Q2: How to install/uninstall rpm and deb packages?
A:

1. Commands for rpm package installation and removal:

  • Installation command: rpm -i filename_of_package_to_install
  • Removal command: rpm -e supermap-idesktopx

Commands for deb package installation and removal:

  • Installation command: dpkg -i filename_of_package_to_install
  • Removal command: dpkg -r supermap-idesktopx
Q3: How to resolve failures during Linux package extraction/installation?
A: 1. If "corrupted compressed data" appears during extraction, verify the package's MD5 value. If damaged, use a complete package.
2. If the package is intact but installation fails with "failed to install it," use root privileges for installation. The default path is /opt/supermap_idesktopx; otherwise, permissions are insufficient.
Q4: Is a graphical interface required to start iDesktopX?
A: Yes, the machine must have a graphical interface for normal startup and use of the desktop. When remotely connecting via terminal tools (e.g., Xshell), ensure the connected machine has a graphical interface. If installed but startup fails with the error below, configure graphical interface connection in the terminal.

Q5: When starting SuperMap iDesktopX, it reports missing dependency libraries like "libpng12.so.0." How to resolve?
A: Method 1: Copy missing libraries from local/other machines or download them online. Place in the bin folder of the SuperMap iDesktopX package and restart. Steps:
  1. Set LD_LIBRARY_PATH environment variable to point to bin: export LD_LIBRARY_PATH=./bin:$LD_LIBRARY_PATH
  2. Confirm missing library (e.g., libpng12.so.0): ldd -d libWrapjGeo.so |grep libpng12.so.0
    If output: libpng12.so.0 => not found, the file is missing.
  3. Search for libpng12.so files in the OS: find / -name libpng12.so.*
    If output shows files (e.g., /snap/core/4917/lib/x86_64-linux-gnu/libpng12.so.0), copy to bin. If not found, obtain elsewhere.
  4. Copy libpng12.so.0 to bin: cp /snap/core/4917/lib/x86_64-linux-gnu/libpng12.so.0 ./bin
  5. Check for other missing libraries: ldd libWrapj.so |grep no
  6. If no missing libraries, start iDesktopX.
Method 2: Execute the systemlibs_check.sh file in root directory/support/systemlibs/third_libs/, then restart the desktop.
Q6: Starting SuperMap iDesktopX on Linux fails with "No X11 DISPLAY variable was set,……" as shown. How to resolve?

A: Failure is due to unconfigured X11 forwarding. Solution: In the command line, enter "export DISPLAY=%computer_ip%:0.0", then restart SuperMap iDesktopX.
Q7: Starting SuperMap iDesktopX on Linux fails with the error below. How to resolve?

A: Failure is due to missing font-related libraries. Solutions:

1. Install java-1.8.0-openjdk: Execute in command line: yum install java-1.8.0-openjdk;

2. Switch to the system's JRE environment: Comment out "export JRE_PATH=./jre/bin" in startup.sh (add #), as shown:

3. Install font dependencies: yum -y install xorg-x11-xauth xorg-x11-utils xorg-x11-fonts-*

4. Restart iDesktopX.

Q8: When running SuperMap iDesktopX on Linux, interface fonts display as squares. Why and how to resolve?
A: This is caused by missing Chinese fonts in the Linux system. Copy the desktop product package/resources/Fonts/WenQuanYiMicronBlack.ttf file to the jdk_installation_directory/jre/lib/fonts/fallback folder of the current JRE environment (e.g., /usr/lib/jvm/java-1.8.0-openjdk-1.8.0.242.b08-1.h5.oe1.x86_64/jre/lib/fonts/fallback). Restart iDesktopX to display text normally.
Q9: When running SuperMap iDesktopX on Linux, interface fonts display as squares. What is the reason?
A: This is caused by missing Chinese fonts in the Linux system. Place a Chinese font in the jre/jre/lib/fonts folder under the product package directory to display interface text normally.
Q10: Why does starting SuperMap iDesktopX on SUSE Linux Enterprise 11 SP2 report "libSuGraphicsQT.uge:undefined symbol:_ZN40GDC170gdcUnicodeStringC1EPKw" error?
A:

On SUSE, third-party database clients must be installed to load SDX data engines correctly. Failure of one SDX engine affects others, preventing data source access or startup. SDX engines requiring third-party clients include: libSuEngineSRDB.sdx, libSuEngineOracle.sdx, libSuEngineDMCI.sdx, libSuEngineOsp.sdx, libSuEngineAltibase.sdx, libSuEngineDB2.sdx, libSuEngineKDB.sdx. For example, to use Oracle data sources, first install the Oracle client, then delete all *.sdx files except libSuEngineOracle.sdx before starting SuperMap iDesktopX. Apply similar steps for other databases.

Solution: Keep libSuEngineImagePlugin.sdx and required database engine files in the bin directory of the product package, and delete unneeded *.sdx files from the list above.

Q11: If startup reports "java.lang.UnsatisfiedLinkError: /opt/SuperMap_idesktopx/bin/ libWrapjGeo.so: /usr/lib64/libstdc++.so.6: version `GLIBCXX_3.4.9' not found (required by ./bin/ libSuToolkit.so)" error, refer to the solution below:
A: Copy the "libstdc++.so.6" file from the support folder of the desktop package to the Bin directory of the component to resolve the issue.
Q12: On Linux systems, software startup may fail due to missing or incompatible system libraries, preventing normal operation.
A:

Download the systemlibs compressed package corresponding to the OS fromhttps://pan.baidu.com/s/1-ohLlVdnoYfxF_uzkCD8DA?pwd=9rrb, extract it, copy missing libraries to the root directory/support/browser folder, and restart the software.

Example: If starting on Linux64 reports "version 'NSS_3.65' not found (required by /lib64/libsmime3.so", download linux64_systemlibs.tar.gz from the link, extract it, copy libsmime3.so to root directory/support/browser, and restart.

Q13: If centos5.7 system uses a JRE version earlier than 1.8, SuperMap iDesktopX fails to start with errors. How to resolve?
A:

SuperMap iDesktopX requires JRE 1.8 or newer. Since the JRE version is insufficient, Java fails to start. Solutions:

  • Option 1: Uninstall the old JRE and install JRE 1.8 or newer, then restart;
  • Option 2: Modify the startup.sh script by moving "$JRE_PATH:" to the front in "export PATH=$SUPERMAP_ROOT:$LD_LIBRARY_PATH:$JRE_PATH:$PATH" to become "export PATH=$JRE_PATH:$SUPERMAP_ROOT:$LD_LIBRARY_PATH:$PATH". Rerun startup.sh.

Note: This issue is resolved in version 9D, eliminating JRE compatibility problems.

Q14: When running the startup script on a hardware environment with UOS (Union Operating System) and Zhaoxin CPU, the system returns error code 33.
A:
  1. Troubleshooting & Isolating the Installation Package Issue: The product package can be extracted normally, and the package integrity is confirmed. The focus shifts to the runtime environment.
  2. Verifying the Runtime Environment:

    • Test 1: Check the Java Runtime Environment (JRE) Attempt to execute the command: ./[Product_Package_Path]/jre/bin/java -version. If the command fails, it indicates a missing or permission-related issue in the base runtime environment. Proceed to Test 2.

    • Test 2: Check Dynamic Library Dependencies Set the library path: export LD_LIBRARY_PATH=./bin:$LD_LIBRARY_PATH. Then, navigate to the bin directory and execute ldd lib* | grep no found to check for missing libraries. If this command also cannot be executed, the system might be preventing the application from calling critical library files.

  3. Solution:Access the "Security Center" or a similar settings interface in the UOS. Change the corresponding policy from "Only allow certified applications to run" to "Allow any application to run."

License Issues

   
Q1: SuperMap iDesktopX fails to start with "no licenses found. please verify that the license was installed successfully."
A: This occurs for three reasons: no license configured, unsuccessful configuration, or license expiration. For the first two, reconfigure the license. Windows and Linux methods differ; refer to Windows Configuration Guide and Linux Configuration Guide for details.
Q2: How to select licenses for Linux systems?
A: SuperMap iDesktopX provides file license, hardware license, public cloud license, and private cloud license. Loongson and ARM packages do not support hardware licenses. If the computer has internet access, use public cloud license; if offline but on a LAN, deploy private cloud license.

Desktop Startup

   
Q1: Does the program output runtime information to logs? Where are logs stored?
A: Two types of logs are output: SuperMap iDesktopX log and SuperMap iObjects log, recording desktop and component runtime information respectively, including output window messages and exceptions. Logs are stored in the "log" folder under the root directory
Q2 After starting SuperMap iDesktopX, the output window prompts "Failed to load the xx plugin!". What is the reason?
A:

Several scenarios in SuperMap iDesktopX can cause a plugin loading failure. Taking the SuperMap.Desktop.Dashboard plugin as an example:

  1. When theenabledattribute in the SuperMap.Desktop.Dashboard.config configuration file is set to "false", the SuperMap.Desktop.Dashboard plugin fails to load.

    Reason: The enabled attribute controls the plugin's visibility. Setting it to "false" makes the plugin invisible.

  2. When the level attribute in the SuperMap.Desktop.Dashboard.config configuration file is set to 1, the SuperMap.Desktop.Dashboard plugin fails to load.

    Reason: The level attribute sets the plugin's priority level. Except for the core Controls plugin which has a level of 1, other plugins should have an integer level between 2 and 10, typically set to 5.

  3. When the SuperMap.Desktop.Dashboard.config configuration file is correct and present, but the corresponding JAR file is missing, the SuperMap.Desktop.Dashboard plugin fails to load.

    When the SuperMap.Desktop.Dashboard.config configuration file is correct and present, but the corresponding JAR file is missing, the SuperMap.Desktop.Dashboard plugin fails to load.

  4. When the pluginClassName specified in the SuperMap.Desktop.Dashboard.config file does not match the plugin class name in the JAR file, the SuperMap.Desktop.Dashboard plugin fails to load.

    Reason: The corresponding plugin class could not be found based on the pluginClassName value "com.supermap.desktop.dashboard.DashboardPlugin".

  5. Failure during the construction of the constructor in the plugin class DashboardPlugin causes the SuperMap.Desktop.Dashboard plugin to fail loading.

    Reason: An exception occurred in the constructor of the plugin class com.supermap.desktop.dashboard.DashboardPlugin, leading to construction failure.

  6. The current license does not include the license for the Dashboard plugin, causing the SuperMap.Desktop.Dashboard plugin to fail loading.

    Reason: The plugin SuperMap.Desktop.Dashboard cannot be loaded under the current license.

  7. The SuperMap.Desktop.Dashboard plugin fails to load due to reasons other than those listed above.

    Reason: The SuperMap.Desktop.Dashboard plugin failed during its build process.

Q3: When starting SuperMap iDesktopX remotely via XRDP, the interface appears black after opening. How should this be resolved?
A: Install the xorg plugin, or use VNC for remote access instead.