Skip Headers

Oracle® Web Conferencing Administrator's Guide
Release 2 (2.0.4)

Part Number B10877-01
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Master Index
Master Index
Go to Feedback page
Feedback

Go to previous page
Previous
Go to next page
Next
View PDF

6
Sample Deployments

This chapter discusses some sample deployment scenarios, ranging from a basic deployment to a sophisticated one spanning multiple geographical regions. It also explains what an administrator should do to set them up. The best way to review this chapter is to go through each example, because each example builds on the previous.


Note:

In Chapter 4, "Post-Installation" Oracle Web Conferencing properties are set using .imt files. The examples use the setProperty command in imtctl (the command used by the .imt files) to set Web Conferencing properties. It is important to remember that when the option "-system true" is used in setProperty, the setting of the property has a global scope and affects not just the instance on which imtctl is being invoked. If the -system true option is not used in the command, the command applies to that instance.


See Chapter 4, "Post-Installation" for basic information about the following:

For all examples, one Oracle9iAS instance is on the machine with the Real-Time Collaboration Core Components and only one Real-Time Collaboration instance is on this machine. For these examples, it is assumed that Oracle9iAS Web Cache is disabled on the mid-tier.

6.1 Basic Deployment

This is the simplest deployment and is generally used to create a pilot deployment. In this deployment, users can access Oracle Web Conferencing from the Internet, through their proxy across the Internet, and through the intranet.

Figure 6-1 Web Conferencing Basic Deployment

Text description of basicdep.gif follows.

Text description of the illustration basicdep.gif

In Figure 6-1, "Web Conferencing Basic Deployment", Host 1 and Host 2 are deployed in the same DMZ, while Host 3 and Host 4 are deployed in the corporate intranet.

These are the mandatory associations that must be made for the various parts of Oracle Web Conferencing to work:

Additional configuration issues are discussed in the rest of the chapter.

6.1.1 Sequence of Steps

  1. Install all prerequisites on all the computers.
  2. Install the Real-Time Collaboration Core Components on Host 1.
  3. Perform post-installation steps on Host 1.
  4. Perform verification tests on Host 1.
  5. Install Document and Voice Conversion Servers on Host 2.
  6. Follow the post-installation steps on Host 2.
  7. Perform verification tests on Host 2.
  8. Perform verification tests on Host 1 to confirm proper connection to Host 2.

6.1.2 Prerequisites

Host 1: Oracle9iAS plus Real-Time Collaboration Core Components set up and configured to use the Oracle9iAS Infrastructure on Host 4.

Host 4: Oracle9iAS Infrastructure needs to be set up on this machine.

Host 2: A Windows NT computer with specialized telephony hardware and software.

Host 3: Oracle9i Database (9.2.0.1) for the Real-Time Collaboration Repository.

See Also:

Oracle Collaboration Suite Installation and Configuration Guide for Solaris for additional information on the prerequisites

6.1.3 Settings

Configure Oracle Web Conferencing to leverage existing enterprise e-mail and proxy servers for its functionality. Assume that the settings are as follows:

Table 6-1 System Settings
Setting Name Value Comments Web Conferencing Property

Existing e-mail server host name (one for the enterprise)

"mail-net.company.com"

Post-installation step

SmtpHost

E-mail server listening port

25

Default

SmtpPort

Existing proxy server host name for HTTP (one for the enterprise)

"www-proxy.company.com"

Post-installation step

UserAgentProxyHost

Proxy server host name for HTTPS (one for the enterprise)

"www-proxy.company.com"

Post-installation step

UserAgentProxySSLHost

Proxy port for HTTP

80

Default

UserAgentProxyPort

Proxy port for HTTPS

443

Default

UserAgentProxySSLPort

Proxy domains to exclude

".company.com"

Post-installation step

UserAgentProxyExclusions

Table 6-2 Instance on Host 1
Setting Name Value Comments Web Conferencing Property

Number of mx

1

Default

SrvNumProcs

Listening port for the single mx

2400

Set during installation

MxListenPort

Actual host name of Host 1

"host1.company.com"

 

N/A

Alias for Host 1

"imeeting1.company.com"

Post-installation step

ApacheWebHost

Instance name

"instance1.company.com"

Set automatically during installation

N/A

Oracle HTTP Server listening port for HTTP on Host 1

7777

Default. Set during installation.

ApacheWebPort

Oracle HTTP Server listening port for HTTPS on Host 1

443

Default

