FAQ: What should I do if an error appears when I activate the system with a license?
Problem 1: The activation page reports "the serial number is already bound to another instance"
A license can be bound to only one instance at a time. This serial number is already bound, so you must retire the old instance before you can activate the new system. Sign in to the 丰盘 online service portal with the registered email account, click "Retire" next to the serial number, and confirm. The host instance is then unbound from the serial number automatically, and you can use the serial number to activate the new system.
Do not keep using the old host instance after you retire it. Its license will stop working automatically, it cannot be activated again or upgraded to a new version, and we do not provide manual technical support for it.
For more details about licensing, see Licensing and version upgrades.
Problem 2: The activation page reports a network timeout, Timeout, or HTTP error
丰盘 supports private deployment, but installation, upgrade, and license activation all require the server to have internet access. These errors mean that processes inside the container cannot reach the 丰盘 activation server. A common cause is that the enterprise host sits on a fully isolated intranet, where neither the host nor the container can reach the internet.
Some enterprises run a customized Linux distribution. After a fresh Docker installation, a restart may be required before Docker works correctly. Run the following commands to restart Docker and the 丰盘 services, then activate again in the web browser.
# Restart Docker; all containers go offline automatically
sudo systemctl restart docker
# Start the 丰盘 containers in dependency order
sh /opt/xpan/tools/xpc.sh upIf the problem persists after the restart, work through the diagnostic steps below.
Info
Each diagnostic step checks both the "丰盘 OTA server" and the "Baidu server". If both fail, the problem lies in the local host or the LAN. If only the 丰盘 OTA server fails, contact our online support for help troubleshooting.
Step 1: Check whether the host has internet access
Run the following commands to test whether the host can reach the internet.
# Run curl (or wget) on the host
# The command prints the 丰盘 OTA server time, for example:
# ✅"2025-11-07 07:11:25"
curl https://ota.ekbcloud.com/api/v1/op/ping
wget -qO- https://ota.ekbcloud.com/api/v1/op/ping
# Test whether the Baidu server responds
# ✅ Expected output: the Baidu home page source is returned
curl https://www.baidu.com/
wget -qO- https://www.baidu.com/If the host cannot reach the internet, check the network adapter settings and the local iptables firewall rules. You can also ask your network administrator whether the LAN gateway blocks outbound internet traffic. Fix the issue, then run the activation again.
If the host has internet access and the LAN does not block traffic, you should see the 丰盘 OTA server time and the Baidu page content. Continue to Step 2.
Step 2: Check whether the Docker network has internet access
If the host can reach the internet, check the Docker network next.
Info
Docker routes traffic through virtual network interfaces. If iptables on the host is misconfigured, the Docker network often stops working. The following commands run inside Docker virtual networks, selected with the --network=xpan or --network=testnet parameter.
First check whether DNS resolution works inside the Docker network.
docker run -it --rm --network=xpan registry.cn-hangzhou.aliyuncs.com/ekbc/curl:latest /bin/sh -c "nslookup ota.ekbcloud.com"
docker run -it --rm --network=xpan registry.cn-hangzhou.aliyuncs.com/ekbc/curl:latest /bin/sh -c "nslookup www.baidu.com"
# ✅️ Expected result on success:
Server: 127.0.0.11
Address: 127.0.0.11:53
Non-authoritative answer:
Name: ota.ekbcloud.com
Address: 106.55.2.26
# ❌ Result when resolution fails:
Server: 127.0.0.11
Address: 127.0.0.11:53
server can't find ota.ekbcloud.com: NXDOMAINIf DNS resolution works, test IP connectivity next.
# Run the command below to test whether the 丰盘 virtual network xpan
# can connect directly to the 丰盘 OTA server.
# ✅ Expected output: a 丰盘 OTA server timestamp, for example "2025-11-07 07:11:25"
docker run -it --rm --network=xpan registry.cn-hangzhou.aliyuncs.com/ekbc/curl:latest -fsSL -m 10 https://ota.ekbcloud.com/api/v1/op/ping
# If the command above fails, rule out 丰盘 first,
# then diagnose the local Docker installation and configuration.
# Create a fresh test network in Docker and try to reach Baidu.
# ✅ Expected output: the Baidu home page source is returned
docker network create --driver=bridge testnet || true &&
docker run -it --rm --network=testnet registry.cn-hangzhou.aliyuncs.com/ekbc/curl:latest -fsSL -m 10 https://www.baidu.com &&
docker network rm testnetIf these checks do not solve your problem, or you run into another activation issue, contact us for help.