Installing on Debian and Ubuntu

Installing on Debian and Ubuntu

Binary packages of TokuMX Community and Enterprise editions are available for Debian 7 and Ubuntu 12.04, 12.10, 13.04, 13.10, and 14.04. The packages come in four components:

• tokumx is a metapackage that installs the full TokuMX distribution.
• tokumx-clients contains the mongo client shell and various tools like mongoimport and mongoexport.
• tokumx-common contains the Fractal Tree indexing libraries and some documentation.
• tokumx-server contains the mongod database server and the mongos routing server.

For enterprise packages, see the enterprise download page.

Community Edition Installation

1. Add the Tokutek package signing key.

   $ sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-key 505A7412
   

   You can check that the fingerprint is correct:

   $ sudo apt-key finger 505A7412
   /etc/apt/trusted.gpg
   --------------------
   pub   2048R/505A7412 2014-01-27
         Key fingerprint = DA56 C65D 432E DAB1 F183  AA6F 70A4 E325 505A 7412
   uid                  Timothy Callaghan (Tokutek Key) <tim@tokutek.com>
   sub   2048R/46A1A9B9 2014-01-27
   

2. Add an entry for the TokuMX package repository for your release (wheezy, precise, quantal, raring, saucy, or trusty).

   $ echo "deb [arch=amd64] http://s3.amazonaws.com/tokumx-debs $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/tokumx.list
   

3. Update apt and install TokuMX.

   $ sudo apt-get update
   $ sudo apt-get install tokumx
   

Running the server

If migrating from an existing MongoDB installation, copy any relevant configuration from /etc/mongodb.conf to /etc/tokumx.conf.

To migrate your existing data to TokuMX, start here: Migrating from MongoDB

1. To control the mongod data server, use service:

   $ sudo service tokumx start
   $ sudo service tokumx restart
   $ sudo service tokumx stop
   

2. To enable TokuMX on boot, use chkconfig on Debian:

   $ sudo chkconfig tokumx on
   $ sudo chkconfig tokumx off
   

   or update-rc.d on Ubuntu:

   $ sudo update-rc.d tokumx defaults
   $ sudo update-rc.d tokumx remove
   

Connecting to TokuMX

Use the mongo shell:

$ mongo
TokuMX mongo shell v1.4.2-mongodb-2.4.10
connecting to: test
Welcome to the TokuMX shell.
For interactive help, type "help".
For more comprehensive documentation, see
	http://docs.mongodb.org/
and the TokuMX Users' Guide available at
	http://www.tokutek.com/products/downloads/tokumx-ce-downloads/
Questions? Try the support group
	http://groups.google.com/group/tokumx-user
> db.serverBuildInfo().tokumxVersion
1.4.2