Installing tarball

Installing from a binary tarball

Binary tarballs of TokuMX Community and Enterprise editions are available for 64-bit Linux distributions. A tarball is also available for OSX for development purposes only.

The tarball is intended to be self-contained for easy installation and upgrade.

Installation

1. Download the tarball from the community or enterprise download page.

2. Unpack the tarball to /opt:

   # tar xzf tokumx-1.4.2-linux-x86_64-main.tar.gz -C /opt
   

3. Create symlinks from /usr/local/bin to the unpacked directory:

   # ln -sf /opt/tokumx-1.4.2-linux-x86_64/bin/* /usr/local/bin/
   

4. Ensure that /usr/local/bin is on your PATH before /usr/bin:

   # echo 'export PATH=/usr/local/bin:$PATH' >> ~/.bashrc
   

Running the server

Run mongod, optionally with --fork and --logpath or --syslog:

# mkdir data
# mongod --dbpath=data --logpath=tokumx.log --fork

If you want TokuMX to start on boot, install the packages for Centos, Fedora, Debian or Ubuntu, or modify a MongoDB init script to start /usr/local/bin/mongod instead of /usr/bin/mongod. Most MongoDB init scripts use numactl, this is not necessary for TokuMX, but won't hurt either.

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

Upgrading

If the above installation procedure is followed, future upgrades will be simple:

1. Download the new tarball from the community or enterprise download page.

2. Unpack the tarball to /opt:

   # tar xzf tokumx-1.5.0-linux-x86_64-main.tar.gz -C /opt
   

3. Stop the old server:

   # mongod --dbpath=data --shutdown
   

4. Update symlinks from /usr/local/bin to the unpacked directory:

   # ln -sf /opt/tokumx-1.5.0-linux-x86_64/bin/* /usr/local/bin/
   

5. Start the new server:

   # mongod --dbpath=data --logpath=tokumx.log --fork