bea.com | products | dev2dev | support | askBEA
 Download Docs   Site Map   Glossary 
Search

Administration Console Online Help

 Previous Next Contents Index  

Configuring Servers

While the Domain Configuration Wizard configures basic attributes of the servers that it creates, you can use the Administration Console to configure additional attributes that define how the server communicates and the services that it provides to applications.

The following sections describe configuring server attributes:

 


Configuring Servers for Development Environments: Main Steps

In a development environment, you might need to complete the following configuration tasks after you create servers:

 


Configuring Servers for Production Environments: Main Steps

In a production environment, the security requirements are typically much more strict than in a development environment. In addition, the network environment is typically more complex, and the need for monitoring and availability is greater.

The following steps outline a logical order for configuring a server's communication and lifecycle services for a production environment. These steps assume that you have already used the Domain Wizard, Administration Console or weblogic.Admin utility to create a server:

  1. If you are using SSL, obtain a private key, digital certificate, and trusted CA. Then configure the server to use your private key and certificates instead of the demonstration keys and certificates. For more information, refer to "Configuring the SSL Protocol" in the Managing WebLogic Security guide.
  2. If you want to use multiple Network Interface Cards (NICs) and/or multiple port numbers in your domain to improve performance and solve common networking problems, set up Network Channels. For more information, refer to "Configuring Network Resources."
  3. Configure servers to start in production mode. For more information, refer to Starting in Development Mode or Production Mode.
  4. If you want to use the Administration Console to start a Managed Server, do the following:
    1. Configure a Node Manager to run on a specific computer (machine). For more information, refer to Configuring a Machine.
    2. Start the Node Manager. For more information, refer to "Starting Node Manager."
    3. Start the Managed Server from the Administration Console. For more information, refer to Starting Managed Servers from the Administration Console.
  5. If you want to use the Node Manager for health monitoring, refer to "Configure Monitoring, Shutdown and Restart for Managed Servers."
  6. To set up log file rotation, refer to Rotating Log Files. To adjust the level of messages that are sent to standard out, refer to Specifying Which Messages a Server Sends to Standard Out. To change the set of messages that a server instance forwards to the domain-wide message log, refer to Specifying the Messages that a Server Forwards to the Domain Log.
  7. If you want to use a WebLogic Server instance as a Web server, refer to "Configuring WebLogic Server Web Components."

    The WebLogic Server Web server component can handle high volume Web sites, serving static files such as HTML files and image files as well as servlets and JavaServer Pages (JSP).Web Components

 


Setting the Listen Ports

Servers can be reached through the following URL: protocol://listen-address:listen-port

By default, each WebLogic Server instance defines two listen ports: one for regular, non-secure requires (via such protocols as HTTP and T3) and the other for secure requests (via such protocols as HTTPS and T3S).

Note: By default, a server instance uses demonstration certificates to authenticate requests from the secure port. In a production environment, you must configure SSL to use certificates from a certificate authority. For more information, refer to "Configuring the SSL Protocol" in the Managing WebLogic Security guide.

You can disable either the default non-secure or the default secure listen port, but at least one must be enabled, even if you create one or more network channels for the server.

Although you can specify any valid port number, if you specify port 80, you can omit the port number from the HTTP request used to access resources over HTTP. For example, if you define port 80 as the listen port, you can use the form http://hostname/myfile.html instead of http://hostname:portnumber/myfile.html.

On some operating systems, port 80 can be accessed only by processes that run under a privileged user or group ID. In this case, you can assign the server instance to a UNIX Machine that has defined a Post-Bind UID or GID. For more information, refer to Machines.

In a development environment, you might want to run multiple instances of WebLogic Server on a single computer. If you do so, each instance must use a unique listen port/listen address combination. On a multihomed computer, you can use the same listen port but unique listen addresses for each active server instance. If your computer does not support multiple IP addresses, you must use a different listen port for each active instance.

