To setup the Membase Server you must use the web browser setup screens to configure the Membase Server installation, including setting the memory settings, disk locations, and existing cluster configuration. You will also be asked to create a password to be used when logging in and administering your server.
To start the configuration and setup process, you should open the
Membase Web Console. On Windows this is opened for you
automatically. On all platforms you can access the web console by
connecting to the embedded web server on port 8091. For example,
if your server can be identified on your network as
servera, you can access the web console by
opening http://servera:8091/. You can also use
an IP address or, if you are on the same machine,
http://localhost:8091.
Once you have opened the web console for the first time immediately after installation you will be prompted with the screen shown below.
Click the button to start the setup process.
First, you must set the disk storage and cluster configuration.
Configure Disk Storage
The Configure Disk Storage option specifies the location of the persistent (on-disk) storage used by Membase Server. The setting affects only this server and sets the directory where all the data will be stored on disk.
Join Cluster/Start New Cluster
The Configure Server Memory section sets the amount of physical RAM that will be allocated by Membase Server for storage.
If you are creating a new cluster, you specify the memory that will be allocated on each node within your Membase cluster. You must specify a value that will be supported on all the nodes in your cluster as this is a global setting.
If you want to join an existing cluster, select the radio button. This will change the display and prompt the IP address of an existing node, and the username and password of an administrator with rights to access the cluster.
Click to continue the installation process.
You must specify the default bucket for this server.
The options are:
Bucket Type
Specifies the type of the bucket to be created, either
MemcachedorMembase. See Membase Data Buckets for more information.The remainder of the options differ based on your selection.
When selecting the
Membasebucket type:Memory Size
This option specifies the amount of available RAM configured on this server which should be allocated to the default bucket.
Replication
For Membase buckets you can enable replication to support multiple replicas of the default bucket across the servers within the cluster. You can configure up to three replicas. Each replica receives copies of all the key/value pairs that are managed by the bucket. If the host machine for a bucket fails, a replica can be promoted to take its place, providing continuous (high-availability) cluster operations in spite of machine failure.
You can disable replication by setting the number of replica copies to zero (0). This will configure the default bucket as local-only and therefore only accessible on this machine.
When selecting the
Memcachedbucket type:Memory Size
The bucket is configured with a per-node amount of memory. Total bucket memory will change as nodes are added/removed.
For more information, see Memory Quotas.
Click to continue the setup process.
You can optionally enable the notification system within the Membase Web Console.
If you select the Update Notifications option, the Web Console will communicate with Couchbase servers to confirm the version number of your Membase installation. During this process, the client submits the following information to the Couchbase server:
The current version of your Membase Server installation. When a new version of Membase Server becomes available, you will be provided with notification of the new version and information on where you can download the new version.
Basic information about the size and configuration of your Membase cluster. This information will be used to help us prioritize our development efforts.
Note
The process occurs within the browser accessing the web console, not within the server itself, and no further configuration or internet access is required on the server to enable this functionality. Providing the client accessing the Membase server console has internet access, the information can be communicated to the Couchbase servers.
The update notification process the information anonymously, and the data cannot be tracked. The information is only used to provide you with update notification and to provide information that will help us improve the future development process for Membase Server and related products.
Supplying your email address will add you to the Couchbase community mailing list, which will provide you with news and update information about Couchbase and related products. You can unsubscribe from the mailing list at any time using the unsubscribe link provided in each email communication.
Click to continue the setup process.
The final step in the setup process is to configure the username and password for the administrator of the server. If you are create a new cluster then this information will be used to authenticate each new server into the cluster. The same credentials are also used when using the Membase Management REST API. Enter a username and password. The password must be at least six characters in length.
Click to continue the complete the process.
Once the setup process has been completed, you will be presented with the Membase Web Console showing the Cluster Overview page.
Your Membase server is now running and ready to use.