Troubleshooting the installation and configuration

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.

Note

If your installation was successful, you may choose to skip this section.

DB sync errors

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.

System language settings

The language setting of your computer can cause issues while conducting the initial database sync. In order to prevent such issues, export the language variables using the following command:

export LC_ALL=en_US.UTF-8
export LANG=en_US.UTF-8

Configuration errors

Please ensure that the configuration file has the correct SQL URL. The format is mysql://username:password@host:port/databaseName. If your password has an @ symbol, the database sync will fail.

Failing Keystone commands

If your Keystone commands are failing, you should check for the following.

Service non-responsive

The service may hang, due to which you will see 5XX errors. Restart the service using the service Keystone restart command.

DNS issues

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.

Network issues

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.

..................Content has been hidden....................

You can't read the all page of ebook, please click here login for view all page.
Reset