Errors & Exceptions Reference

    +
    Error codes and messages, and some links to further actions.

    Connecting to Cloud

    Although the SDK and cliet application should be located in the same LAN-like environment (or cloud availability zone), and this is the only network configuration supported, we recognise that this set-up may not be possible during development. In particular, you may be developing against Couchbase Cloud from a laptop in a small or home office, where DNS-SRV may cause problems.

    In order for your application to connect to your cloud, Couchbase Cloud creates a special kind of DNS record, called a Service record, or DNS-SRV record. DNS SRV records are widely supported and used frequently in systems like XMPP, and Kubernetes services. Occasionally, some DNS providers can run into issues with large DNS SRV records. This can manifest as a host not found issue. The actual problem is (a typically older) DNS server that cannot handle large responses which converts the error to host not found. This has frequently been observed when working from home with a service provider router that embeds a caching DNS Server.

    Below is a list of log messages that you may see if you hit DNS SRV issues. These examples have been created in the circumstance that the SRV record is too long for the DNS provider to handle, and are included here so that they are findable by search, and you can then go to our cloud connection troubleshooting page.

    54ms [I5afdccc413f7d46] {81150/307} [ERROR] (connection - L:503) <8676842d-4e8b-4c5b-a44f-e0886f8c0bc1.dp.cloud.couchbase.com:11207> (SOCK=a683f97effd6323c) Couldn't look up 8676842d-4e8b-4c5b-a44f-e0886f8c0bc1.dp.cloud.couchbase.com (nodename nor servname provided, or not known) [EAI=8]
    54ms [I5afdccc413f7d46] {81150/307} [ERROR] (connection - L:164) <8676842d-4e8b-4c5b-a44f-e0886f8c0bc1.dp.cloud.couchbase.com:11207> (SOCK=a683f97effd6323c) Failed to establish connection: LCB_ERR_UNKNOWN_HOST (1049), os errno=0
    54ms [I5afdccc413f7d46] {81150/307} [DEBUG] (lcbio_mgr - L:349) <8676842d-4e8b-4c5b-a44f-e0886f8c0bc1.dp.cloud.couchbase.com:11207> (HE=0x7fa82f4252e0) Received result for I=0x7fa82f426d40,C=0x0; E=0x419
    Could not get configuration
    54ms [I5afdccc413f7d46] {81150/307} [ERROR] (cccp - L:171) <NOHOST:NOPORT> (CTX=0x0,) Could not get configuration: LCB_ERR_UNKNOWN_HOST (1049)
    Provider 'CCCP' failed
    54ms [I5afdccc413f7d46] {81150/307} [INFO] (confmon - L:196) Provider 'CCCP' failed: LCB_ERR_UNKNOWN_HOST (1049)
    54ms [I5afdccc413f7d46] {81150/307} [DEBUG] (confmon - L:240) Will try next provider in 0us
    54ms [I5afdccc413f7d46] {81150/307} [TRACE] (confmon - L:285) Attempting to retrieve cluster map via HTTP
    54ms [I5afdccc413f7d46] {81150/307} [TRACE] (htconfig - L:359) Starting HTTP Configuration Provider 0x7fa82f406730
    Timeout=2000000us
    54ms [I5afdccc413f7d46] {81150/307} [INFO] (connection - L:487) <8676842d-4e8b-4c5b-a44f-e0886f8c0bc1.dp.cloud.couchbase.com:18091> (SOCK=385c8688a482c7bd) Starting. Timeout=2000000us
    Couldn’t look up …​ (nodename nor servname provided, or not known)
    55ms [I5afdccc413f7d46] {81150/307} [ERROR] (connection - L:503) <8676842d-4e8b-4c5b-a44f-e0886f8c0bc1.dp.cloud.couchbase.com:18091> (SOCK=385c8688a482c7bd) Couldn't look up 8676842d-4e8b-4c5b-a44f-e0886f8c0bc1.dp.cloud.couchbase.com (nodename nor servname provided, or not known) [EAI=8]
    Failed to establish connection: LCB_ERR_UNKNOWN_HOST (1049), os errno=0
    55ms [I5afdccc413f7d46] {81150/307} [ERROR] (connection - L:164) <8676842d-4e8b-4c5b-a44f-e0886f8c0bc1.dp.cloud.couchbase.com:18091> (SOCK=385c8688a482c7bd) Failed to establish connection: LCB_ERR_UNKNOWN_HOST (1049), os errno=0
    Connection to REST API failed with LCB_ERR_UNKNOWN_HOST
    55ms [I5afdccc413f7d46] {81150/307} [ERROR] (htconfig - L:309) Connection to REST API failed with LCB_ERR_UNKNOWN_HOST (1049) (os errno = 0)
    Provider 'HTTP' failed
    55ms [I5afdccc413f7d46] {81150/307} [INFO] (confmon - L:196) Provider 'HTTP' failed: LCB_ERR_UNKNOWN_HOST (1049)
    Maximum provider reached. Resetting index
    55ms [I5afdccc413f7d46] {81150/307} [TRACE] (confmon - L:245) Maximum provider reached. Resetting index
    Failed to bootstrap
    55ms [I5afdccc413f7d46] {81150/307} [ERROR] (bootstrap - L:196) Failed to bootstrap client=0x7fa82f405cd0. Error=LCB_ERR_NO_MATCHING_SERVER (1010) (Last=LCB_ERR_UNKNOWN_HOST (1049)), Message=No more bootstrap providers remain
    Couldn’t bootstrap from cluster
    Couldn't bootstrap from cluster. Received code 0x419 (LCB_ERR_UNKNOWN_HOST (1049))