1. Marketing Installation and Administration Guide
  2. Configuring the Web Survey Daemon

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'ueueing.

    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