Product Installation, Configuration, and Startup

Windows System

   
Q1: Why, after installing SuperMap iDesktopX into system directories such as C:\Program Files or C:\Program Files (x86), does the desktop start normally, but some features (e.g., modifying the color scheme, saving layouts to the template library) fail to work properly?
A: Executing functions like modifying the color scheme or saving a layout to the template library writes data to the installation path. When starting iDesktopX by directly double-clicking SuperMap iDesktopX.exe, it lacks the permission to write data to system directories, causing these functions to fail. Running SuperMap iDesktopX.exe as an administrator can resolve this issue.
Q2: Why can't SuperMap iDesktopX open data located in system directories like C:\, C:\Program Files, or C:\Program Files (x86), nor save images, templates, or other files to these directories?
A:

When starting iDesktopX by directly double-clicking SuperMap iDesktopX.exe, it lacks permission to read from or write to system directories. This issue can be resolved in the following ways:

  • Option 1: Place the data to be used in a non-system directory and change the output file path to a non-system directory; (Recommended)
  • Option 2: Right-click on SuperMap iDesktopX.exe and select "Run as administrator";
  • Option 3: Right-click on SuperMap iDesktopX.exe, select "Properties," change the .exe permission to administrator privilege, and rerun the .exe;
Q3:

When starting SuperMap iDesktopX on a Windows system, the startup fails and reports the following error. Additionally, error.log indicates "installation path\SuperMap iDesktopX\bin\WrapjGeo.dll: The specified program could not be found." How to resolve this?
A: This situation is due to a missing Microsoft Visual C++ runtime environment. In the product package installation path \SuperMap\SuperMap iDesktopX\support folder, double-click vcredist110_x64.exe to successfully install Microsoft Visual C++ 2012. Afterwards, SuperMap iDesktopX should start normally.
Q4:

On a Windows Server system, starting SuperMap iDesktopX prompts the error shown in the figure below. How to resolve this?
A:

This is caused by a failure to load the DLL file. It can be resolved by the following method:

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

Linux System

   
Q1: How to choose the appropriate product package type and format for a Linux system?
A:

To accommodate different computer CPU architectures in Linux systems, the desktop Linux version provides three types of product packages: x86, Arm, and Loongson. Each type is available in three formats: tar, deb, and rpm. The selection method is as follows:

1. Product Package Type Selection:

  • If the computer's CPU architecture is X86, choose the x86 version of the Linux product package;
  • If the computer's CPU architecture is ARM, choose the arm version of the Linux product package;
  • If the computer's CPU architecture is Loongson, choose the Loongson version of the Linux product package;

2. How to Choose the Product Package Format:

  • tar.gz Green Package: Extract and use; suitable for various Linux operating systems.
  • deb Installation Package: Install and use; suitable for Ubuntu, Kylin, UOS, and other operating systems.
  • rpm Installation Package: Install and use; suitable for NeoKylin, CentOS, and other operating systems.
Q2: How to install/uninstall rpm and deb packages?
A:

1. Commands for installing and uninstalling rpm packages are as follows:

  • Installation command: rpm -i package_file_name_to_install
  • Removal command: rpm -e supermap-Variable "小写" is not defined

Commands for installing and uninstalling deb packages are as follows:

  • Installation command: dpkg -i package_file_name_to_install
  • Removal command: dpkg -r supermap-Variable "小写" is not defined
Q3: What should be done if extraction/installation of the Linux product package fails?
A: 1. If prompted "corrupted compressed data" during extraction, compare the MD5 value of the product package to confirm if it is damaged. If damaged, it is recommended to use a complete product package for extraction/installation.
2. If the product package is intact but installation fails with a prompt, root privileges are required for installation. The default installation path is /opt/supermap_Variable "小写" is not defined. Otherwise, permission will be denied.
Q4: Is a graphical interface required to start iDesktopX?
A: Yes, the machine starting iDesktopX must have a graphical interface to ensure normal startup and use of the desktop. When remotely connecting via terminal tools (like xshell), ensure the connected machine has a graphical interface installed. If a graphical interface is installed but starting via the terminal tool reports the error below, then graphical interface connection configuration is needed in the terminal.

