Familiarize Yourself With The Course Tools

DSE Version: 6.7

Intro

Exercises

Slides

No write up.

Exercise: Familiarize Yourself With The Course Tools

In this exercise, you will:

  • Launch an Apollo databse

  • See KillrVideo in action

  • Take a quick look at Theia - an IDE

  • Learn how to use DataStax Studio

We'll start by Launching an Apollo database.

Without Apollo, launching a secure Apache Cassandra database can be a daunting task. There is a myriad of decisions to make about various settings and configuration options. While most of these configuration settings have defaults, it is difficult to know which defaults to use and which ones to change.

But things are different thanks to Apollo. This service streamlines the process down to a handful of simple configuration parameters that are easy to understand and set. This exercise shows you just how easy this is.

Steps

1. Go to the Constellation website. From the course landing page, click on the DataStax Constellation link (it takes you to datastax.apollo.com).

 

2. Use your credentials to log in to Constellation. Fill out the Log In dialog with your Constellation credentials, and click the Log In button - or register if you are one of the few people left on the earth without a Constellation account.

2. Verify cloud provider. As Apollo adopts more cloud providers, you will see them listed here.

3. Select the region. This is the region where your database will reside physically (choose one close to you or your users).

4. Fill in the database name - killrvideocluster. While Apollo allows you to fill in these fields with values of your own choosing, please follow our reccomendations to make the rest of the exercises easier to follow. If you don't, you are on your own! :)

5. Fill in the keyspace name - killrvideo. It's really important that you use the name killrvideo (with no 'e' in "killr") here in order for all the exercises to work well. We realize you want to be creative, but please just roll with this one today.

6. Fill in the Database User name - KVUser. Note the user name is case-sensitive. Please use the case we suggest here.

7. Fill in the password - KVPassword. Fill in both the password and the confirmation fields. Note that the password is also case-sensitive. Please use the case we suggest here.

8. Set the Compute Size. For the work we are doing, just use the Developer: low-cost option.

9. Launch the database. Review all the fields to make sure they are as shown, and click the Launch Database button.

10. View your database. It may take 20-30 minutes for your database to spin up. You will receive an email at that point. But, go ahead and continue with the rest of the exercise now.

11. Lets review the database you have configured. In the box on the top-left side of the window, you can see the database and keyspace name metadata. The box on the top-right describes the size and location of your database. The lower-left box shows your estimated cost. Once Apollo initializes the database completely, the lower-right box will have connection details.

Now let's take the KillrVideo tour.

KillrVideo is our reference app that shows you how to handle many different use-cases with Cassandra. Let's look at the KillrVideo functionality.

Steps

1. Open your KillrVideo instance. From the course landing page, click on the KillrVideo (Local) link.

You should see something that looks like the following.

 2. Inspect the landing page. A quick look at the landing page (and the "LOADING..." message alerts you that your instance of KillrVideo doesn't look like the official killrvideo.com site the instructor showed you.

There are two reasons why your instance isn't fully functional:

  • First, the back-end service for your KillrVideo instance is not yet running.
  • Second, Even if your back-end service were running, it's not fully functional yet - That's what you get to build in this class!

However, there are some things we can investigate in our own instance of KillrVideo...

3. Start a tour. One of the things you can do with your instance of KillrVideo is to follow the online tour. Start by clicking the Tour Off button on the top of the window:

4. Continue the tour. We'll only take a couple steps into this tour right now. We just want you to be aware of it.

5. Leave the tour. Now that you have seen how to follow the tour, we'll leave off here. You can come back and follow the tour later. It's a great way to see the KillrVideo data model and some of the interesting use-cases contained within KillrVideo.

6. Try to register. Eventhough we realize the functionality is missing, let's try to register just to see what happens. Click on the REGISTER button in the top-right corner of the window, fill out the form and click Register.

 

7. Regain your composure. Yeah, registration didn't work - but that's actually a good thing. Fixing the identity management service is what we will learn how to do in this course!

Next, we'll look at the IDE we will use in this course.

If we are going to do any developement, of course, we're going to need and IDE. We'll use Theia on a cloud instance so we can avoid all the installation and set-up.

Theia is easy to use - take a look

Steps

1. Launch Theia. From your course landing page, click on the Eclipse Theia IDE link to open Theia in a new browser tab.

You should see something in a new tab that looks like the following.

Theia looks like most IDEs. Across the top you see a standard set of menu optoins.

On the left side is the Project Explorer. You see that we have six different projects.

2. Expand the crud-python project. Each of these projects contains many files. You can expand the project and its folders to see the files the project contains. We'll expand the crud-python project because it's a nice simple project.

3. Open db_connection.py. In the project browser you can click on a file name to open the file. Click on db_connection.py to see its contents.

WARNING: Theia automatically saves file changes, so be careful not to change this file at this time.

4. Close the file. We'll look into these projects and files later. We only wanted to open the file to show you how to do it. Now that you know, close the file. Click on the "X" in the file window's tab to close the file.

5. Open a command-shell terminal window. Click on the Terminal menu-item, then on New terminal. You will notice the terminal window open at the bottom of Theia.

6. Enter a Linux command. Just to demonstrate that this is a standard Linux command shell, let's enter the ls command.

You see that we are in the ~/workspace directory. The ls command lists the names of all the project directories.

7. Expand the command-shell window. You can double-click on the command-shell window's tab to expand it to full-screen mode.

8. Return the command-shell window to its original size. Double-click on the window's tab again to shrink the window. By the way, this works for all windows in Theia.

9. Close the command-shell window. Click on the "X" in the window's tab to close the window.

You are now armed and dangerous with respect to Theia.

Finally, Let's learn how to use DataStax Studio.

Studio is a development and prototyping tool we will use to Explore Apollo. Let's try out an introductory notebook to learn how to use Studio.

WARNING: You will be unable to proceed with the steps in the section of the exercise until your Apollo instance is up and running.

Steps

1. Launch Studio. Now let's familiarize ourselves with DataStax Developer Studio. Your database machine(s) hosts the Studio application. This application let's you access your Cassandra database via notebooks - we'll show you...

Back in the Apollo tab, click on Launch Developer Studio.

 

2. Look for the notebook. Here is the notebook you are looking for (if you don't see it, refer to the next section):

If you cannot find this notebook, you can download it here, and then import the notebook into Developer Studio.

3. Open the notebook. Click on the notebook to open it.

4. Fill in Connection credentials. The first time you open the notebook, you will be prompted for the Connection credentials. Fill in the credentials as shown (KVUser and KVPassword). Then, click the Test button to make sure the credentials work. Once you have verified the credentials, click Save.

5. Work through the notebook. This notebook explains how to use studio. Either with your instructor, or individually, follow the exercises in the notebook. Once you have completed this notebook, you have completed this exercise!

Woohooo!!! You have your very own full Cassandra database spinning-up! Proudly let your friendly neighbors know you beat them. This isn't a race, but let's see if you finished first.

END OF EXERCISE

No FAQs.
No resources.
Comments are closed.