GBase Database Installation Troubleshooting: A Quick Reference

Summary: Use this GBase Database(GBase 8s) troubleshooting guide to diagnose common installation, startup, connectivity, locale, disk space, and permission issues on Linux.

When installing GBase Database(GBase 8s), many errors can be traced to a few recurring causes. This quick reference helps you identify what to check first instead of troubleshooting blindly.

GBase Database Installation Troubleshooting Checklist

Symptom	Possible cause	What to check
oninit won't start	Port conflict or startup configuration error	Check the configured port with ss -tlnp; inspect the startup error and online log
dbaccess cannot connect	Hostname or connection configuration mismatch	Verify sqlhosts, hostname, and /etc/hosts
Garbled text or unexpected sorting	Locale or character set mismatch	Check DB_LOCALE and the database/client locale configuration
Reinstall reports “version already exists”	Leftovers from a previous installation	Verify the old installation state and inspect relevant files before cleanup
Installation hangs during extraction	Insufficient temporary disk space	Run df -h /tmp and check available space
Permission error during installation	Incorrect ownership or execution user	Verify installation directory ownership; run instance initialization as gbasedbt

Recommended Troubleshooting Order

For common GBase Database installation errors, start with these checks:

1. Port and startup status — identify port conflicts and inspect startup errors.
2. Connectivity configuration — verify sqlhosts and hostname resolution.
3. Locale settings — check character set compatibility before creating production databases.
4. Previous installation leftovers — confirm what can safely be removed.
5. Disk space — check /tmp and the filesystems used by the installation and data directories.
6. Permissions — verify directory ownership and the correct execution user.

Important: Don't run onmode -ky or delete installation files without confirming the target instance and environment. These actions can disrupt a running service or remove files still in use.

For reliable GBase Database deployment, keep this checklist in your team's installation documentation. A consistent troubleshooting process reduces repeated mistakes and makes database operations easier to maintain.

Which GBase Database installation issue do you encounter most often?