ApacheWebSecurePort

You must configure the settings in Table 6-1 and Table 6-2 every time you install Web Conferencing.

In addition, you must configure Host 2 as follows:

Table 6-3 Host 2 Settings
Setting Name Value Comments Web Conferencing Property

HTTP listening port for the Voice Conversion Server

2460

Set during installation

 

Dial-in prefix for voice conversion server instance

9

Post-installation step

VoiceDialinPrefix

6.1.4 Installation

On Host 1, install the Real-Time Collaboration Core Components, and provide the required port numbers. On Host 2, install the Document and Voice Conversion Servers, and provide the required port numbers.

See Also:

Oracle Collaboration Suite Installation and Configuration Guide for Solaris for details

6.1.5 Post-Installation

Invoke the imtctl commands in this section, while setting Web Conferencing properties. The commands in this section are based on the data in the Settings tables in Section 6.1.3, "Settings".

Step 1 Integrate Web Conferencing with existing e-mail.
imtctl> setProperty -system true -pname SmtpHost -pvalue "mail-net.company.com"

Because the port is 25 (which is default), there is no need to set the port.

Step 2 Integrate Web Conferencing to use existing proxy servers.
imtctl> setProperty -system true -pname UserAgentProxyHost -pvalue 
"www-proxy.company.com" 
imtctl> setProperty -system true -pname UserAgentProxySSLHost -pvalue 
"www-proxy.company.com"
imtctl> setProperty -system true -pname UserAgentProxyExclusions -pvalue  
"[\".company.com\"]" 


Note:

Because the default proxy port for HTTP is 80 and HTTPS is 443, there is no need to set these ports.


Step 3 Integrate Web Conferencing with Oracle HTTP Server on this Real-Time Collaboration Core Components machine.
  1. Enable the mod_imeeting.

    Make the necessary configuration changes to the Oracle HTTP Server in which mod_imeeting is configured. mod_imeeting is included through the
    $ORACLE_HOME/imeeting/conf/mod_imeeting.conf file, which in turn gets included in $ORACLE_HOME/Apache/Apache/conf/oracle_apache.conf file for Oracle HTTP Server.

    Add the following include line for mod_imeeting.conf in oracle_apache.conf:

    Include "$ORACLE_HOME/imeeting/conf/mod_imeeting.conf"
    
    
    

    Replace $ORACLE_HOME with the actual Oracle home.

  2. Update the Oracle HTTP Server configuration using DCM.
    $ORACLE_HOME/dcm/bin/dcmctl -v updateConfig -ct ohs
    
    
  3. Restart Oracle HTTP Server through DCM.
    $ORACLE_HOME/dcm/bin/dcmctl -v restart -ct ohs
    
    
  4. Set up mod_imeeting/mx redirect.

    For one mx process (installer default), invoke:

    imtctl> setProperty -ct mxcomm -pname MxRedirectPort -pvalue "[\"2420\"]"
    
    
  5. Make Web Conferencing aware of basic Oracle HTTP Server settings by invoking:
    imtctl> setProperty -pname ApacheWebHost -pvalue "imeeting1.company.com"
    
    

    Because 80 and 443 are defaults, no additional steps are required for setting the ports.


    Note:

    imeeting1.company.com is the URL users will use to access Web conferences.


Step 4 Set up reports.

Web Conferencing reports can be generated and sent via e-mail using the imtreport script. The script is located at $ORACLE_HOME/imeeting/bin and is invoked as "imtreport" on all platforms. The actual script file is "imtreport" for UNIX and Linux and "imtreport.cmd" for Microsoft Windows. Mandatory report options such as the recipient list are set by editing variables at the top of the report script. The script contains comments on the options provided. Be sure to edit the proper script for the platform you are using. You may want to send out automated weekly reports by using some operating system provided mechanism for invoking the script on a weekly basis (for example, cron job on UNIX or the Task Scheduler on Windows).

Step 5 Set up for periodic monitoring.

Set up your monitoring infrastructure to periodically ping the following URLs:

See Section 7.6, "Real-Time Collaboration Interfaces" for more information.

Host 2

No post-installation configuration is required.

6.1.6 Verification

Host 1

Invoke imtctl> runTests. This runs the full verification test.

Typically, all tests succeed. However, if this command is run before Host 2 is set up, the Voice Conversion Server test and the Document Conversion Server test will fail.

Run this test as described in Section 6.1.1, "Sequence of Steps".

Host 2

