Siebel Marketing Installation and Administration Guide > Setting Up Web Marketing > Setting Up Siebel Web Marketing >

Configuring the Web Survey Daemon

This topic describes the tasks you must perform to configure the Web Survey Daemon after it is installed. After configuring the WSD, you must also configure the outbound Web service in Siebel Marketing for the Web Survey Daemon. This task is also described in this topic.

Configuring the Web Survey Daemon

Perform the steps in the following procedure to configure the WSD.

To configure the Web Survey Daemon

1. In the Oracle database, create a new user for the Web Survey Daemon.
2. Assign all Admin privileges to the user, and then log out.
3. Log in as the new user and run the appropriate script for your database (for example, communicatorOracle10g.sql script). This creates all WSD tables.
4. In the websurveys.properties file located at WSD_HOME\webapps\websurveys\config, define the parameters shown in the following table.

   Parameter	Value
   db.driver	com.siebel.sem.jdbc.oracle.OracleDriver The configuration file contains driver classes for several databases.
   db.WEBSURVEY.password	com123 the new WSD database user's password NOTE:  The password must be encrypted. To encrypt strings, make sure occam-crypto.jar is in the classpath. At the command line, type: java com.siebel.occam.security.OccamCrypto encrypt string. Use the output to make entries in the properties file.
   db.WEBSURVEY.url	Make sure the database URL is set for the appropriate database type. Sample URLs are provided in the configuration file.
   db.WEBSURVEY.user	com the new WSD database user
   DEFAULT_RESPONSE_DAEMON_SLEEP_TIME	Sleep time in milliseconds for the response processor daemon.
   QueueFlushInterval	Interval in milliseconds that the response processor is invoked.
   QueueMaxSize	Max Queue size after which the response processor is invoked.
   SIEBEL_PASSWORD	Siebel Password for response Web Service call.
   SIEBEL_URL	Siebel endpoint URL for response processing.
   SIEBEL_USERNAME	Siebel Username for response Web Service call.
   survey.baseURL	MachineName:port/websurveys
   WebSurveyHandlerClassName	oracle.apps.sem.wsd.runtime.queueing.MBQQueueHandler
   WebSurveyProcessorClassName	oracle.apps.sem.wsd.response.ResponseDataProcessor
   WebSurveyQueueDirectory	Directory where the queue files will be written. The default directory is WSD_home_directory\webapps\websurveys\queueing. You can specify a different location if you choose.

5. (Optional) Configure advanced settings in the websurveys.properties file.

   Parameter	Value
   systemCache.active	This is an optional but recommended system cache setting to activate the WSD's object cache. Default is true.
   systemCache.maxSize	This is an optional system cache setting to specify the maximum number of Java objects to keep in the Web survey's cache. Default is 9216.
   systemCache.maxAge	This is an optional system cache setting to specify the maximum age (in milliseconds) of objects in the cache. Default is 3,600,000 (one hour).
   systemCache.cleanFrequency	This is an optional system cache setting to specify how often (in milliseconds) the cache is cleaned. Default is 300,000 (5 minutes).
   respondentCache.active	This is an optional (but highly recommended) respondent cache setting to activate the Web survey's object cache. Default is true.
   respondentCache.maxSize	This is an optional respondent cache setting to specify the maximum number of respondents' answers that will be kept in the Web survey's cache. Default is 1024.
   respondentCache.maxAge	This is an optional respondent cache setting to specify the maximum age (in milliseconds) of objects in the cache. Default is 1,200,000 (20 minutes).
   respondentCache.cleanFrequency	This is an optional respondent cache setting to specify how often (in milliseconds) the cache is cleaned. Default is 60,000 (1 minute).
   SOCKET_TIMEOUT	This is a response processor setting that adjusts the timeout of the network socket used to communicate with the response import Web Service. It prevents a socket timeout from occurring when the import Web Service needs more time to process the responses (due to resource issues or the batch size). Default is 300,000 ms.

6. (Optional) If you are running the WSD in a load-balanced, multi-server configuration, list the base URLs of each computer in your configuration in the Multi-Server Settings section of the websurveys.properties file. These URLs go directly to the individual computers, bypassing whatever load balancing facility you are using. Be sure to include the application context path (typically /websurvey). For example:

   #server.1 = http://websurvey01.example.com/websurvey

   #server.2 = http://websurvey02.example.com/websurvey

   #server.3 = http://websurvey03.example.com/websurvey

7. On a Windows server, start the Siebel Web Survey Daemon service.
8. On a UNIX server, enter and run the following command:

   ./tomcat-ctl.sh start

Configuring the Web Survey Outbound Web Service

Perform the steps in the following procedure to configure the Web Survey outbound Web service for the WSD.

To configure the Web survey outbound Web service for the WSD

1. Navigate to the Administration - Web Services screen, and then the Outbound Web Services view.
2. Configure the IP address and port for the Web Survey outbound Web service to point to the appropriate computer name and port where the WSD is running. For example:

   http://MachineName:8088/websurveys/services/WebSurveyWebService?wsdl

3. WSD Web Service security is seeded in Siebel Marketing and the WSD server. The default username is SiebelSystem. If the user password is changed in the WSD, it must also be changed for the Web Survey Daemon server in the server configuration as follows:
   1. Navigate to the Administration - Marketing screen, and then the Servers view.
   2. Query for Web Survey Daemon.
   3. Change the password and save it.
4. (Optional) If the default port 8080 is unavailable, you can change the port by doing the following:
   1. Navigate to %CATALINA_HOME%\conf and open the server.xml file.
   2. Edit the port number in the following section:

   <!-- Define a non-SSL HTTP/1.1 Connector on port 8080 -->

   <Connector port="< your port No.>" maxHttpHeaderSize="8192"

   3. Restart Apache Tomcat server.