Create generic servers

A generic server is a server that is managed in the WebSphere administrative domain, although it is not a server that is supplied by WebSphere Application Server. The WebSphere Application Server generic servers function enables you to define a generic server as an application server instance within the WebSphere Application Server administration, and associate it with a non-WebSphere server or process.

Overview

• Non-Java applications or processes.

• Java applications or processes

Therefore, a generic server can be any server or process that is necessary to support the Application Server environment, including:

• A Java server

• A C or C++ server or process

• A CORBA server

• A RMI server

You can use the wsadmin tool or the administrative console to create a generic server.

For standalone application server profiles (profiles which do not belong to a Network Deployment cell), you can use the administrative console to create generic servers and to adjust the settings for the generic server. However, you cannot use the administrative console to start, stop or otherwise control the server. Use the wsadmin tool for those types of operations.

Procedure

• Create a non-Java application as a generic server. The following steps describe how to use the administrative console to create a non-Java application as a generic application server.

  1. Select Servers > Generic servers

  2. Click New.

  3. Type in a name for the generic server.

     The name must be unique within the node. It is recommended that you use a naming scheme that makes it easy to distinguish your generic application servers from regular WebSphere Application Servers.

  4. Click Next

  5. Click Finish. The generic server now appears as an option on the Generic servers page in the administrative console.

  6. On the Generic servers page, click on the name of the generic server.

  7. Under Additional Properties, click Process Definition.

  8. In the Executable name field under General Properties, enter the name of the non-WebSphere Application Server program that is launched when you start this generic server. Executable target type and Executable target properties are not used for non-Java applications. Executable target type and Executable target properties are only used for Java applications

  9. Click OK.

• Create a Java application as a generic server: The following steps describe how to use the administrative console to create a Java application as a generic application server.

  1. Select Servers > Generic servers

  2. Click New.

  3. Type in a name for the generic server.

  4. Click Next

  5. Click Finish. The generic server now appears as an option on the Applications Server page in the administrative console.

  6. Click Finish. The generic server now appears as an option on the Generic servers page in the administrative console.

  7. On the Generic servers page, click on the name of the generic server.

  8. Under Additional Properties, click Process Definition.

  9. In the Executable name field under General Properties, enter the path for the WebSphere Application Server default JVM, ${JAVA_HOME}/bin/java, which is used to run the Java application when you start this generic server.

  10. In the Executable target type field under General Properties, select whether a Java class name, JAVA_CLASS, or the name of an executable JAR file, EXECUTABLE_JAR, is used as the executable target of this Java process. The default for WebSphere Application Server is JAVA_CLASS.

  11. In the Executable target field under General Properties, enter the name of the executable target. Depending on the executable target type, this is either a Java class containing a main() method, or the name of an executable JAR file.) The default for WebSphere Application Server is com.ibm.ws.runtime.WsServer.

  12. Click OK.

      Note: If the generic server is to run an application server other than the WebSphere Application Server, leave the Executable name field set to the default value and specify the Java class containing the main function for your application serve in the Executable target field.

Results

You can use either the Terminate or Stop buttons in the administrative console to stop any application server, including a generic application server.

Related tasks