Create generic servers

 

Overview

There are two types of generic application servers:

• Non-Java applications or processes.

• Java applications or processes

Use the wsadmin tool or the Generic servers panel of the administrative console to create either type.

Note: For the Base WebSphere Application Server product, although use the administrative console to create a generic application server definition, one cannot use it to start, stop or, in any way, control or manage that application server. The Base product administrative console can only be used to create server definitions and, if necessary, adjust the server definitions that it creates. To manage Base generic application servers, use the wsadmin tool.

 

Steps for this task (dependent on configuration)

• 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. We can then specify the name of the generic server you are creating.

  3. Type in a name for the generic server. The name must be unique within the node. It is highly recommended that you use a naming scheme that makes it easy to distinguish your generic application servers from regular Websphere Application Servers. This will enable you to quickly determine whether to use the Terminate or Stop button in the administrative console to stop specific application server. You must use the Terminate button to stop a generic application server.

  4. Select a template to use in creating the new server. We can use a default application server template for your new server or use an existing application server as a template. The new application server will inherit all properties of the template server. If you create the new server using an existing application server do not enable the option to map applications from the existing server to the new server. This option does not apply for a generic server.

  5. Click Next

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

  7. On the Generic servers panel, 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 name of the non-WebSphere Application Server program that is to be 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

  10. 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. We can then specify the name of the generic server you are creating.

  3. Type in a name for the generic server. The name must be unique within the node. It is highly recommended that you use a naming scheme that makes it easy to distinguish your generic application servers from regular Websphere Application Servers. This will enable you to quickly determine whether to use the Terminate or Stop button in the administrative console to stop specific application server. You must use the Terminate button to stop a generic application server.

  4. Click Next

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

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

  7. On the Generic servers panel, 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 Websphere Application Server's default JVM (${JAVA_HOME}/bin/java), which will be 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, will be 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 will be 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.

 

Result

We can now start and terminate the generic server whenever you want to start or terminate the non-WebSphere Application Server server or process associated with this server.

 

See also

Starting and terminating generic servers
Generic servers

 

Related Tasks

Manage generic servers using scripting

 

---