Lesson 2.2: Configure eXtreme Scale client applications to run in the Liberty using Eclipse tools

You must configure your WebSphere® eXtreme Scale servers to run in the WebSphere Application Server Liberty. Complete this task to configure eXtreme Scale servers with Eclipse tools.

Before you begin

For this lesson, you must have a catalog and container server created.

About this task

Configuring the eXtreme Scale server entails specifying the server properties and including those properties in the Liberty server.xml file in the wlp_home/usr/servers/your_server_name directory. This server definition is required to run eXtreme Scale in the Liberty.

Procedure

Generate the eXtreme Scale server properties file.
1. Click File > New > Other.
2. Expand WebSphere eXtreme Scale, and select Container server configuration file. Click Next. The eXtreme Scale Server Configuration File window is displayed.
3. Specify the name of the server configuration file.
  For the purposes of this tutorial, name your server configuration file xsServerConfig.xml.
4. Click Browse to specify where the Liberty is installed; for example, C:\XSWLP\wlp. Then, select the defaultServer Liberty server definition for which you want to configure for your eXtreme Scale servers. Click Next. The General Server Configuration window is displayed.
5. Complete the server configuration by accepting the default settings. Select Include catalog server to include an eXtreme Scale catalog server.
  Click Next. The Container Server Configuration window is displayed.
6. Complete the container server configuration by accepting the default settings. Click Next.
  Another window is displayed for the catalog server settings. Accept the default values for the catalog server configuration. Click Next. The Server Logging Configuration window is displayed.
7. Complete the logging information pages by accepting the default settings. Click Next until the Security Configuration window is displayed.
8. Optional: Specify the location of the objectGridSecurity.xml file, which describes the security properties that are common to all servers, including catalog servers and container servers. An example of the defined security properties is the authenticator configuration, which represents the user registry and authentication mechanism. The file name specified for this property must be in a URL format, such as file:///tmp/og/objectGridSecurity.xml.
9. Click Finish.
A configuration file is generated in the Liberty profile.
Include the configuration from the eXtreme Scale server properties file in the server.xml file.
1. In Eclipse, open the server.xml file in the defaultServer folder.
2. Add an include tag to the server.xml file; for example:
```
<server>
<include location="xsServerConfig.xml" />
</server>
```
  Save your changes to the server.xml file.
You have added the xsServerConfig eXtreme Scale server configuration to the Liberty. Now, when the Liberty starts, eXtreme Scale catalog and container servers start according to the configuration that you added in this step.

Results

The Liberty can now detect your client application and the specified eXtreme Scale server, which is configured to use the server properties that you have defined. The generated xsServerConfig.xml file already includes the server feature, and server feature already includes the client feature, which allow your applications to run in the Liberty and use eXtreme Scale APIs.

Lesson checkpoint

Now that you have used the Eclipse developer tools to install and configure the eXtreme Scale development environment for the Liberty, you are ready to create object grid configuration files that are to be used in a container server.

In this lesson, you generated a xsServerConfig.xml configuration file, which you imported into the server.xml file. From that configuration file, the Liberty can now use each of the properties that you defined for your eXtreme Scale server.

If you want to learn more about the server properties that you can define in the Liberty, see Liberty profile server properties.