Creating a remote Liberty server by using developer tools

You can use developer tools to create and start a remote Liberty server.

<server description="new server">
<!-- Enable features-->
<featureManager>
<feature>restConnector-2.0</feature>
</featureManager>

<keyStore id="defaultKeyStore" password="password" />

<quickStartSecurity userName="admin" userPassword="password"/>

<httpEndpoint id="defaultHttpEndpoint" host="*" httpPort="9080" httpsPort="9443"/>

<remoteFileAccess>
<writeDir>${server.config.dir}</writeDir>
<writeDir>${server.output.dir}</writeDir>
<writeDir>${wlp.user.dir}</writeDir>
</remoteFileAccess>
</server>

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 within the Servers view and select New > Server.
3. Under the server type list, expand IBM and select the Liberty Server server type.
4. Enter the remote host name in the Server's host name field.
5. Click Next. The Liberty Runtime Environment page is displayed.

   Check that the Liberty runtime environment on the local system and on the remote system have the same set of features that are installed. Also, check that they are configured to use the same level of the Java™ runtime environment (JRE). The Liberty runtime environment of the local system is used as the target runtime in the development environment. A mismatch between the local system runtime and the remote system runtime can cause problems from configuration errors to application publishing issues.

6. Tip: If you already have a Liberty runtime that is installed, you go directly to the New Remote Liberty Server page, skip to Step 7.
   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 7.

   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 12.

   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 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.

   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 7.

   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 12.

   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.

7. If the Liberty Server Type page displays, select Stand-alone server.
8. Complete the user ID, password, and port information for the remote server and click Verify.
   Important:

   • The user ID and password must have the appropriate security credentials as defined by the quickStartSecurity configuration item or the user registry of the remote Liberty server.
   • The port is the HTTPS port that is configured in the server.xml file.

   After you click Verify, if you see the following message, a local server or remote server is already created with the same name.

   The Liberty server already exists

   You can verify this situation by expanding the following folders in the Enterprise Explorer view and seeing the listed servers in the following projects:

   • WebSphere® Application Server Liberty
   • WebSphere Application Server Liberty (Remote)

   The remote directory is shown on the same page if the connection is successful. To resolve this issue of two servers with the same name, you can rename the Remote Directory folder on the remote system.
9. In the New Remote Liberty Server page, click Next.

   The Remote WebSphere Application Server Settings page is displayed.

10. If you do not want to enable remote start, stop, and restart, ensure that Enable the server to start remotely is cleared, click Next, and skip the next step.
11. Enable remote start, stop, and restart.
    1. Select Enable the server to start remotely.
    2. Select whether your remote server is installed on the Windows operating system or other operating systems.
    3. Enter the location of the runtime installation and server configuration.

       For more information, see the Directory locations and properties topic.

    4. Enter the remote server authentication information.
       For authentication, complete one of the following options.

       • To access the remote server with logon credentials, enter your user name and password. On Windows platforms use your Windows user name and password for the user account that has access to the server. On non-Windows platforms use the SSH user name and password credentials.
       • To access the remote server with Secure Shell (SSH) by using a private key, copy the private key file to the computer where the workbench is installed, and specify the key file location and user ID.
12. 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.
13. Click Finish.