Enablement Bootcamp Prerequisite

What to Know

Prior to attending the enablement bootcamp, all students should have completed the Level 0 Learning Path delivered as a quarterly webinar or through Liferay Learn.  To access the learning content on Liferay Learn, you will need to be logged in as a Liferay partner or employee

What to Bring

  • Git
  • Java JDK version 11.0.23+ (Some students have experienced problems with v11.0.2)
  • Liferay Blade CLI
  • 4gb available RAM
  • 10gb available disk space
  • Clone/Download the Enablement Workspace
  • Optional: JMeter 5.6.3
We recommend completing these activities before traveling to the bootcamp. While we will do everything we can to have wifi available for the bootcamp, sometimes things happen that will be beyond our control.

Completing these steps before you travel will minimize your dependency on the available wifi.

Installing and Verifying Git

To verify if you already have Git installed, open up your terminal application.

  • If you are using a Mac, you can use the application called "Terminal".
  • If you are using a Windows machine, you can use the windows command prompt.

$ git version
git version 2.44.0

 

The specific version of Git is not important, but if the Git command is not found or is ‘unknown’, instructions for installing Git can be found here: https://github.com/git-guides/install-git. Make sure you enable Git from the command line and also from 3rd-party software.


 Note, for this bootcamp you do not need a Github account, you only need to have Git installed on your computer. 

Installing and Verifying the JDK

You can find distributions of Java JDK 11 for all operating systems on this website: https://learn.microsoft.com/en-us/java/openjdk/download#openjdk-11

Note, We have noted problems running Liferay specifically with openjdk-11.0.2. If you are using this version, please update your Java version.

You can download the JDK as a ZIP (Windows) or TAR.GZ (Linux/Mac) package. To install, extract the file in a folder of your choice, then set the JAVA_HOME environment variable to that folder.

Alternatively, you can install Java using native installers according to your OS. Instructions can be found here: 


Verifying the JDK is done using the simple command:

$ java -version
openjdk version "11.0.19" 2023-04-18 LTS
OpenJDK Runtime Environment Zulu11.64+19-CA (build 11.0.19+7-LTS)
OpenJDK 64-Bit Server VM Zulu11.64+19-CA (build 11.0.19+7-LTS, mixed mode)

As long as the version reports as 11.0.23 or above and also is a JDK (not simply a JRE), you’re good to go.

Installing and Verifying Blade CLI

Instructions for installing Blade CLI can be found here:   https://learn.liferay.com/w/dxp/liferay-development/tooling/blade-cli/installing-and-updating-blade-cli

Verifying that Blade is installed and available can be done using the following command:  

$ blade version
blade version 6.0.0.202404102137

Your version should be equal or greater than the above version. If your version is older, then please update using the update command:  

$ blade update

Getting The Enablement Workspace

The workspace for the bootcamp is here: https://github.com/liferay/enablement-bootcamp-clarity

Open up the terminal of your choice (Git Bash, Powershell, etc.). From your command line, navigate to the folder that you would like to clone your repository and run the following command:

Clone the workspace using the command:

$ git clone https://github.com/liferay/enablement-bootcamp-clarity

Go into the downloaded workspace and issue the following command:

Unix-based systems:

$ ./gradlew initBundle

Windows systems:

$ .\gradlew.bat initBundle

 

This performs two critical downloads. First, it downloads the Gradle version used for the workspace so all of the commands function correctly. Second, it downloads the Liferay Tomcat Bundle that will be used for the bootcamp.

 

Completing this in advance will ensure that your local environment has any necessary large downloads already completed and will not rely on the bootcamp wifi.

Optional: JMeter

During the course, we will have a session on using JMeter to perform load testing on the local bundle. This will be a completely optional step. If you have JMeter, we will provide the script to run against the bundle; if not, you will be able to watch the presenters.

Download and extract the JMeter package in advance:
Depending on your OS, the next steps may vary:

For Windows:
  1. Go to the extracted apache-jmeter-5.6.3/bin/ folder.
  2. Double-click the ApacheJMeter.jar file to execute it.
  3. The application should start running successfully.

For Unix-based systems:
  1. Open a command line of your choice.
  2. Navigate to the extracted apache-jmeter-5.6.3/bin/ folder.
  3. Run the following command:
    1. $ ./jmeter
  4. The application should start running successfully.

Note, Depending upon test scenarios, a laptop with more resources (RAM and CPU) would be preferred.