Oracle® Web Conferencing Administrator's Guide Release 2 (2.0.4.3) Part Number B10877-03 |
|
|
View PDF |
This chapter describes configuration of the Web Conferencing system in detail, including both required and optional configuration tasks. This chapter also explains the basics of the property management system and configuration management, and lists the available properties.
When you add a new instance to the system, follow the steps in Chapter 4, "Post-Installation". Use this chapter as a reference for all configuration details.
You use properties to configure the Web Conferencing system. You use the imtctl
utility to set properties. This chapter gives the syntax for setting various properties with the imtctl
utility; for more details about using the utility, see Chapter 10, "imtctl Command Line Utility". The following sections discuss:
You set properties to customize attributes of the entire system, as well as aspects of individual instances and components. You can also set properties for particular sites that you create, to control conference attributes for a particular line of business or department within your company (see Chapter 9, "Web Conferencing Sites" for information about creating sites).
The portion of the Web Conferencing system that a property affects is called its scope. Figure 5-1, "Hierarchy of Configuration Properties" shows the scopes of the properties and their relationship to each other.
System properties: Set for an entire Web Conferencing system. They are typically set once and do not need to be changed when a new instance or new set of Real-Time Collaboration Core Components is added to the system.
Example: Load balancer (LBR) properties. If an enterprise has one LBR, its properties usually only need to be set once.
Instance properties: Set on a single instance. Any change in the value of these properties affects that instance only.
Example: Location properties. Each instance in the system may have its location attribute set to a different value.
Component properties: Set on a component in a specific instance. A change in the properties affects the configuration of that component only.
Example: Properties to control the number of processes for a component. Each component in an instance can have a different number of processes. For example, the multiplexer (mx) component could have two mx processes, and the Web Conferencing Server component could have four Collaboration Server processes.
Note that changes to component properties apply to that component in that instance only. Changes do not affect the same components in other instances. Therefore, if, for example, you want to set the number of mx processes to five on all instances, you must set this property for each instance.
Site properties: Set on a specific site, to configure web conferencing for a particular line or business or department. See Chapter 9, "Web Conferencing Sites" for details about creating sites.
Example: The PreLoginMessage property. This property controls the text of a message that appears under the login link on the login page; you could have a different message for each site you create.
Some properties affect multiple scopes. Oracle Real-Time Collaboration provides the following features for properties:
Inheritance: The property value at a particular scope can be inherited from higher up in the hierarchy. For example, if you set the log level at the system scope, all instances and components in instances will use that log level.
The path of inheritance follows the order shown, from top to bottom, in Figure 5-1, "Hierarchy of Configuration Properties".
Allow Override: A property can be set at a certain scope, but the value can be overridden lower down in the hierarchy and set to a different value. For example, the log level could be set at the system scope, but you can change the log level of a specific instance. All other instances will maintain the log level set at the system scope.
This approach provides an administrator maximum flexibility and ease in configuring the system. You set a property's scope by including a scope option with the imtctl
command, for example, -system
or -instance
. See Chapter 10, "imtctl Command Line Utility" for more details about imtctl.
The rest of the sections in this chapter describe how to use individual properties. For each property, the scope(s) that apply are noted as shown in the left column of the following table:
Table 5-1 Available Scopes for Properties
Scope | Property Affects: |
---|---|
system | Property can be set to affect the entire system |
instance | Property can be set to affect an instance |
component | Property can be set to affect a component |
system and instance | Property can be set to affect the entire system, but can be overridden for a specific instance |
instance and component | Property can be set to affect an instance, but can be overriden for a specific component in that instance |
system, instance, component | Property can be set to affect the entire system, but can be overridden for a specific instance, and in turn overridden for a specific component in that instance |
site | Property can be set to affect an entire site |
system and site | Property can be set to affect the entire system, but can be overridden for a specific site |
You can display a listing of current property settings using the imtctl command, getProperties
. See "getProperties" for more information about viewing existing property settings.
The following table lists properties available for configuring Oracle Web Conferencing in alphabetical order. The next sections, discuss the properties in groups based on what portions of the Web Conferencing the properties configure.
Table 5-2 Web Conferencing Properties
Property | Configures | Details | Section Covered |
---|---|---|---|
AdditionalLocationsServed | Cluster of multiple instances | Sets locations that Document and Voice Conversion servers serve | "Properties to Configure Clusters" |
AdminEmail | E-mail conference invites | Sets the administrator's e-mail for e-mail invites. | "Properties to Configure E-mail Invites" |
AllowPublicMeetings | Conference defaults | Allows or prevents setting a meeting to be public | "Properties to Configure Conference Runtime Characteristics" |
ApacheProtocolSecure | HTTP Server | Sets whether the Apache HTTP server is using SSL security | "Properties to Synchronize with Oracle HTTP Server Settings" |
ApacheTunnelHost | Second IP Address for WebCache | Sets the second IP address for a virtual host in httpd.conf | "Properties to Configure Web Conferencing with Oracle9iAS Web Cache" |
ApacheTunnelPort | Second IP Address for WebCache | Sets the port for the tunnel for a second IP address | "Properties to Configure Web Conferencing with Oracle9iAS Web Cache" |
ApacheWebHost | HTTP Server | Sets the host name for the Apache server | "Properties to Synchronize with Oracle HTTP Server Settings" |
ApacheWebPort | HTTP Server | Sets the port on which the HTTP (Apache) server is listening for HTTP requests | "Properties to Synchronize with Oracle HTTP Server Settings" |
ApacheWebSecurePort | HTTP Server | Sets the port on which the HTTP server is listening for HTTPS requests | "Properties to Synchronize with Oracle HTTP Server Settings" |
DefaultTimeZoneName | Time zone settings | Sets the time zone for this Web Conferencing system | "Property to Configure Time Zones" |
EarlyJoinMinutes | Conference defaults | Sets the number of minutes before the scheduled start time that attendees can join a conference | "Properties to Configure Conference Runtime Characteristics" |
EnableChat | Conference defaults | Allows or prevents using chat in conferences | "Properties to Configure Conference Runtime Characteristics" |
EnableCobrowseMode | Conference defaults | Allows or prevents cobrowsing in conferences | "Properties to Configure Conference Runtime Characteristics" |
EnableDesktopSharingMode | Conference defaults | Allows or prevents desktop sharing in conferences | "Properties to Configure Conference Runtime Characteristics" |
EnableDocumentPresentationMode | Conference defaults | Allows or prevents document presentation mode in conferences | "Properties to Configure Conference Runtime Characteristics" |
EnableRecording | Conference defaults | Allows or prevents recording of conferences | "Properties to Configure Conference Runtime Characteristics" |
EnableSharedControl | Conference defaults | Allows or prevents shared control between a host and attendee | "Properties to Configure Conference Runtime Characteristics" |
EnableWhiteboardMode | Conference defaults | Allows or prevents whiteboard mode in conferences | "Properties to Configure Conference Runtime Characteristics" |
FirstAttendeeBehavior | Conference defaults | Sets the first attendee to a meeting to be co-presenter | "Properties to Configure Conference Runtime Characteristics" |
GlobalMeetingSSLSupportEnabled | SSL Security | Enables SSL for Web Conferencing | "Properties to Configure SSL Security" |
GlobalProtocolSecure | Load Balancer Integration | Sets SSL security on or off for the global Web host | "Properties to Integrate with a Load Balancer" |
GlobalWebHost | Load Balancer Integration | Name of the global Web host for this Web Conferencing system | "Properties to Integrate with a Load Balancer" |
GlobalWebPort | Load Balancer Integration | The HTTP port of the global Web host | "Properties to Integrate with a Load Balancer" |
GlobalWebSecurePort | Load Balancer Integration | The HTTPS port of the global Web host | "Properties to Integrate with a Load Balancer" |
InstanceLocation | Cluster of multiple instances | Sets a location for an instance | "Properties to Configure Clusters" |
IsCalendarOCSInstalled | Force scheduling with Oracle Calendar | Suppresses the Schedule tab so that users must schedule web conferences using Oracle Calendar | "Suppressing the Schedule Tab for Web Calendar Users" |
LogFlushInterval | Log Reports | Sets when logs are flushed | "Properties to Configure Logging" |
LogLevel | Log Reports | Sets levels at which log info is recorded | "Properties to Configure Logging" |
LogPath | Log Reports | Sets where logs are saved | "Properties to Configure Logging" |
MeetingAllControlLayout | Conference defaults | Sets whether all attendees can control the layout of the console | "Properties to Configure Conference Runtime Characteristics" |
MeetingAllUseTools | Conference defaults | Sets whether all attendees can use annotation tools | "Properties to Configure Conference Runtime Characteristics" |
MeetingAllViewAttendeeList | Conference defaults | Sets whether attendees can view the list of attendees | "Properties to Configure Conference Runtime Characteristics" |
MeetingAllViewStatusMsg | Conference defaults | Sets whether attendees can view status messages for a conference | "Properties to Configure Conference Runtime Characteristics" |
MeetingAutoHide | Conference defaults | Sets whether the conference console should be hidden when starting a conference | "Properties to Configure Conference Runtime Characteristics" |
MeetingChatInterface | Conference defaults | Sets whether the Chat interface is "docked" or a pop-up window | "Properties to Configure Conference Runtime Characteristics" |
MeetingChatType | Conference defaults | Sets what type of Chat is available for a conference | "Properties to Configure Conference Runtime Characteristics" |
MeetingDialInAndConfId | Conference defaults | Sets default dial-in information for any scheduled conference | "Properties to Configure Conference Runtime Characteristics" |
MeetingDurationMinutes | Conference defaults | Sets the default duration for any scheduled conference | "Properties to Configure Conference Runtime Characteristics" |
MeetingEmailJoin | Conference defaults | Allows attendees to join a conference directly from an e-mailed invitation to a scheduled conference | "Properties to Configure Conference Runtime Characteristics" |
MeetingEndUrl | Conference defaults | Sets the ending URL for a scheduled conference | "Properties to Configure Conference Runtime Characteristics" |
MeetingExpandHelpText | Conference defaults | Sets whether the Help banner appears in the console | "Properties to Configure Conference Runtime Characteristics" |
MeetingExpandSecondRow | Conference defaults | Sets whether the second row of the console banner (with network status, poll, preference, and details commands) appears | "Properties to Configure Conference Runtime Characteristics" |
MeetingInformation | Conference defaults | Sets additional information listed for any scheduled conference | "Properties to Configure Conference Runtime Characteristics" |
MeetingIsInstant | Conference defaults | Sets whether a conference is an "instant" conference | "Properties to Configure Conference Runtime Characteristics" |
MeetingPublishOption | Conference defaults | Sets whether the attendee list is published to attendees by default | "Properties to Configure Conference Runtime Characteristics" |
MeetingSharedControlSendPoll | Conference defaults | Sets whether attendees sharing control with the presenter can send polls | "Properties to Configure Conference Runtime Characteristics" |
MeetingSharedControlUseTools | Conference defaults | Sets whether attendees sharing control with the presenter can use annotation tools | "Properties to Configure Conference Runtime Characteristics" |
MeetingShouldSendEmail | Conference defaults | Controls whether e-mail is sent to attendees by default for a scheduled conference | "Properties to Configure Conference Runtime Characteristics" |
MeetingStartUrl | Conference defaults | Sets the starting URL for a scheduled conference | "Properties to Configure Conference Runtime Characteristics" |
MeetingTypeOfMtg | Conference defaults | Sets the default conference type (regular, public, or restricted) for any scheduled conference | "Properties to Configure Conference Runtime Characteristics" |
MxListenPort | Multiplexer (mx) | Set the ports on which the mxcomm processes listen | "Properties to Configure the Multiplexer (Mx)" |
MxRedirectEnabled | Multplexer (mx) redirect | Indicates that a port or socket name has been set using MxRedirectPort | "Properties to Configure the Multiplexer (Mx)" |
MxRedirectPort | Multiplexer (mx) redirect | Sets the multiplexer port or socket name for handing off from mod_imeeting to the mx | "Properties to Integrate with the Oracle HTTP Server" |
MxWalletLocation | SSL Security | Oracle Wallet used by the Oracle HTTP Server | "Properties to Configure SSL Security" |
MxWalletPassword | SSL Security | Set a password for the Oracle Wallet | "Properties to Configure SSL Security" |
PreLoginMessage | Web Conferencing Application Pages | Customize text of a message that appears under the login link on the login page | "Properties to Configure the Application Pages" |
PrivacyLink | Privacy statement | Sets the URL for the privacy link | "Customizing the Privacy Statement" |
PrivacyText | Privacy statement | Sets the text of the privacy statement from the privacy link | "Customizing the Privacy Statement" |
PublicMeetingNumRows | Web Conferencing Application Pages | Set the number of rows in the Public Conferences table | "Properties to Configure the Application Pages" |
PublicMeetingSortBy | Web Conferencing Application Pages | Set the criteria by which conferences in the Public table are sorted | "Properties to Configure the Application Pages" |
PublicMeetingSortOrder | Web Conferencing Application Pages | Control the order in which conferences in the Public Conferences table are sorted | "Properties to Configure the Application Pages" |
QuicklinkNName | Web Conferencing Application Pages | Configure the name of one of the QuickLinks | "Configuring the Quicklinks Bin" |
QuicklinkNURL | Web Conferencing Application Pages | Set the URL associated with one of the QuickLinks | "Configuring the Quicklinks Bin" |
ReportEnvironmentName | Reports | Set the name of the environment (site, system, etc.) for a report | "Property to Configure E-Mailed Usage Reports" |
ShowPrivacyLink | Privacy statement | Allows or suppresses display of the link to a privacy statement | "Customizing the Privacy Statement" |
SmtpHost | E-mail conference invites | Identifies the host name of the e-mail SMTP server | "Properties to Configure E-mail Invites" |
SmtpPort | E-mail conference invites | Listen port of the e-mail SMTP | "Properties to Configure E-mail Invites" |
SrvNumProcs | Multiplexer (mx) | Set the number of mx processes for a component | "Properties to Configure the Multiplexer (Mx)" |
SSLRequiredforMeetings | SSL Security / Conference defaults | Controls whether meetings must use SSL security. | "Properties to Configure SSL Security" |
StartupMeetingMode | Conference defaults | Sets the default start mode for any conference | "Properties to Configure Conference Runtime Characteristics" |
UserAgentProxyEnabled | Proxy server info | Enables all proxy settings | "Properties for Proxy Servers" |
UserAgentProxyExclusions | Proxy server info | Sets a list of URLS that should not be proxied | "Properties for Proxy Servers" |
UserAgentProxyHost | Proxy server info | Sets the hostname of the HTTP proxy server | "Properties for Proxy Servers" |
UserAgentProxyPort | Proxy server info | Sets the port number for the proxy server | "Properties for Proxy Servers" |
UserAgentProxySSLHost | Proxy server info | Sets the hostname of the HTTPS proxy server | "Properties for Proxy Servers" |
UserAgentProxySSLPort | Proxy server info | Sets the port number of the SSL proxy server | "Properties for Proxy Servers" |
VoiceDialInPrefix | Voice conference defaults | Sets the dial-in prefix for a Voice Conversion server | "Property to Configure Voice Conversion Servers" |
This section discusses all properties that pertain to configuring Real-Time Collaboration network connectivity. See "Setting Up Web Conferencing" for steps to set up proxy server properties using an imtctl
script. See "Setting Up Web Conferencing for Internet Access" for steps to integrate and synchronize with the Oracle HTTP server using imtctl
scripts. This section covers the following properties:
The following properties configure the proxy settings used by all Oracle Web Conferencing HTTP client code to do tasks like cobrowsing and cross-instance HTTP-based diagnostics. See "Setting Up Web Conferencing" for steps to set up proxy server properties using an imtctl
script.
Description: Sets the host name of the HTTP proxy.
Default value: None
Valid values: host name
Scope: Component
Examples:
To set the proxy to www-proxy.company.com for the entire system, enter:
imtctl> setProperty -system true -pname UserAgentProxyHost -pvalue "www-proxy.company.com"
To set the proxy to www-proxy.company.com for the current instance, enter:
imtctl> setProperty -pname UserAgentProxyHost -pvalue "www-proxy.company.com"
Description: Sets the host name of the HTTPS proxy.
Default value: None
Valid values: valid host name
Scope: Component
Examples:
To set the proxy to www-proxy.company.com for the entire system, enter:
imtctl> setProperty -system true -pname UserAgentProxySSLHost -pvalue "www-proxy.company.com"
To set the proxy to www-proxy.company.com for the current instance, enter:
imtctl> setProperty -pname UserAgentProxySSLHost -pvalue "www-proxy.company.com"
Description: Sets the proxy port.
Default value: 80
Valid values: Any port
Scope: Component
Examples:
To set the proxy port to 80 for the entire system, enter:
imtctl> setProperty -system true -pname UserAgentProxyPort -pvalue 80
To set the proxy port for the current instance, enter:
imtctl> setProperty -pname UserAgentProxyPort -pvalue 80
Description: Sets the SSL proxy port.
Default value: 443
Valid values: Any port
Scope: Component
Examples:
To set the SSL proxy port to 443 for the entire system, enter:
imtctl> setProperty -system true -pname UserAgentProxySSLPort -pvalue 443
To set the SSL proxy port for the current instance, enter:
imtctl> setProperty -pname UserAgentProxySSLPort -pvalue 443
Description: Sets a list of URLs for domains or hosts that should not be proxied.
Default value: None
Valid values: (simple tail-matching algorithm). The format of the value must be "[\"domain1\", \"domain2\"]"
Scope: System, Instance. The property can be set at system scope but can be overridden for a specific component.
Examples:
To set the exclusions for the whole system for domains company.com and companycorp.com, enter:
imtctl> setProperty -system true -pname UserAgentProxyExclusions -pvalue "[\".company.com\", \".companycorp.com\"]"
To set the exclusions for the current instance for domains company.com and companycorp.com, enter:
imtctl> setProperty -pname UserAgentProxyExclusions -pvalue "[\".company.com\", \".companycorp.com\"]"
Description: Enables the proxy settings. None of the other proxy settings take effect unless this is set to true.
Default value: true
Valid values: true/false
Scope: Component
Example: To enable the proxy setting, enter:
imtctl> setProperty -system true -pname UserAgentProxyEnabled -pvalue true
To integrate with the Oracle HTTP server, you must first enable the mod_imeeting
process. See "Setting Up Web Conferencing for Internet Access" for details about this step, and about setting the MxRedirectPort
property.
The following property sets the port that redirects the connections from the mod_imeeting
process to the multiplexer. See "Client Connection Details" for more details about this hand-off.
Note: You must do the tasks described in "Setting Up Web Conferencing for Internet Access" before settting the mx redirect properties. |
Description: Internet end-users connecting through the Web Conferencing Console typically connect to the Oracle HTTP server and mod_imeeting
. Ultimately, the socket is handed off to the multiplexer by mod_imeeting
, and this property facilitates the communication between mod_imeeting
and the mx process on the instance.
Default value: None. The value differs depending on the platform:
UNIX: Not a port, but a name. The socket is handed off using Domain Name Sockets.
NT: A port.
Linux: Not a port, but a name.
Valid Values: Integer within the range 2400-2700
Scope: Component.
Examples:
For one mx process (installer default), enter:
imtctl> setProperty -ct mxcomm -pname MxRedirectPort -pvalue "[\"2420\"]"
For two mx processes, enter:
imtctl> setProperty -ct mxcomm -pname MxRedirectPort -pvalue "[\"2420\",\"2421\"]"
Typically, these two examples are enough to support all modes of connections if Oracle9iAS Web Cache is not present on the Real-Time Collaboration Core Components machine, and Oracle HTTP Server is the listener.
Description: Indicates that the MxRedirectPort
has been set and must be used by mod_imeeting
when handing off sockets to the multiplexer. This property must be set to true if MxRedirectPort
is used.
Default value: False.
Valid Values: True, false.
Scope: Component.
Examples:
imtctl> setProperty -ct mxcomm -pname MxRedirectEnabled -pvalue "true"
You change the following properties to synchronize with the Oracle HTTP Server settings. Again, see "Setting Up Web Conferencing for Internet Access" for detailed steps to set up these properties, including how to use an imtctl
script to set the properties.
Description: Sets the hostname for the Apache server. The Real-Time Collaboration installer assumes that the actual host name configured for the Real-Time Collaboration Core Components machine is used by clients to access Oracle Web Conferencing resources. This might not be true in some deployments where DNS aliasing and other advanced network deployment scenarios might require customization of the names used to access Web Conferencing resources from external locations.
Default value: Actual host name derived at installation by the installer.
Valid values: Any host name
Scope: Instance
Example: If the actual host name is web10.us.oracle.com, but if the name to be used is imeeting.company.com, enter:
imtctl> setProperty -pname ApacheWebHost -pvalue "imeeting.company.com"
Description: The port on which the Oracle HTTP Server is listening for HTTP requests
Default value: 7777
Valid values: Any legal port value
Scope: Instance
Example: If the Oracle HTTP Server on the instance is listening on port 80 instead of 7777 for HTTP requests (a typical setup), enter:
imtctl> setProperty -pname ApacheWebPort -pvalue 80
Note: Setting the port to a value other than 80 may prevent access to users coming behind remote proxies. |
Description: The port on which Oracle HTTP Server is listening for HTTPS requests.
Default value: 4443
Valid values: Any legal port value
Scope: Instance
Example: If the Oracle HTTP Server on the instance is listening on port 443 instead of 4443 for HTTPS requests, enter:
imtctl> setProperty -pname ApacheWebSecurePort -pvalue 443
Note: Setting this to something other than 443 may prevent access to users behind remote proxies. |
Description: Sets whether the ApacheWebHost is using SSL.
Default value: false
Valid values: true/false
Scope: System
Example: If the Oracle HTTP Server Web host is using SSL, this property needs to be set to true, as follows:
imtctl> setProperty -pname ApacheProtocolSecure -pvalue true
If Oracle9iAS Web Cache is present on the Real-Time Collaboration core components machine, you must create a second IP address and a virtual host on the Oracle HTTP server. See "Setting Up Web Conferencing for Internet Access" for details about how to set these items. Then you set a tunnel host with the properties listed.
Note: You must do the tasks noted in "Setting Up Web Conferencing for Internet Access" before setting the properties listed. |
Description: The second IP address for which a virtual host has been configured in httpd.conf
Default value: None
Valid values: An IP address
Scope: Instance
Example: If the second IP address is 145.35.28.4, enter:
imtctl> setProperty -pname ApacheTunnelHost -pvalue 145.35.28.4
Description: Sets the tunnel port. It should be 443. Having a value other than 443 creates problems, such as preventing connection from clients from other intranets that attempt to connect through their proxy across the Internet.
Default value: 443
Valid values: A port number
Scope: Instance
Example: This is the default setting that sets the tunnel port to 443.
imtctl> setProperty -pname ApacheTunnelPort -pvalue 443
You may optionally use the following properties to set up the number of processes handled by the multiplexer (mx). The mx is the communication hub to which all component processes on an instance connect, including the Web Conferencing Server processes. Through the Web Conferencing Console, users connect to the mx processes for conferences hosted by a Web Conferencing Server on an instance. The Voice Conversion Server and the Document Conversion Server processes servicing this instance then connect to the mx.See Chapter 2, "Understanding Oracle Web Conferencing" for an overview of the multiplexer processes and how they handle Web Conferencing connection requests.
If users access web conferencing over the Internet, you can specify the port that redirects the connections from the mod_imeeting
process to the multiplexer.
Description: Sets the processes for each component. Setting this parameter for component type clbsrvr
does not affect any other parameter. However, if you change this property for the mx component, you must make sure there are enough ports to match.
Default value: 1 for component type mxcomm
, 4 for component type clbsrv
Valid values: Depends on the amount of memory on the system.
Scope: Component.
Examples:
To set the number of mx processes to 2 on the current instance, enter:
imtctl> setProperty -ct mxcomm -pname SrvNumProcs -pvalue 2
To set the number of Web Conferencing Server processes to 8 on the current instance, enter:
imtctl> setProperty -ct clbsvr -pname SrvNumProcs -pvalue 8
Description: Specifies a list of ports on which the processes in the mxcomm
component listen.
Default value: None (set during installation)
Valid values: 2400-2700
Scope: Component.
Examples:
To set one mx communication process that listens on 2400 direct port, enter:
imtctl> setProperty -ct mxcomm -pname MxListenPort -pvalue "[\"2400\"]"
To set two mx processes, one of which listens on 2400 direct port and the other one on 2401 on an instance, enter:
imtctl> setProperty -ct mxcomm -pname MxListenPort -pvalue "[\"2400\",\"2401\"]"
A load balancer (LBR) provides a single published address to the client browsers, while distributing requests to multiple Real-Time Collaboration core component middle tiers that actually serve the requests. It acts as a global Web host for all of the requests. The load balancer itself is a very fast network device that can distribute requests to a large number of physical servers.
Generally, you set the Web Conferencing properties described once for the entire system. However, if you have a different set of published addresses based on geographical considerations, each of these addresses would have multiple Real-Time Collaboration core components serving the requets. In this second scenario, you must set the following properties on each Real-Time Collaboration instance.
Description: The name of the global Web host.
For example, there could be multiple machines behind a load balancer (server1.oracle.com, server2.oracle.com), but the Web host name you wish to appear in the URL used to join a conference is server1.oracle.com.
The name cannot work if arbitrarily DNS registered.
Note: Once set, the only way to unset this property is to use the-pvaluenull true option with the setProperty command. See Chapter 10, "imtctl Command Line Utility" for more details about this option. |
Default value: None
Valid values: A host name, such as machine.company.com or machine.us.company.com.
Scope: System, Instance
Example: To set the global Web host to server1.oracle.com, enter:
imtctl> setProperty -system true -pname GlobalWebHost -pvalue "server1.oracle.com"
Description: The HTTP port of the global Web host.
Default value: 80
Valid values: Any legal port value
Scope: System, Instance
Example: To reset the global Web host to listen on port 80 for HTTP requests, enter:
imtctl> setProperty -system true -pname GlobalWebPort -pvalue 80
Note: Setting the port to a value other than 80 may prevent access to users behind remote proxies. |
Description: The HTTPS port of the global Web host.
Default value: 443
Valid values: Any legal port value
Scope: System, Instance
Example: To reset the global Web host to listen on port 443 for HTTPS requests, enter:
imtctl> setProperty -system true -pname GlobalWebSecurePort -pvalue 443
Note: Setting the port to a value other than 443 may prevent access to users behind remote proxies. |
Description: Sets whether the global Web host is using SSL security.
Default value: false
Valid values: false, true
Scope: System, Instance
Example: If the global Web host uses SSL, set the property to true:
imtctl> setProperty -system true -pname GlobalProtocolSecure -pvalue true
Use the imtctl
command line interface to assign roles to Web Conferencing users. Example:
imtctl> modifyRole -username "anyusername" -rolename "businessadmin"
See "Setting User Roles" for details about this command.
Oracle Real-Time Collaboration provides complete conference runtime security, as well as application security by providing complete support for HTTPS Secure Socket Layer (SSL).
In order configure SSL setup, the Web Conferencing properties that need to be in sync with Oracle HTTP Server settings and any load balancer settings to be set up, as well. The following properties need to be set:
ApacheWebSecurePort, discussed
ApacheProtocolSecure, discussed
GlobalWebSecurePort, discussed
GlobalProtocolSecure, discussed
In addition, you must update the imt_mod_osso.conf
file on the Oracle HTTP Server as described in the final step of "Setting Up Web Conferencing for Internet Access".
Note: Read the SSL steps in "Setting Up Web Conferencing for Internet Access" before you set any of the properties discussed in this section. |
The following sections discuss both the properties that an administrator can use to configure security options, as well as user controls for setting secure conferences and additional configuration for cobrowsing secure sites.
Note: An administrator can mandate that some or all pages use HTTPS, based on Oracle9iAS controls. Oracle Corporation strongly recommends that an administrator make sure that the Oracle9iAS Single Sign-On access during a user login is done using HTTPS. |
By default, SSL is disabled for the entire system. However, an administrator can enable the use of SSL for the entire system. Enabling SSL does not mean that it is mandated; it means that the conference runtime SSL is available. An additional property can be used to mandate use of SSL for all conferences in a system or at a site.
GlobalMeetingSSLSupportEnabled
Description: Enables the conference runtime SSL for the entire Real-Time Collaboration system. This means that users can choose to hold secure meetings, not that they are required to do so.
Default value: false
Valid values: false/true
Scope: System
Example: To enable SSL conferences on an entire Web Conferencing system, enter:
imtctl> setProperty -system true -pname GlobalMeetingSSLSupportEnabled pvalue "true"
Description: The mx uses the same wallet that the Oracle HTTP Server uses on the Real-Time Collaboration Core Components machine. The only requirement is that the wallet must be in "Auto Login mode." Use the Oracle Wallet Manager to change the wallet to "Auto Login mode." Then set the MxWalletLocation property to the location of the wallet.
Default value: Default value is unset, in which case the location $ORACLE_HOME/Apache/Apache/conf/ssl.wlt/default
is used.
Valid values: Full path of the wallet
Scope: Instance
Example:
imtctl> setProperty -pname MxWalletLocation -pvalue "/902ias/Apache/Apache/conf/ssl.wlt/default"
Decsription: Lets you set a password for the wallet. In order to set this property, you must first create an obfuscated password for the wallet user account using the Apache server's iasobf
command.
Valid values: obfuscated password for the wallet user
Scope: Instance
Example:
Obfuscate the password for the wallet user by entering the following on the Apache server:
$ORACLE_HOME/Apache/Apache/bin/iasobf -p oracle1 root base64_encoded_string
The result is a base64 encoded string, such as 03421BAB7EC4DFBD304495A4D56D541030CE4F7BB1DCA48C5.
Take the resulting obfuscated value and set the mxWalletPassword property:
imtctl> setProperty -pname MxWalletPassword -pvalue string
Description: Lets an administrator require HTTPS for all conferences or set HTTPS as the default option for all conferences.
Default value: false
Valid values: false/true
Scope: System, Site
Examples:
To require that all conferences use HTTPS by default, but allow sites to override this setting, enter:
imtctl> setProperty -system true -pname SSLRequiredForMeetings -pvalue true
To mandate use of HTTPS for all the conferences in a particular Oracle Web Conferencing site, enter:
imtctl> setProperty -siteId <site-id> -pname SSLRequiredForMeetings -pvalue true -force true
In the Oracle Web Conferencing Application, users can choose regular or SSL conferences (if both options are allowed by the administrator) by choosing the Regular or Restricted radio buttons in the Schedule Details tab. However, using controls provided in Oracle9iAS, an administrator can mandate use of SSL for some or all URLs in the application. Therefore, even if a user goes to a non-secure URL, the user could be redirected to a secure URL.
When setting their Web Conferencing Preferences, a user can mandate use of the secure mode for all attendees in the conferences that the user creates. Thus, attendees are forced to use the secure mode, based on the host's preferences.
Users can use Oracle Web Conferencing to cobrowse SSL Web sites. No additional Web Conferencing configuration is necessary if the Web sites have Web server certificates from the following certificate authorities: RSA, GTE CyberTrust, Baltimore Technologies, and Entrust.
This set is not comprehensive. If you cobrowse a Web site that uses a certificate from a certificate authority not included in the default set, the Web Conferencing Console displays an error message such as:
IMT_SRV_CM_SSL_HANDSHAKE_FAILED. The certificate submitted by the site has either expired or is not trusted by the iMeeting server.Please request your iMeeting server administrator to update the Trusted Signer Certificates Database with the certificate for the site you are visiting. [https://www.secureWeb site.com/uri/] ...
If you get this error, add Trusted Root Certificate Authority certificates to the Real-Time Collaboration Core Components machine as described in the next section.
SSL communications involve, among other things, digital certificates. Certificates are issued by a third party, called a Certificate Authority (CA). When you use your browser to visit an SSL-secured Web site, your browser validates that the Web site is who it claims to be by verifying the Web site's certificate. Your browser comes bundled with a set of Trusted Root Certificate Authority Certificates, which it uses to validate any certificate a Web site presents. Occasionally, your browser will prompt you to determine whether you want to proceed, and also optionally installs a certificate when a Web site presents a new certificate signed by a CA.
The Web Conferencing Server that browses Web sites on behalf of conference attendees comes with a default set of Trusted Root Certificate Authority certificates. When an attendee cobrowses a Web site that deploys a certificate from a CA vendor not included in the default set, you need to add the Trusted Root Certificate to the Real-Time Collaboration Core Components configuration. Follow the steps in this section to do this.
You will need to use Internet Explorer 5.5 or later to install the CA root certificate into the browser and export it as a Base64 encoded X.509 (.CER) file. You cannot use Netscape, because it does not allow the export of the root certificates to a file.
From an Internet Explorer browser that is not using Oracle Web Conferencing, go to the SSL-secured Web site that gave an error through Web Conferencing.
Using your browser, access secured areas of the Web site until you see the yellow lock in your browser status bar at the bottom.
Click the yellow lock, and then click the Certification Path tab in the pop-up window.
Select all the certificates one by one from the certificate chain. Click the General tab to read the description of the selected certificate. It contains the name of the issuer, its validity period, and so on.
If you are comfortable trusting the issuer (CA), then click the Details tab.
Click Copy To File and then click Next on the following screen.
In the subsequent screen, choose the format you want to export in as Base64 encoded X.509 (.CER) and click Next.
Enter a file name in which you want to store the certificate, for example, cavendor.cer, and save the CA certificate. Repeat steps 4 to 8 for all the certificates in the chain.
Each of the files contains a certificate in the format:
-----BEGIN CERTIFICATE----- MIICYzCCAdACEAuZ4ibKgW0O66lustIp2TowDQYJKoZIhvcNAQEEBQAwXzELMAkG A1UEBhMCVVMxIDAeBgNVBAoTF1JTQSBEYXRhIFNlY3VyaXR5LCBJbmMuMS4wLAYD VQQLEyVTZWN1cmUgU2VydmVyIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MB4XDTAw ... -----END CERTIFICATE-----
Append the file(s) saved in step 8 to the certdb.txt
file specified by the Real-Time Collaboration Core Components default property TrustDBFile
(use the imtctl
command getProperty
to see the value of this property). This file is typically located in $ORACLE_HOME/imeeting/conf
.
As discussed in "Real-Time Collaboration Clusters", you can create clusters of Real-Time Collaboration core components. You do so by assigning separate InstanceLocation
properties to a set of components. For example, if components A and B have an InstanceLocation
of "US," and components C and D have an InstanceLocation
of "India," you have two clusters, one labeled US and one labeled India.
Instances containing the Voice Conversion Server and Document Conversion Server can also be clustered by assigning them an InstanceLocation that matches the location of the Real-Time Collaboration core components you want them to serve.
Although not recommended, if for any reason an instance containing a Voice or Document Conversion server needs to serve multiple locations, use the AdditionalLocationsServed
property in this chapter.
Description: Sets the location of an instance. By default, all instances are in the location default
. All core services (Web Conferencing Servers) in a particular location are considered for load balancing.
Default value: Default
Valid values: Any string
Scope: Instance
Example: To set the location for an instance to "US," enter:
imtctl> setProperty -pname InstanceLocation -pvalue "US"
Description: Sets a list of locations to which a Voice or Document Conversion Server instances will provide service.
Default value: default
Valid values: The value should be in the format: "[\"location1\", \"location2\"]"
Scope: Instance
Example: To have a Document and Voice Conversion Server instance provide service to instances with locations HQ and UK, enter:
imtctl> setProperty -pname AdditionalLocationsServed -pvalue "[\"HQ\", \"UK\"]"
The Oracle Web Conferencing Application can generate outbound e-mail for various purposes, such as inviting users to a conference. To enable this feature, you must configure the Real-Time Collaboration system with certain e-mail-related properties. See "Setting Up Web Conferencing" for details about the steps to set up e-mail, including using an imtctl
script to set the following properties.
Description: The host name of the SMTP server Oracle Web Conferencing should use to send e-mail.
Default value: None
Valid values: a host name
Scope: System, Instance
Examples:
To set the SMTP host for the whole system to mail-net.company.com, enter:
imtctl> setProperty -system true -pname SmtpHost -pvalue "mail-net.company.com"
To set the SMTP host for the current instance to mail-net.company.com, enter:
imtctl> setProperty -pname SmtpHost -pvalue "mail-net.company.com"
Description: The listen port of the SMTP server.
Default value: 25
Scope: System, Instance
Examples:
To set SmtpPort for the whole system to 3000, enter:
imtctl> setProperty -system true -pname SmtpPort -pvalue 3000
To set SmtpPort for the current instance to 3000, enter:
imtctl> setProperty -pname SmtpPort -pvalue 3000
Description: Enables the sending of e-mailed conference invitations.
Default value: false
Valid values: false, true
Scope: System, Instance
Example: To enable e-mailed conference invitations for an entire system, enter:
imtctl> setProperty -system true -pname EmailEnabled -pvalue true
Description: Sets the e-mail account that should receive administrative e-mails from the Web Conferencing system
Default value: None
Valid values: Any user's e-mail address
Scope: System, Instance
Example: To set Joe Smith to receive administrative e-mails, enter:
imtctl> setProperty -system true -pname AdminEmail -pvalue joe.smith@oracle.com
You can customize various elements of the Oracle Web Conferencing Application. These customizations can have a system scope and also a site scope: a site can supersede the customizations of the system.
Description: Sets the text of a message that appears under the login link on the login page.
Default value: "Login is based on Single Sign-On. To log in, enter your global e-mail ID (first.last@oracle.com) and your e-mail apssword."
Valid values: Any text message.
Scope: System, Site
Example: To set the login link text to "Log in to OracleWeb Conferencing" enter:
imtctl> setProperty -system true -pname PreLoginMessage -pvalue "Log in to Oracle Web Conferencing"
Description: Sets the number of rows that are displayed in the Public Meetings table.
Default value: 10
Valid values: -1 to display all meetings, or any positive integer.
Scope: System, Site
Example: To show all meetings in the Public Meetings table for a particular site (siteID 123456), enter:
imtctl> setProperty -siteID 123456 -pname PublicMeetingNumRows -pvalue -1
Description: Sets the "sort by" column of the Public Meeting table.
Default value: The number of the "Start Date" column.
Valid values: Any integer indicating the column position, starting from 0.
Scope: System, Site
Example: To sort the Public Meetings table for a whole Web Conferencing system by the second column, enter:
imtctl> setProperty -system true -pname PublicMeetingSortBy -pvalue 1
Description: Sets the sort order of the column specified in the PreLoginPublicMeetingSortBy
property.
Default value: asc
Valid values: asc=ascending, desc=descending
Scope: System, Site
Example: To sort the rows in descending order in the PublicMeetingSortBy
column, enter:
imtctl> setProperty -system true -pname PublicSortOrder -pvalue desc
A default privacy statement ships with Oracle Web Conferencing. A link to the statement labeled "Privacy Statement" appears at the bottom of Web Conferencing application pages. Your company should evaluate whether the statement should be changed for your own needs; if so, you can change it using the following properties.
Description: Sets whether the privacy link appears at the bottom of the Web Conferencing application pages.
Default value: true
Valid values: false, true
Scope: System, Site
Example: To suppress the privacy link for site ID 123456, enter:
imtctl> setProperty -siteID 123456 -pname ShowPrivacyLink -pvalue false
Description: Sets the URL to which the privacy link points.
Default value: cmn_privacy.uix
Valid values: Any valid URL, either a relative link from the web conferencing home or an absolute link in the format http://www.site.com/filename.html
Scope: System, Site
Example: To set the privacy link to go to the Web page www.mycompany.com/legal/privacy.html, enter:
imtctl> setProperty -system true -pname PrivacyLink -pvalue "www.mycompany.com/legal/privacy.html"
Description: Sets the text displayed in the privacy statement.
Default value: ORACLE RECOMMENDS EACH COMPANY DISCUSS THE LEGAL ISSUES OF USING ORACLE WEB CONFERENCING WITH ITS CUSTOMERS, PARTNERS, AND EMPLOYEES AND REPLACE THE TEXT ON THIS PAGE WITH THE APPROPRIATE DISCLAIMER. FOR INSTRUCTIONS ON HOW TO CHANGE THIS TEXT, PLEASE REFER TO THE ORACLE WEB CONFERENCING ADMINISTRATOR'S GUIDE.
Valid values: Any valid string.
Scope: System, Site
Example: To set the privacy text to "My Company Privacy text," enter:
imtctl> setProperty -system true -pname PrivacyText -pvalue "My Company Privacy text"
If your company uses the Oracle Collaboration Suite Calendar in conjunction with Web Conferencing, you may wish to require users to schedule conferences solely through the calendar. To do so, you set the following property to prevent the Schedule tab from appearing on the Web Conferencing application pages.
Description: Sets whether the Schedule tab appears.
Default value: false
Valid values: false, true
Scope: System
Example: To prevent the Schedule tab from appearing, so that users must schedule web conferences using the Oracle Calendar, enter the following:
imtctl> setProperty -system true -pname IsCalendarOCSInstalled -pvalue true
You can make commonly-used URLs easily accessible by adding them to the Quicklinks bins on the Web Conferencing prelogin and home pages. You can add four user-defined links to this bin, setting the link names and URL with the following properties.
Description: Sets the name of the Quicklink, where N is any number from 1 through 4.
Default value: Quicklink1, Quicklink2, Quicklink3, Quicklink4
Valid values: Any string.
Scope: System, Site
Example: To configure the first user-defined link to be called "Real-Time Meetings," enter:
imtctl> setProperty -system true -pname Quicklink1Name -pvalue "Real-Time Meetings"
Description: Sets the URL associated with QuicklinkNName, where N is any number from 1 through 4.
Default value: None
Valid values: Any valid URL
Scope: System, Site
Example: To configure the first user-defined link to jump to http://realtimemeetings.company.com, enter:
imtctl> setProperty -system true -pname Quicklink1URL -pvalue "http://realtimemeetings.company.com"
Note: If the value associated with any of the Quicklinks is null, then that link does not display in the Quicklinks bin. |
You can configure some characteristics of a conference session using the following properties. These properties are used when a conference is created from an integrating site using the Oracle Web Conferencing Integration Service.
Note that individual users can also set many of these items for their own conferences, using the Preferences page.
Description: Sets the default startup mode of the Web Conferencing Console when it loads.
Default value: Cobrowse
Valid values: Cobrowse, DocumentPresentation, Whiteboard, DesktopSharing
Scope: Site
Example: To set conferences at site 1010506 to always start in DesktopSharing mode, enter:
imtctl> setProperty -siteId 1010506 -pname StartupMeetingMode -pvalue DesktopSharing
Description: Allows or prevents desktop sharing in conferences.
Default value: true
Valid values: true, false
Scope: System, Site
Example: To prevent Desktop Sharing mode for conferences at site 1010506, enter:
imtctl> setProperty -siteId 1010506 -pname EnableDesktopSharingMode -pvalue false
Description: Allows or prevents using Whiteboard mode in conferences.
Default value: true
Valid values: true, false
Scope: System, Site
Example: To allow Whiteboard mode for conferences at site 1010506, enter:
imtctl> setProperty -siteId 1010506 -pname EnableWhiteboardMode -pvalue true
EnableDocumentPresentationMode
Description: Allows or prevents document presentation in conferences.
Default value: true
Valid values: true, false
Scope: System, Site
Example: To prevent Document Presentation mode for conferences at site 1010506, enter:
imtctl> setProperty -siteId 1010506 -pname EnableDocumentPresentationMode -pvalue false
Description: Allows or prevents users from cobrowsing websites in conferences.
Default value: true
Valid values: true, false
Scope: System, Site
Example: To allow cobrowsing of other websites for conferences at site 1010506, enter:
imtctl> setProperty -siteId 1010506 -pname EnableCobrowseMode -pvalue true
Description: Sets whether the conference console should be automatically hidden at start-up.
Default value: false
Valid values: true, false
Scope: Site
Example:
imtctl> setProperty -siteId 1010506 -pname MeetingAutoHide -pvalue true
Note: Be careful when setting this property. If users do not see the conference console, they may not know that they have successfully entered a web conference. |
Description: Allows or prevents users from expanding the help text in the conference console.
Default value: false
Valid values: false, true
Scope: Site
Example: To allow expanded help text to appear in the conference console for meetings at site 1010506, enter:
imtctl> setProperty -siteId 1010506 -pname MeetingExpandHelpText -pvalue true
Description: Allows or prevents users from expanding the second row of icons and controls in the conference console. The second row includes the Network connection readout, security icon, and the Poll, Preferences, and Conference Details buttons.
Default value: false
Valid values: false, true
Scope: Site
Example: To allow the second row of icons to appear in the conference console for meetings at site 1010506, enter:
imtctl> setProperty -siteId 1010506 -pname MeetingExpandSecondRow -pvalue true
Description: Allows or prevents all conference attendees from using annotation tools.
Default value: true
Valid values: false, true
Scope: Site
Example: To prevent users participating in conferences at site 1010506 from using the annotation tools, enter:
imtctl> setProperty -siteId 1010506 -pname MeetingAllUseTools -pvalue false
Description: Allows or prevents all attendees from controlling the console layout.
Default value: true
Valid values: false, true
Scope: Site
Example: To allow all attendees to control console layout in conferences at site 1010506, enter:
imtctl> setProperty -siteId 1010506 -pname MeetingAllControlLayout -pvalue true
Description: Allows or prevents attendees from viewing the attendee list.
Default value: true
Valid values: false, true
Scope: Site
Example: To prevent users at site 1010506 from viewing the attendee list while participating in conferences, enter:
imtctl> setProperty -siteId 1010506 -pname MeetingAllViewAttendeeList -pvalue false
Description: Allows or prevents attendees from viewing status messages.
Default value: true
Valid values: false, true
Scope: Site
Example: To prevent users at site 1010506 from viewing conference status messages, enter:
imtctl> setProperty -siteId 1010506 -pname MeetingAllViewStatusMsg -pvalue false
Description: Sets the default chat type for a conference
Default value: PUBLIC_HOST (public chat with the host)
Valid values: ALL (group chat among all attendees), NONE (no chat allowed), HOST (private chat with the host), PUBLIC_HOST (public chat with the host)
Scope: Site
Example: To set the default chat mode for conferences at site 1010506 to allow all attendees to participate in a group chat, enter:
imtctl> setProperty -siteId 1010506 -pname MeetingChatType -pvalue ALL
Description: Sets whether the chat window is docked to the console, or a pop-up window.
Default value: P (pop-up)
Valid values: P, D (docked)
Scope: Site
Example: To set the chat window to be docked in the console by default, enter:
imtctl> setProperty -siteId 1010506 -pname MeetingChatInterface -pvalue D
Description: Allows or prevents the Chat feature from being available during a conference
Default value: true
Valid values: true, false
Scope: System, Site
Example: To prevent users at site 1010506 from using the Chat feature during a conference, enter:
imtctl> setProperty -siteId 1010506 -pname EnableChat -pvalue false
Description: Allows or prevents the recording features from being available during a conference
Default value: true
Valid values: true, false
Scope: System, Site
Example: To prevent attendees from recording a conference, enter:
imtctl> setProperty -system true -pname EnableRecording -pvalue false
Description: Allows or prevents shared control between host and a selected attendee
Default value: true
Valid values: true, false
Scope: System, Site
Example: To prevent a host from sharing control with attendees in conferences at site 1010506, enter:
imtctl> setProperty -siteId 1010506 -pname EnableSharedControl -pvalue false
Description: Allows attendees with shared control to use annotation tools.
Default value: true
Valid values: true, false
Scope: Site
Example: To allow attendees of conferences at site 1010506 who have been granted shared control of the conference to use annotation tools, enter:
imtctl> setProperty -siteId 1010506 -pname MeetingSharedControlUseTools -pvalue true
Description: Allows attendees with shared control to send polls.
Default value: false
Valid values: true, false
Scope: Site
Example: To allow attendees of conferences at site 1010506 who have been granted shared control of the conference to send polls, enter:
imtctl> setProperty -siteId 1010506 -pname MeetingSharedControlSendPoll -pvalue true
Description: Sets a default URL that is displayed when the conference starts.
Default value: none
Valid values: Any valid URL
Scope: Site
Example: To set the starting URL for meetings at site 1010506 to www.mycompany.com, enter:
imtctl> setProperty -siteId 1010506 -pname MeetingStartUrl -pvalue http://www.mycompany.com
Description: Sets a default URL that is displayed when the conference finishes.
Default value: none
Valid values: Any valid URL
Scope: Site
Example: To set the ending URL for meetings at site 1010506 to www.mycompany.com, enter:
imtctl> setProperty -siteId 1010506 -pname MeetingEndUrl -pvalue http://www.mycompany.com
Description: Sets whether conferences held at a site are instant conference.s
Default value: false
Valid values: true, false
Scope: Site
Example: To set conferences at site 1010506 to be standard rather than instant conferences, enter:
imtctl> setProperty -siteId 1010506 -pname MeetingIsInstant -pvalue false
Description: Sets the suggested default conference duration in minutes.
Default value: 60
Valid values: any valid integer
Scope: Site
Example: To set scheduled conferences at site 1010506 to default to 30 minutes long, enter:
imtctl> setProperty -siteId 1010506 -pname MeetingDurationMinutes -pvalue 30
Description: Set the default conference type option in the Schedule tab.
Default value: REGULAR
Valid values: REGULAR (anyone to whom you provide the conference URL may attend), PUBLIC (anyone may attend, and the conference is published on the Web Conferencing pages), RESTRICTED (only registered users who have been invited may attend the conference; the conference is not listed on the Web Conferencing pages)
Scope: Site
Example: To set the default conference type at site 1010506 to Public, enter:
imtctl> setProperty -siteId 101 -pname MeetingTypeOfMtg -pvalue PUBLIC
Description: Sets default dial-in information and a conference ID; this can be used if you have a phone conference service that you use while you web conference.
Default value: none
Valid values: Any text
Scope: Site
Example: To set the default dial-in for site 1010506 to dial a conference number and a specific conference id, enter:
imtctl> setProperty -siteId 1010506 -pname MeetingDialInAndConfId -pvalue "18001234567,,,ID555666#"
Description: Sets default additional information related to all conferences.
Default value: none
Valid values: Any text
Scope: Site
Example: To inform users at site 1010506 that SSL security is on by default, you could enter:
imtctl> setProperty -siteId 1010506 -pname MeetingInformation -pvalue "All conferences at ABC Corp. use SSL security."
Description: Allows or prevents the host from publishing the attendee list.
Default value: true
Valid values: true, false
Scope: Site
Example: To prevent any hosts at site 1010506 from publishing attendee lists for their meetings, enter:
imtctl> setProperty -siteId 1010506 -pname MeetingPublishOption -pvalue false
Description: Allows attendees to join the conference directly from the e-mail link.
Default value: true
Valid values: true, false
Scope: Site
Example: To allow attendees of conferences at site 1010506 to join conferences from the link displayed in an e-mail announcement, enter:
imtctl> setProperty -siteId 101 -pname MeetingEmailJoin -pvalue true
Description: Allows the host to notify attendees by e-mail.
Default value: true
Valid values: true, false
Scope: Site
Example: To allow hosts of conferences at site 1010506 to send e-mailed invitations to a web conference, enter:
imtctl> setProperty -siteId 101 -pname MeetingShouldSendEmail -pvalue true
Description: Sets the number of minutes before a conference's scheduled start time during which users can join.
Default value: 30
Valid values: Any positive integer
Scope: System
Example: To configure this value to 15 minutes, enter:
imtctl> setProperty -system true -pname EarlyJoinMinutes -pvalue 15
Description: Allows or prevents users from choosing Public meetings in the Schedule tab or listing archived conferences on the public Web page.
Default value: true
Valid values: false, true
Scope: System, Site
Example: To prevent users at site 1010506 from holding Public meetings or publishing archived meetings on the public web page, enter:
imtctl> setProperty -system true -pname AllowPublicMeetings -pvalue false
Description: Sets whether the first attendee is prompted to be a presenter.
Default value: Attendee
Valid Values: Attendee (the attendee is not a presenter), DesktopControl (the attendee can present)
Scope: System, Site
Example: To set the first attendee to be prompted for presenter mode, enter:
imtctl> setProperty -system true -pname FirstAttendeeBehavior -pvalue DesktopControl
The VoiceDialInPrefix
property lets you set dial-in prefixes. See "Setting Up Document and Voice Conversion Servers for Web Conferencing" for complete details about all Voice Conversion server configuration.
Description: This property sets the dial-in prefix for an instance of the Voice Conversion Server. This prefix would be added to all dial-in numbers received by the Voice Conversion Server before dialing out. Typically, corporations have a dial-in prefix ("9," for example) for dialing numbers outside the company's internal phone network.
Default Value: None
Valid Value: Any valid dialing sequence. In most cases, it would be a number example: "9" A valid dialing sequence contains numbers 0-9 and any of the following characters: * # ,
Scope: Instance
Example: To configure the dial-in prefix for a Voice Conversion Server instance to "9" enter:
imtctl> setProperty -i <instance-name> -pname "VoiceDialinPrefix" -pvalue "9"
Oracle Web Conferencing reports can be generated and sent via e-mail using the imtreport script. This script also controls whether the Usage Reports that appear under the Reports tab are populated with data. "Setting Up Web Conferencing" describes how to edit the script and set up a cron job or Scheduled Task to run the script on a regular basis.
The ReportEnvironmentName property controls the name that appears at the top of the e-mailed reports.
Description: Sets the name of the environment for this report. The name appears in the report header.
Default value: None
Valid values: Any text
Scope: System
Example: To set the report environment name to "My Company Web Conferencing System," enter:
imtctl> setProperty -system true -pname ReportEnvironmentName -pvalue "My Company Web Conferencing System"
You can configure levels of conference logging, as well as the location of the generated logs.
Description: Log level
Default value: CONFIG
Valid values: NONE, SEVERE, WARNING, INFO, CONFIG, FINE, FINER, FINEST, ALL
Scope: System, Instance and Component. The property can be set at a system scope, can be overridden for a specific instance and in turn can be overridden for a specific component in that instance.
Examples:
An administrator wants to set the system-wide log level to SEVERE and then for a specific instance, the administrator wants to change it to WARNING and then for the Web Conferencing Servers in that instance, wants to change the log level to FINE.
To set the system-wide log-level to SEVERE, enter:
imtctl> setProperty -system true -pname LogLevel -pvalue SEVERE
To set the instance-wide log-level for the current instance to WARNING, enter:
imtctl> setProperty -pname LogLevel -pvalue WARNING
To set the log level for Web Conferencing Servers only to FINE in this instance, enter:
imtctl> setProperty -ct clbsvr -pname LogLevel -pvalue FINE
Description: The log path relative to IMT_HOME. The filename must be specified using forward slashes '/', even on the Microsoft Windows platform.
Default value: logs (Because this is relative to IMT_HOME, it becomes IMT_HOME/logs)
Valid values: any directory. The directory name must be specified using forward slashes (/), even on the Microsoft Windows platform.
Scope: Component (default), System, Instance
Example: To set the log path to directory IMT_HOME/imtlogfiles/, enter:
imtctl> setProperty -system true -pname LogPath -pvalue "imtlogfiles"
Description: System-wide log flush interval in the system-wide log flush interval, duration types must be specified in some combination of days, hours, minutes, seconds, and milliseconds. Valid abbreviations include "d", "hr", "min", "sec", "millis". Values must be in quotation marks due to the spaces.
Default value: 10 sec
Scope: Component (default), System, Instance
Example: To set the log flush interval to one second, enter:
imtctl> setProperty -pname LogFlushInterval -pvalue "1 sec"
Users can set their time zone by logging in to the Web Conferencing Application and clicking Preferences. A list of available time zones displays.
After users have set their time zone, all date and time references in the Web Conferencing Application and Web Conferencing Console are automatically converted to their time zone.
Example: User A sets his time zone to "(-05:00) US Eastern Time." He then schedules a conference for 30-Mar-2004 5:00 PM. He intends to have the conference at 5 pm Eastern Time. User B, whose time zone is set to "(-08:00) US Pacific Time," is invited to this conference. When User B sees the invitation in her Upcoming Meetings tab, it displays as 30-Mar-2004 2:00 PM. The time has been converted to Pacific Time for User B.
See Appendix A, "Time Zones" for a complete list of supported time zones.
When a user registers with Oracle Web Conferencing for the first time, the user's default time zone is set based on the system-level property DefaultTimeZoneName.
DefaultTimeZoneName
Description: Sets the default time zone for this Web Conferencing system.
Default: UMT (Universal Mean Time)
Valid values: Any zone listed in Appendix A, "Time Zones"
Scope: System
Example: To set the system time zone to New York time, enter:
imtctl> setProperty -system true -pname DefaultTimeZoneName -pvalue America/New_York
Note: This setting only affects the default time zones for users who have not set their time zone yet. You should encourage users to set their time zones. |