Github Repository for Revature Online Certification Programming Beginning February 8, 2021
This document provides a list of the required technologies for anyone who will be participating in the ROC I program. It details why each technology is required and provides some step-by-step instructions on how to install and configure the technologies. This guide also walks you through any needed environment setup.
NOTE: It is VERY important that you install these technologies before training begins as we will not have much time to devote to environment setup due to the volume of content we'll cover. It is also important that you install the correct versions of the tools listed here as not all versions of the technologies we will use are guaranteed to be compatible with each other. If you choose to use a different version of one of the tools listed here, you will be responsible for debugging issues that are specific to your version.
The following technologies are required in order to complete this phase of the program:
- Git: We'll be using Git as a version control tool during the course of this program. Not only will you use Git to track changes to your projects, but you'll also use it to collaborate with your trainer and with your fellow associates.
- Java SE Development Kit 8: We will be utilizing Java 8 as our primary language for the duration of the program. This software development kit will provide the compiler and runtime environment needed to quickly and efficiently develop Java applications.
- Spring Tool Suite 4: We will be using Spring Tool Suite 4 as our integrated development environment (IDE). Though you don't need an IDE to write code, an IDE provides several features that make rapid development (e.g. quickly writing and refactoring code) easier.
- Apache Maven: Maven is a software project management and build automation tool. We will use it to manage our projects' builds as it provides dependency management and streamlines several aspects of the testing life cycle.
- PostgreSQL 10: PostgreSQL is an open source relational database. We will leverage this technology in order to persist and organize data.
- DBeaver: DBeaver is a free, open source universal database tool that is compatible with several external data sources, PostgreSQL included. We'll use DBeaver in order to modify our databases and persist data using a simple user interface provided to us by the tool.
- Apache Tomcat 8: During this program, we will explore web development. As a result, we'll need a runtime environment for our web applications. Apache Tomcat provides a web server environment in which we can run our Java code so that we can easily and quickly deploy our web applications.
- Postman: Postman is used for testing RESTful APIs. We'll use it to set up collections of tests for the RESTful APIs we design throughout the program. It can also be used to quickly test a single endpoint.
- Visual Studio Code (Optional): Visual Studio Code is a text editor that makes viewing and modifying code simple. Do not confuse this tool with an integrated development environment as it does not come equipped with all of the development tools you typically find in an IDE. This tool is optional, but it can be helpful if you are new to programming and wish to familiarize yourself with the syntax of the Java programming language.
NOTE: This guide primarily is written for those on a Windows Machine. For Mac users this guide may be more helpful.
You need only visit the official websites for each of the technologies listed and download the version of the tool that is compatible with your system.
Do note that setting system environment variables differs from machine to machine. This guide shows how to set environment variables on a Windows machine.
The first thing you'll want to do is open your web browser of choice. This guide will use Chrome.
Note: Many of the tools that you will install have different system installers that are platform dependent. It is very important that you download the correct installer. The following list details how you should choose the installer for a program:
- If you have a 32-bit version of Windows, use the installer that is marked as the 32-bit version.
- If you have a 64-bit version of Windows, use the installer that is marked as the 64-bit version.
- If you have a Linux distribution (e.g. Debian, Ubuntu, Red Hat, Fedora), you should choose the installer that matches your distribution.
- If you have a Mac, you should choose the installer that is marked as the Mac installer.
These options will be clearly labeled on the websites you visit to download the technologies. If you're not s 8000 ure how to figure out what version of the Windows operating system you're running, do the following:
- Type "Control Panel" into the Windows search bar and click on the "Control Panel" app.
- Select "System and Security".
- Select "System".
You should now see the following screen:
You should see your operating system listed ("Windows 10" in the above example) and the system type listed under the "System" tab (a 64-bit operating system in the above example).
- Navigate in your browser to Git's Website and click the latest download for Windows. (For those using a different OS click the appropriate OS and look for the most recent stable release.)
-
Click yes to any security/firewall popup asking if you are sure you want to download the file.
-
The install file will begin downloading; most browsers will show the file that has just downloaded, click that file when it completes. If you do so skip to step 6. If the download is not apparent on your browser or disappears upon finishing go to step 4.
- If you were not able to click the install exe file you just downloaded in your browser open your file explorer.
- In the window that opens click the "Downloads" folder, use the search bar in the upper right to search "git", and then double click on the Git installer exe file.
-
Click yes to any security pop-ups asking you if you want to allow the installer to make changes to your computer.
-
The install wizard will open to guide you through the process of installing Git. Read the license agreement and click "Next."
- Accept the default installation path by clicking "Next."
- Select your components. It is recommended to add a desktop icon. Leave the other boxes in their default setting. Click "Next."
- Leave the rest of the set up as the default configuration clicking Next until you get to the experimental options (which you should leave unchecked) and then click Install. This will run the actual install process.
- After install you will get a a final window giving you the options to launch Git Bash and view the Readme notes. Select open Git Bash and deselect the view Readme notes. Click "Next."
- When Git Bash opens type "git --version" and hit Enter. If it return the version of Git you installed it correctly.
-
Navigate in your web browser to Oracle's JDK 8 website. NOTE: If you are experiencing errors when trying to load the webpage try another browser. If you still are having trouble, try again later.
-
In the top right of the website click "View Accounts" and then "Create an Account." (If you already have an Oracle account you can just skip to step 5)
- Fill in the form with your information (you may type "none" for Company Name) and then click the "Create Account" button.
- Check your e-mail account for a new message from Oracle. (This may take a few minutes.) When you receive the e-mail open it and click the "Verify Email Address" button inside. This should direct you to a success screen.
- Return to Oracle's JDK 8 website. Scroll to find the appropriate JDK for your Operating System and Architecture. (Windows 10 will be Windows x64 as shown below) and click to download.
- A popup will ask you to review the license before continuing. Do so and click the check box and then the download button.
- If you are not signed in a pop will appear asking you to do so. Enter your sign in information (your e-mail is your user name) and submit. The download should then begin.
- Once the download is complete, click the file that downloads in your browser to open it and skip to step 11. If you do not see the file in your browser then proceed to step 9 to find it in your downloads folder.
- If you could not open the JDK installer from your browser open your file explorer.
- In the window that opens click the "Downloads" folder, search (in the top right) for "jdk" and double click the jdk installer.
- The installer will inform you that the license has been updated from previous versions. Review the license if you have not already and click next.
- The installer will continue and you should just accept the default setup. IMPORTANT: Make note of the file path for the installation directory! You WILL need this later. Click "Next."
- The install will begin extracting files and will ask to confirm the installation directory of the JRE. Confirm the default directory by clicking "Next."
- Java will finish installing and you can then click "Close."
- Use your system search tool (next to the windows button) to look for "Edit the system environment variables" in the control panel. Be sure that you open the SYSTEM environment not the ones just for your account.
- Click the "Environment Variables" button in the window that opens.
- Under "System Variables" click the "New" button.
- Name the new variable "JAVA_HOME" and give it the value of the directory where your JDK was installed to. (See Step 12.) If you are unsure of your directory path you can go to C:\Program Files\Java in your file explorer then click on the JDK folder to open it. You can then copy the path from the navigation bar at the top of the file explorer.
- In your system variables then select the "Path" variable and click "Edit."
- Click "New" to create a new line. Add the path to the JDK bin folder in this line, it will be the same as the path in JAVA_HOME with a "\bin" at the end.
- Click "OK" to close the Environment Variables window.
- Open Git Bash, type "java -version" and hit Enter. If the JDK is installed correctly you should see Java with the version number you downloaded.
- Navigate to the Spring Tools website and download Spring Tools 4 for Eclipse.
- Once the download has finished go to your downloads folder, search for the spring-tool-suite jar file and double click it to begin the install process. NOTE: STS will install to the directory the jar file is in when you open it. If you would like STS to install to another directory than your downloads directory, move the jar file before opening it.
- An unnamed progress bar will appear as STS is installed into your directory.
- Once the install is complete you will have an STS folder in the directory. Double click it to enter it.
- Once inside the folder double click the SpringToolSuite4 application icon to start STS and ensure it runs correctly. If you encounter any errors check all the path variables you configured in the previous setup guides.
-
If STS opens without errors you will be asked to create a workspace. You can just click "Cancel" at this time.
-
If you would like to place a shortcut to STS on your desktop (which is highly recommended) you can right-click the SpringToolSuite4 application, hover over "Send to" and click "Desktop (create shortcut)". You will now have a desktop icon from which you can open STS.
- Navigate in your web browser to the Maven Download Page and scroll down to the "Files" section. Click the Binary zip archive link to download. Approve any firewall/security popups asking if you are sure you want to download the file.
- The download should appear in your browser. When it completes right-click and click "Show in folder." Skip to step 4. If you were unable to right-click and show in folder proceed to step 3.
- If you could not open the file location from your browser, open your file explorer, click downloads, and search "maven" in the upper right search bar. You should see the file you just downloaded.
- Right click the Maven zip archive you just downloaded and click "Extract All..."
- Your extraction wizard will open. Set the file path to "C:\Maven" and click the box to show extracted files when complete. Then click "Extract."
- Your file will be unzipped and your file explore will open a window to C:\Maven containing the folder with your maven version. Double click to open that folder.
- Now inside the versions specific folder, click the navigation bar and the top and copy the file path. You will need this for your environment variables.
- Use your system search tool (next to the windows button) to look for "Edit the system environment variables" in the control panel. Be sure that you open the SYSTEM environment not the ones just for your account.
- Click the "Environment Variables" button in the window that opens.
- Under "System Variables" click the "New" button.
- Name the new variable "M2_HOME" and give it the value of the file path you copied in step 7. Then click "OK."
- Click the new button again. Give the variable the name "M2" and the file path "%M2_HOME%\bin" then click "OK."
- In your system variables then select the "Path" variable and click "Edit."
- Click new to open a new line and type in "%M2%" then click "OK."
- Click "OK" to close the Environment Variables window.
- Open Git Bash and type "mvn -v" then hit Enter. If that returns the maven version you have it set up correctly.
In order to install PostgreSQL, please visit PostgreSQL's official website.
Once you've navigated to the website, you should see the following:
Please look at the row for version 10.13 as we will downloading this version. Select the download link which corresponds with your system and click it.
You'll then be prompted to save the file. Click "Save File".
The file should now be located in your "Downloads" folder.
Double click the file, which should launch the installer. You might be asked if you want the application to make changes to your device. Say "yes".
You'll be presented with several menus in the Setup Wizard.
Hit "Next" until you get to the "Select Components" menu. Here, you'll want to select and/or deselect the following and then click "Next":
Continue to hit "Next" until you reach the "Password" menu. Here you will be tasked with providing a password for the default Postgres user (which is "postgres"). The password is completely up to you. That said, DO NOT forget your password as you won't be able to login to your database as the superuser. If you have to, write your password down somewhere or use a password manager.
After you've decided on a password, hit "Next" on the remaining menus and allow time for Postgres to be installed. Once the installation is complete, you might be asked if you want to launch Stack Builder. You can say "no".
PostgreSQL should now be successfully installed on your computer.
In order to install DBeaver, please visit DBeaver's official website.
Once you navigate to the website, you should see the following:
You'll notice that there are two options: Community Edition and Enterprise Edition. Please select the Community Edition as it is free. Do NOT select the Enterprise as it is not free.
Note that the newest versions of DBeaver require Java 11, as such, as will be using an older version that can be found in the Archives section. Scroll down to the "Archive" and click on the link.
Here, you will find links to previous versions with the installers for the Community Edition. Select the "7.1.1" folder and choose the appropriate installer. As with all other software listed here, please make sure that you choose the correct installer for your system. For windows users, you want to select the "dbeaver-ce-7.1.1-x86_64-setup.exe".
Once you've clicked on the installer that is compatible with your system, you'll be prompted to save the file. Save it and note where you've saved it on your machine. These files are usually stored in your computer's "Downloads" folder by default.
Now navigate to the folder where the installer is stored. For this example, we've downloaded the file to the "Downloads" folder.
Double click the installer. Once you've done so, the installer will be launched. The installer should take you through the process of setting up DBeaver. You'll be asked, for instance, to select a language of choice and review license terms before you install the software.
When you arrive at the portion of the setup which is titled "Choose Components", please select "DBeaver Community" and "Associate .SQL files".
If your installation was successful, you should now be able to search for and find "DBeaver" using your computer's search bar.
In order to download Tomcat, please visit Apache Tomcat's official website.
Once you've navigated to the site, you should see the following screen:
Scroll down until you see the section labeled "Tomcat 8.5.56" as shown below. Click the "Download" link at the bottom of this section.
Note: At the time of this tutorial, the version of Tomcat 8 was 8.5.56. In the future, this will not be the case. That said, please choose any version of Tomcat 8 that is available. In other words, Tomcat 8.x.xx is a valid choice as well.
After you've clicked the "Download" link, you should be taken to yet another page. Scroll down until you see the following:
Click the "zip" option under the "Core" section. It should be the first option listed. You should see the following after you've clicked the link, after which you should opt to save the file.
Now go into your system's "Downloads" folder. You should see a folder that is labeled "apache-tomcat-8.x.xx".
Right click the folder. Once you do so, you should see a list of options. Choose the option that reads "Extract All...". You'll then be asked to select a destination for the extracted files. You may choose any location on your computer you wish to by hitting the "Browse" button, but for this tutorial, we will be choosing to place the extracted files in the "Program Files" folder.
Note: Please keep note of where you choose to place the extracted files as you'll need this information in the next step.
Once you've selected a destination, hit the "Extract" button at the bottom of the box.
After you've done so, wait for the files to be extracted. Then go the location where you specified the extracted files should be placed. In our case, we are navigating to the "Program Files" directory.
There you should see the files you just extracted in a folder called "apache-tomcat-8.x.xx". Go inside of this folder by double clicking it. Once inside, copy the path to it by clicking on the bar that shows your file path near the top of the box. It should be directly to the left of the search bar. In this example, the bar contains the text:
Local Disk (C:) > Program Files > apache-tomcat-8.5.56
Once you've clicked on the bar, copy the address. In this example, the address is:
C:\Program Files\apache-tomcat-8.5.56
Note: This next portion will only work if you are running Windows as the process for setting environment variables is different on different systems.
Now go into your search bar and type "Edit the System Environment Variables".
Then click on the "Environment Variables" button at the bottom of the box that appears.
A new box should pop up. At this point, you should click the "New" button at the bottom of the box.
Yet another box will then pop up. It will prompt you for a "Variable name" and "Variable value". Enter the following into these boxes:
The variable name MUST be exactly what is typed above. The variable value should equivalent to the path to your Tomcat folder you copied during the last step.
Once you've entered this information, hit "OK". You should then hit "OK" again on the remaining two boxes.
Note: If you do not hit OK on all three of the boxes, your environment variable will not be properly set!
In order to verify that your environment variable was properly set, please open your terminal (e.g. type "Command Prompt" into the Windows search bar) and type the following:
At this point, the value of the CATALINA_HOME environment variable should be displayed.
In order to download Postman, please visit Postman's official website.
Once you've navigated to the site, you should see the following:
Note that the default download is for Windows. If you wish to download Postman for Mac or Linux, you should click on one of the links highlighted in the small box beneath the version number and "RELEASE NOTES" link. You can see these links at the bottom of the image provided above for reference.
You should now click the "Download" button, at which point you'll be prompted to select either Windows 32-bit or Windows 64-bit (assuming you're downloading Postman for Windows). Choose the option which is compatible with your system. You'll then be prompted to save the file.
Once you've saved the file, open your "Downloads" folder and double click the newly downloaded installer.
Upon double clicking the executable, the installer will be launched and the program will be installed. In order to verify that it has been installed correctly, you can search for "Postman" on your machine by using your search bar.
Note that you'll likely have to sign up for an account to use the application. Please do so as signing up for an account is completely free.
In order to download Visual Studio Code, please visit Visual Studio Code's official website.
Once you've navigated to the website, you should see the following:
Choose the installer that is compatible with your system. Once you've clicked the installer of your choice, you'll be prompted to save the file. Do so.
Once you've saved the installer, it should be located in your "Downloads" folder.
Double click the installer. Once you've done so, the installer should be launched. Accept the license agreement and proceed until you reach a menu titled "Select Additional Tasks". Once you've arrived here, be sure to check all of the boxes that are checked in the image!
After you've done so, hit "Next" and then "Install" on the next menu. If your installation was successful, you should be able to search for "Visual Studio Code" on your machine.
- Git Cheat Sheet (This is a GitHub-provided cheat sheet for some simple Git commands.): https://github.github.com/training-kit/downloads/github-git-cheat-sheet.pdf
- Java Docs (The official API specification for Java 8): https://docs.oracle.com/javase/8/docs/api/
- Maven Repository (This provides a repository of dependencies which we can add to our Project Object Models.): https://mvnrepository.com/
- PostgreSQL Docs (This is PostgreSQL's official documentation.): https://www.postgresql.org/docs/