This chapter describes the network environment preconfiguration required by the Oracle WebCenter Content enterprise deployment topology. Use this chapter to plan your configuration of virtual server names, load balancers, IPs and Virtual IPs, and firewalls and ports.
This chapter includes the following topics:
Section 3.1, "Overview of Preparing the Network for an Enterprise Deployment"
Section 3.5, "Enabling Virtual IP Addresses for an Enterprise Deployment"
You must configure several virtual servers and associated ports on the load balancer for different types of network traffic and monitoring. These virtual servers should be configured to the appropriate real hosts and ports for the services running. Also, the load balancer should be configured to monitor the real host and ports for availability so that the traffic to these is stopped as soon as possible when a service is down. This ensures that incoming traffic on a given virtual host is not directed to an unavailable service in the other tiers.
The Oracle WebCenter Content enterprise topology uses the following virtual server names:
Ensure that the virtual server names are associated with IP addresses and are part of your DNS. The nodes running Oracle Fusion Middleware must be able to resolve these virtual server names.
You will define the virtual server names on the load balancer using the procedure in Section 3.3, "Configuring the Load Balancers."
wcc.mycompany.com
is a virtual server name that acts as the access point for all HTTP traffic to the run-time Oracle WebCenter Content components. Traffic to SSL is configured. Clients access this service using the address wcc.mycompany.com:443
.
admin.mycompany.com
is a virtual server name that acts as the access point for all internal HTTP traffic that is directed to administration services such as Oracle WebLogic Server Administration Console and Oracle Enterprise Manager Fusion Middleware Control.
The incoming traffic from clients is not SSL-enabled. Clients access this service using the address admin.mycompany.com:80
, and the requests are forwarded to port 7777 on WEBHOST1 and WEBHOST2.
soainternal.mycompany.com
is a virtual server name used for internal invocations of SOA and WebCenter Content services. This URL is not exposed to the Internet and is accessible only from the intranet. (For Oracle SOA Suite systems, users can set this URL while modeling composites or at runtime with the appropriate MBean through Fusion Middleware Control, as the URL to be used for invoking internal services.) You can use this URL for any service call back to WebCenter Content components from Oracle SOA Suite.
The incoming traffic from clients is not SSL enabled. Clients access this service using the address soainternal.mycompany.com:80
, and the requests are forwarded to port 7777 on WEBHOST1 and WEBHOST2.
Several virtual servers and associated ports must be configured on the load balancer for different types of network traffic and monitoring. These should be configured to the appropriate real hosts and ports for the services running. Also, the load balancer should be configured to monitor the real host and ports for availability so that the traffic to these is stopped as soon as possible when a service is down. This ensures that incoming traffic on a given virtual host is not directed to an unavailable service in the other tiers.
There are two load balancer devices in the recommended topologies. One load balancer is set up for external HTTP traffic and the other load balancer is set up for internal LDAP traffic. A deployment may choose to have a single load balancer device due to a variety of reasons. While this is supported, the deployment should consider the security implications of doing this and if found appropriate, open up the relevant firewall ports to allow traffic across the various DMZs. In either case, it is highly recommended to deploy a given load balancer device in fault-tolerant mode.
This enterprise topology uses an external load balancer. Configure the load balancer by defining the virtual server names described in Section 3.2, "Virtual Server Names Used by the Topology."
For more information on load balancers, see Section 2.1.3, "About the Web Tier Nodes."
The enterprise topologies use an external load balancer. This external load balancer must have the following features:
Ability to load-balance traffic to a pool of real servers through a virtual host name: Clients access services using the virtual host name (instead of using actual host names). The load balancer can then load balance requests to the servers in the pool.
Port translation configuration.
Monitoring of ports (HTTP and HTTPS).
Virtual servers and port configuration: Ability to configure virtual server names and ports on your external load balancer, and the virtual server names and ports must meet the following requirements:
The load balancer should allow configuration of multiple virtual servers. For each virtual server, the load balancer should allow configuration of traffic management on more than one port. For example, for Oracle WebLogic Server clusters, the load balancer must be configured with a virtual server and ports for HTTP and HTTPS traffic.
The virtual server names must be associated with IP addresses and be part of your DNS. Clients must be able to access the external load balancer through the virtual server names.
Ability to detect node failures and immediately stop routing traffic to the failed node.
Resource monitoring, port monitoring, and process failure detection: The load balancer must be able to detect service and node failures (through notification or some other means) and to stop directing non-Oracle Net traffic to the failed node. If your external load balancer has the ability to automatically detect failures, you should use it.
Fault-tolerant mode: It is highly recommended that you configure the load balancer to be in fault-tolerant mode.
Other: It is highly recommended that you configure the load-balancer virtual server to return immediately to the calling client when the back-end services to which it forwards traffic are unavailable. This is preferred over the client disconnecting on its own after a timeout based on the TCP/IP settings on the client machine.
SSL acceleration: This feature is required.
Configure the virtual server or servers in the load balancer for the directory tier with a high value for the connection timeout for TCP connections. This value should be more than the maximum expected time over which no traffic is expected between the Oracle Access Manager and the directory tier.
Ability to preserve the client IP addresses: The load balancer must have the capability to insert the original client IP address of a request in an X-Forwarded-For HTTP header to preserve the client IP address.
The Oracle Technology Network provides a list of validated load balancers and their configuration at http://www.oracle.com/technetwork/middleware/ias/tested-lbr-fw-sslaccel-100648.html
.
The procedures for configuring a load balancer differ, depending on the specific type of load balancer. Refer to the vendor supplied documentation for actual steps. The following steps outline the general configuration flow:
Create a pool of servers. This pool contains a list of servers and the ports that are included in the load balancing definition. For example, for load balancing between the web hosts, you create a pool of servers that would direct requests to hosts WEBHOST1 and WEBHOST2 on port 7777.
Create rules to determine whether or not a given host and service is available and assign it to the pool of servers described in Step 1.
Configure a virtual server in the load balancer for soainternal.mycompany.com:80
, and define the following rules for this virtual server:
Use your internal SOA address and internal Oracle WebCenter Content address as the virtual server address (for example, soainternal.mycompany.com
). This address is typically not externalized.
Specify HTTP as the protocol.
Enable address and port translation.
Enable reset of connections when services, nodes, or both are down.
Assign the pool created in step 1 to the virtual server.
Create rules to filter out access to /console
and /em
on this virtual server.
Configure a virtual server in the load balancer for wcc.mycompany.com:443
, and define the following rules for this virtual server:
Use your system's front-end address as the virtual server address (for example, wcc.mycompany.com
). The front-end address is the externally facing host name that is used by your system and will be exposed in the Internet.
Configure this virtual server with port 80 and port 443. Any request that goes to port 80 should be redirected to port 443.
Specify HTTP as the protocol.
Enable address and port translation.
Enable reset of connections when services, nodes, or both are down.
Assign the pool created in step 1 to the virtual server.
Create rules to filter out access to /console
and /em
on this virtual server.
Configure a virtual server in the load balancer for admin.mycompany.com:80
, and define the following rules for this virtual server:
Use your internal administration address as the virtual server address (for example, admin.mycompany.com
). This address is typically not externalized.
Specify HTTP as the protocol.
Enable address and port translation.
Enable reset of connections when services, nodes, or both are down.
Optionally, create rules to allow access only to /console
and /em
on this virtual server.
Assign the pool created in step 1 to the virtual server.
Configure monitors for the Oracle HTTP Server nodes to detect failures in these nodes:
Set up a monitor to regularly ping the "/
" URL context.
Tip:
Use GET /\n\n
instead if the Oracle HTTP Server's document root does not include index.htm
and Oracle WebLogic Server returns a 404 error for "/
".
For the ping interval, specify a value that does not overload your system. You can try 5 seconds as a starting point.
For the timeout period, specify a value that can account for the longest response time that you can expect from your Oracle WebCenter Content system, that is, specify a value greater than the longest period of time any of your requests to HTTP servers can take.
After you configure the virtual hosts in Section 7.5, "Defining Virtual Hosts," you should be able to access the virtual host name addresses. If you cannot access them, review this procedure to ensure that it was completed correctly.
Configure the Administration Server and the Managed Servers to listen on different virtual IPs and physical IPs as illustrated in Figure 3-1. As shown in this figure, each VIP and IP is attached to the Oracle WebLogic Server instance that uses it. VIP1 is failed manually to restart the Administration Server in SOAHOST2. VIP2 and VIP3 fail over from SOAHOST1 to SOAHOST2 and from SOAHOST2 to SOAHOST1, respectively, through the Oracle WebLogic Server migration feature. WLS_IMG1 and WLS_IMG2 also use server migration to fail over VIP4 and VIP5, respectively, from WCCHOST1 to WCCHOST2.
For information about the WebLogic Server migration feature, see the Oracle Fusion Middleware High Availability Guide.
Physical IPs (non-virtual) are fixed to each node. IP1 is the physical IP of WCCHOST1 and is used as the listen address by the WLS_WCC1 server. IP2 is the physical IP of WCCHOST2 and is used as the listen address by the WLS_WCC2 server.
The virtual IP db-scan.mycompany.com
is the database Oracle Single Client Access Name (SCAN) address for a GridLink data source.
Figure 3-1 IPs and VIPs Mapped to Administration Server and Managed Servers
Table 3-1 provides descriptions of the various virtual hosts.
Virtual IP | VIP Maps to... | Description |
---|---|---|
VIP1 |
ADMINVHN is the virtual host name that is the listen address for the Administration Server and fails over with manual failover of the Administration Server. It is enabled on the node where the Administration Server process is running (SOAHOST1 by default). |
|
VIP2 |
SOAHOST1VHN1 is the virtual host name that maps to the listen address for WLS_SOA1 and fails over with server migration of this Managed Server. It is enabled on the node where WLS_SOA1 process is running (SOAHOST1 by default). |
|
VIP3 |
SOAHOST2VHN1 is the virtual host name that maps to the listen address for WLS_SOA2 and fails over with server migration of this Managed Server. It is enabled on the node where WLS_SOA2 process is running (SOAHOST2 by default). |
|
VIP4 |
WCCHOST1VHN1 is the virtual host name that maps to the listen address for WLS_IMG1 and fails over with server migration of this Managed Server. It is enabled on the node where WLS_IMG1 process is running (WCCHOST1 by default). |
|
VIP5 |
WCCHOST2VHN1 is the virtual host name that maps to the listen address for WLS_IMG2 and fails over with server migration of this Managed Server. It is enabled on the node where WLS_IMG2 process is running (WCCHOST2 by default). |
|
db-scan.mycompany.com |
|
This step is required for failover of the WebLogic Server Administration Server, regardless of whether other Oracle Fusion Middleware components are installed later or not.
You associate an Administration Server with a virtual IP address. This allows the Administration Server to be started on a different host if the primary host fails.
To enable a virtual IP address from a Linux system, run the following commands as root
:
/sbin/ifconfig interface:index IPAddress netmask netmask /sbin/arping -q -U -c 3 -I interface IPAddress
where interface
is eth0
or eth1
, and index
is 0
, 1
, or 2
.
For example:
/sbin/ifconfig eth0:1 100.200.140.206 netmask 255.255.255.0
Enable your network to register the new location of the virtual IP address:
/sbin/arping -q -U -c 3 -I eth0 100.200.140.206
Validate that the address is available by issuing the ping
command from another node; for example:
/bin/ping 100.200.140.206
Many Oracle Fusion Middleware components and services use ports. As an administrator, you must know the port numbers used by these services and ensure that the same port number is not used by two services on a host.
Most port numbers are assigned during installation.
Table 3-2 lists the ports used in the Oracle WebCenter Content topology, including the ports that you must open on the firewalls in the topology.
Firewall notation:
FW0 refers to the outermost firewall.
FW1 refers to the firewall between the web tier and the application tier.
FW2 refers to the firewall between the application tier and the data tier.
Type | Firewall | Port and Port Range | Protocol / Application | Inbound / Outbound | Other Considerations and Timeout Guidelines |
---|---|---|---|---|---|
Browser request |
FW0 |
80 |
HTTP / Load Balancer |
Inbound |
Timeout depends on all HTML content and the type of process model used for Oracle SOA Suite. |
Browser request |
FW0 |
443 |
HTTPS / Load Balancer |
Inbound |
Timeout depends on all HTML content and the type of process model used for Oracle SOA Suite. |
Browser request |
FW1 |
80 |
HTTP / Load Balancer |
Outbound (for intranet clients) |
Timeout depends on all HTML content and the type of process model used for Oracle SOA Suite. |
Browser request |
FW1 |
443 |
HTTPS / Load Balancer |
Outbound (for intranet clients) |
Timeout depends on all HTML content and the type of process model used for Oracle SOA Suite. |
Callbacks and outbound invocations |
FW1 |
80 |
HTTP / Load Balancer |
Outbound |
Timeout depends on all HTML content and the type of process model used for Oracle SOA Suite. |
Callbacks and Outbound invocations |
FW1 |
443 |
HTTPS / Load Balancer |
Outbound |
Timeout depends on all HTML content and the type of process model used for Oracle SOA Suite. |
Oracle Notification Server (ONS) |
FW2 |
6200 |
ONS |
Both |
Both required for Gridlink. An ONS server runs on each database server. |
n/a |
7777 |
HTTP |
n/a |
||
OHS registration with Administration Server |
FW1 |
7001 |
HTTP/t3 |
Inbound |
Set the timeout to a short period (5-10 seconds). |
OHS management by Administration Server |
FW1 |
OPMN port (6701) and OHS Admin Port (7779) |
TCP and HTTP, respectively |
Outbound |
Set the timeout to a short period (5-10 seconds). |
FW1 |
8001 Range: 8000 - 8080 |
HTTP / WLS_SOAn |
Inbound and Outbound |
Timeout varies based on the type of process model used for Oracle SOA Suite. |
|
FW1 |
16200 |
HTTP / WLS_WCCn |
Inbound |
Browser-based access. Configurable session timeouts. |
|
FW1 |
16000 |
HTTP / WLS_IMGn |
Inbound |
Browser-based access. Configurable session timeouts. |
|
Imaging connection to Oracle WebCenter Content |
n/a |
4444 |
TCP/IP Unicast |
n/a |
Persistent connection. Timeout configurable on Content Server. |
Communication between SOA_Cluster members |
n/a |
8001 |
TCP/IP Unicast |
n/a |
By default, this communication uses the same port as the server's listen address. |
Communication between WCC_Cluster members |
n/a |
16200 |
TCP/IP Unicast |
n/a |
By default, this communication uses the same port as the server's listen address. |
Communication between IMG_Cluster members |
n/a |
16000 |
TCP/IP Unicast |
n/a |
By default, this communication uses the same port as the server's listen address. |
Session replication within a WebLogic Server cluster |
n/a |
n/a |
n/a |
n/a |
By default, this communication uses the same port as the server's listen address. |
FW1 |
7001 |
HTTP / Administration Server and Oracle Enterprise Manager Fusion Middleware Control t3 |
Both |
You should tune this timeout based on the type of access to the administration console (whether it is planned to use the WebLogic Server Administration Console from application tier clients or clients external to the application tier). |
|
n/a |
5556 |
TCP/IP |
n/a |
n/a For actual values, see "About Firewalls and Ports" in the Oracle Fusion Middleware Enterprise Deployment Guide for Oracle Identity Management. |
|
Access Server access |
F |
5575 6021 |
OAP |
Inbound |
For actual values, see "About Firewalls and Ports" in the Oracle Fusion Middleware Enterprise Deployment Guide for Oracle Identity Management. |
Identity Server access (Oracle Access Manager 10g) |
FW1 |
6022 |
OAP |
Inbound |
n/a |
FW2 |
1521 |
SQL*Net |
Both |
Timeout depends on all database content and on the type of process model used for Oracle SOA Suite. |
|
Coherence for deployment |
n/a |
8088 Range: 8000 - 8090 |
n/a |
n/a |
|
Oracle Internet Directory access |
FW2 |
389 |
LDAP |
Inbound |
You should tune the directory server's parameters based on load balancer, and not the other way around. |
Oracle Internet Directory access |
FW2 |
636 |
LDAP SSL |
Inbound |
You should tune the directory server's parameters based on load balancer, and not the other way around. |
JOC for OWSM |
n/a |
9991 Range: 9988-9998 |
TCP/IP |
n/a |
n/a |
Browser request |
n/a |
16250 16250 |
HTTP / WLS_IBRn |
n/a |
Browser-based access. Configurable session timeouts. |
Note:
The firewall ports depend on the definition of TCP/IP ports.