1.Base

1.Base Template

This is a base Vagrant template that starts with only Java pre-installed. Follow the instructions below to try a couple different ways of installing Apache Cassandra and DataStax Enterprise.

Instructions

Setup

If Vagrant and VirtualBox have been installed correctly, you can bring up the Vagrant VM with the following:

$ vagrant up

The process will take several minutes to create the VM and load the initial packages. For the very first run, the download will take a while as the whole Ubuntu image is downloaded to your system. Future "ups" will be much faster.

When the up command is done, login to the VM and confirm that Java is installed:

$ vagrant ssh
vagrant@base:~$ java -version
openjdk version "1.8.0_242"
OpenJDK Runtime Environment (build 1.8.0_242-8u242-b08-0ubuntu3~16.04-b08)
OpenJDK 64-Bit Server VM (build 25.242-b08, mixed mode)

Cassandra (Tarball)

First let's try installing Apache Cassandra from the tarball. These steps are patterned after the Cassandra Getting Started page.

1. From the Cassandra project site find the current 3.0 release tarball download link

2. Click the link to find a suitable mirror link and copy it

3. From inside the VM, download and expand:

    $ wget https://www-us.apache.org/dist/cassandra/3.0.19/apache-cassandra-3.0.19-bin.tar.gz
    $ tar xvzf apache-cassandra-*-bin.tar.gz
    $ cd apache-cassandra-*
   

4. Now we'll start Cassandra (as a background process) and make sure it's running with cqlsh, the interactive CQL shell:

    $ bin/cassandra
    $ bin/cqlsh
    Connected to Test Cluster at localhost:9160.
    [cqlsh 5.0.1 | Cassandra 3.0.19 | CQL spec 3.4.0 | Native protocol v4]
    Use HELP for help.
    cqlsh>
   

5. Try some CQL commands:

    CREATE KEYSPACE usertest WITH REPLICATION = { 'class' : 'SimpleStrategy', 'replication_factor' : 1 };
   
    USE usertest;
   
    CREATE TABLE users (
      user_id int,
      fname text,
      lname text,
      email text,
      primary key (user_id)
    );
   
    INSERT INTO users (user_id, fname, lname, email) VALUES (1000, 'john', 'smith', '[email protected]');
    INSERT INTO users (user_id, fname, lname, email) VALUES (1001, 'john', 'doe', '[email protected]');
    INSERT INTO users (user_id, fname, lname, email) VALUES (1002, 'bob', 'johnson', '[email protected]');
   
    SELECT * FROM users;
   

To exercise and play further with Cassandra, go through the Getting Started walk-through. To load the table with more data, there is a sample data CSV file which can be imported using the CQL shell:

$ cqlsh
Connected to Test Cluster at localhost:9160.
[cqlsh 5.0.1 | Cassandra 3.0.19 | CQL spec 3.4.0 | Native protocol v4]
Use HELP for help.
cqlsh> COPY usertest.users (user_id, email, lname, fname) FROM '/vagrant/sample_users.csv' WITH HEADER = true;
100 rows imported in 0.173 seconds.
cqlsh> select count(*) from usertest.users;

 count
-------
   103

(1 rows)

To clean up from this step, stop Cassandra and remove the data directories:

$ pkill -f CassandraDaemon
$ rm -rf data/
$ rm -rf logs/

DataStax Distribution of Apache Cassandra

Next we'll try installing the DataStax Distribution of Apache Cassandra using the tarball.

1. From the DataStax downloads page find and download the current release tarball (as of this writing, it's ddac-5.1.15-bin.tar.gz)

2. Move the ddac tarball into the 1.Base directory

3. From inside the VM, download and expand:

    $ tar xvzf /vagrant/ddac-*-bin.tar.gz
    $ cd ddac-*
   

4. Next create the data and log directories for Cassandra

    $ sudo mkdir /var/{lib,log}/cassandra
    $ sudo chown -R $USER:$GROUP /var/{lib,log}/cassandra
   

5. Now we'll start Cassandra (as a background process) and make sure it's running with cqlsh, the interactive CQL shell:

    $ bin/cassandra
    $ bin/cqlsh
    Connected to Test Cluster at 127.0.0.1:9042.
    [cqlsh 5.0.1 | Cassandra 3.11.3.5115 | CQL spec 3.4.4 | Native protocol v4]
    Use HELP for help.
    cqlsh>
   

Now you can play with Cassandra as we did before, using the CQLSH tool.

See also the example 6.DDAC which is a full automatic multinode install of DDAC.