Setting the Listen Ports from the Administration Console

  1. Expand the Servers node in the left pane.

    A list of servers appears under the Servers node.

  2. Select the server for which you want to set the listen ports. (See Figure 3-1.)

    Figure 3-1 Select a Server


     

  3. In the right pane, click the Configuration tab and the General subtab.
  4. If you want to disable the non-SSL listen port so that the server listens only on the SSL listen port, remove the checkmark from the Listen Port Enabled box.
  5. If you are using the non-secured listen port and you want to modify the default port number, change the default number in the Listen Port box.
  6. If you want to disable the SSL listen port so that the server listens only on the non-SSL listen port, do the following:
    1. Click the Create button.
    2. Click the Protocols tab.
    3. Click the SSL tab.
    4. Remove the checkmark from the Enable SSL Listen Port box.
    5. Click the Apply button.

    Note: You cannot disable both the non-SSL listen port and the SSL listen port. At least one port must be active.

  7. If you want to modify the default SSL listen port number, do the following:
    1. Click the Protocols tab.
    2. Click the SSL tab.
    3. Change the value in the SSL Listen Port box.
  8. Click Apply.
  9. If the server is running, you must restart it.

 


Setting the Listen Address

Servers can be reached through the following URL: protocol://listen-address:listen-port

By default, a server's listen address attribute is undefined, which enables you to reach the server through any of the following listen addresses:

If the server instance must be accessible as localhost (for example, if you have administrative scripts that connect to localhost), and must also be accessible by remote processes, leave the listen address blank. Otherwise, if you want to limit the valid listen addresses for a server, refer to Table 3-1 for guidelines on specifying listen addresses.

Note: For WebLogic servers running on multi-homed Windows NT machines, you should not leave the listen address value undefined or blank. (Multi-homed machines are configured with multiple IP addresses.) Otherwise, the WebLogic Server reserves and listens on its port for each of the machine IP addresses. This precludes other servers from using the same port on the machine.

Table 3-1 Setting the Listen Address

If the Listen Address is set to...

Then, the following is true...

IP address

  • To connect to the server instance, processes can specify either the IP address or the corresponding DNS name.

  • Processes that specify localhost will fail to connect.

  • You must update existing processes that use localhost to connect to the server instance.

  • Connections that specify the IP address for the listen address and a secured port for the listen port must disable host name verification.

DNS name

  • To connect to the server instance, processes can specify either the DNS name or the corresponding IP address.

  • Processes that specify localhost will fail to connect.

  • You must update existing processes that use localhost to connect to the server instance.

  • Connections that specify the IP address for the listen address and a secured port for the listen port must disable host name verification.

localhost

  • Processes must specify localhost to connect to the server instance.

  • Only processes that reside on the machine that hosts the server instance (local processes) will be able to connect to the server instance.

Setting the Listen Address from the Administration Console

To set the listen address from the Administration Console, do the following:

  1. Expand the Servers node in the left pane.

    A list of servers appears under the Servers node.

  2. Select the server for which you want to set the listen address. (See Figure 3-1.)
  3. In the right pane, click the Configuration tab and the General subtab.
  4. Enter an value in the Listen Address box. Refer to Table 3-1 for guidelines.
  5. Click Apply.
  6. If the server is running, restart it.

 


Configure Startup Arguments for Managed Servers

To configure the startup arguments that Node Manager will use to start a Managed Server:

  1. Invoke the Administration Console, if it isn't already running.
  2. In the left pane, expand the Servers folder, then select the name of the server instance you want to configure. (See Figure 3-1.)
  3. In the right pane, select Configuration—>Remote Start. Edit the startup arguments as follows:

    Note: You must enter user name and password to start a Managed Server. Managed Servers do not inherit the user name and password that you supplied to the Administration Server.

  4. Click Apply.

 


Configure Monitoring, Shutdown and Restart for Managed Servers

Follow these steps to configure Node Manager features for monitoring, shutting down, and restarting a Managed Server.:

  1. If you have not yet done so, configure the Managed Server's startup information as described in Configure Startup Arguments for Managed Servers.
  2. Access the Administration Console for the domain that contains the Managed Server.
  3. Select the Servers entry in the left pane, then select the name of the server you want to configure. (See Figure 3-1.)
  4. Select the Configuration->Health Monitoring tab to display the Managed Server's automatic restart and health monitoring attributes.
  5. To change the Managed Server's restart behavior, edit the following attributes:
  6. Click Apply to apply your changes.
  7. If you did not start the Managed Server using Node Manager, shut it down, and restart it using Node Manager. Node Manager cannot perform automatic monitoring and monitoring and shutdown on a server that it did not start.

 


