Service URI |
SuperMap iServer provides a three-level architecture: service provider, service component and service interface.
The home page of SuperMap iServer is http://<server>:<port>/iserver. and the page http://<server>:<port>/iserver/services can list all services currently published. The complete URI of service is: http://<server>:<port>/iserver/services/<servicecomponent>/<serviceinterface>, where:
For example, server is local machine (localhost), port is 8090, configured service component map-world has already been bound to service interface wms111, rest, then access addresses for the two services are:
http://localhost:8090/iserver/services/map-world/wms111
http://localhost:8090/iserver/services/map-world/rest
IPv6 is an IP protocol of the next-generation that replaces the current IP protocol (IPv4) version. IPv6 has the advantages of larger address capacity, simpler header format, and personalized network services guaranteed compared to IPv4. Furthermore, IPv6 guarantees the integrity and confidentiality of end-to-end communication at the network layer and stronger security. Based on this, SuperMap iServer supports IPv6, providing more secure, convenient and quality-assured services for users.
You must first configure the IPv6 protocol in the system to access the service using the IPv6 format address. This article introduces how to configure IPv6 protocol in Windows and Linux environments.
There are serveral ways to enable IPv6 on Windows system. This section only describes how IPv6 in the Teredo tunnel can be enabled.
You can skip this step in the case of Windows Vista and Windows 7, Windows 2008, and Windows 10. While you need to install it manually for Windows XP and Windows 2003 operating systems as the IPv6 protocol is not installed by default. The installation commands are as follows:
netsh interface ipv6 install
This command applies to most Windows operating systems. In addition, the following command only applies to XP systems:
ipv6 install
After the installation is complete, enter Control Panel > Network and Sharing Center > Change Adapter Settings > Local Area Connection > Properties, cancel the check status of IPv6.
In the command prompt window or Windows PowerShell, enter the following command to set the Teredo server:
netsh interface teredo set state enterpriseclient server=default
Test IPv6 links:
ping -6 ipv6.test-ipv6.com
ping -6 [2001:470:1:18::125]
Reset IPv6 configuration
netsh interface ipv6 reset
Reboot the system and enter the following command in the command prompt window:
netsh interface ipv6 show address
If an IPv6 address starting with 2001:: has been assigned, it indicates that it has been assigned an IPv6 address. If there is only the address of fe80:: , this means the IPv6 network is already connected, but the IPv6 service is not opened by the local network.
If the above method fails, the configuration of Windows may be incorrect or the Teredo server may not be properly connected. Please refer to various tutorials for details.
In this section, we take the Linux centos system as an example to describe how to configure IPv6.
Use the command below to check whether the IPv6 is enabled.
ifconfig
If not, modify the following contents in /etc/sysctl.conf file, then execute the command sysctl -p to enable IPv6.
net.ipv6.conf.all.disable_ipv6 = 0
net.ipv6.conf.default.disable_ipv6 = 0
net.ipv6.conf.lo.disable_ipv6 = 0
Modify the following infos to "0" in the /etc/modprobe.d/disable_ipv6.conf file.
options ipv6 disable=0
Modify the following infos to "0" in the /etc/sysconfig/network file.
NETWORKING_IPV6=YES
Then reboot:
service network restart
At this point, the device has IPv6 enabled.
Configuring an IPv6 address
IPV6ADDR=2001:da8:8003:202:120:1:1 % IPv6 address %
IPV6DEFAULTGW=2001:da8:8003:801::1 % IPv6 address gateway %
Note: If there are multiple IPv6 addresses in your Windows / Linux system, or if you use a tunnel adapter in Linux to configure IPv6, in order to ensure the correctness of IP reading, it is recommended that JAVA OPTS-Diserver ip be set to the desired IP at %SuperMap iServer_HOME%/bin/catalina file (Windows is catalina.bat, Linux is catalina.sh), for example:
JAVA_OPTS="-Diserver_ip='fe80::c069:a23d:57e6:61ef'"
After setting, the catalina.bat file is as follows:
catalina.sh is as follows:
Enable IPv6 and disable IPv4 after the configuration is complete, iServer service can then be accessed via an IPv6 address. Note: unlike IPv4, the IPv6 login address is http:/[IPv6]:<port>/iserver as shown in the following figure, the IPv6 address is wrapped with"[]."
At this point, the service can be accessed via IPv6. The conventional GIS functions, such as service publishing, service proxy, multi-process, and cluster, etc., all support IPv6, and the usage is consistent with that of IPv4. The specific support is shown in the following table. Note: To access the iServer service in IPv6 format from the client, the client also needs to configure IPv6.
Table 1 IPv6 support in iServer services
Function type | Whether to support IPv6 |
Map Service |
√ |
Data Service |
√ |
Geometry Service |
√ |
3D Service |
√ |
Data Flow Service |
√ |
Streaming Service |
- |
Plotting Service |
√ |
Traffic Transfer Analysis Service |
√ |
Address Matching Service |
√ |
Spatial Analysis Service |
√ |
Transportation Analysis Service |
√ |
3D Network Analysis Service |
√ |
Data Catalog Service |
√ |
Data Registration Function |
√ |
Distributed Analysis Service |
- |
Distributed Tiling Service |
√ |
Service Proxy |
√ |
Cache Distribution |
√ |
Forwarding Service |
√ |
CAS SSO |
√ |
Multi-Progress |
√ |
iServer cluster |
√ |
Distributed Computing Cluster |
Supports to start local cluster. If using other Spark cluster, IPv6 can't be recognized. |
iServer can also publish commonly used datasources as services via IPv6 protocol. The table below shows the IPv6 support conditions of different datasources.
Table 2 IPv6 support in different datasources
Datasource | Details | Whether to support IPv6 |
Shapefile directory |
√ |
|
Third-party online map |
√ |
|
Map cache |
MongoDB tiles |
√ |
UGCV5 tiles |
√ |
|
UGCV5(MVT) tiles |
√ |
|
Aliyun OTS tiles |
√ |
|
FastDFS tiles |
√ |
|
SMTiles |
√ |
|
SVTiles |
√ |
|
MbTiles |
√ |
|
GeoPackage files |
√ |
|
ZXY tiles |
√ |
|
ArcGIS cache |
√ |
|
Database |
PostGIS |
√ |
PostgreSQL |
√ |
|
Oracle |
√ |
|
MySQL |
√ |
|
SQLServer |
√ |
|
HBase |
√ |
|
Elasticsearch |
- |