open-liberty-tools

Summary

Open Liberty Tools are lightweight tools for developing, assembling, and deploying apps to Open Liberty.

Table of Contents

• Prereqs
• Known Issues
• Getting Started
• Contribute to Open Liberty Tools
• Community

Prereqs

Java 21 is now required as of version 24.1 of the tools.

The 24.1 release supports Eclipse versions 2024-06 and 2023-12.

Known Issues

Please see the Liberty Tools known issues page for known issues and workarounds.

Getting Started

To install the Open Liberty Tools and other WebSphere Developer Tools features:

1. If you don’t already have Eclipse, install Eclipse 2024-06 for Enterprise Java and Web Developers ( 4.32 )
2. Download Open Liberty tools by going to the Open Liberty Tools list of repositories, choosing a folder that is close in time to your Open Liberty release date and downloading the openlibertytools-*.zip file therein.
3. Start your Eclipse workbench.
4. Start the installation using the following method.
   • Locate the installation files from your Eclipse workbench:
     1. Click Help > Install New Software.
     2. Click Add, click Archive.
     3. Select the archive downloaded in step 2 and click Open. Give your repository a name and click Add.
5. In the list of available software, expand the parent nodes and select the WebSphere Application Server Liberty Tools feature and any other feature that are needed. When you are finished, click Confirm.
6. On the Review Licenses page, review the license text. If you agree to the terms, click I accept the terms of the license agreements and then click Finish. The installation process starts.

  Note:
      During the installation, a Security Warning dialog box might open and display the following message:
      Warning: You are installing software that contains unsigned content. The authenticity or validity of this software cannot be established. Do you want to continue with the installation? 
      You can safely ignore the message and click 'install anyway' to continue.

6. When the installation process completes, restart the workbench.

To install the Open Liberty Tools only from Open Liberty site, follow this instruction.

Visit the WASdev Community for documentation and tutorials. Here are a few related to the tools:

Contribute to Open Liberty Tools

1. Clone the repository to your system.

   git clone https://github.com/OpenLiberty/open-liberty-tools

2. Run a gradle build.

   cd open-liberty-tools/dev

   ./gradlew

3. Go Open issues, Review existing contributions, or Submit fixes.

Community

1. Open Liberty group.io
2. OpenLibertyIO on Twitter
3. ibm-wdt tag on stackoverflow