Developing RESTful Services with REST/JAX-RS: Lab Setup Instructions (Mac OS: Java 11, Eclipse, Tomcat 9)

Below are the standard requirements for this course. If you have any questions or issues, please contact us.

Important Note: Student lab files are required on each computer used for the course. The links for these are not in this lab setup, and you should receive them separately.

Other notes:

• It’s a good idea to keep downloaded software install files on the machines during the class in case of problems that require a re-install.
• Cloning a setup is generally not a problem. If it is, we’ll mention it in the software section (for example, much of the IBM/RAD-WAS software can be problematic in this regard).

Hardware and classroom setup.

Each student and the instructor shall have a workstation that fulfills the listed requirements.

• Required: Intel-compatible processor (with reasonably recent hardware).
• Memory: 8GB min recommended
• Disk Space: Free disk space for software installs (generally minimum 2GB)
• Operating System: One of the following.
  • Mac OS: Any relatively recent version - lab instructions are generally geared for Windows users, but Mac users should be able to adapt fairly easily. If shell scripts are provided for labs, they generally are provided in both Windows and *nix variants.
  • Linux: The labs should run under Linux, but we do not test under Linux, nor directly support it. If you have problems or questions, feel free to reach out, and we’ll do our best to help.
• Recommended: Internet access
• Recommended: Class machines networked together - allows students to access a shared network directory.
• Required: Adobe Acrobat Reader
• Required: One of either Safari browser, Firefox browser (https://www.mozilla.org/en-US/firefox/new/) or Chrome browser (https://www.google.com/chrome/).

Lab Files: Each student and instructor must have lab files installed (links to these files are generally sent separately via e-mail).

• Extract the lab files to a location conveniently accessible to the student (e.g. the student’s home directory )
• If using folder other than the student’s home directory, make sure that students know where they are.

Other instructor requirements for the classroom

• Projector or large screen TV capable of 1280x800 or higher resolution. Instructor must be able to use this to project slides.
• Whiteboard (preferred) or flip charts with markers.

Install Java Development Kit – JDK 11 (11.0.15)

• Note that any JDK 11 version should work fine. Other close (later) Java versions (e.g. Java 12 or 13) should be fine also, but have not been tested.
   
• From https://www.oracle.com/java/technologies/javase/jdk11-archive-downloads.html download the installer file for your OS
  • Mac OS something like: jdk-11.0.n_osx-x64_bin.dmg

• Run the installer and take all defaults.

• Create or modify environment variables. This will add an environment variable JAVA_HOME, and modify your path to include the jdk bin folder
  • Done by modifying .bash_profile in the user’s home folder
    • Open ~/.bash_profile for editing (Make a copy first - .bash_profile.ORIG)
    • Insert the following lines into the file:
      
      export JAVA_HOME=$(/usr/libexec/java_home)

      export PATH=$JAVA_HOME/bin:$PATH

• Open a terminal prompt, type the below, and press Enter
  
  javac -version
  
  You should get a message that tells you the version. If the command is not found, you did something wrong.

• Close the terminal prompt. You’re done installing Java

Install Eclipse 2020-06 for Enterprise Java Developers (Mac OS)

• Download:
  • Try a direct link first:
    https://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/2020-06/R/eclipse-java-2020-06-R-macosx-cocoa-x86_64.dmg
  • If you have problems with a direct link, follow the instructions below
    • Go to https://www.eclipse.org/downloads/packages/release/2020-06/r
    • Look for the heading “Eclipse IDE 2020-06 R Packages” and the download areas below it. This is below the top banner on the page. Do NOT use the Download links in the top banner.
    • Find the section for “Eclipse IDE for Enterprise Java Developers”
    • Click the link next to Mac Cocoa 64 bit
    • The install file will have a name like eclipse-jee-2020-06-R-macosx-cocoa-x86_64.dmg
• Install:
  • Execute the installer
  • Install to applications folder as usual
• Test
  • Execute the program (Click on it in Applications)
  • Accept the default workspace, and let it load
  • Quit Eclipse
     
• That’s it. You’re done installing Eclipse

Install Tomcat 9.0

• Download: From https://tomcat.apache.org/download-90.cgi go to the Binary distributions section for Tomcat 9.0 and download the zip file
  • Go to the link with label zip: in the section labeled Core:
  • The filename will be something like apache-tomcat-9.0.94.zip
  • Save the file where you can access it easily
     
• Extract: Extract the zip file where students can access and run it easily.
  • Windows OS: Common location is C:\
  • Mac OS: Common location is user home directory.
     
• That’s all that needs to be done to install Tomcat.