Installing on Centos

Leif Walsh edited this page May 9, 2014 · 4 revisions

Installing on Centos

Binary packages of TokuMX Community and Enterprise editions are available for Centos 5 and 6. The packages come in three components:

  • tokumx 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.


  1. For a full installation, download all three packages from the community or enterprise download page.

    You should have these files in your current directory:

    $ ls tokumx*.rpm
    tokumx-1.4.2-2.el6.x86_64.rpm  tokumx-common-1.4.2-2.el6.x86_64.rpm  tokumx-server-1.4.2-2.el6.x86_64.rpm
  2. Install the downloaded packages with yum.

    $ sudo yum install tokumx*.rpm

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:

    $ sudo chkconfig tokumx on
    $ sudo chkconfig tokumx off

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
and the TokuMX Users' Guide available at
Questions? Try the support group
> db.serverBuildInfo().tokumxVersion