![]() ![]() ![]() ![]() ![]() ![]() ![]() |
This document summarizes the tasks required to install and configure a multiple-server installation of WebLogic SIP Server 2.2. It is intended for users who are already familiar with WebLogic Server installation and configuration, or for users who want to quickly set up a multiple-server configuration for demonstration or evaluation. If you are unfamiliar with installing BEA products or you want to perform automated or non-graphical installations, see to Installing WebLogic SIP Server instead.
This document contains the following sections:
The quick-start installation involves performing the following steps:
The WebLogic SIP Server software must be available on all server machines that will run a WebLogic SIP Server instance. Follow these steps for the Administration Server machine and for all other machines that will run a Managed Server:
chmod a+x ./wlss220_linux32.bin |
./wlss220_linux32.bin |
(Substitute the appropriate filename name for the installation program you have obtained.)
To launch the Windows executable:
wlss220_win32.exe |
To launch the generic JAR file installation:
See Installing WebLogic SIP Server for more information about using the installation program.
All related WebLogic SIP Server instances must be members of the same administrative domain. The Configuration Wizard provided with WebLogic SIP Server contains four templates that help you create different types of domains:
findme
example automatically deployed.Follow these steps to install a new WebLogic SIP Server domain:
WLSS_HOME
\common
directory, where WLSS_HOME
is the directory in which you install WebLogic SIP Server 2.2 (for example, c:\bea\wlss220\common
).config.cmd
or config.sh
script to launch the Configuration Wizard.WLSS_HOME
\user_projects\domains
directory of the WebLogic SIP Server installation directory. Click Create to create the new domain.
The WebLogic SIP Server instances you intend to use must be created within a single administrative domain, and servers in the engine and data tiers should be arranged into clusters to simplify deployment and management. If you used the Configuration Wizard to create a Replicated WebLogic SIP Server domain, the domain is automatically created with default engine tier servers and data tier servers arranged into clusters; you can modify this configuration to match the number of servers you want to use in your domain. See Modifying the Default Replicated Domain.
If you used the Configuration Wizard to create a Basic WebLogic SIP Server domain, only a single server is configured. You will need to create engine and data tier servers and clusters by hand. See Creating Servers and Clusters by Hand.
WARNING: | When you configure a domain with multiple engine and data tier servers, you must accurately synchronize all server system clocks to a common time source (to within one or two milliseconds) in order for the SIP protocol stack to function properly. See Configuring NTP for Accurate SIP Timers in Configuring and Managing WebLogic SIP Server for more information. |
The default Replicated WebLogic SIP Server domain is preconfigured with four separate servers and two clusters.
You may want to modify the default replicated domain if you want to add, remove, or rename servers in either of the clusters, or to configure the network settings of individual server instances. To modify the default configuration:
cd c:\bea\user_projects\domains\replicated |
startWebLogic.cmd |
Note: | These quick-start instructions assume each managed server listens on a single network address. If you intend to run servers on multi-homed server hardware, or if you want to configure secure SIP transport protocols, see Managing WebLogic SIP Server Network Resources in Configuring and Managing WebLogic SIP Server. |
If you used the Configuration Wizard to create a Basic WebLogic SIP Server domain, the domain contains a single WebLogic SIP Server instance that acts as the administration server and WebLogic SIP Server (with data and engine tier functionality combined). To move from the basic domain to a production domain, you will need to create all servers and clusters by hand, and move engine tier services off of the Administration Server instance. Follow these instructions:
cd c:\bea\user_projects\domains\replicated |
startWebLogic.cmd |
If the machine uses multiple IP addresses (a multihomed machine), enter the IP address and port to use for a connections on one of the available NICs. Repeat the above three steps to create a separate channel for each NIC.
weblogic.kernel.Default
.
In the previous section you organized the data tier servers into a cluster for administration purposes. You must also configure the datatier.xml
file to define how data tier servers are used to manage SIP application call state for your installation.
The data tier cluster can be arranged into one or more partitions. A partition consists of one or more data tier server instances that manage the same portion of the concurrent call state data. In a single-server WebLogic SIP Server installation, or in a two-server installation where one server resides in the engine tier and one resides in the data tier, all call state data is maintained in a single partition. Multiple partitions are required when the size of the concurrent call state exceeds the maximum size that can be managed by a single server instance. In most cases, the amount of call state that can be managed by a server corresponds to the Java Virtual Machine limit of approximately 1.6GB per server.
Additional servers can also be added within the same partition to manage copies of the call state data. When multiple servers are part of the same partition, each server manages a copy of the same portion of the call data, referred to as a replica of the call state. If any server in a partition fails or cannot be contacted due to a network failure, another replica in the same partition can supply the call state data to the engine tier.
Before modifying datatier.xml
, read
Configuring Data Tier Partitions and Replicas in Configuring and Managing WebLogic SIP Server to fully understand the role of the data tier and the format of the datatier.xml
configuration file.
To modify datatier.xml
for your domain:
datatier.xml
configuration file with a text editor. This file is part of the sipserver
application that provides WebLogic SIP Server functionality, installed in the top level of your domain directory:
cd c:\bea\user_projects\domains\replicated\sipserver\config |
notepad datatier.xml |
If you installed the default replicated domain, the datatier.xml
file contains the entries shown in Listing 2-1, which defines a single partition with two replicas.
<st:data-tier xmlns:st="http://www.bea.com/ns/wlcp/wlss/220">
<st:partition>
<st:name>partition-0</st:name>
<st:server-name>replica1</st:server-name>
<st:server-name>replica2</st:server-name>
</st:partition>
</st:data-tier>
To start the fully-configured WebLogic SIP Server domain, first start the Administration Server, then start individual Managed Servers to connect to the Administration Server. The sections that follow provide server startup instructions.
To start the Administration Server:
Note: | WebLogic SIP Server start scripts use default values for many JVM parameters that affect performance. For example, JVM garbage collection and heap size parameters may be omitted, or may use values that are acceptable only for evaluation or development purposes. In a production system, you must rigorously profile your applications with different heap size and garbage collection settings in order to realize adequate performance. See Tuning JVM Garbage Collection for Production Deployments in Configuring and Managing WebLogic SIP Server for suggestions about maximizing JVM performance in a production domain. |
To start the Managed Servers in your domain:
mkdir c:\myManagedServer |
cd c:\myManagedServer |
Note: | The Managed Server machines do not have a domain directory. Instead, they obtain their configuration by connecting to the Administration Server at startup. |
WL_HOME\common\bin
directory:
WL_HOME |
After booting your domain, you may want to perform further administration procedures such as configuring network resources, enabling logging, or setting up security providers. For more information on these topics, see Configuring and Managing WebLogic SIP Server.
![]() ![]() ![]() |