DEV Community

mmllllzcn
mmllllzcn

Posted on

TIL: Check Port 9088 Before Installing GBase Database

#gbase #database #数据库 #todayilearned

Last week, I helped a team troubleshoot a GBase Database(GBase 8s) installation failure. The logs repeatedly reported:

Cannot bind to port 9088
Enter fullscreen mode Exit fullscreen mode

The reason was simple: port 9088 was already being used by another process.

It was a good reminder that checking the database port before installing GBase Database can save a lot of unnecessary troubleshooting.

Why Port 9088 Matters

In this GBase Database(GBase 8s) deployment, 9088 is the database service listening port.

During installation and instance initialization, GBase 8s needs to bind the configured port. If another process is already listening on that port, the database instance cannot bind to it and may fail to start.

Before installation, check whether 9088 is available.

One-Command Port Check

On Linux, use ss to check the port:

ss -ltnp | grep ":9088 "
Enter fullscreen mode Exit fullscreen mode

If the command returns something like:

LISTEN 0 128 0.0.0.0:9088 0.0.0.0:* users:(("nginx",pid=1234))
Enter fullscreen mode Exit fullscreen mode

port 9088 is already occupied.

If there is no output, the port is likely available.

On systems where ss is not available, you can use:

netstat -tlnp | grep 9088
Enter fullscreen mode Exit fullscreen mode

What to Do If 9088 Is Occupied

First, identify which process is using the port:

ss -ltnp | grep ":9088 "
Enter fullscreen mode Exit fullscreen mode

Do not immediately run kill -9. First determine whether the process is required by the system or another application.

If it is an unnecessary service, stop it using the appropriate service manager:

systemctl stop <service>
Enter fullscreen mode Exit fullscreen mode

Then verify that port 9088 has been released:

ss -ltnp | grep ":9088 "
Enter fullscreen mode Exit fullscreen mode

If another application must continue using 9088, you can configure GBase Database(GBase 8s) to use another available port.

Keep the Port Configuration Consistent

If you change the GBase Database port, make sure the server configuration and client connection configuration use the same port.

For example, if the database service is changed to 9098, the corresponding sqlhosts entry should use 9098:

gbase01 onsoctcp 192.168.1.100 9098
Enter fullscreen mode Exit fullscreen mode

If the server listens on 9098 but the client still tries to connect to 9088, the connection will fail.

This is a common point to check when troubleshooting GBase Database connectivity.

Check the Firewall Too

A free port does not automatically mean that clients can reach it.

If remote clients need to connect to GBase Database through TCP port 9088, check the server firewall:

firewall-cmd --list-ports
Enter fullscreen mode Exit fullscreen mode

If your security policy allows it, add the required port:

firewall-cmd --add-port=9088/tcp --permanent
firewall-cmd --reload
Enter fullscreen mode Exit fullscreen mode

There is usually no need to disable the entire firewall just to make the database accessible. Opening only the required port is a better approach.

A Simple Pre-Installation Checklist

Before installing GBase Database(GBase 8s), check:

  • Is port 9088 already in use?
  • Which process owns the port?
  • Is the port configured consistently in the database and sqlhosts?
  • Can remote clients reach the port through the firewall?

The Takeaway

A GBase Database installation problem does not always come from the database itself. Sometimes, a single occupied port is enough to stop the instance from starting.

Before installing GBase Database(GBase 8s), spend a few seconds checking port 9088. It can save you hours of troubleshooting later.

Top comments (0)