Invoke imtctl> getState to verify that the processes are up, but the real test needs to be invoked on Host 1 (imtctl> runTests) to make sure that the document and voice conversion services provided by Host 2 are available.

6.2 Multiple Real-Time Collaboration Core Components and Load Balancer

In this deployment, Host 1, Host 2, and Host 5 are deployed in the DMZ, while Host 3 and Host 4 are deployed in the corporate intranet.

Figure 6-2 Multiple Real-Time Collaboration Core Components + LBR

Text description of multimid.gif follows.

Text description of the illustration multimid.gif

6.2.1 Sequence of Steps

  1. Install all prerequisites on all the computers, including the load balancer (LBR).
  2. Install Real-Time Collaboration Core Components on Host 1.
  3. Perform post-installation steps on Host 1.
  4. Perform verification tests on Host 1.
  5. Install Document Conversion Server and Voice Conversion Server on Host 2.
  6. Perform post-installation steps on Host 2.
  7. Perform verification tests on Host 2.
  8. Perform verification tests on Host 1 to confirm proper connection to Host 2.
  9. Install Real-Time Collaboration Core Components on Host 5.
  10. Perform post-installation steps on Host 5.
  11. Perform verification tests on Host 5.

6.2.2 Prerequisites

Host 1: Oracle9iAS mid-tier set up and configured to use the Oracle9iAS Infrastructure on Host 4

Host 5: Oracle9iAS mid-tier set up and configured to use the Oracle9iAS Infrastructure on Host 4

Host 4: Oracle9iAS Infrastructure needs to be set up on this machine.

Host 2: A Windows NT computer with specialized hardware and software

Host 3: Oracle9i Database for the Real-Time Collaboration Repository

Using the instructions in the Advanced Configuration document at http://otn.oracle.com/products/webconferencing/, configure the LBR/Oracle9iAS Single Sign-On for multiple sets of Real-Time Collaboration Core Components. The URL used to access Oracle Web Conferencing will now be "imeeting.company.com," and "imeeting1.company.com" and "imeeting2.company.com" will be behind the LBR. Users will access "imeeting.company.com" and the request will automatically be routed to either imeeting1.company.com or imeeting2.company.com.

See Also:

Oracle Collaboration Suite Installation and Configuration Guide for Solaris for additional information on the prerequisites

6.2.3 Settings

Configure Web Conferencing to leverage existing enterprise e-mail and proxy servers for its functionality. Assume that the settings are as follows:

Table 6-4 System Settings
Setting Name Value Comments Web Conferencing Property

Existing e-mail server host name (one for the enterprise)

"mail-net.company.com"

Post-installation step

SmtpHost

E-mail server listening port

25

Default

SmtpPort

Existing proxy server host name for HTTP (one for the enterprise)

"www-proxy.company.com"

Post-installation step

UserAgentProxyHost

Proxy server host name for HTTPS (one for the enterprise)

"www-proxy.company.com"

Post-installation step

UserAgentProxySSLHost

Proxy port for HTTP

80

Default

UserAgentProxyPort

Proxy port for HTTPS

443

Default

UserAgentProxySSLPort

Proxy domains to exclude

".company.com"

Post-installation step

UserAgentProxyExclusions

Web Conferencing access URL

"imeeting.company.com"

Post-installation step. Requests to imeeting.company.com will be redirected to imeeting1.company.com and imeeting2.company.com.

GlobalWebHost

Host 1 settings are the same as described as in Table 6-2, "Instance on Host 1".

Configure Host 5 as follows:

Table 6-5 Host 5 Settings
Name of Setting Value Comments Web Conferencing Property

Number of mx

1

Default

SrvNumProcs

Listening port for the single mx

2400

Set during installation. Keep it the same as Host 1.

MxListenPort

Actual host name of Host 5

"host5.company.com"

 

N/A

Alias for Host 5

"imeeting2.company.com"

Post-installation step

ApacheWebHost

Apache listening port for HTTP on Host 5

7777

Default. Set during installation.

ApacheWebPort

Apache listening port for HTTPS on Host 5

443

Default

ApacheWebSecurePort

6.2.4 Installation

On Host 1 and Host 5, install the Real-Time Collaboration Core Components, and provide the required port numbers.

6.2.5 Post-Installation

Invoke the imtctl commands in this section, while setting Web Conferencing properties. The commands in this section are based on the data in the Settings tables in Section 6.2.3, "Settings".

Host 1