Configuring Protocols

Specifying the Default Protocol

  1. In the left pane of the Administration Console, expand the Servers folder.
  2. Click on a server. (See Figure 3-1.)
  3. In the right pane, select the Protocols tab. Then select the General tab.
  4. Select a protocol from the Default Protocol list.
  5. Select a secure protocol from the Default Secure Protocol list.
  6. Click Apply

Configuring the T3 Protocol

  1. In the left pane of the Administration Console, expand the Servers folder.
  2. Click on a server. (See Figure 3-1.)
  3. In the right pane, select the Protocols tab. Then select the General tab.
  4. In the Advanced Options bar, click Show.
  5. Modify the values for Complete Message Timeout, and Maximum Message Size. For information about each setting, refer to Attributes.

    Note: These settings apply to all protocols in the server's default network configuration. For more information, refer to "Understanding the Default Network Configuration."

  6. To enable tunneling of connections, click Enable Tunneling and provide values for Tunneling Client Ping and Tunneling Client Timeout. For information about each setting, refer to Attributes.

    Note: These settings apply to all protocols in the server's default network configuration that support tunneling.

  7. Click Apply.

Configuring the HTTP Protocol

  1. In the left pane of the Administration Console, expand the Servers folder.
  2. Click on a server. (See Figure 3-1.)
  3. In the right pane, select the Protocols tab. Then select the General tab.
  4. In the Advanced Options bar, click Show.
  5. Modify the values for Complete Message Timeout, Idle Connection Timeout, and Maximum Message Size. For information about each setting, refer to Attributes.

    Note: These settings apply to all protocols in the server's default network configuration. For more information, refer to "Understanding the Default Network Configuration."

  6. To enable tunneling of connections, click Enable Tunneling and provide values for Tunneling Client Ping and Tunneling Client Timeout. For information about each setting, refer to Attributes.

    Note: These settings apply to all protocols in the server's default network configuration that support tunneling.

    For more information, refer to "Setting Up WebLogic Server for HTTP Tunneling."

  7. Click Apply.

Enabling and Configuring the IIOP Protocol

  1. In the left pane of the Administration Console, expand the Servers folder.
  2. Click on a server. (See Figure 3-1.)
  3. In the right pane, select the Protocols tab. Then select the IIOP tab.
  4. Enable the IIOP protocol by checking the Enable IIOP check box.
  5. To modify the default configuration, in the Advanced Options bar, click Show.

    The advanced options are enabled only when you have enabled IIOP by clicking in the Enable IIOP check box.

  6. If you want to specify a default IIOP user name and password, do the following:
    1. In the Default IIOP User field, enter a user name.
    2. Click Apply.
    3. Next to Default IIOP Password, click Change.
    4. On the Change Password page, enter the password and its confirmation.
  7. For information on the other options on the IIOP tab, refer to Related Topics.
  8. On the IIOP tab, click Apply.
  9. To configure maximum messages size and timeout settings, do the following:
    1. Click the General tab.
    2. In the Advanced Options bar, click Show.
    3. Modify the values for Complete Message Timeout, Idle Connection Timeout, and Maximum Message Size. For information about each setting, refer to Attributes.

    Note: These settings apply to all protocols in the server's default network configuration. For more information, refer to "Understanding the Default Network Configuration."

    1. On the General tab, click Apply.
  10. To enable tunneling connections, do the following:
    1. Click the General tab.
    2. In the Advanced Options bar, click Show.
    3. Click Enable Tunneling and provide values for Tunneling Client Ping and Tunneling Client Timeout. For information about each setting, refer to Attributes.
    4. Note: These settings apply to all protocols in the server's default network configuration that support tunneling.

    5. On the General tab, click Apply.