Q5: When starting SuperMap iDesktopX, it prompts that a dependency library "libpng12.so.0" or other dependency library files are missing. What to do?
A: Method One: The missing dependency library can be copied from this machine or another machine, or downloaded from the internet. Place the missing library file in the bin folder of the SuperMap iDesktopX package, then start iDesktopX. Specific steps are as follows:
  1. Set the LD_LIBRARY_PATH environment variable to point to the bin directory: export LD_LIBRARY_PATH=./bin:$LD_LIBRARY_PATH
  2. Enter the following command to confirm if the specified dependency library file (libpng12.so.0) is indeed missing: ldd -d libWrapjGeo.so |grep libpng12.so.0
    If the output is: libpng12.so.0 => not found, it indicates the libpng12.so.0 file is missing.
  3. Enter the following command to view all libpng12.so files in the operating system: find / -name libpng12.so.*
    If output information like below appears, it indicates the library file exists in third-party software on the OS. Copy this file to the product package bin directory. If not found, obtain it through other means. /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
  4. Execute the following command to copy the libpng12.so.0 file to the bin directory: cp /snap/core/4917/lib/x86_64-linux-gnu/libpng12.so.0 ./bin/
  5. Execute the following command to check if other dependency libraries are still missing: ldd libWrapj.so |grep no
  6. If no missing dependencies are prompted, start iDesktopX.
Method Two: Execute the systemlibs_check.sh file located at root directory/support/systemlibs/third_libs/, then restart the desktop.
Q6: Starting SuperMap iDesktopX on a Linux system fails and prompts "No X11 DISPLAY variable was set,……", as shown below. What to do?

A: The failure is due to X11 forwarding not being configured. The solution is: in the command line window, enter "export DISPLAY=%computer_ip%:0.0", then restart SuperMap iDesktopX.
Q7: Starting SuperMap iDesktopX on a Linux system fails and prompts the information shown in the figure below. What to do?

A: The failure is due to missing libraries related to the font library. The solution is as follows:

1. Install java-1.8.0-openjdk by executing in the command line window: yum install java-1.8.0-openjdk;

2. Switch the current JRE environment to the system's JRE environment by commenting out (adding a #) the line "export JRE_PATH=./jre/bin" in the startup.sh file, as shown below:

3. Execute the following command in the command line to install font-related dependency libraries: yum -y install xorg-x11-xauth xorg-x11-utils xorg-x11-fonts-*

4. Restart iDesktopX.
Q8: When running SuperMap iDesktopX on a Linux system, why do fonts in the interface appear as blocks, and how to resolve this?
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 currently used JRE environment. For example: /usr/lib/jvm/java-1.8.0-openjdk-1.8.0.242.b08-1.h5.oe1.x86_64/jre/lib/fonts/fallback folder. Restart iDesktopX, and the interface text will display normally.
Q9: When running SuperMap iDesktopX on a Linux system, why do fonts in the interface appear as blocks?
A: This is caused by missing Chinese fonts in the Linux system. Place a Chinese font file in the jre/jre/lib/fonts folder under the product package directory, and the program interface text will display normally.
Q10: Why does starting SuperMap iDesktopX on SUSE Linux Enterprise 11 SP2 operating system report the error "libSuGraphicsQT.uge:undefined symbol:_ZN40GDC170gdcUnicodeStringC1EPKw"?
A:

On SUSE, a third-party database client needs to be installed for the SDX data engines to load correctly. Failure to load one SDX engine can affect the loading of other SDX data engines, leading to the inability to open any datasource or program startup failure. The SDX data engine files that depend on third-party database clients are: libSuEngineSRDB.sdx, libSuEngineOracle.sdx, libSuEngineDMCI.sdx, libSuEngineOsp.sdx, libSuEngineAltibase.sdx, libSuEngineDB2.sdx, libSuEngineKDB.sdx. For example, if an Oracle datasource is needed, first install the Oracle client, then delete all *.sdx files listed above except libSuEngineOracle.sdx, and then start the SuperMap iDesktopX desktop. Similarly, handle other database engines accordingly.

The solution is: Keep libSuEngineImagePlugin.sdx in the bin directory of the product package and the necessary database engine files, and delete the unwanted database engine files (*.sdx from the list above).
Q11: If starting iDesktopX reports the error "java.lang.UnsatisfiedLinkError: /opt/SuperMap_Variable "小写" is not defined/bin/ libWrapjGeo.so: /usr/lib64/libstdc++.so.6: version `GLIBCXX_3.4.9' not found (required by ./bin/ libSuToolkit.so)", refer to the following solution:
A:
Q12: When starting the software on a Linux system, missing system libraries or incorrect versions may prevent normal startup.
A:

Download the systemlibs compressed package corresponding to the operating system fromhttps://pan.baidu.com/s/1XmxelUQIZHHf-6LvHoXihw?pwd=eq2u,extract it, copy the missing libraries to the product package root directory/support/browser folder, and restart the software.

Example: If starting the software on a Linux64 system prompts "version 'NSS_3.65' not found ( required by /lib64/libsmime3.so". Then download the linux64_systemlibs.tar.gz compressed package from the systemlibs in the above link, extract it, copy the libsmime3.so from the extracted package to the product package root directory/support/browser folder, and restart the software.
Q13: If the CentOS 5.7 system has a JRE version earlier than 1.8 configured, SuperMap iDesktopX fails to start and reports an error. How to solve this problem?
A:

