[AIX Solaris HP-UX Linux Windows][z/OS]

Configuring JBoss servers

After you create a middleware server representation of a JBoss server, you must update a few configuration settings so that they are defined specifically for your JBoss installation.

Before you begin

Federate the node that is running the JBoss server and create a representation of the server.

About this task

If you installed JBoss in a location other than the default directory, update the WebSphere® variables so that the installation directory is correct. To perform server operations on your server, you must configure the server operations for the JBoss middleware server representation.

Note: Intelligent Management support for using JBoss servers is stabilized. You can use the administrative console or wsadmin scripting to manage these servers.

Procedure

  1. Update the WebSphere variables so that they match the settings on the node that is running the JBoss server.
    • Follow the directions in the topic on modifying variables using wsadmin scripting to edit the variables.
    • In the administrative console, click Environment > WebSphere Variables to edit the variables.
    Edit the JBOSS_DIST variable, which specifies the home directory of your JBoss installation. Usually, the default installation location includes the JBoss version, so it is likely that you need to update the default values. Default values are set at the cell scope level:
    • [Windows]C:\Program Files\jboss
    • [AIX HP-UX Solaris]/usr/local/jboss

    Edit the JBOSS_PROFILE variable, which specifies the configuration set in use for the server representation, and defaults to the name of the server itself. The default value is set at the server scope level: ${WAS_SERVER_NAME}. If these settings are different on different nodes in your configuration, create the variables for a specific node.

    Create a new variable and name it JBOSS_HOST. Set the value to the host that the JBoss server will run on. Set the scope to the JBoss server.

  2. Update server operations for the JBoss server to include the user name and password.
    • Launch wsadmin scripting with a username and password so that you can start and stop server operations.

      Follow the directions in the topic on starting the wsadmin scripting client to enable security. The startMiddlewareServer command and the stopMiddlewareServer command require a user name and password to run.

    • In the administrative console, click Servers > Other middleware servers > JBoss servers > jboss_server > Server operations. Edit the start and stop server operations to include the user name and password that is required to run these commands.
  3. Optional: Update the HTTP and HTTPS ports for your servers.
    The default port is 8080. If you use a value other than the default, you must change the port.
    • Use the modifyForeignServerProperty command in the middleware server management administrative tasks to change the ports.
    • In the administrative console, click Servers > Other middleware servers > JBoss servers > jboss_server. Edit HTTP connector or HTTPS connector. Click OK, and save and synchronize your changes.

What to do next

  • To use this configuration when you are configuring your other JBoss servers, create a server template of your current JBoss server.
  • View the log files for your JBoss server on the machine that hosts it. To view the log files for your JBoss server in the administrative console, use the external log viewing service. This service is enabled by default. The following directories are configured by default:
    • ${JBOSS_DIST}/server/${JBOSS_PROFILE}/logs
    • ${AGENT.HOME}/logs/${WAS_SERVER_NAME}
  • Edit configuration files for your JBoss server on the machine that hosts it.
  • After you create representations of all the JBoss servers, you can add the representations to a dynamic cluster.