This chapter describes the steps you must complete before you can deploy Community-Gadgets. It is assumed that you have successfully generated the Community-Gadgets deployment file.
This chapter contains the following sections:
Section 16.2, "Copying Installer-Generated Configuration Files"
Section 16.4, "Adding Community-Gadgets URLs to the WebCenter Sites customBeans.xml file"
Section 16.6, "If Your Management and/or Production WebCenter Sites Is Integrated with OAM"
Run Sites Explorer and connect to the production WebCenter Sites server using the ContentServer
user. (For instructions on logging in to Sites Explorer, see the Oracle Fusion Middleware WebCenter Sites Developer's Guide.)
Open the SystemSatellite
table in Sites Explorer:
Copy the first row of the table.
Paste the row into the table, once for each management node of the Community-Gadgets application and once for each production node of the Community-Gadgets application.
In the new rows, change the values of the following fields to match the values for your installation:
description: <node name>
protocol: <http or https>
host: <host name or IP address of the management or production Community-Gadgets application server>
port: <port number of the management or production Community-Gadgets application server>
flushservletpath: /cg/FlushServer
Note:
If the standard Community-Gadgets application context root is not used, use:/<new context root>/FlushServer
username: <of the production Satellite Server user>
(the default is SatelliteServer
)
password: <password of the above user>
Continue to Section 16.2, "Copying Installer-Generated Configuration Files."
The Community-Gadgets installer created property files and other configuration files that will be read by the application server to start the deployed Community-Gadgets application correctly.
For easier management and scalability, we recommend copying the files such that each instance of the Community-Gadgets application has its own set of files:
In <cg_install_dir>
, create a directory called <cg-standalone-configs>
.
Within this newly created directory, create a subdirectory for each management node and each production node. The subdirectories will hold the configuration files for those nodes. These directories can be either on a shared file system or on an individual server, depending on you architecture.
For each subdirectory that you created in the step above, add its path to your application server's classpath.
For example, in Linux:
mkdir <cg_install_dir>/<cg-standalone-configs> cd <cg_install_dir>/<cg-standalone-configs> mkdir <cgA_M1> <cgA_M2> <cgB_P1> <cgB_P2> ...
Copy the installer-generated configuration and property files to the node subdirectories as follows:
For each Management Community-Gadgets application node:
Copy the configuration files from <cg_install_dir>
/deploy/management/management_node1
to the subdirectories that you created in step 1.b for the management Community-Gadgets application.
For example, in Linux:
cd <cg_install_dir>/deploy/management/management_node1 cp -p ./* <cg_install_dir>/<cg-standalone-configs>/<cgA_M1>
If needed, change the log file names by modifying log4j-cos.properties
and log4j-shindig.properties
for each management Community-Gadgets application on a particular node.
For each Production Community-Gadgets application node:
Copy the configuration files from <cg_install_dir>
/deploy/production/production_node1
to the subdirectories that you created in step 1.b for the production Community-Gadgets application.
For example, in Linux:
cd <cg_install_dir>/deploy/production/production_node1 cp -p ./* <cg_install_dir>/<cg-standalone-configs>/<cgB_P1>
Edit jbossTicketCacheReplicationConfig.xml
by going to the UDP tag and doing the following:
For a non-clustered application, set the value of mcast_port
to a port number that is unique relative to the other CAS applications on the subnet.
For a clustered application, set the value of ip_ttl
to 8
and change the bind_addr
to the host IP address of the Visitors CAS cluster member. Ensure that all cluster members are listening on the same mcast address and port.
If needed, change the log file names by modifying log4j-cos.properties
, log4j-shindig.properties
, and log4j.properties
for each production Community-Gadgets application on a particular node.
Complete the rest of the steps in this chapter as necessary for your system. When you have finished, continue to Chapter 17, "Deploying Community-Gadgets."
The Community-Gadgets application supports up to five proxy connection settings (disabled by default) as shown in Figure 16-1.
Figure 16-1 Proxy Connection Settings Supported by Community-Gadgets
Proxy connection 1 is an Internet connection proxy that supports communication from the production Community-Gadgets application to the Internet. This proxy connection is used for external authentication via third-party services such as Facebook, Twitter, Google, and Janrain.
Proxy connection 2 is an Internet connection proxy that supports communication from the management Community-Gadgets application to the Internet. This proxy connection is used for access to external gadgets descriptors during gadgets registration.
Proxy connection 3 supports communication from the production Community-Gadgets application to the production WebCenter Sites application.
Proxy connection 4 supports communication from the management Community-Gadgets application to the management WebCenter Sites application.
Proxy connection 5 supports communication from the management Community-Gadgets application to the production WebCenter Sites application.
If you wish to configure proxy connections, do the following:
Proxy connections are configured in the setup_proxy.properties
file located in the deploy/production/production_node1
and deploy/management/management_node1
folders, or inside the folders you created in Section 16.2, "Copying Installer-Generated Configuration Files." The setup_proxy.properties
file contains five sections with parameters for each proxy connection.
If proxies are not used, all proxy sections by default have the <proxy>
.proxy.attrs.enabled
parameter set to false
.
If a proxy is used, go to the relevant section and set the following parameters:
Set the <proxy>.proxy.attrs.enabled
parameter to true
.
Set the <proxy>.proxy.attrs.host
parameter to the host name or IP address of the proxy.
Set the <proxy>.proxy.attrs.port
parameter to the port of the proxy cos-production_www.proxy.attrs.auth.user
If a proxy requires authentication, set the <proxy>.proxy.attrs.auth.required
parameter to true
and specify the username and password in the <proxy>.proxy.attrs.auth.user
and <proxy>.proxy.attrs.auth.password
parameters.
Note:
In the Internet proxies sections, it can be useful to add the host names of your management and production WebCenter Sites instances to the list of hosts for which a proxy should not be used in production and management.For reference, a sample configuration section is given below:
Sample configuration for a production Internet connection proxy (first section in the setup_proxy.properties
file):
# Use proxy server # Possible values: "true" or "false" cos-production_www.proxy.attrs.enabled=true # Proxy type # Possible values: "http" or "socks" cos-production_www.proxy.attrs.type=http # Proxy server host cos-production_www.proxy.attrs.host=www-proxy.example.com # Proxy server port. cos-production_www.proxy.attrs.port=80 # Is authentication required for proxy server configured above. cos-production_www.proxy.attrs.auth.required=true # User proxy account to log in to the proxy server cos-production_www.proxy.attrs.auth.user=user # Password of the above user. cos-production_www.proxy.attrs.auth.password=proxypassword # List of hosts for which proxy should not be used cos-production_www.proxy.attrs.non_proxy_hosts=
Complete the rest of the steps in this chapter as necessary for your system. When you have finished, continue to Chapter 17, "Deploying Community-Gadgets.".
In your installation, navigate to <sites_install_dir>/bin/customBeans.xml
.
Open the customBeans.xml
file.
In the RequestParamValidator
bean section, add the Community-Gadgets URLs inside validUrls
list as follows:
On the WebCenter Sites management system, enter the following for each management Community-Gadgets instance:
<value>{protocol}://{cg_mgmt_node_host}:{cg_mgmt_node_port}/{cg_context}/*</value>
On the WebCenter Sites production system, enter the following for each production Community-Gadgets instance:
<value>{protocol}://{cg_prod_node_host}:{cg_prod_node_port}/{cg_context}/*</value>
In case of clustered installation, additional value is required for Community-Gadgets Load Balancer.
Example 16-1 shows a sample customBeans.xml
file.
Example 16-1 Sample customBeans.xml File
<bean id="RequestParamValidator"class="com.fatwire.cas.web.RequestParamValidator"> <property name="validUrls"> <list> <!-- Sites URL --> <value>http://192.0.2.1:8080/cs/*</value> <!-- Community-Gadgets node 1 --> <value>http://192.0.2.2:8080/cg/*</value> <!-- Community-Gadgets node 2 --> <value>http://192.0.2.3:8080/cg/*</value> <!-- Community-Gadgets Load Balancer 1 --> <value>http://192.0.2.4:80/cg/*</value> </list> </property> </bean>
Gadgets that are either developed for iGoogle or use iGoogle features may require you to enable extra Shindig features in order for those gadgets to render properly. If you enable these Shindig features, the Community-Gadgets application downloads the third-party libraries necessary for rendering the gadgets that require them from the Internet.
Note:
To enable downloading of third-party libraries, you must have access to the Internet. If you use a proxy for Internet access, configure the proper connections settings for both management and production Internet access in thesetup_proxy.properties
files. For more information, see Section 16.3, "Proxy Connection Settings."If you wish to enable additional Shindig features for the Community-Gadgets application, uncomment the following lines in the gas_features.txt
file located in the <cg_install_dir>/deploy/management/management_node1
and <cg_install_dir>/deploy/production/production_node1
folders (or in the folders you created in Section 16.2, "Copying Installer-Generated Configuration Files"):
# features/analytics/feature.xml # features/com.google.gadgets.analytics/feature.xml # features-extras/org.jquery.core-1.4.2/feature.xml
Complete the rest of the steps in this chapter as necessary for your system. When you have finished, continue to Chapter 17, "Deploying Community-Gadgets."
If your management and/or production instance of WebCenter Sites is integrated with OAM, configure the Community-Gadgets instance to work with the same OAM. For instructions, see Oracle Fusion Middleware WebCenter Sites: Installing and Configuring Supporting Software.
Continue to Chapter 17, "Deploying Community-Gadgets."