Installation Guide for Mac

1. Installation Guide for Mac

This guide supplies step-by-step instructions for installing the required tools for the course.

Note: If you haven't done so already, create a GitHub account.

2. Terminal

Because you’re using a Mac, you already have access to Terminal! To open it, follow these steps:

1. Press Command and the space bar to open Spotlight Search, shown in the following image:

   

2. Type "terminal" in the search box, then press Enter, as shown in the following image:

   

3. Select Terminal from the list of search results—when it opens, it will resemble the following image:

   

3. Xcode

To install Xcode, follow these instructions:

1. Open the Mac App Store and search for Xcode, as shown in the following image:

   

2. Download and install Xcode. When the installation completes, open the program.

3. Agree to the terms of service.

4. You'll know that the installation is complete when the "Welcome to Xcode" window appears, as shown in the following image:

   

4. Java Development Kit (OpenJDK)

1. Navigate to the Adoptium JDK webpage.

2. Select "Temurin 8 (LTS)" from the list.

3. Select "Latest release".

4. Run the installation file.

5. Click Continue to move through the installation process.

6. On the final Summary page, click Finish.

7. Check that the installation was successful by opening Terminal and entering the command java -version.

5. IntelliJ IDEA

1. Navigate to the Intellij IDEA downloads page.

2. Download the Community edition.

3. When the download completes, run the disk image file.

4. In the Finder window that appears, drag the IntelliJ IDEA CE icon into your Applications folder.

5. Find IntelliJ in either Launchpad or your Applications folder, then open it.

6. When you receive a prompt to open a third-party app downloaded from the internet, select Open.

7. Choose whether or not to send usage statistics.

8. After a successful installation, eject the install drive and delete the IntelliJ IDEA disk image from your downloads.

6. Homebrew

1. Navigate to the Homebrew webpage. Copy the script listed under Install Homebrew, as shown in the following image:

   

2. Paste the script into your Terminal window and press Enter, as shown in the following image:

   

That's it!

7. MySQL

1. Once you've installed Homebrew, install MySQL Server using the command brew install mysql.

2. The server is set up without a default root password. You can connect to it using the command mysql -uroot.

Important: You should change the root password after you install MySQL Server. You can do this using the command mysql_secure_installation.

8. Docker

1. Navigate to the Docker Desktop on Mac installation page.

2. Select the "Mac with Intel Chip" or the "Mac with Apple Chip" button, depending on the microprocessor in your computer. The Docker.dmg file will then download.

   Important: First check the OS version to ensure that a compatible version will download.

3. Double-click the Docker.dmg file to start the installation process. Remember to drag the Docker icon into the Applications folder.

9. Docker Images

1. Open Terminal.

2. Pull the Cassandra Docker image by using the following command:

   docker pull cassandra:latest

3. Pull the MySQL Docker image by using the following command:

   docker pull mysql:latest

4. Run the following command:

   docker run -e MYSQL_ROOT_PASSWORD=password -p 3306:3306 --name mysql_local mysql:latest

10. DBeaver

1. Run the command brew install --cask dbeaver-community.

2. If there are no errors, you are ready to use DBeaver!

11. Connect MySQL to DBeaver

1. Open the DBeaver desktop app.

2. Select the Database menu in the top menu bar, then click New Database Connection.

3. Select MySQL and click Next.

4. Enter your "root" as the username and "password" as the password, then click "Test Connection".

5. Click on the Driver Properties tab.

6. Find "allowPublicKeyRetrieval" and change the value to "true".

7. Click Test Connection.

8. Click Download.

9. When the test is successful, click Finish.

12. Create Cassandra Driver

Note: Before creating the Cassandra driver for DBeaver, spin up an instance of Cassandra by opening Terminal and entering the following command:

docker run -p 9042:9042 --name cass_cluster cassandra:latest

1. Download the Simba JDBC driver from DataStax.

   Note: Make sure you select "Simba JDBC Driver for Apache Cassandra" from the dropdown.

2. Unzip the file to a folder you will remember.

3. Open DBeaver.

4. Open the Database menu from the top menu bar, then click Driver Manager.

5. Click New.

6. In the window that opens, fill in the boxes as follows:

   • Driver Name: Cassandra

   • Driver Type: Generic

   • Class Name: com.simba.cassandra.jdbc42.Driver

   • URL Template: jdbc:cassandra://{host}[:{port}];AuthMech=1

   • Default Port: 9042

   Refer to the following image for an example:

   

7. Click on the Libraries tab at the top of the Create New Driver window.

8. Click Add File.

9. Navigate to the file you unzipped in Step 2, select the "CassandraJDBC42" file, and click Open.

10. Click OK.

13. Connect Cassandra to DBeaver

1. Open the DBeaver desktop app.

2. Select the Database menu in the top menu bar, then click New Database Connection.

3. Select Cassandra and click Next.

4. Enter "cassandra" as both the username and password.

5. Click Test Connection.

6. Follow the prompts to download missing components.

7. When the test is successful, click Finish.

14. Insomnia

1. Navigate to the Insomnia download page.

2. Click the Download button.

3. When the download is complete, open the file to bring up the installation prompt.

4. Drag the Insomnia icon into the Applications folder.

15. You're Done

That's all for the installations! Your computer has everything that you'll need to begin on the first day of class.