Configuring a Network Channel

  1. Start the Administration Console for the domain that contains the server instance you want to configure.
  2. Select the Servers node in the left pane of the Administration Console.
  3. Select the server instance for which you want to configure a channel. (See Figure 3-1.)
  4. Select the Protocols-->Channel tab.
  5. Click Configure a new Network Channel... in the right pane.
  6. Enter the Name, Protocol, Listen Address and Listen Port for the new network channel and click Create.

    The page repaints, and displays the values you entered for Listen Port and Listen Address in the External Listen Address and External Listen Port fields.

  7. Enter a different External Listen Address and External Listen Port as desired.

    To support NAT firewalls, change the External Listen Address and External Listen Port. For External Listen Address enter the IP address or DNS name that clients use to access applications on the server instance.

  8. To enter advanced attributes, click the Show (advanced options) link.
  9. Enter values for the attributes, as desired.
  10. Click Apply to save the channel.
  11. To use the new channel, you must reboot any servers that you assigned as targets.

 


Monitoring a Server

  1. Click the server node in the left pane.
  2. Select a specific server in the left pane.
  3. Select the Monitoring tab.
  4. The current state of the server is displayed.

Monitoring Server Performance

  1. Click the server node in the left pane.
  2. Select a specific server in the left pane.
  3. Select the Performance tab.
  4. The page displays performance metrics about pending and processed requests for the server.

Viewing the Server JNDI Tree

  1. Right-click the instance node in the left pane under Servers for the server whose JNDI tree you want to view. This opens a pop-up menu.
  2. Click View JNDI Tree. A new browser window is displayed showing the naming context data.

Monitoring Transactions

  1. Click the server node in the left pane.
  2. Select a specific server in the left pane. (See Figure 3-1.)
  3. Select the Monitoring tab.
  4. Select the JTA tab. Totals for transaction statistics are displayed in the JTA dialog.
  5. Optionally, click the monitoring text links to monitor transactions by resource or by name, or to monitor all active transactions.

Monitoring Web App Components on a Server

  1. Click the instance node in the left pane under Servers to select a server for web-application monitoring. (See Figure 3-1.)

    A dialog displays in the right pane showing the tabs associated with this instance.

  2. Click the Deployments tab.
  3. Click the Web Applications tab.
  4. Click the Monitor All Active Web Applications text link. The web applications table displays in the right pane showing all the web applications deployed on this server.

Monitoring the JRockit Virtual Machine

If you run a server with the JRockit Virtual Machine (VM), you can view runtime data about the underlying JRockit VM and the memory and processors on the computer that is hosting the VM.

To monitor the JRockit VM, do the following:

  1. Use the JRockit VM to start the server. For more information, refer to Changing the JVM That Runs a WebLogic Server Instance.
  2. In the left pane of the Administration Console, expand the Servers folder.
  3. Click a server that is using the JRockit VM. (See Figure 3-1.)
  4. In the right pane, click the Monitoring tab. Then click the JRockit tab.

    The JRockit tab displays monitoring information.

To view additional data about the VM, such as how long it spends in a specific method, use the JRockit Management Console. Note that if you want to use the JRockit Management Console, you must include the -XManagement startup option when you start the server. (You do not need this option to use the WebLogic Server Administration Console to monitor the VM.) For more information, refer to "JRockit User Guide."

Configuring Low Memory Detection

  1. Click the server node in the left pane.
  2. Select a specific server in the left pane. (See Figure 3-1.)
  3. Select the Configuration tab.
  4. Select the Memory tab.
  5. Enter a percentage value in the Low Memory GCThreshold attribute field to specify the threshold after which WebLogic Server performs automatic garbage collection. A value of 5 means that the server forces garbage collection after the average free memory reaches 5% of the initial free memory measured at the server's boot time.
  6. Enter a percentage value in the Low Memory Granularity Level attribute field to specify the size of memory drop required before WebLogic Server logs a low memory warning message. A value of 5 means that if the average free memory drops by 5% or more over two measured intervals, the server logs a low memory warning in the log file and changes the server health state to "warning."
  7. Enter a value in the Low Memory Sample Size to specify the number of times the server samples free memory during a fixed time period. Using a higher sample size can increase the accuracy of the reading.
  8. Enter a value in the Low Memory Time Interval to define the interval (in seconds) over which the server determines average free memory values.
  9. Click Apply to apply your changes.
  10. Reboot the server to use the new low memory detection attributes.

 


