Search:

Search all manuals
Search this manual
Manual
Couchbase Server Manual 2.0
Community Wiki and Resources
Download Couchbase Server 2.0
Couchbase Developer Guide 2.0
Client Libraries
Couchbase Server Forum
Additional Resources
Community Wiki
Community Forums
Couchbase SDKs
Parent Section
2.2 Installing Couchbase Server
Chapter Sections
Chapters

2.2.4. Mac OS X Installation

Note

Couchbase Server on Mac OS X is for development purposes only.

The Mac OS X installation uses a Zip file which contains a standalone application that can be copied to the Applications folder or to any other location you choose. The installation location is not the same as the location of the Couchbase data files.

Warning

Due to limitations within the Mac OS X operating system, the Mac OS X implementation is incompatible with other operating systems. It is not possible either to mix operating systems within the same cluster, or configure XDCR between a Mac OS X and Windows or Linux cluster.

If you need to move data between a Mac OS X cluster and a cluster hosted on another platform, please use cbbackup and cbrestore. For more information, see Section 5.6.3, “Backup and Restore Between Mac OS X and Other Platforms”.

To install:

  1. Delete any previous installs of Couchbase Server at the command line or by dragging the icon to the Trash can.

  2. Remove remaining files from previous installations:

    > rm -rf ~/Library/Application Support/Couchbase
    
    >rm -rf ~/Library/Application Support/Membase
  3. Download the Mac OS X Zip file.

  4. Double-click the downloaded Zip installation file to extract the server. This will create a single folder, the Couchbase Server.app application.

  5. Drag and Drop Couchbase Server.app to your chosen installation folder, such as the system Applications folder.

Once the install completes, you can double-click on Couchbase Server.app to start it. The Couchbase Server icon appears in the menu bar on the right-hand side. If you have not yet configured your server, then the Couchbase Web Console opens and you should to complete the Couchbase Server setup process. See Section 2.3, “Initial Server Setup” for more details.

The Couchbase application runs as a background application. If you click on the icon in the menu bar you see a list of operations that can be performed, as shown in Figure 3.1, “Couchbase Server on Mac OS X — Menubar Item”.

The command line tools are included in the Couchbase Server application directory. You can access them in Terminal by using the full path of the Couchbase Server installation. By default, this is /Applications/Couchbase Server.app/Contents/Resources/couchbase-core/bin/.