Configuring eXtreme Scale in the Liberty profile using Eclipse tools

[Version 8.5 and later] You must configure your WebSphere® eXtreme Scale servers to run in the WebSphere Application Server Liberty profile. Complete this task to configure eXtreme Scale servers with Eclipse tools.

Before you begin

You must define a Liberty profile server in Eclipse. To complete this task, see Creating a Liberty profile server using developer tools.

About this task

Configuring the eXtreme Scale server entails specifying the server properties and including those properties in the Liberty profile 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 profile.

This procedure also includes adding the configuration from the eXtreme Scale server properties file, xsServerConfig.xml, to the server.xml file.

Procedure

  1. 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. Click Browse to specify where the Liberty profile is installed. Then, select the Liberty profile server definition for which you want to configure for your eXtreme Scale servers. Click Next. The General Server Configuration window is displayed.
    4. Complete the server configuration. Click Next. The Container Server Configuration window is displayed.
    5. Complete the container server configuration. Click Next.
    6. If you included the catalog server configuration, then another window is displayed, where you specify the catalog server settings. Click Next. The Server Logging Configuration window is displayed.
    7. Complete the logging information pages, and 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.
  2. Include the configuration from the eXtreme Scale server properties file in the server.xml file.
    1. Open the Servers view in Eclipse.
    2. Expand Liberty Server to locate your server configuration XML file.
    3. Double-click the entry for your server configuration to open the file.
    4. Click Add, and select Include to add an include statement to the server.xml file. Click OK.
    5. Under Include Details, click Browse. The Browse for Include File window is displayed.
    6. Select xsServerConfig.xml, to include the server configuration settings that you created in step 1. Click OK.

What to do next

The eXtreme Scale server configuration file, xsServerConfig.xml, is now included in the Liberty profile server.xml file. Now, you are ready to start the Liberty profile server, where your eXtreme Scale servers will run.