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:

• server: Address of server publishing services.
• port: Port for publishing services.
• servicecomponent: Name of the configured service component or service component set, e.g., map service component map-world configured by SuperMap iServer by default.
• serviceinterface: Name of the configured service interface bound to servicecomponent, e.g., service interface name wms111 configured by SuperMap iServer by default.

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-based service URI

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.

Configuring IPv6 on Windows system

There are serveral ways to enable IPv6 on Windows system. This section only describes how IPv6 in the Teredo tunnel can be enabled.

Install IPv6 protocol

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.

Enable 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.

Configuring IPv6 on Linux system

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 %

Access iServer services via IPv6

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.

IPv6 support in iServer services

Table 1 IPv6 support in iServer services

IPv6 support in different datasources

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