Step 1 Set up GlobalWebHost.
imtctl> setProperty -system true -pname GlobalWebHost -pvalue 
"imeeting.company.com"

Follow steps 2-7 as defined in Section 6.1.5, "Post-Installation".

Step 2 Set up e-mail.
Step 3 Set up proxy.
Step 4 Integrate Web Conferencing with Oracle HTTP Server on this Real-Time Collaboration Core Components machine.
Step 5 Set up for monitoring.
Step 6 Set up reports.

Host 5

It is not necessary to set up e-mail, proxy, or global Web host, because they are global settings and will apply to this instance, as well.

Step 1 Integrate Web Conferencing with Oracle HTTP Server on this Real-Time Collaboration Core Components machine.

Follow the step as defined in Section 6.1.5, "Post-Installation".

Step 2 Set up for monitoring.

Follow the step as defined in Section 6.1.5, "Post-Installation".

Host 2

No post-installation steps are required.

6.2.6 Verification

Host 1

Invoke imtctl> runTests. This runs the full verification test.

Typically, all tests succeed. However, if you run this command before setting up Host 2, the Voice Conversion Server test and the Document Conversion Server test will fail.

Run this as described in the Section 6.2.1, "Sequence of Steps".

Host 5

Invoke imtctl> runTests. This runs the full verification test.

Typically, all tests succeed. However, if you run this command before setting up Host 2, the Voice Conversion Server test and the Document Conversion Server test will fail.

Run this as described in Section 6.2.1, "Sequence of Steps".

Host 2

Invoke imtctl> getState to verify that the processes are up, but the real test needs to be invoked on Host 1 and Host 5 (imtctl> runTests) to make sure that the services provided by Host 2 are available.

6.3 Multiple Geographical Locations and Load Balancer

Figure 6-3 Multiple Geographical Locations + LBR

Text description of disprdep.gif follows.

Text description of the illustration disprdep.gif

In this deployment, Host 1, Host 2, Host 5, and Host 6 are deployed in the DMZ. Host 3 and Host 4 are deployed in the corporate intranet.

This is almost identical to the previous example (Section 6.2, "Multiple Real-Time Collaboration Core Components and Load Balancer") with the following key differences:

Refer to Table 6-5 and Table 6-5 in the previous section for all the values for Host 1 through Host 5 and system settings. The changes are as follows:

Table 6-6 Host 5 Setting Changes from the Previous Section
Setting Name Value Comments Web Conferencing Property

Location of Host 5

"UK"

Post-installation step.

InstanceLocation

Table 6-7 Host 6 Settings
Setting Name Value Comments Web Conferencing Property

HTTP listening port for the Voice Conversion Server

2460

Set during installation.

 

Location

"UK"

Post-installation step. Keep it the same as Host 5.

InstanceLocation

Table 6-8 Host 1 Setting Changes from the Previous Section
Setting Name Value Comments Web Conferencing Property

Location

"US"

Post-installation step.

InstanceLocation

Table 6-9 Host 2 Settings
Setting Name Value Comments Web Conferencing Property

HTTP listening port for the Voice Conversion Server

2460

Set during installation.

 

Location

"US"

Post-installation step. Keep it the same as Host 1.

InstanceLocation

Follow all installation, prerequisite, and post-installation instructions from Section 6.2, "Multiple Real-Time Collaboration Core Components and Load Balancer" in addition to the following:

Host 1

Step 1 Set up the location.
imtctl> setProperty -pname InstanceLocation -pvalue "US"

Host 2

Set this up to serve the Real-Time Collaboration Core Components on Host 1.

imtctl> setProperty -pname InstanceLocation -pvalue "[\"US\"]"

Host 5

Step 1 Set up the location.
imtctl> setProperty -pname InstanceLocation -pvalue "UK"

Host 6

Set this up to serve the Real-Time Collaboration Core Components on Host 5.

imtctl> setProperty -pname InstanceLocation -pvalue "[\"UK\"]"

6.4 Adding New Core Components to an Existing System

Figure 6-4 Text description of newmtier.gif follows.

Text description of the illustration newmtier.gif

Existing Web Conferencing Deployment with Additional Core Components

This example shows the addition of a machine, Host 7, to the configuration shown in the previous example. The changes are as follows:

6.4.1 Sequence of Steps

  1. Install prerequisites on Host 7.
  2. Install Real-Time Collaboration Core Components on Host 7.
  3. Perform post-installation steps on Host 7.
  4. Perform verification tests on Host 7.
  5. Restart the Document and Voice Conversion Servers on Host 2.
  6. Perform verification tests on Host 7.

