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.

Configure the Web Survey Daemon

  1. Prepare the WSD database and create the WSD schema objects. For instructions for Oracle Database, Microsoft SQL Server, or IBM Db2, see Prepare the WSD Database.

  2. In the webservey.properties file located at WSD_HOME\webapps\websurveys\config, define the parameters shown in the following table.

    Note: Do not use either encrypted WSD account value for this parameter. The database owner password is used by WSD to connect to the database; the system and SiebelSystem passwords authenticate their respective WSD accounts.
    Parameter Value

    db.driver

    Set db.driver to the driver class for the WSD database:

    For Oracle database: com.siebel.sem.jdbc.oracle.OracleDriver

    For Microsoft SQLServer database: com.siebel.sem.jdbc.sqlserver.SQLServerDriver

    For IBM DB2 database: com.siebel.sem.jdbc.db2.DB2Driver

    db.WEBSURVEY.password

    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

    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.

  3. (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.

  4. (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

  5. On a Windows server, start the Siebel Web Survey Daemon service.

  6. On a UNIX server, enter and run the following command:

    ./tomcat-ctl.sh start