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 11 is now required as of version 21.0.0.3 of the tools.

The 21.0.0.3 release supports Eclipse versions 2021-03, 2020-12 and 2020-09.

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 2021-03 for Enterprise Java and Web Developers ( 4.19 )
2. Start your Eclipse workbench.
3. Start the installation using either of the following methods.
   • Locate the installation files from your Eclipse workbench:
     1. Click Help > Eclipse Marketplace.
     2. In the Find field, type Liberty.
     3. In the list of results, locate IBM Liberty Developer Tools and then click Install. The Confirm Selected Features page opens.
   • Drag an Install icon from a web page to your Eclipse workbench:
     1. Click download Liberty page
     2. Locate the Install icon for WebSphere Application Server Liberty.
     3. Select and drag the Install icon to your Eclipse workbench, and drop it on the Eclipse toolbar. The Confirm Selected Features page opens.
4. On the Confirm Selected Features page, 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.
5. 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