+

Search Tips   |   Advanced Search

Manually installing a Liberty feature to the Liberty profile V8.5 or earlier

When we develop a Liberty feature using the WebSphere Application Server Developer Tools, we create a Liberty feature project that packages the Liberty feature in a compressed file. To install the Liberty feature, we must extract the contents of the compressed file to the Liberty profile environment.

  • Create a Liberty feature project.

    Restriction: This topic is supported for WebSphere Application Server Liberty Profile V8.5 or earlier. For versions 8.5.5, see Install a Liberty feature to the Liberty profile V8.5.5 topic.

    The compressed file has the following structure:

    /lib
        OSGi bundle JAR files             .
                .
                .
    /features
        manifest file  

    To install a Liberty feature to the Liberty profile:

    1. In the workspace, right-click the Liberty feature project and select Export > Liberty Feature.

    2. In the To ESA file field, specify the location and name of the compressed file to which to export the Liberty feature project.

    3. Click Finish to export the Liberty feature project to the specified location.

    4. Extract the contents of the compressed file to the ${wlp.user.dir}/extension directory.

    5. Add the feature name to the list of configured features in server.xml; prefix the feature name with usr:.

      For example:

      <featureManager>
           <feature>usr:sample-1.0</feature>
      </featureManager>


    Parent topic: Create a Liberty feature using developer tools

    Tasks:

  • Create a Liberty feature project
  • Add OSGi bundles to a Liberty feature project
  • Specify API and SPI packages for a Liberty feature project
  • Install a Liberty feature to the Liberty profile V8.5.5