## 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.

### Add a Server

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.

### Modify Server Properties

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.

#### Process Server Properties

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.