-
- When starting SuperMap iPortal
service, what are the possible reasons and solutions for not passing
the environment check?
A: SuperMap iPortal needs configuring JRE 1.8 or higher, and the license.
- Port occupancy error occurs when starting SuperMap iPortal service, which causes iPortal service to fail to start. How to solve?
A: SuperMap iPortal package are deployed in Tomcat by default, Tomcat uses the 8090, 8015 ports by default, if any of the ports are occupied, you can not start the normal service. You can this problem in two ways below:
(1) Quit the program that takes the port and restart SuperMap iPortal. Currently known procedures that may occupy 8090 port are: The automatic upgrade program of 360 anti-virus software.
(2) Modify the Tomcat port number in SuperMap iPortal package and restart SuperMap iPortal. Go to % SuperMap iPortal_HOME% / conf / server.xml, modify the related ports in it, such as: <Server port = "8016" ... ..., <Connector port = "8091" ... redirectPort = "8454" ... ....
- Why error "java.lang.OutOfMemoryError: unable to create new native thread" occurs when running SuperMap iPortal?
- What are the possible reasons for the collapse of SuperMap iPortal service?
A: There are the following possible reasons:
(1) Check whether you have installed Kingsoft anti-virus software. Running the Kingsoft may cause the iPortal service to crash.
(2)The Tomcat 7.0.29 will cause memory leaks, please change to other Tomcat versions, such as Tomcat 7.0.26.
- Why does the SuperMap iPortal service automatically restart in the case of abnormal shutdown?
A: iPortal provides automatic restarting mechanism to ensure that it can continue to work correctly in the case of abnormal shutdown. The auto-restart feature is valid in the following scenarios:
- When starting iPortal Windows / Linux installation package by command line
The auto-restart function does not apply to the following scenario:
- When starting iPortal via Windows service
Note: SuperMap iPortal can be shut down by executing shutdown.bat/shutdown.sh (located in the [SuperMap iPortal installation directory]\bin) or press Ctrl + C on the keyboard to end the service. For details, see Server's startup/stop.
The auto-restart feature is controled by the <restartWhenCrash> parameter under the <properties> node in The system configuration file (iserver-system.xml).
- Where are the log files placed, when starting SuperMap iPortal via Windows service in Java Web container, like Tomcat?
A: When starting SuperMap iPortal via Windows service, in Tomcat for instance, iserver-log4j.properties in [ SuperMap iPortal installation directory]\webapps\iportal\WEB-INF specifies the log's location. Open the file, find "log4j.appender.F.File = .. /logs/iserver.log", which means the logs folder located in the upper directory of the service startup file (cmd.exe), that is, the log file path is: C:\Windows\logs\.
In addition, the user can modify the log4j.properties file above, for example change to a absolute path: log4j.appender.F.File = D:/Tomcat/logs/iserver.log.
- When you stop SuperMap iPortal, why does the bin generate a * .mdmp file, which causes the disk to take up too much?
A: When stopping SuperMap iPortal, please use shutdown.bat/sh instead of the Ctrl + C command.
- If SuperMap iPortal's operating system is configured with multiple IPs, how do I specify the IP used by the iPortal service?
A: You can specify all IPs used by iPortal by modifying the -Diserver_ip in the Java virtual machine parameters in Catalina.bat. That is: modify the% SuperMap iPortal_HOME%/bin/catalina.bat JAVA_OPTS, set-Diserver_ip for the desired IP, such as:
set JAVA_OPTS =% JAVA_OPTS% -Xms256m -Xmx1536m -XX: MaxPermSize = 192m -Xss512k -Diserver_ip = 192.168.12.13
- iPortal does not support the registration of localhost and 127.0.0.1 service address, then how to meet the needs of registering services on stand-alone machine when the network is not available for product demonstration?
A: When the network is not available, the problem of registering services on Windows platform can be resolved through the following ways :
Add a mapping to the hosts file in the C:\Windows\System32\drivers\etc directory, for example:
127.0.0.1 www.iportaldemo.com
Then registering service address starting with the above domain name.
- Why does this error occur when starting iPortal service on a Linux system: "Unable to set localhost. This prevents creation of a GUID"?
- Linux system does not have a graphical interface, how to configure the SuperMap iPortal 7C use license through the command line?
A: There are four steps to configure license through com.supermap.license.jar in the way of command lines:
- A "The 32bit support is missing. Please install the x86 compatibility
packages required by your distribution and retry the installation.
See the installation guide for more details.Aborting …" error
happens on a Linux 64-bit OS when installing SuperMap License
Center driver.
A: Linux 64-bit operating system lacks 32-bit support libraries. You need to install the related support libraries of 32 bit as follows maually, or you can also load the system disk to install the relevant libraries, or go to the corresponding operating system official website to obtain the relevant libraries to install.
- libc6-i386 和 ia32-libs（Ubuntu）
- libstdc++-devel.i686、glibc.i686、libgcc.i686、libstdc++.i686、glibc-devel.i686（RHEL、 CentOS、OpenSUSE、SLES and OES）
- glibc-32bit（OpenSUSE、SLES and OES）
For operating systems of SUSE series 10.3 or later, Red Hat series 5.5 or later, iPortal provides a script file to help you install the above dependeny libraries. You only need to run the following command before starting iPortal service in [SuperMap iPortal installation directory]/SuperMapiPortal7C/support/SuperMap_License/Support:
./rpms_check_and_install_for_64bit.sh
- On the Linux
OS on Hyper-v, the 7C license fails to install, or it is not available after restarting
the system.
A: If you encounter a license installation fails, or the installed license is not available, you can use the following method to uninstall the driver and then reinstall.
(1) Use the following command to delete the directory /var/hasplm
cd /var
rm -rf hasplm
(2) Uninstall the license driver:
cd /SuperMapiServer7C/support/SuperMap_License/Support/aksusbd-2.2.1-i386
./dunst
(3) Reinstall the license driver:
./dinst
- When
installing SuperMap License Center on Linux, the error "hasp_update
failed with status 65" shows up. Why?
A: You can skip this message. This occurs when you repeat the installation of license center.
- When
using putty, SecureCRT, SSH to start SuperMap iServer 7C or SuperMap
iPortal 7C service on Linux, such error as "Could not initialize
class sun.awt.X11GraphicsEnvironment” or “System environment checking
failed” appear on the front page. But it works well when starting
service locally. Why?
- Why certain request cannot
be recognized and the request may fail or wrong result may be
returned?
A: Because the sent HTTP request did not use UTF-8 encoding. For non-ASCII characters, SuperMap iPortal will use UTF-8 by default. If the request is not encoded with UTF-8, the characters can't be correctly parsed.
- Restering iServer services proxied by nginx to iPortal, when enabling iPortal service proxy, some resources can't be accessed when accessing the proxied iServer service address. For example, when accessing map resource's rjson representation, the port number of the urls of some resources is not the port number of the iPortal service proxy, but the nginx's listening port. Why, and how to solve?
A: You need to modify the nginx configuration which proxies the iServer services, open the [nginx installation path]\conf\nginx.conf file, modify the proxy_set_header under the http node -> server node -> location node as follows:
server {
......
location /iserver{
#proxy_set_header Host $http_host;
proxy_set_header ProxyHost $http_host; }
......
Change the $ host: port in proxy_set_header to $ http_host and restart nginx.
- What should I do if I forget the password of the administrator acount created when SuperMap iPortal was initialized?
A: There is a passwordreset.bat / passwordreset.sh file in [SuperMap iPortal_HOME]\bin directory, specifically used to deal with the situation that user forget the password of the administrator account created when the system was initialized. If you forget password, you can re-create the administrator account by performing the following operations:
(1) Stop SuperMap iPortal service, that is, execute shutdown.bat /shutdown.sh file in [SuperMap iPortal_HOME]\bin directory.
(2) Execute the passwordreset.bat /passwordreset.sh file.
(3) Restart SuperMap iPortal service, ie., execute startup.bat / startup.sh file in [SuperMap iPortal_HOME]\bin directory. When access the iPortal home page after the service starts, the system will automatically jump to interface of creating administrator account, then just re-create the administrator account. - Why SSO failed after
I configured CAS authentication server?
- I have configured the mailbox server correctly, but why does it still prompt "warning: SMTP server configuration is not legal"?
A: If you are using a JDK version of 1.8 and above (the JDK version comes with the iPortal product package is 1.8), the mail server configuration may not be verified when the security protocol uses SSL or STARTTLS, prompting "Warning: SMTP server Configuration is not legal ". You need to resolve by the following steps:
- Download the UnlimitedJCEPolicyJDK7.zip at http://www.oracle.com/technetwork/java/javase/downloads/jce-7-download-432124.html
- Unzip UnlimitedJCEPolicyJDK7.zip to get the following two files
- local_policy.jar
- US_export_policy.jar
- Use these two jar files to cover the files with the same name in [SuperMap iPortal_HOME]\support\jre\lib\security directory (recommended to backup the original files)
- Restart the iPortal service
- In the case of a large number of iPortal users, for example: 20, 000 users, start iPortal service will be slower, the loading of user management page will be slow too, how to solve?
A: When iPortal service starts, it caches all the users' information into memory by default, all the following operations on querying users' information will be based on memory. When the number of users is large, it is recommended to disable the caching operation to improve the performance. Open the iserver-system.xml file under [SuperMap iPortal_HOME]\webapps\iportal\WEB-INF, add <cacheInfoToMemory> node under <management> -> <security> -> <SecuritySetting> node as follows:
<management>
......
<security>
<SecuritySetting>
<cacheInfoToMemory>false</cacheInfoToMemory>
......
true means that caching all the users' information into memory. When the amount of user data is large, it is recommended to set it to false to disable the caching operation.
- How do I understand and distinguish between iPortal's normal user role (PORTAL_USER) and viewer role (PORTAL_VIEWER)?
A: The differences between iPortal's normal user role (PORTAL_USER) and viewer role(PORTAL_VIEWER) are as follows:
- The users who are associated with PORTAL_USER role are the normal users of iPortal, they have the permission to use iPortal, including using, creating and sharing iPortal resources. And the number of this kind of users occupy the number allowed by iPortal's license;
- The users who are assigned PORTAL_VIEWER role can log in to iPortal, and view the resources shared by others, but they can't create and manage resources. And this type of users won't take up the number allowed by iPortal's license.
For more information about iPortal's normal user role (PORTAL_USER) and the viewer role (PORTAL_VIEWER), see Roles and Permissions.
- I've created SuperMap iPortal's system administrator account, then I changed to use MySQL database, not using the default SQLite anymore, but when I perform operations like registering serivces, creating maps, the console prompts "Can not add or update a child row: a foreign key constraint fails ... "
A: Because the iPortal lost the user information in the user_infos table stored in the original SQLite database. You need to synchronize the user information in iportal.db under [SuperMap iPortal_HOME]\webapps\iportal\WEB-INF\iportaldata to the MySQL database. The specific operation is: add the record of the iPortal administrator into user_infos table in MySQL database, if the name of the administrator account is "admin", then the SQL statement is:
insert into user_infos(name, nickname) values("admin", "admin");
(For SuperMap iPortal 8C SP1 or previous versions, you also need to ensure that the servicerooturls table in MySQL database is empty, if there is a record, you need to delete), and then restart the iPortal service.
It is important to note that if you have created maps, registered services, etc., you need to synchronize all portal data in iportal.db to keep the previous portal data when you switch to the MySQL database.
- When upgrading SuperMap iPortal from 8C SP1 to 8C SP2 and later versions, the function of monitoring servers doesn't work, but it worked well on the SP1 version. How to solve?
A: You can try to re-enter the password on the "Monitor Server" -> "Monitoring Configuration" page and save it.
In the catalog of %SuperMap iPortal_HOME%\bin, you can check the version and configuration information of SuperMap iPortal by using “iportal.bat -v” ("./iportal.sh -v" for Linux/Unix). The possible reasons and solutions are:
(1) Use the right license and make sure the license is properly configured. Please refer to Configuring the License.
(2) The JRE/JDK version is too low or incompatible. Please download JRE/JDK1.8 or higher and set the environment variables.
A: When creating thread in the pool, a physical thread will be created in the operating system. For certain machines with inadequate memory, the memory needed for operating system to create physical thread will compete with Java virtual machine heap memory when the amount of registered data and visits are large, and the system needs to deal with high concurrent requests, resulting in creating threads failed (The maximum memory of Java virtual machine of iPortal 32-bit package is assigned 512M by default, the maximum thread number is 300). To solve the problem, you can:
(1) Reduce the memory assigned to Java virtual machine by changing Java virtual machine parameter. For example, changing JAVA_OPTS " in %SuperMap iPortal_HOME%/bin/catalina.bat to a smaller value like -Xmx512.
(2) Reduce the active threads of Tomcat connection pool by changing maxThreads in %SuperMap iPortal_HOME%/conf/server.xml to a smaller value.
A: Please configure the IP address corresponding to host name in /etc/hosts file. If you add the last row, it means to map linux-3z6l to 192.168.112.213.
# Syntax: # IP-Address Full-Qualified-Hostname Short-Hostname 127.0.0.1 localhost 192.168.112.213 linux-3z6l
(1) Set the Java environment variable, and set the directory of LD_LIBRARY_PATH as com.supermap.license.jar.
export=./support/jre/bin/
export=./support/SuperMap_License/
(2) Get the machine information. Enter SuperMapiPortal7C\Support\SuperMap_License directory, execute the following command with specifying the path where the generated local information file is stored, then a * .c2v file in the specified path will be generated.
java -jar com.supermap.license.jar -create /path/*.c2v
(3) Submit the local information to the Beijing SuperMap Software Co., Ltd.
Submit the local information file (* .c2v) generated by the above steps to Beijing SuperMap Software Co., Ltd., we will generate *. v2c official license file based on it and return to you, through which you can configure the official license.
(4) Make the license work. Place your *. v2c official license file into a specified location, execute the following command:
java -jar com.supermap.license.jar -update /pathName/*.v2c
Besides, you can execute java -jar com.superamp.license.jar -help to view the related commands about license. For details, see: License configuration on Linux.
A. When remotely starting SuperMap iServer 7C and SuperMap iPortal 7C, you need to first log in to the Linux server and run the command below:
(1) X:n& Start XServer on the n-th screen. n is any integral, e.g. 22, 30.
(2) export DISPLAY=:n.0 Set DISPLAY variable to the XServer of the local machine, and restart the service .
A: When the CAS authentication server and the GIS server are not on the same machine, the time difference between the two servers may result in the failure of log in. In this case, you need to adjust the time to be the same or extend the time tolerance. By default, the tolerance of iServer, iPortal, and iEdge is 3 minutes. You can change it through casRealm.tolerance (unit: ms):
......
casRealm.enabled = false
casRealm.reserveSystemAccount = true
casRealm.casServerUrlPrefix = http://{ip}:{port}/cas
casRealm.casService = http://{ip}:{port}/{contextPath}/shiro-cas
casRealm.securityInfoDAO = $sqliteRealm
casRealm.tolerance = 180000
......