Configuring jCom

Enabling jCOM

  1. In the left pane of the Administration Console, expand the Servers folder.
  2. Click on a server. (See Figure 3-1.)
  3. In the right pane, select the Protocols tab. Then select the jCOM tab.
  4. Enable the jCOM protocol by checking the Enable COM check box.
  5. Click Apply.
  6. Restart the server to effect this change.

Setting the Primary Domain Controller to be Used for Authentication

  1. Click the server node in the left pane.
  2. Select a specific server in the left pane. (See Figure 3-1.)
  3. Select the Protocols tab.
  4. Select the jCOM tab.
  5. In the NTAuth Host field, enter the IP address of the primary domain controller to be used for authenticating clients.
  6. Restart the server to effect this change.

Allowing or Disallowing Native Mode Communication

  1. Click the server node in the left pane.
  2. Select a specific server in the left pane. (See Figure 3-1.)
  3. Select the Protocols tab.
  4. Select the jCOM tab.
  5. Check or uncheck the Native Mode Enabled Box.
  6. Restart the server to effect this change.

Enabling or Disabling the Logging of Memory Usage

  1. Click the server node in the left pane.
  2. Select a specific server in the left pane. (See Figure 3-1.)
  3. Select the Protocols tab.
  4. Select the jCOM tab.
  5. Check or uncheck the Memory Logging Enabled box.
  6. Restart the server to effect this change.

Allowing Prefetching of Elements

  1. Click the server node in the left pane.
  2. Select a specific server in the left pane. (See Figure 3-1.)
  3. Select the Protocols tab.
  4. Select the jCOM tab.
  5. Check or uncheck the Prefetch Enums box.
  6. Restart the server to effect this change.

Allowing or Disallowing Apartment Threaded COM Initialization in Native Mode

  1. Click the server node in the left pane.
  2. Select a specific server in the left pane. (See Figure 3-1.)
  3. Select the Protocols tab.
  4. Select the jCOM tab.
  5. Check or uncheck the Apartment Threaded box.
  6. Restart the server to effect this change.

 


Other Configuration Tasks

Deleting a Server

  1. Click the Servers node in the left pane. The Servers table displays in the right pane showing all the servers defined in the domain.
  2. Click the Delete icon in the row of the server you want to delete. A dialog displays in the right pane asking you to confirm your deletion request.
  3. Click Yes to delete the server. The server icon under the Servers node is deleted.

Replicating a Domain's Configuration Files for Managed Server Independence

A Managed Server can replicate the domain's configuration files. If the Administration Server is unavailable, you can start the Managed Server using the replicated files.

Caution: Do not enable file replication for a server that shares an installation or root directory with another server. Unpredictable errors can occur for both servers.

To replicate a domain's configuration files on a server, do the following:

  1. Click the server node in the left pane.
  2. Select a specific server in the left pane. (See Figure 3-1.)
  3. From the Configuration tab, click the Tuning tab.
  4. Click the MSI File Replication Enabled check box.

Disabling Managed Server Independence

By default, Managed Server Independence mode is enabled. To disable the mode, do the following:

  1. Click the server node in the left pane.
  2. Select a specific server in the left pane. (See Figure 3-1.)
  3. From the Configuration tab, click the Tuning tab.
  4. Clear the Managed Server Independence Enabled check box.

Specifying Cluster Settings for a Server

  1. Click the Server node in the left pane and select a specific server in the left pane. (See Figure 3-1.)
  2. Select the Cluster tab.
  3. Enter the name of a list of clustered instances for storing session state replicas in the Replication Group field.
  4. Enter the name of a secondary list of clustered instances for storing session state replicas in the Preferred Secondary Group field.
  5. Enter a value in the range 1-100, to determine what proportion of the load a server will bear relative to other servers in a cluster, in the Cluster Weight field.
  6. Enter the interface address to handle multicast traffic in the Interface Address field.
  7. Click Apply to save your changes.

