Issue
If you are installing and starting a new CQ instance you may experience the following exception:
*ERROR* [FelixStartLevel] org.apache.jackrabbit.core.RepositoryImpl failed to start Repository: Unable to register data store in cluster.
javax.jcr.RepositoryException: Unable to register data store in cluster.
…
Caused by: java.net.UnknownHostException: <server_hostname>: <server_hostname>
at java.net.InetAddress.getLocalHost(InetAddress.java:1360)
at java.net.PlainSocketImpl.connectToAddress(PlainSocketImpl.java:211)
at java.net.PlainSocketImpl.connect(PlainSocketImpl.java:200)
at java.net.SocksSocketImpl.connect(SocksSocketImpl.java:366)
at java.net.Socket.connect(Socket.java:529)
at java.net.Socket.connect(Socket.java:478)
at java.net.Socket.<init>(Socket.java:375)
at java.net.Socket.<init>(Socket.java:218)
… 56 more
Reason
This typically happens if the name returned by the “hostname” command cannot be resolved.
Solution
Add the following entry to /etc/hosts (replacing <server_hostname> with the hostname of the server where the CQ instance is running):
127.0.0.1 <server_hostname>