By following the steps given in this chapter, you shouldn't encounter any issues as such with the installation. However, let's look at troubleshooting some common issues, which may help you with a successful installation.
When attempting the database sync in the populate the Keystone DB section, you may encounter errors. Please follow the following steps to try and fix the errors.
If your Keystone commands are failing, you should check for the following.
The service may hang, due to which you will see 5XX errors. Restart the service using the service Keystone restart
command.
Please ensure that you are able to resolve the names that are mentioned in several of the configuration URLs. If you cannot ping them, check the DNS server configuration in /etc/resolv.conf
(if it is an enterprise environment) or simply ensure that the /etc/hosts
file has the appropriate entries.
Please ensure that there are no IP table services, that, if present, they are disabled, or that the proper rules are in place to allow different ports and communications. Please note, Keystone uses the 5000
and 35357
ports.
Please ensure that the ports are listening to all IP addresses or to an external IP address rather than to the 127.0.0.1 or localhost. You can verify this by netstat –ln
.
Please ensure that you have proper routing rules and a default gateway in place. The routing table can be checked using the netstat –rn
command.