6.4.2 Prerequisites

Host 7: Oracle9iAS mid-tier set up and configured to use the Oracle9iAS Infrastructure on Host 4.

See Also:

Oracle Collaboration Suite Installation and Configuration Guide for Solaris for details

6.4.3 Settings

Configure Host 7 as follows:

Table 6-10 Host 7 Settings
Name of setting Value Comments Web Conferencing Property

Number of mx

1

Default

SrvNumProcs

Listening port for the single mx

2400

Set during installation. Keep it the same as Host 1.

MxListenPort

Actual host name of Host 7

"host7.company.com"

 

N/A

Alias for Host 5

"imeeting3.company.com"

Post-installation step

ApacheWebHost

Apache listen port for HTTP on Host 5

7777

Default. Set during installation.

ApacheWebPort

Apache listen port for HTTPS on Host 5

443

Default

ApacheWebSecurePort

Location of Host 5

"US"

Post-installation step. Keep it the same as Host 1.

InstanceLocation

6.4.4 Installation

On Host 1 and Host 5, install the Real-Time Collaboration Core Components, and provide the required port numbers.

6.4.5 Post-Installation

Invoke the imtctl commands in this section, while setting Web Conferencing properties. The commands in this section are based on the data in the Settings tables in Section 6.4.3, "Settings".

Host 7

It is not necessary to set up e-mail, proxy, or global Web host, because they are global settings and will apply to this instance, as well.

Step 1 Integrate Web Conferencing with Oracle HTTP Server on this Real-Time Collaboration Core Components machine.

Follow the step as defined in Section 6.1.5, "Post-Installation".

Step 2 Set up location.
imtctl> setProperty -pname InstanceLocation -pvalue "US"

Step 3 Set up for monitoring.

Follow the step as defined in Section 6.1.5, "Post-Installation".

Step 4 Restart Host 2.

Restart Host 2 so that it recognizes the Real-Time Collaboration Core Components on Host 7.

6.4.6 Verification

Host 7

Invoke imtctl> runTests. This runs the full verification test.

All tests succeed.

6.5 Adding Document and Voice Conversion Servers to an Existing System

Figure 6-5 Web Conferencing Deployment with Additional Document and Voice Conversion Servers

Text description of newspsvc.gif follows.

Text description of the illustration newspsvc.gif

Another machine with Document and Voice Conversion Servers is added (Host 8).

6.5.1 Sequence of Steps

  1. Install prerequisites on Host 8.
  2. Install the Document and Voice Conversion Servers on Host 8.
  3. Perform post-installation steps on Host 8.
  4. Perform verification tests on Host 8.
  5. Bring down the Document and Voice Conversion Servers on Host 2, so that Host 8 is the only one available.
  6. Perform verification tests on Host 7 or Host 1.
  7. Restart the Document and Voice Conversion Servers on Host 2.

6.5.2 Prerequisites

See the Oracle Collaboration Suite Installation and Configuration Guide for Solaris for additional information on the prerequisites.

6.5.3 Settings

Table 6-11 Host 8 Settings
Setting Name Value Comments Web Conferencing Property

HTTP listening port for the Voice Conversion Server

2460

Set during installation

 

Location

"US"

Post-installation step

InstanceLocation

6.5.4 Installation

On Host 8, install the Document and Voice Conversion Servers, and provide the required port numbers.

6.5.5 Post-Installation

Host 8

  1. Set this up to serve the Real-Time Collaboration Core Components in location "US" by invoking:
    imtctl> setProperty -pname InstanceLocation -pvalue "[\"US\"]"
    
    
    
  2. Restart the Document and Voice Conversion Servers by invoking
    imtctl> stop and then imtctl> start.

6.5.6 Verification

Host 8

Invoke imtctl> getState to verify that the processes are up, but the real test needs to be invoked on Host 1 (imtctl> runTests) to make sure that the services provided by Host 8 are available.

Host 2

Shut down Host 2.

Host 1

Invoke imtctl> runTests. This runs the full verification test.

All tests succeed.

6.6 Additional Example

The topology is identical to the basic deployment, but the Document and Voice Conversion Servers are deployed in a different DMZ.

Figure 6-6 Deployment with Core Components in a Different DMZ

Text description of spsvcdmz.gif follows.

Text description of the illustration spsvcdmz.gif

The following additional configuration is required: