A newer version of this documentation is available.

View Latest

Setting Storage Paths

The paths for data storage, index storage, and analytics storage can be configured with POST /nodes/self/controller/settings.

HTTP method and URI

POST /nodes/self/controller/settings
Table 1. /nodes/self/controller/settings parameters
Argument Description


The path for data storage. This parameter can only be used when initializing a node that is not part of a provisioned cluster.


The path for the index files.


The path for analytics storage. This parameter can be repeated several times, separated by ampersands, to setup multiple storage paths (I/O devices) in analytics.


Curl request syntax:

curl -X POST -u [admin]:[password]
    -d path=[data storage path]
    -d index_path=[index storage path]
    -d cbas_path=[analytics storage paths]


Raw HTTP request:

POST /nodes/self/controller/settings HTTP/1.1
Host: localhost:8091
Content-Type: application/x-www-form-urlencoded; charset=UTF-8
Authorization: Basic YWRtaW46YWRtaW4=
Content-Length: xx path=/var/tmp/test_indexpath

Curl request example

curl -X POST -u Administrator:password \
   -d 'index_path=/var/tmp/test_indexpath' \
   -d 'cbas_path=/mnt/d1&cbas_path=/mnt/d2&cbas_path=/mnt/d3' \

Response codes

The HTTP response contains the response code and optional error message:

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 0

If you try to set the data path at this endpoint, the following error displays:

ERROR: unable to init (400) Bad Request
{u'error': u'Changing data of nodes that are part of provisioned cluster is not supported'}