Establishes username and password for the administrator who’s setting up a new, single-node cluster. The administrator has Full Admin permissions, but will not appear as a listed administrator in the Security window of Couchbase Web Console. The administrator will be able to add other administrators, with specific roles, including administrators with Full Admin permissions: all will appear in the Security window of Couchbase Web Console.

During the process of provisioning a new single-node cluster, prior to the establishing of a username and password, no authentication is required to execute the APIs that support provisioning. This permits Naming a Node, Naming a Cluster, and Configuring Memory to be performed without any username or password being specified. However, once a username and password have been established, all further calls, including those used in provisioning, require authentication.

Following the establishment of username and password, the single-node cluster can no longer be initialized. If no memory allocations have been made prior to the username and password being assigned, the default memory allocations are used. See Configuring Memory.

Following the establishment of username and password, the node-name can continue to be assigned and reassigned, provided that the node remains a single-node cluster. Memory allocations and cluster name can also continue to be modified, including after the cluster has become a multi-node cluster.

The password and username arguments are respectively the password and username that must be used for authentication following the call; giving the administrator the Full Admin role.

The REST API port must be specified, with SAME as the default value.

Success returns 200 OK, and a message confirming the IP address of the node, such as: {"newBaseUri":"http://10.144.220.101:8091/"}. Failure to specify a username, password, or port-number returns 400 Bad Request, and an error message such as: {"errors":{"port":"The value must be supplied"}}. Failure correctly to specify the URI returns 404 Object Not Found.

The following example specifies the username as Administrator, the password as password, and the port as the default value of SAME.

Operational Insights roles are described in System Defined Roles.

For each of the specific steps required in the provisioning process, see Configuring Memory, Naming a Node, Naming a Cluster, and Initializing a Node.

For further information about initialization and provisioning — using the UI, the CLI, and the REST API — see Manage Nodes and Clusters.