Assigning WLEC Connection Pools to a Server

  1. Click the Server node in the left pane.
  2. Select the server to which you want to assign a connection pool in the left pane. (See Figure 3-1.)
  3. Select the Services tab.
  4. Click the WLEC Tab.
  5. To assign a connection pool to the selected server, select a connection pool in the list of Available connection pools and click the right arrow to move the connection pool to the Chosen list. You can select multiple connection pools by Shift-clicking or Ctrl-clicking connection pools in the list.
  6. To remove a connection pool from the selected server, select a connection pool in the list of Chosen connection pools and click the left arrow to move the connection pool to the Available list. You can select multiple connection pools by Shift-clicking or Ctrl-clicking connection pools in the list.
  7. Click Apply to save your changes.

Assigning Jolt Connection Pools to a Server

  1. Click the Server node in the left pane.
  2. Select the server to which you want to assign a connection pool in the left pane. (See Figure 3-1.)
  3. Select the Services tab.
  4. Click the Jolt Tab.
  5. To assign a connection pool to the selected server, select a connection pool in the list of Available connection pools and click the right arrow to move the connection pool to the Chosen list. You can select multiple connection pools by Shift-clicking or Ctrl-clicking connection pools in the list.
  6. To remove a connection pool from the selected server, select a connection pool in the list of Chosen connection pools and click the left arrow to move the connection pool to the Available list. You can select multiple connection pools by Shift-clicking or Ctrl-clicking connection pools in the list.
  7. Click Apply to save your changes.

Assigning a WTCServer to a Server

  1. Click the Server node in the left pane.
  2. Select the server to which you want to assign a WTCServer in the left pane. (See Figure 3-1.)
  3. Select the Services tab.
  4. Click the WTC Tab.
  5. To assign a WTCServer to the selected server, select a WTCServer in the list of Available WTCServers and click the right arrow to move the WTCServer to the Chosen list. You can not assign more than one WTCServer to a WebLogic Server.
  6. To remove a WTCServer from the selected server, select the WTCServer in the list of Chosen WTCServers and click the left arrow to move the WTCServer to the Available list.
  7. Click Apply to save your changes.

Creating a Migratable Target

  1. Select the Servers node in the left pane.
  2. Select the name of a server that resides in the cluster you want to configure. (See Figure 3-1.)
  3. Select Control->Migration Config. in the right panel (or select Control->JTA Migration Config. to create a migratable target for JTA services). The right panel displays a list of servers that you can select as constrained candidate servers for the migratable target.
  4. In the Available column, select all of the servers that can potentially host migratable services in the cluster. Use the arrow button to place these servers in the Chosen column.
  5. Click Apply to apply your changes to the new migratable target.

Migrating Services to a New Server

  1. Select the Servers node in the left panel.
  2. Select the name of a server that resides in the cluster you want to work with. (See Figure 3-1.)
  3. Click the Control->Migrate tab to migrate JMS servers or click Control->JTA Migrate to migrate the JTA transaction recovery service.
  4. Use the Destination Server drop-down list to select a server from the migratable target list.
  5. Click Migrate... to migrate pinned services running on the Current Server to the Destination Server you selected. If you selected the JTA Migrate tab, note that the cluster migrates only the JTA service to the selected server.

Assigning FileT3 (Deprecated) Files to a Server

For information on how to create a file system, see Create a File System.

  1. Click the Server node in the left pane.
  2. Select the server to which you want to assign a file system in the left pane. (See Figure 3-1.)
  3. Select the Services tab.
  4. Click the FileT3 Tab.
  5. To assign a file system to the selected server, select a file system in the list of Available file systems and click the right arrow to move the file system to the Chosen list. You can select multiple file systems by Shift-clicking or Ctrl-clicking file systems in the list.
  6. To remove a file system from the selected server, select a file system in the list of Chosen file systems and click the left arrow to move the file system to the Available list. You can select multiple file systems by Shift-clicking or Ctrl-clicking file systems in the list.
  7. Click Apply to save your changes.

 

Back to Top Previous Next