SuperMap iDesktopX desktop startup depends on JRE 1.8 or newer environments. Since the JRE version does not meet the requirement, Java fails to start. Solutions are as follows:

  • Option 1: Uninstall the locally installed older JRE environment, install JRE 1.8 or newer, then restart Java.
  • Option 2: The Java product package includes a JRE 1.8 environment. When starting iDesktopX, the locally configured environment is prioritized, causing startup failure. If the user does not want to uninstall the local JRE environment, modify the startup.sh script by moving "$JRE_PATH:" to the front in the line "export PATH=$SUPERMAP_ROOT:$LD_LIBRARY_PATH:$JRE_PATH:$PATH", i.e., change it to: export PATH=$JRE_PATH:$SUPERMAP_ROOT:$LD_LIBRARY_PATH:$PATH. Then execute the startup.sh file again to start Java.

Note: This issue has been resolved in the 9D version; the problem of JRE environment being too low to start will not occur.
Q14: When running the startup script startup file in a hardware environment with a UnionTech operating system and Zhaoxin CPU, the system returns error code 33.
A:
  1. Troubleshooting
    1. Exclude Installation Package Issue

      The product package can be extracted normally, and the installation package integrity is fine. The focus shifts to the runtime environment.

    2. Verify Runtime Environment
      • Test One: Check Java Runtime Environment

        Attempt to execute the command ./product_package_path/jre/bin/java -version. If the command fails to execute, it indicates a missing basic runtime environment or permission issue. Proceed to Test Two.

      • Test Two: Check Dynamic Library Dependencies

        Set the library path export LD_LIBRARY_PATH=./bin:$LD_LIBRARY_PATH, then execute ldd lib* | grep no in the bin directory to check for libraries not found. If this command also cannot execute, the system might be preventing the application from calling key library files.

  2. Resolve the Issue: Enter the "Security Center" or similar settings interface in the UnionTech operating system, and change the corresponding policy from "Only allow running certified applications" to "Allow running any application."

License Issues

   
Q1: When starting iDesktopX, it fails to launch and prompts "no licenses found. please verify that the license was installed successfully."
A: Windows Configuration Guide and Linux Configuration Guide, respectively.
Q2: How to choose a license for a Linux system?
A:
   
Q1: Is information output to logs during program operation? Where are the logs stored?
A: SuperMap iDesktopX log, and the other is the SuperMap iObjects log. They record information output by the desktop and components respectively, including program output window information, exception information, etc. The logs are stored in the "log" folder under the "bin" directory at the root directory.
Q2: After starting the SuperMap iDesktopX desktop, the output window prompts "xx plugin failed to load!" What is the reason?
A: SuperMap iDesktopX prompts plugin loading failure in the following situations, taking the SuperMap.Desktop.Dashboard plugin as an example:

1. When the enabled property in the SuperMap.Desktop.Dashboard.config file is set to "false": SuperMap.Desktop.Dashboard plugin failed to load!
Reason: The enabled attribute controls plugin visibility. Setting it to "false" makes the plugin invisible.

2. When the level property in the SuperMap.Desktop.Dashboard.config file is set to 1: SuperMap.Desktop.Dashboard plugin failed to load!
Reason: The level attribute sets the plugin level. Except for core plugins with Controls level set to 1, other plugin levels are integers from 2-10, typically set to 5.

3. When the SuperMap.Desktop.Dashboard.config file is correct and exists, but the corresponding jar package is missing, it causes SuperMap.Desktop.Dashboard plugin loading failure!
Reason: The Dashboard.jar package does not exist in the installation path\bundles\idesktop_bundles directory, so the plugin cannot be loaded.

4. When the pluginClassName in the SuperMap.Desktop.Dashboard.config file does not match the plugin class name in the jar package, causing SuperMap.Desktop.Dashboard plugin loading failure!
Reason: The corresponding plugin class is not matched based on the pluginClassName attribute value "com.supermap.desktop.dashboard.DashboardPlugin".

5. The constructor in the DashboardPlugin class fails, causing SuperMap.Desktop.Dashboard plugin loading failure!
Reason: An exception occurs in the constructor of the plugin class com.supermap.desktop.dashboard.DashboardPlugin, leading to construction failure.

6. The Priority to use local licenses does not include the license for the Dashboard plugin, causing SuperMap.Desktop.Dashboard plugin loading failure!
Reason: The plugin SuperMap.Desktop.Dashboard cannot be loaded with the current license!

7. SuperMap.Desktop.Dashboard plugin failed to load for reasons other than the above!
Reason: SuperMap.Desktop.Dashboard plugin failed during the construction process.

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