Create a Liberty profile server using developer tools

Overview

Install the Liberty profile developer tools.

We can create a server as described in this topic, or as described in Create a Liberty profile server manually.

We specify the installation of the Liberty profile to use. Options:

• Select an existing installation.
• Install from a previously downloaded archive file.

To use the tools to install a Liberty edition from an archive file, download the archive file.

Create a Liberty profile server

As we go through the steps, we can download add-ons in the Liberty Repository from the WASdev community download site.

1. In the workbench, run...
   Servers tab | Servers (Right-click) | New | Server | Server type | IBM WebSphere Application Server Liberty Profile server | Next

   The Liberty Profile Runtime Environment page is displayed.

2. Select an installation, install from an archive file.

   If we previously installed the Liberty profile...

   1. Select...

      Choose an existing installation

   2. In the Path field, type or browse for the directory where you installed the Liberty profile runtime environment, then click Next.

   To install the Liberty profile from a downloaded archive file...

   1. On the Liberty Profile Runtime Environment page, in the section...
      How to create the runtime environment?

      ...select...

      Install from an archive or a repository

      Click Next.

   2. On the Install Runtime Environment page, in the field...

      Enter the destination path

      ...type the path for the new directory where we want to install the Liberty profile runtime environment or browse to the path, then click Next.

      If you type a path that does not exist, a folder for that path is created during the installation.

   3. Select...
      Install a new runtime environment from an archive

      Type or browse for the archive where we downloaded the Liberty profile runtime environment, then click Next.

   4. In the Install Add-ons page, click "Install" or "Install Pending" to make the selection of add-on archive files to install on the Liberty profile runtime environment.

      We can install an add-on archive file from the local file system, download, or use a combination of both when we install multiple add-on archive files. If the workbench is connected to the internet, the Install Add-ons page is populated with add-on archive files available for download from the WAS dev community download site.

      This download site includes add-ons that we can select from the Liberty Repository, such as runtime features, samples, or open source integration.

      To install add-on archive files from the local file system, click Add Archive. In the Add-on archive field, type or browse for the add-on archive file on the local file system> OK. If we have more add-on archive files to install from the local file system, repeat this step until we are done.

      After completing the selection in the Install Add-ons page, click Next.

   5. In the License Acceptance page, if you accept the license terms, select I accept the terms of all the license agreements then click Next.

   To download and install the no-charge developer edition of the Liberty profile:

   1. In the How do to create the runtime environment? section of the Liberty Profile Runtime Environment page, select...

      Install from an archive or a repository

      Click Next.

   2. On the Install Runtime Environment page, in the Enter the destination path field, either type the path for the new directory where to install the Liberty profile runtime environment or browse to the path, then click Next.

      If you type a path that does not exist, then a folder for that path is created during the installation.

   3. Select Download and install a new runtime environment from, choose a download site, then click Next.

   4. In the Install Add-ons page, click Install or Install Pending to make the selection of add-on archive files to install on the Liberty profile runtime environment.

      We can install an add-on archive file from the local file system, download, or use a combination of both when we install multiple add-on archive files. If the workbench is connected to the internet, the Install Add-ons page is populated with add-on archive files available for download from the WAS dev community download site.

      This download site includes add-ons that we can select from the Liberty Repository, such as runtime features, samples, or open source integration.

      To install add-on archive files from the local file system, click Add Archive. In the Add-on archive field, type or browse for the add-on archive file on the local file system> OK. If we have more add-on archive files to install from the local file system, repeat this step until we are done.

      After completing the selection in the Install Add-ons page, click Next.

   5. In the License Acceptance page, if you accept the license terms, select I accept the terms of all the license agreements then click Next.

3. If the Liberty Profile Server page displays, in the Liberty profile server field, use the drop-down list to select an existing server. Or click New to create a new server.

   This step is skipped and the New Liberty Profile Server dialog is displayed directly if there are no defined Liberty Profile Servers to choose from.

4. If we are creating a new server, in the Server name field of the New Liberty Profile Server page, enter a server name of our choice or use the default server name, defaultServer. Then, click Next if available, otherwise click Finish.

5. In the Liberty Profile Server, click Next.

6. Optional: Add the projects of the application to the server. On the Add and Remove page, under the Available list, select the projects to add to the server and click Add. The project appears in the Configured list.

7. Click Finish.

Results

We created a WebSphere Application Server Liberty Profile server.

• Click the Servers view to see the server that we created and its server configuration.

• Click the Enterprise Explorers view to see the project, the server folder, and the server configuration files.

What to do next

• Edit the server configuration.

  See Edit the Liberty profile configuration using developer tools topic.

• Start or stop the server, add or remove applications on the server, and many other tasks. We can perform these tasks using the server context menu (right-click on the server to open the pop-up menu) or by selecting the tray buttons in the Servers view.

  In the Servers view, we must select the server entry to perform these tasks. Do not select the server configuration, such as the Server Configuration [server.xml] entry for performing these tasks.

• Optionally configure the server to do specific tasks such as configure the Liberty profile to authenticate users with Tivoli Directory Server: Right-click Servers. Select Utilities> Add config snippets. After we select the snippets and accept any licenses, the selected configuration snippets are then downloaded and included in server.xml.

Parent topic: Set up the Liberty profile

Tasks:

Install the Liberty profile by extracting an archive file

Specify Liberty profile bootstrap properties
Explore the runtime environment using developer tools