Configuring Servers (Step 3)

The Configuration Expert allows you to create new server entries, as well as deploying these server entries on the server group. Use the following steps to create a new server, add a new server, or modify an existing server:

Note: It is possible to deploy the same server on multiple groups or even within the same group allowing multiple copies of the same executable to be started.

Creating a New Server

Note: If you are using C++ Expert or Rose Expert, the gservers.lst file is automatically generated to make the servers immediately available.

To create a new server:

1. Click Create on the Configuration toolbar in the main window. The New Server Properties window box is displayed as shown in Figure 3-14.

   Figure 3-14 Creating a New Server

   

   The following table explains the fields available on the New Server window.

   Table 3-9 Creating a New Server

   Field	Description
   Server Name	Name that you assign the server. For Windows NT you do not need to specify the.exe file extension.
   Resource Manager Name	Resource Manager assigned to the new server. This is the same Resource Manager name that you have used with the -r option when building the server.
   Conversational (check box)	If selected, the new server must be a conversational server. The corresponding BEA TUXEDO parameter is CONV.
   Default Command Line Options	Command line options assigned to the new server. The corresponding BEA TUXEDO parameter is CLOPT.
   Export to available server file	If selected, the server is added to the exported server file; otherwise it is not exported.

2. When you have filled in the fields, click OK to save your changes and close the window.

To add a server:

1. On the main window, select the server you want to add from the list in the right panel, as shown in Figure 3-15.

   Figure 3-15 Configure Server

   

2. Click Add on the Configuration Tool bar.

   Repeat steps 1 and 2 until all server choices are added to your configuration.

   Once all servers are added, you may change the properties of each server. See Modify Server Properties.

   The list of available servers depends on the type of group selected in the tree. Only the servers that match the Resource Manager of the selected group are shown. The iservers.lst shows the available servers for the group.

You can modify the following properties of a server in the configuration tree:

• General Server Properties-This is where you assign a name to the server you have added, or change the name of an existing server.

• Process Server Properties-Sets the behavior of the server process(es).

General Server Properties

1. Select the General tab on the Server Properties window as shown in Figure 3-16.

   Figure 3-16 General Server Properties

   

   The following table explains the fields available on the General Group Properties window.

   Table 3-10 General Server Properties

   Field	Description
   Server Name	Name of the server executable.
   Command Line Options	Command line options assigned to this server. The corresponding BEA TUXEDO server parameter CLOPT.

2. When you have filled in the fields, click OK to save your changes and close the window.

1. Select the Process tab on the Server Properties window as shown in Figure 3-17.

   Figure 3-17 Process Server Properties

   

   The following table explains the fields available on the Process Server Properties window.

   Table 3-11 Process Server Properties

   Field	Description
   Minimum # of Processes	Specifies the minimum number of occurrences of the server to be booted. The corresponding BEA TUXEDO server parameter is MIN.
   Maximum # of Processes	Specifies the maximum number of occurrences of the server that may be booted. The corresponding BEA TUXEDO server parameter is MAX.
   Restartable	Specifies whether the server is restartable. The corresponding BEA TUXEDO server parameter is RESTART.
   Grow Pool when queue depth is over	During runtime, if the number of messages is met or exceeded for a time set by the next parameter, a new server is spawned.
   Seconds to wait before growth	Time elapsed before the sever pool is expanded.
   Shrink pool when queue depth under	During runtime, if the number of messages is below this value for a time set by the next parameter, a server is deactivated.
   Seconds to wait before shrinking	Time elapsed before the sever pool is reduced.

2. When you have filled in the fields, click OK to save your changes and close the window.

   Note: For more information on the parameters for automatic server pool management, see the -p option in the SERVOPTS(5) BEA TUXEDO manual page.