Creating a Liberty server by using developer tools

You can use developer tools to create and start a Liberty server. If you have not yet installed Liberty, the developer tools can install it for you when you create a server for the first time.

1. In the workbench, open the Servers view by clicking the Servers tab.
   Tip: If the Servers view is not visible, navigate to Window > Show view > Other... and type Server in the filter text. Then, select Servers.
2. Right-click the Servers view and select New > Server.
3. Under the server type list, expand IBM and select the Liberty Server server type.
   The WebSphere® Application Server Liberty server type replaces the old WebSphere Application V8.5 Liberty server type and supports all versions of the WebSphere Application Server Liberty server. Existing servers in a workspace that were created with the old server type still work.
4. Click Next.
   The Liberty Runtime Environment page is displayed.
5. Tip: If you already have a Liberty run time that is installed, you will go directly to the New Liberty Server page, skip to Step 6.
   Select an installation, install from an archive file, or (for the no-charge developer edition) download and install, Liberty.

   If you previously installed Liberty, complete the following steps:

   1. Select Choose an existing installation.
   2. In the Path field, type or browse for the directory where you installed the Liberty runtime environment.
   3. On the Liberty Runtime Environment page, click Next.

      The application-serving environment is selected, and now you can skip to Step 6.

   If you want to install Liberty from an archive file that was previously downloaded, complete the following steps:

   1. Select Install from an archive or repository, and click Next.
   2. In the Destination field, type or browse for the directory where you want to install the Liberty runtime environment.

      If you type a path that does not exist, then a folder for that path is created automatically at the end of Step 10.

   3. Select Install a new runtime environment from an archive.
   4. In the Path field, either type or browse to the archive file on the local file system, and click Next.
   5. In the Install Add-ons page, click Install or Install Pending to make your selection of add-on archive files that you want to install on the Liberty runtime environment.

      You can install an add-on archive file from your local file system, download, or use a combination of both when you install multiple add-on archive files.

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

      If you want to install add-on archive files from your 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, and then click OK. If you have more add-on archive files to install from your local file system, repeat this step until you are done.

      If you want to install add-on files from a custom repository, first add the repository by clicking Configure Repositories. Click New... to add the repository. The files are then added to the list of add-on files.

      After you complete your selection in the Install Add-ons page, click Next.

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

      Now you can skip to Step 6.

   If you want to download and install the no-charge developer edition of Liberty, complete the following steps:

   1. Select Install from an archive or respository, and click Next.
   2. In the Destination field, type or browse for the directory where you want to install the Liberty runtime environment.

      If you type a path that does not exist, then a folder for that path is created automatically at the end of Step 10.

   3. Select Download and install a new runtime environment from ibm.com, choose a runtime environment version, and then click Next.
   4. In the Install Add-ons page, click Install or Install Pending to make your selection of add-on archive files that you want to install on the Liberty runtime environment.
      You can install add-on archive files by one of the following methods:

      • From your local file system
      • By downloading files
      • By using a combination of both, when you install multiple add-on archive files

      If you want to install add-on archive files from your local file system, complete the following steps:

      1. Click Add Archive.
      2. In the Add-on archive field, type or browse to the add-on archive file on the local file system.
      3. Click OK.

      If you have more add-on archive files to install from your local file system, repeat this procedure until you are done.

      If you want to install add-on files from a custom repository, complete the following steps:

      1. To add the repository, click Configure Repositories.
      2. Click New....

      The files are then added to the list of add-on files.

      After you complete your 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.

      Now you can skip to Step 6.

6. If the tools display the Server type options, select Stand-alone server.
7. If the Liberty Server page displays, in the Liberty server field, use the drop-down list to select an existing server. Or click New to create a new server.
   Note: This step is skipped and the New Liberty Server dialog is displayed directly if there are no defined Liberty Servers to choose from.
8. If you are creating a new server, in the Server name field of the New Liberty Server page, enter a server name of your choice or use the default server name, defaultServer. Then, click Next if available, otherwise click Finish.
9. In the Liberty Server, click Next.
10. Optional: Add the projects of your application to the server. On the Add and Remove page, under the Available list, select the projects that you want to add to the server and click Add. The project appears in the Configured list.
11. Click Finish.